diff --git a/ach/origin/README.md b/ach/origin/README.md new file mode 100644 index 000000000..fc31c517c --- /dev/null +++ b/ach/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Ocoko ma en aye ka i kom Discord ki i GitHub Discussions ki i kare ma en aye. +--- + +# 🏠 Pe iyi Dokumenti Portal + +{% hint style="info" %} + +**Dokumenti ki Plazma kicel me gwok ma kicel me tic pa iye.** + +[![Translation Status](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Kiyeko kubinnyabufuzi kwa [https://translate.plazmamc.org/](https://translate.plazmamc.org/) kacel kipokorwo iyi ukibinnyabufuzi. + +{% endhint %} + +### Kilwama pe i kom Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Kica Thunderbolt, ki i kom ma i coko? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Kica Volt, ki i kom ma i coko? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Coko ki i kom ma i coko ki Minecraft ma lubo dano? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ach/origin/SUMMARY.md b/ach/origin/SUMMARY.md new file mode 100644 index 000000000..b1cdd02ad --- /dev/null +++ b/ach/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Lok ma kwo + +- [🏠 Maleng Dok Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Icwalo Dok](plazma/README.md) +- [❓ Plazma ni?](plazma/about/README.md) + - [⬇️ Gamo](plazma/about/downloads.md) + - [✅ Lubanga ma Kicwalo](plazma/about/supported-versions.md) +- [⚒️ 서버 관리 가이드](plazma/administration/README.md) + - [👟 시작하기](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Reference](plazma/administration/reference/README.md) + - [🖥️ Commands](plazma/administration/reference/commands.md) + - [🛡️ Permissions](plazma/administration/reference/permissions.md) + - [🎛️ Arguments and Properties](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Dok ma kicel pa dano](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Dok ma kicel pa dano](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Dok ma kicel pa dano](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Advanced](plazma/administration/expert/README.md) + - [🧹 Optimization](plazma/administration/expert/optimize.md) + - [🔀 프록시](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray 차단](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilities and Solutions](plazma/administration/expert/fix-exploits.md) + - [⁉️ Frequently Asked Questions](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Lubanga Dokar](plazma/developers.md) + - [✏️ Yee i](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Gwok i Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Gwok i Volt](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ View Downloads](plazma/about/downloads-all.md) diff --git a/ach/origin/miscellaneous/README.md b/ach/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ach/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ach/origin/plazma/README.md b/ach/origin/plazma/README.md new file mode 100644 index 000000000..34e2d62f2 --- /dev/null +++ b/ach/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma tic me nyingo ki kwo Minecraft: Java Edition ma pe ki opo i kit ma cwinywa i paper, cwinywa i experiment, i cwinywa i mekerani me pwonyo." +--- + +# ✨ Dokumenti ki Tic me Plazma + +## 👋 Woko ki Dokumenti me Plazma + +Dokumenti me Plazma kicwinywa ki woko! + +{% hint style="info" %} + +**Gin ma en aye kiketo ni i pwonyo ki ngom?** + +[Acholi translation not available] + +{% endhint %} + +### Maco me Plazma + +> Cwinywa ki woko ki Plazma. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Ki balo me Gwok mekerani + +> Cwinywa ki woko ki Plazma ki kwo tic me server mukene. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Ki balo me Gwok mekerani + +> Cwinywa ki woko ki Plazma ki kwo tic me cwinywa i mekerani me tye ka cwinywa. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ach/origin/plazma/about/README.md b/ach/origin/plazma/about/README.md new file mode 100644 index 000000000..abcebd6eb --- /dev/null +++ b/ach/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Cwinywa ki woko ki Plazma. +--- + +# ❓ Plazma pe ngatino? + +- **Plazma** ni [Andromeda](https://github.com/EarendelArchived/Andromeda) me [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) ma [Paper](https://github.com/PaperMC/Paper) pe ikineno [Paper](https://github.com/PaperMC/Paper) ki geno ni server platform. +- Kica mako ni ngec pa lubo ma kwo kwede, kwo ngec ma kwede, kwo tic ma kwo kwede, kwo tic ma kwo kwede kadi kwo kwede kadi kwo kwede kadi kwo kwede. + +## 📋 Kakube ki Plazma + +- Kica mako ni kwo tic ma kwo kwede, kwo ngec pa lubo ma kwo kwede. +- Modo platform ki kwo tic ma kwo kwede kadi kwo kwede, kwo tic ma kwo kwede kadi kwo kwede kadi kwo kwede. +- Vanila pe kwo tic ma kwo kwede kadi kwo kwede kadi kwo kwede kadi kwo kwede. + +## ⚙️ Kube ki kwo tic + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Kube ki peyo update meyo**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ki ngec meyo Plazma meyo patch ki kwo tic ma kwo kwede, Paper ki geno ni server platform meyo kwo tic ma kwo kwede. +6. **Kube ki peyo basic configuration file**\ + Basic configuration file ki ngec meyo kwo tic ma kwo kwede. +7. **Kube ki peyo multi-thread meyo**\ + Game meyo mechanism kadi relation meyo system mechanism ki ngec meyo asynchronous, [delay time](#user-content-fn-4)[^4] ki ngec meyo server ki optimization. +8. **Kube ki peyo unnecessary space**\ + Data meyo ki ngec meyo kwo tic ma kwo kwede kadi kwo kwede. + +## ✨ Kube ki kwo tic + +- **Pwonyo me giteregi ma pe kicel**\ + Developer [IPECTER](https://github.com/IPECTER) giketo ki server ma Plazma ki giketo.\ + NMS me reflection ki giketo, kiketo me kiketo ki pwonyo, giteregi ma pe kicel ki data packs ki kwan me kwan pe romo cwalo,\ + 100 pe i pwonyo me pwonyo ki player ki kicwalo i pe cwalo. +- **RPG server ma pe kicel ki pwonyo**\ + Cluster me cwinywa 100 ki player ki pe cwalo TPS, ki pe cwalo,\ + 4 ki cluster me cwinywa 250 ki player ki pe kicel ki pwonyo ma pe kicel ki pwonyo. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Many streamers have chosen the platform**\ + It is being used as a bucket for viewer participation by many streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +Kacel i kom Plazma ki ngec meyo. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Version meyo kwo tic ma kwo kwede information ki ngec meyo? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugin ma Paper, Pufferfish, Purpur plugin. + +[^2]: Microsoft Corporation. + +[^3]: Chat reporting system ki peyo kwo tic ma kwo kwede chat meyo kwo tic ma kwo kwede Mojang ki chat tracking kwo tic ma kwo kwede. + +[^4]: System mechanism ki ngec meyo game ki ngec meyo kwo tic ma kwo kwede. diff --git a/ach/origin/plazma/about/downloads-all.md b/ach/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..35c74d117 --- /dev/null +++ b/ach/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma 실행 파일 다운로드 전체보기 +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Lanyo | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ach/origin/plazma/about/downloads.md b/ach/origin/plazma/about/downloads.md new file mode 100644 index 000000000..8899cf295 --- /dev/null +++ b/ach/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Kube Plazma kwo tic pa ngec kacel i kompyuta. +--- + +# ⬇️ Download + +#### Version meyo kwo tic ma kwo kwede information ki ngec meyo? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**I kilo pa loyo kwede ni kabedo ma kicel acel mako.** + +Developer ni, pwonyo kwede ma ber kwede ni, i kilo pa loyo kicel mako ki gengo. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
LanyoGwok kacel
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + PIRA +
1.20.1 + +
1.19.4 + +
+ +*** diff --git a/ach/origin/plazma/about/patches-list.md b/ach/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..c20a83bb2 --- /dev/null +++ b/ach/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Cwiny Pwonye ki i Plazma ma kicel i kwo ngec pi dong kwede. +--- + +# 📑 Kit ma cwiny Pwonye diff --git a/ach/origin/plazma/about/supported-versions.md b/ach/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..ccc1a7c84 --- /dev/null +++ b/ach/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Kube me Plazma: Java Edition yoo i kom" +--- + +# ✅ Yoo i kom + +{% hint style="info" %} + +**Plazma ki 1.19.4 dong pe i kare kadi, 1.19.4 me pwonyo ki dong pe i kare.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/Information%20missing +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| Lanyo | Stability and functionality support | Kicoyo i gengo | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ach/origin/plazma/administration/README.md b/ach/origin/plazma/administration/README.md new file mode 100644 index 000000000..ada7b456d --- /dev/null +++ b/ach/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Cwinywa ki woko ki Plazma ki kwo tic me server mukene. +--- + +# ⚒️ Dokot pa Server diff --git a/ach/origin/plazma/administration/diagnosis/README.md b/ach/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..a1f9ea863 --- /dev/null +++ b/ach/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Kubeo woko kicoyo i cwinywa ki ngec mogo. +--- + +# 🧾 진단 diff --git a/ach/origin/plazma/administration/diagnosis/plugins.md b/ach/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..92f52313e --- /dev/null +++ b/ach/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Kikwero pe iŋwene pe iŋwene ki ngec ma gicoyo iye. +--- + +# 📜 플러그인 diff --git a/ach/origin/plazma/administration/expert/README.md b/ach/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..0a95e39a8 --- /dev/null +++ b/ach/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Cing ma Plazma ki yom cwiny pi romo ada i ma i kare ma en aye. +--- + +# 🎓 Kwo i cwiny diff --git a/ach/origin/plazma/administration/expert/fix-exploits.md b/ach/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..4197ea084 --- /dev/null +++ b/ach/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Monyo i loko i kom i lobo me cwiny me kwanyo ki iye. +--- + +# ⚠️ Monyo i loko i kom i lobo me cwiny me kwanyo ki iye diff --git a/ach/origin/plazma/administration/expert/optimize.md b/ach/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..a6c53a00a --- /dev/null +++ b/ach/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Cwinyo Plazma ki dogi maber. +--- + +# 🧹 Cwinyo diff --git a/ach/origin/plazma/administration/expert/proxy.md b/ach/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..9a9491c6b --- /dev/null +++ b/ach/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Kiketo "Velocity" me pwonyo kwede i proksi platform. +--- + +# 🔀 Proksi diff --git a/ach/origin/plazma/administration/expert/vanillaize.md b/ach/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..c8576d115 --- /dev/null +++ b/ach/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Kwo kwo i Paper me vanilla pa kwo cwinywa iye. +--- + +# ↩️ Kwanyo vanilla + +{% hint style="warning" %} + +**Paper woko i vanila itye kwede kicoyo ki kwo kicoyo me patch me bot I nino.** + +Plazma me cwinywa iye kwo iye patch manyenyo ma vanilla tye ki i kom. + +Ento iyi guide tye ki i kom, kadi itye ka i kom i ma gengo kwedeo ki iye. + +{% endhint %} diff --git a/ach/origin/plazma/administration/expert/xray.md b/ach/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..2bd0fe2df --- /dev/null +++ b/ach/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray를 차단하는 여러 가지 내장된 방법에 대해 알아보세요. +--- + +# 🩻 X-Ray 차단 diff --git a/ach/origin/plazma/administration/faq.md b/ach/origin/plazma/administration/faq.md new file mode 100644 index 000000000..b19690e10 --- /dev/null +++ b/ach/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Kicwoko ki kicwinyo ni kicwinyo ki cungu. +--- + +# ⁉️ Kicwoko ki kicwinyo + +{% hint style="info" %} + +**Pe olara i kwo me tye i cwiny matino?** + +[Acholi translation not available] + +{% endhint %} + +### Plazma pe kicwako + +Consolet `no main manifest attribute, in plazma-(version).jar` gine ki kicwinyo,\ +Fail me donyo ni API me bedo, GitHub pe **Reobf Paperweight** kicoyo. + +Kicwinyo ni kicwinyo ki iye ma kicwoko ki i wiya. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Server pe kicwinyo ki iye ma kicwoko ki kicwinyo ki cungu. + +Plazma pe i cungu ma iye, kiketo ki cungu ki iye, dong i wiya i kompyuta pe kicwinyo ki iye ma kicwoko ki kicwinyo ki cungu. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Kicwinyo ki iye me [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] gine ki kwano i kompyuta. + +Kicwinyo ni kicwinyo ki iye ma kicwoko ki i wiya. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1 pe i wiya diff --git a/ach/origin/plazma/administration/getting-started/README.md b/ach/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..b88ae6edf --- /dev/null +++ b/ach/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Kwon ma Plazma ki yoo kare ma server iye ki kwanyo. +--- + +# 👟 Cing i + +Kwon ma Plazma ki tye kwede ngom me cwinywa, kadi sistema ki dong i kom bedo ma i kom. + +| | Tye kwede | Tye kwede iye | +| :-------------: | --------- | ------------- | +| Akitekci | x64 | - | +| RAM | 8GB | 16GB | +| Dano me cwinywa | 1GB | 8GB | +| JDK | 17 | 21 | + +Icwinywa me kwo koni i kit ma pe ngom, [Visual Studio Code](https://code.visualstudio.com/download) me iye ma kwo yee kwanyo woko iye. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Kicel ma kicel" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' ki i kwo woko me kic me kic, me kic matwero, kun o ma +bati file ma pe i kom. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Ka ki tye kwede ki JRE **JDK 21** me `.msi` kwede ma [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) ki download. +2. Jokkwa kwede ma gin ma, `Doki` ki cwalo. +3. **Lok me cwalo, `Set JAVA_HOME variable` ki gengo ngolo,** `Doki` ki cwalo. +4. Ki cwalo ki tye kwede JRE ki tye ki `kwede` ki tye kwede. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Kadi kwede, calo kom me tye ki terminal ki gengo JRE ki tye kwede. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma ki download + +Plazma ki nyutu ma kwo poto me doki me tye kwede. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Yom me kwo + +Poto me doki me kwede iyi `plazma-(kare me bedo)-1.20.4-R0.1-SNAPSHOT-(maping kacel).jar` ma onongo. + +- **Maping kacel**\ + Maping iyi ni Minecraft ma kwo doki me cwiny me lukalala ki dong kwede. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Kare me bedo**\ + Kare me bedo ni doki me cwiny me server ki doki me lukalala ki dong kwede. + - **Paperclip**\ + PaperMC timo ki yom Paper mukene ki dong kwede, kare me bedo ni kwo download ma kwo cwalo me server. + - **Bundler**\ + Minecraft kare me bedo ki dong kwede. + +
+ +*** + +## 3. Lok ma cwalo ki gengo + +Plazma ki yom ma kwo, server ki cwalo me cwiny ma kwo, [lok ma cwalo ki gengo](#user-content-fn-6)[^6] ki tye kwede. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Lok me tye kare dongo download ki gengo lok ma cwalo ki gengo.\ +**Dongo download ki gengo tye kwede kare ma i kom yom me kare me bedo pe JRE ki tye kwede.** + +*** + +## 4. Failo ki yom + +Iyi dongo download ki gengo me Plazma ki weko i kom kwede ki tye ki tye kwede. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Iyi dongo download ki gengo me cwalo ki gengo. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA dok ma cwalo + +Lok ma cwalo ki gengo, folder ki `eula.txt` ki tye kwede. + +EULA[^9] ni [Mojang Studios](#user-content-fn-10)[^10] ki lok me dong ma pe tye kwede ki iye moko. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA ki kwede, `eula=false` me cwalo ki `eula=true` ki i kom ma cwalo. + +*** + +## 6. Lok me yom dok ma cwalo (Windows) + +Lok ma tye, lok me yom me cwiny me cwalo, **kare me cwalo** pe **router** ki tye kwede ki dong kwede. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Router ki UPnP pe tye kwede, router ki yom ma pe tye, ngolo ma cwalo ki kwede. + +Tye, [Ngrok](https://ngrok.com/) ki tye kwede ki dong kwede, ki iye moko. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Polo me fowadi ki dong kwede ki tye kwede + +Lok me tye kare ma cwalo ki dong kwede ki tye kwede, ki iye moko. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Maco cwalo ki tye `Keto` ma pe tye, `Keto` me fowadi ki tye kwede ki tye kwede ki iye moko. + +### 6.2 Server ki yom + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Server ki yom ma fowadi ki dong kwede ki tye kwede ki dong kwede. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Kadi kwede, server me cwalo ki dong kwede, Plazma ki yom me fowadi ki dong kwede. + +Iyi ni dok ma pe tye, UPnP mukene pe i kom iye moko, i kom iye moko, i kom iye moko, i kom iye moko, i kom iye moko. + +| Dok ma pe tye | Kwo mukene | +| ------------------------------- | ----------------------------------------------------------- | +| `Lok ma tye kare (kare)` | Kare me fowadi mukene. | +| `Kare (kare) ki tye kwo mukene` | Doki me server ki tye ki dong kwede mukene. | +| `Lok ma tye kare (kare)` | Kare me fowadi mukene. | +| `Doki ma pe tye kare` | Router ki UPnP pe tye kwede. | + +Server ki tye, Plazma ki yom ma fowadi ki tye kwede. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok homepage](https://ngrok.com/download) ki download `Windows (64-bit)` ZIP kwede. +2. Doki me download ki Ngrok ki server folder. +3. [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) ki tye ki [yom me dong](#user-content-fn-13)[^13]. +4. Server folder ki doki me tye kare me dong ki dok ma cwalo. +5. Doki ma tye kwede ki dong kwede, `start /b ngrok tcp --region jp 25565` ma cwalo ki dong kwede, `taskkill /f /t /im ngrok.exe` ki yom ma pe tye. +6. Kare ma pe tye ki dong kwede kwo mukene, `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` ma cwalo ki dong kwede. +7. Iyi ni doki me i kom dong kwede ki tye kwede. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Kikwero, dok pa cwinyo ma cwinyo, + +```log +Windows IP gang + +Ethernet Adapter Ethernet: + + DNS suffix kun kikwero. . . . : + IPv4 Address. . . . . . . . : 192.168.3.7 + Subnet Mask . . . . . . . : 255.255.255.0 + Default Gateway . . . . . . : 192.168.3.1 + +``` + +Kikwero ma '192.168.3.7' ma kikwero, kikwero me server, cwiny pa 'localhost' ma kikwero. + +Server me game pa PC mamegi, 'localhost' ma kikwero. +{% endtab %} +{% endtabs %} + +## 7. Keto kwede + +Server ki kwo kikwero, ki kwo kikwero me server ki dano. + +Kwo ikit ma pe waco server. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma ki kwo Paper ki kwo Spigot, ki kwo Spigot ki kwo server platform ki kwo. + +[^3]: Windows key + R + +[^4]: Linux ma cwinyo 'java --version' pa terminal + +[^5]: JRE ni open source project mo, Minecraft server platform ki dong ma kwo. + +[^6]: Kwede **dong ma kwo** ma kwo. + +[^7]: Kwede 'Auto-restart' ki kwo server ki kwo kikwero. Cwalo 'Control + C' ki tye. + +[^8]: Dyang ma en aye kikwero ki kwo pe i temo. + + Kikwero, dyang ma en aye memory capacity ki 8GB, 4GB ma kwo pe i temo. + +[^9]: End-User License Agreement, Lok me kwo kikwero ki temo. Gin ma giketo ki [Minecraft lok ma en](https://www.minecraft.net/ko-kr/usage-guidelines) kacel iweko. + +[^10]: Microsoft Corporation. + +[^11]: Pa Uganda ma gin ma en i kit ma kwo tic ki lanyo me lawang i kano 32 me 1 me 9, **Korea Microsoft Corporation** ma en i kwo tic ki. + +[^12]: Universal Plug & Play. Plazma ma Purpur kicel i ngom miyo ma Purpur ki tye ka kompyuta me router kicel i ngom, ki tye ka server ki gengo ma kicel ki nyutu woko dong i port, ki tye ka port forwarding ma en odok i kompyuta. + +[^13]: En aco ni dong i Ngrok, i kompyuta ma en aco ni Google to GitHub, i Ngrok ki cok ma en aco. diff --git a/ach/origin/plazma/administration/getting-started/customization.md b/ach/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..44bfa783e --- /dev/null +++ b/ach/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,126 @@ +--- +description: Kube me nino ma kwo iye i kompyuta. +--- + +# 🎨 I kompyuta + +Gin Mojang Studios kicel i kwo kicel kwede kwede ki kompyuta +Plazma ma en aye i kwo kicel kwede kwede ki kompyuta, gin ma giketo +**gangi** pe romo kicel kwede ki kwede i kompyuta. + +Makwongo i Plazma ma en aye kicel ki kwo i kwo iye iye iye iye. + +## Lok ada Plazma + +Plazma ma en aye kicel ki kwo i kwo iye iye iye iye ki gangi, gin ma kicel kwede ki kicel kwede i kompyuta. + +Plazma kicel kwede ki kwede iye kwede ki kompyuta, i kompyuta ma en aye +mechanism ma en aye, mob ma en aye, gangi ma en aye kicel kwede i kompyuta. + +Kicel kwede ki Plazma ki kwo iye iye iye iye ki kwo iye iye iye iye. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Lok ada plugin Plazma + +{% hint style="success" %} + +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, +Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 +모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. +Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 +공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 +사이트에 업로드하기도 합니다. + +{% hint style="caution" %} + +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, +신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. + +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 + 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, + `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. + 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. + `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. + 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, +[리소스팩](#user-content-fn-1)[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="caution" %} + +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. + +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. +폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} + +**일부 [데이터팩](#user-content-fn-2)[^2]의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. + +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, +서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} + +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md) + +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. diff --git a/ach/origin/plazma/administration/getting-started/next-step.md b/ach/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..5ff245bc0 --- /dev/null +++ b/ach/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,170 @@ +--- +description: Kube me nino ma kwo iye i kompyuta. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Makwongo i Plazma ma en aye kicel ki kwo i kwo iye iye iye iye. + +## Lok ada Plazma + +Plazma ma en aye kicel ki kwo i kwo iye iye iye iye ki gangi, gin ma kicel kwede ki kicel kwede i kompyuta. + +Plazma kicel kwede ki kwede iye kwede ki kompyuta, i kompyuta ma en aye +mechanism ma en aye, mob ma en aye, gangi ma en aye kicel kwede i kompyuta. + +Kicel kwede ki Plazma ki kwo iye iye iye iye ki kwo iye iye iye iye. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Lok ada plugin Plazma + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. 폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +## 최적화 + +Plazma에는 많은 최적화 패치가 적용되어 있습니다. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 프록시 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +안전하고 올바른 프록시 설정에 대한 정보는 아래 페이지를 참고하세요. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 안전 + +Minecraft는 모드가 발달하여 온라인에서도 쉽게 [취약점 공격 엔진](#user-content-fn-3)[^3]을 구할 수 있습니다. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 권한 설정 + +일부 플러그인의 관리자 명령어는 권한이 제대로 설정되지 않은 취약점이 존재하기도 합니다. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray 차단 + +X-Ray는 기본적인 최적화 클라이언트에서도 쉽게 사용 가능한 취약점 중 하나입니다. + +Plazma에는 X-Ray를 기본적으로 차단할 수 있는 구성을 제공하고 있습니다. + +X-Ray 차단 방법과 설명은 아래 페이지를 참고하시기 바랍니다. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 화이트리스트 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +접속이 허용된 플레이어를 보려면 `/whitelist query` 를 사용합니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. + +[^3]: 일반적으로 "핵" 으로 불립니다. + +[^4]: 구성이 최적화되지 않았거나, Plazma가 오래되었거나, 새로 발견된 취약점의 경우 차단되어 있지 않을 수 있습니다. + +[^5]: 플레이어가 서버에 접속할 때 Ngrok 프록시 서버를 통해 접속되며, 매 재시작마다 발급되는 Ngrok 주소는 달라집니다. diff --git a/ach/origin/plazma/administration/reference/README.md b/ach/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..9b6624da5 --- /dev/null +++ b/ach/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Kolot me Plazma ki dong pe romo ki iye i pwonyo. +--- + +# 📜 리퍼런스 + +Plazma ki dong pe obedo i pwonyo me i pwonyo. + +Dong me, i cwalo 4 me i pwonyo ducu ki dong pe romo ki iye i pwonyo. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Acholi translation not available] +{% endhint %} + +*** + +## 🖥️ Lub me + +> Lub me dong ma kwo i pwonyo me i pwonyo ki i pwonyo dong pe romo ki iye i pwonyo. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Kwanyo + +> Kwanyo ma kwo i pwonyo ki i pwonyo dong pe kwo iye i pwonyo. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Ngec ma Kicwalo + +> Ngec ma kicwalo ki Plazma ki dong pe kwo i pwonyo ma kwo i pwonyo. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Cwalo + +> Cwalo ki Plazma ki dong pe romo ki iye i pwonyo ma kwo i pwonyo. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ach/origin/plazma/administration/reference/arguments.md b/ach/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..fe3d40183 --- /dev/null +++ b/ach/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +Gin ma pwonyo me kicel i kare kwo Plazma me [lanyo kwede](#user-content-fn-1)[^1] ma kicel, Plazma ma lubo gin ma kicwalo i kare ki pwonyo. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **Cik mat**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Cik mat**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **Cik mat**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **Cik mat**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **Cik mat**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **Cik mat**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` +- **Gwok kom**: `Plazma.disableConfigOptimization` + +Lok ada mukato man rom kwede kwede odoco. + +Kombedi yom cwinyo ni rom kombedo, me gin ma tye itye ki bino ma to wek iye i jami + +#### `Plazma.disableConfigOptimization` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` +- **Gwok kom**: `Plazma.aggressiveOptimize` + +Lok ada mukato ma gimukato man rom. + +En odok tyen Paper ma Kwacio bwoni. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` + +Kwacena Plazma ki ngec calo cing i ma yo ki Favicon ma Kwacio + +#### `Plazma.useVanillaConfiguration` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` +- **Gwok kom**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Gin ma to wegi calo i jami me tito ki calo i cwinyo me cano. + +Gin ma ki l. Tito ki mar nec Pi ki kwo en onyo. +{% endhint %} + +Lok ada mukato ma Mojang kombedo ma kwacio ma Kwacio. + +En odok tyen Paper ma tye kicung i maraco atayo. + +Maraco atayo kwede ki Paper waco ki Plazma, bero kwede weko calo. + +#### `Plazma.vanillaize` + +- **Cik mat**: `Boolean` +- **Kwena mukato**: `kweli` +- **Gwok kom**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Lok ada mukato kombedi calo yi Kwacio ki kuny me odoco. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` +- **Kicel ma kicel**: Timings ki Plazma ki ngec pe i tye ka cok + +Gin ma Aikar Timings API ki i yam mek ikom ki Plazma + +Keto kwede API ki i yam mek icwek i ngec pe tye ka cok, onongo kwanyo kwede ki lanyik + +*** + +## Dwog ma en aye + +Dwog ma en aye `-jar *.jar` ki ngec pe i tye ka cok, Plazma ki tye ka ngec me kenyo i kom + +### Lok ma en aye + +Dwog ma en aye `-jar *.jar` ki ngec pe i tye ka cok, ngom ma program ki tye ka ngec me kenyo i kom + +Pi mara, `nogui` dwog ma en aye ki cok,\ +ka i kom Plazma ki tye ka ngec me kenyo i kom `nogui` dwog ma en aye ki cok + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Dwog ma en aye pe + +#### `bukkit-settings` + +- **Lok pa dano**: `b` +- **Kit ma en aye**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Lok pa dano**: `c` +- **Kit ma en aye**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Lok pa dano**: `c` +- **Kit ma en aye**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Dwog ma en aye kulu ki gengo me server + +#### `eraseCache` + +Dwog ma en aye kacel ki kare ma kacel mukene + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Lok pa dano**: `?` + +Lok ma en aye pe kulu ki gengo me dwog ma en aye + +#### `initSettings` + +Dwog ma en aye ki gengo me kicel ma kicel kacel ki lobo + +#### `jfrProfile` + +JFR profiling ki gengo me cok + +#### `max-players` + +- **Lok pa dano**: `s`, `size` +- **Kit ma en aye**: `(dano me server)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Dwog ma en aye ki gengo me lok pa maleng + +#### `nojline` + +JLine ki gengo me lok pa maleng i yam mek mukene + +#### `online-mode` + +- **Lok pa dano**: `o` +- **Kit ma en aye**: `(dano me server)` + +Kicel ki yam mek Mojang authentication server tye ka cok + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Lok pa dano**: `paper` +- **Kit ma en aye**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Kicel ma kicel me PaperSpigot dano ki tye ka cok + +Kicel ma kicel me lok pa dano ma Plazma + +#### `paper-settings-directory` + +- **Lok pa dano**: `paper-dir` +- **Kit ma en aye**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Lok pa dano**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Lok pa dano**: `p` +- **Kit ma en aye**: `plugins` + +Lok ma nying me dano ki tye ka cok + +#### `pufferfish-settings` + +- **Lok pa dano**: `pufferfish` +- **Kit ma en aye**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Lok pa dano**: `purpur` +- **Kit ma en aye**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(Lok pa kicel) Kicel ma kicel me dok kwac me server + +#### `server-ip` + +- **Lok pa dano**: `h`, `host` +- **Kit ma en aye**: `(dano me server)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Lok pa dano**: `p`, `port` +- **Kit ma en aye**: `(dano me server)` + +Lok ma nying me port ki tye ka cok ki kicel + +#### `server-name` + +- **Kit ma en aye**: `A Plazma Server` + +Lok ma nying me ngom ki tye ka cok ki kicel + +#### `spigot-settings` + +- **Lok pa dano**: `S` +- **Kit ma en aye**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Lok pa dano**: `v` + +Plazma dong ki tye ka cok + +#### `world-dir` + +- **Lok pa dano**: `W`, `universe`, `world-container` +- **Kit ma en aye**: `(doki me server)` + +Lok ma nying me doki ki tye ka cok ki kicel + +#### `world-name` + +- **Lok pa dano**: `w`, `world` +- **Kit ma en aye**: `(dano me server)` + +Dwog ma en aye ki gengo me doki + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Keto kwede i kom ma en aye ki gengo me doki ki tye ka cok + +[^3]: Pi mara, `Plazma.iKnowWhatIAmDoing` ki yam mek `true` ki dong i kom, `-DPlazma.iKnowWhatIAmDoing=true` ki tye ka cok ngene `-DPlazma.iKnowWhatIAmDoing` ki tye ka cok + +[^4]: Pi mara, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Kit ma en acoya. + +[^6]: Kit ma en acoya. + +[^7]: Kiliyenti. + +[^8]: Lok me bedo ki server ma tye ka romo itwero woko. + +[^9]: Gin ma Purpur AFK kwanyo kede ki dong pe itye ka kwo kwanyo player. + +[^10]: Sync Chunk Write System, Lok me gengo chunk me sync. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: 게임에서 `월드 최적화` 도 이와 같은 원리로 동작합니다. + +[^13]: `레벨 2` 이상의 관리자는 제외합니다. + +[^14]: Internet Protocol, IP. diff --git a/ach/origin/plazma/administration/reference/commands.md b/ach/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..50464793b --- /dev/null +++ b/ach/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Cwinya i Plazma ki tek ma kicayo iye. +--- + +# 🖥️ Cwinya diff --git a/ach/origin/plazma/administration/reference/configurations/README.md b/ach/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..8c1da1d5d --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Cwalo ki Plazma ki dong pe romo ki iye i pwonyo ma kwo i pwonyo. +--- + +# 🧾 구성 + +*** + +## 🪨 Lubanga + +> Lubanga ni Minecraft ki dong kwede kwede me kit ma pe romo kubed i file me gwok. Lubanga ki dong kwede kwede me gitic kwede me game. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Lubanga + +> Bukkit Lubanga ni Plazma ki dong kwede kwede me kit ma pe romo kubed i file me gwok. Bukkit Lubanga ki dong kwede kwede me gitic kwede me Minecraft server. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Lubanga + +> Spigot Lubanga ni dong kwede me game, kic pa lwak, kwanyo, tye ki kwo me kwo me gitic pa kwo iye. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Lubanga + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish Lubanga ni dong kwede me Plazma ki mukene pa ente. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Lubanga + +> Purpur Lubanga ni dong kwede me game ki mukene pa deta. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Lubanga + +> Plazma Lubanga ni dong kwede me Plazma ki mukene pa itwero. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ach/origin/plazma/administration/reference/configurations/bukkit.md b/ach/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0813f8ada --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Kwo koni kare ma bukkit.yml me tier pa node mamegi? +--- + +# 🪣 Bukkit diff --git a/ach/origin/plazma/administration/reference/configurations/paper/README.md b/ach/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..ff0ccdeb6 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Lok ma kiketo ki folder config ma yoo i yom cwinyeno. +--- + +# 🛩️ Paper diff --git a/ach/origin/plazma/administration/reference/configurations/paper/global.md b/ach/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..b8c34563d --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Tyeke i paper-global.yml kiketo ki ni ki bot lanyo. +--- + +# 🌏 전역 구성 diff --git a/ach/origin/plazma/administration/reference/configurations/paper/world.md b/ach/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..129f62bdc --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Papil (paper-world.yml tye kiketo gang mito ada mako kede i kom. +--- + +# 🏳️ 세계별 구성 + +Dunia diff --git a/ach/origin/plazma/administration/reference/configurations/plazma/README.md b/ach/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e32f333d7 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Lok ma kiketo ki folder config ma yoo i yom cwinyeno. +--- + +# ✨ Plazma diff --git a/ach/origin/plazma/administration/reference/configurations/plazma/global.md b/ach/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..d2edaeca4 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/ach/origin/plazma/administration/reference/configurations/plazma/world.md b/ach/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..833845b94 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/ach/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ach/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/ach/origin/plazma/administration/reference/configurations/property.md b/ach/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..ee8f5dead --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Kube server.properties ma kwo ada ada i kom. +--- + +# 🪨 Server.properties diff --git a/ach/origin/plazma/administration/reference/configurations/pufferfish.md b/ach/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..c20dfa587 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Dokot pa pufferfish.yml ma en odoko pe iye ni en aye i pwony. +--- + +# 🐡 Pufferfish diff --git a/ach/origin/plazma/administration/reference/configurations/purpur/README.md b/ach/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..1b3a95d52 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml pa lub node mapecek kwede onino kicoyo. +--- + +# 🦑 Purpur diff --git a/ach/origin/plazma/administration/reference/configurations/purpur/global.md b/ach/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..e40333a12 --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml pa lub node mapecek kwede onino kicoyo. +--- + +# 🌏 전역 구성 diff --git a/ach/origin/plazma/administration/reference/configurations/purpur/world.md b/ach/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..2c74a307f --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml pa lub node mapecek kwede onino kicoyo. +--- + +# 🏳️ 세계별 구성 diff --git a/ach/origin/plazma/administration/reference/configurations/spigot.md b/ach/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..2734af39c --- /dev/null +++ b/ach/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Tye kacel spigot.yml ma gicel ki i loke dano. +--- + +# 🚰 Spigot diff --git a/ach/origin/plazma/administration/reference/permissions.md b/ach/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..01010737b --- /dev/null +++ b/ach/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Monyo me Plazma ki nyingi. +--- + +# 🛡️ Nyingi + +Lok ma kwo ne pi server, pe olal ki player dong i kwo tic mukene iye kwede i pwonye kwede. + +Lok ma kwo ne pi kwede, kicoyo kicoyo ka [LuckPerms](https://luckperms.net) ki dong i kwo tic. + +*** + +## Kwede iye kwede Acelo + +Minecraft ma kwo ne pi kwede iye kwede ma pwonye i kwo tic. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Player**\ + Kicoyo pa player me cok i kwo tic. +2. **Mediator**\ + Kicoyo pa kwo di gang me opwonyo. +3. **Lok me iye**\ + Kicoyo pa iye me kwo tic ma iye me [command block](configurations/property.md) ki dong i kwo tic.\ + Kicoyo pa data pack ma command block iye kwede me kwede i kwo tic. +4. **Admin**\ + Kicoyo pa player me cok ma iye me [command](configurations/property.md) ki dong i kwo tic. +5. **Admin mukene**\ + Kicoyo pa lok me server ki dong i kwo tic ma iye me [command](configurations/property.md) ki dong i kwo tic.\ + Kicoyo pa console mukene opwonyo me kwo tic. + +*** + +## Kwo tic iye kwede + +*** + +## Kwede iye kwede + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Lok me iye**: `pek` + +Player mukene i entiti me `kwo coko` ki dong ma i entiti me kwo tic me iye me kwo tic. + +Entiti me kwo coko, player mukene `kwo kwo` ki entiti me kwo coko ma, `kwo jump` ki dong ma iye kwo tic. + +`(Namespaced Key)` ma entiti me [Namespaced ID](#user-content-fn-2)[^2] ki waco. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Lok me iye**: `pek` + +Player mukene entiti me kwo coko, entiti me kwo tic me kwo tic ki dong i kwo tic. + +Entiti me kwo coko mape kwo tic ki dong. Kwede iye kwede entiti me kwo tic ki gengo i kom. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) wacel [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions) ki dong i kwo tic! +{% endhint %} + +
+ +Cel ma iye i kwo tic ki gengo + +- **`crepper`**\ + `kwo jump` ki dong ma kwo coko.\ + Player mukene `allow.powered.creeper` kwede i kwo tic, `kwo jump` ki dong ma kwo tic. +- **`dolphin`**\ + `kwo jump` ki dong ma kwo coko. +- **`phantom`**\ + `kwo jump` ki dong ma kwo coko. +- **`wither`**\ + `kwo coko` ma wither head ki dong ma kwo coko. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Lok me iye**: `Lok me iye mukene` + +[`/compass` command](commands.md#compass) ki dong i kwo tic. + +#### `bukkit.command.credits` + +- **Lok me iye**: `Lok me iye mukene` + +[`/credits (Player)` command](commands.md#credits) ki dong i kwo tic. + +Kwede iye kwede `.other` wacel pe kwo tic iye kwede player mukene ki dong i kwo tic. + +#### `bukkit.command.demo` + +- **Lok me iye**: `Lok me iye mukene` + +[`/demo (Player)` command](commands.md#demo) ki dong i kwo tic. + +Kwede iye kwede `.other` wacel pe kwo tic iye kwede player mukene ki dong i kwo tic. + +#### `bukkit.command.ping` + +- **Lok me iye**: `Lok me iye mukene` + +[`/ping (Player)` command](commands.md#ping) ki dong i kwo tic. + +Kwede iye kwede `.other` wacel pe kwo tic iye kwede player mukene ki dong i kwo tic. + +#### `bukkit.command.ram` + +- **Lok me iye**: `Lok me iye mukene` + +[`/ram` command](commands.md#ram) ki dong i kwo tic. + +#### `bukkit.command.rambar` + +- **Lok me iye**: `Lok me iye mukene` + +[`/rambar (Player)` command](commands.md#rambar) ki dong i kwo tic. + +Kwede iye kwede `.other` wacel pe kwo tic iye kwede player mukene ki dong i kwo tic. + +#### `bukkit.command.restart` + +- **Lok me iye**: `Lok me iye mukene` + +[`/restart` command](commands.md#restart) ki dong i kwo tic. + +#### `bukkit.command.tps` + +- **Lok me iye**: `Lok me iye mukene` + +[`/tps` command](commands.md#tps) ki dong i kwo tic. + +#### `bukkit.command.tpsbar` + +- **Lok me iye**: `Lok me iye mukene` + +[`/tpsbar (Player)` command](commands.md#tpsbar) ki dong i kwo tic. + +Kwede iye kwede `.other` wacel pe kwo tic iye kwede player mukene ki dong i kwo tic. + +#### `bukkit.command.timings` + +- **Lok me iye**: `Lok me iye mukene` + +[`/timings` command](commands.md#timings) ki dong i kwo tic. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Kwede iye ki dong ma kwo tic ki gengo, wacel [Spark](https://spark.lucko.me/docs/Command-Usage) ki dong i kwo tic. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Lok me iye**: `Lok me iye mukene` + +[`/uptime` command](commands.md#uptime) ki dong i kwo tic. + +#### `minecraft.command.gamemode.(GameMode)` + +- **Lok me iye**: `Lok me iye mukene` + +`/gamemode (GameMode) (Player)` command ki dong i kwo tic. + +Kwede iye kwede `.other` wacel pe kwo tic iye kwede player mukene ki dong i kwo tic. + +#### `paper.antixray.bypass` + +- **Lok me iye**: `pek` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Kwo tic ma iye me kwo tic iye kwede i kwo tic. + +> X-Ray kwede iye ki dong ma iye mukene, wacel i kom pek ki dong i kwo tic. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Lok me iye**: `pek` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Lok me iye**: `pek` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Lok me iye**: `pek` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Lok me iye**: `pek` + +Moru ma [MiniMessage tag](https://docs.advntr.dev/minimessage/format.html) ki mukene. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Lok me iye**: `pek` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Lok me iye**: `pek` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Lok me iye**: `pek` + +Player mukene kwo tic ki dong i kwo tic. + +#### `purpur.debug.f3n` + +- **Lok me iye**: `Lok me iye mukene` + +Player mukene `F3 + N` key ki dong ma kwo tic. + +Kwo tic mukene kwede iye ki dong ma kwo tic. + +#### `purpur.drop.spawners` + +- **Lok me iye**: `pek` + +Gengo wacel waco item ma iye kwo coko, item ma iye kwo tic ki dong i kwo tic. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Lok me iye**: `pek` + +Ender chest me cok iye kwo tic ki dong. + +`(NumberString)` wacel `one`, `two`, `three`, `four`, `five`, `six` ki waco. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Lok me iye**: `pek` + +Totem me kwo tic ma iye me kwo tic ki dong i kwo tic. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Lok me iye**: `pek` + +Kica me kwanyo kwede kacel ma kicel i kare ma en aye. + +#### `purpur.mending_shift_click` + +- **Lok me iye**: `pek` + +Kica me kwanyo kwede 'kwo cwek i cwek' ki kare ma en aye i kare ma en aye. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Lok me iye**: `pek` + +Kica me kwanyo kwede kwo gengo ma kwo i kare ma en aye. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Lok me iye**: `pek` + +Kica me kwanyo kwede kwo nedi Nether ma kwede kwo kwede i kwede. + +#### `purpur.sign.color` + +- **Lok me iye**: `pek` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Lok me iye**: `pek` + +표지판에 난독화 코드`(&o)`를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Lok me iye**: `pek` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Lok me iye**: `pek` + +플레이어가 가위로 `상호 작용`하여 TNT 폭발을 막을 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### 제공 예정 권한 + +#### `plazma.bypass.ncr-require` + +- **Lok me iye**: `pek` + +플레이어가 [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) 모드가 설치되어 있지 않아도 접속할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: 예: `ender_dragon` diff --git a/ach/origin/plazma/adminstration/README.md b/ach/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..ada7b456d --- /dev/null +++ b/ach/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Cwinywa ki woko ki Plazma ki kwo tic me server mukene. +--- + +# ⚒️ Dokot pa Server diff --git a/ach/origin/plazma/adminstration/expert/README.md b/ach/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..0a95e39a8 --- /dev/null +++ b/ach/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Cing ma Plazma ki yom cwiny pi romo ada i ma i kare ma en aye. +--- + +# 🎓 Kwo i cwiny diff --git a/ach/origin/plazma/adminstration/expert/fix-exploits.md b/ach/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..4197ea084 --- /dev/null +++ b/ach/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Monyo i loko i kom i lobo me cwiny me kwanyo ki iye. +--- + +# ⚠️ Monyo i loko i kom i lobo me cwiny me kwanyo ki iye diff --git a/ach/origin/plazma/adminstration/expert/optimize.md b/ach/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..a6c53a00a --- /dev/null +++ b/ach/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Cwinyo Plazma ki dogi maber. +--- + +# 🧹 Cwinyo diff --git a/ach/origin/plazma/adminstration/expert/vanillaize.md b/ach/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..0e420a038 --- /dev/null +++ b/ach/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Kwo kwo i Paper me vanilla pa kwo cwinywa iye. +--- + +# ↩️ Kwanyo vanilla + +{% hint style="warning" %} + +### Paper ma gengo cwinywa iye me patch manyenyo ma vanilla tye ki i kom. + +Plazma me cwinywa iye kwo iye patch manyenyo ma vanilla tye ki i kom. + +Ento iyi guide tye ki i kom, kadi itye ka i kom i ma gengo kwedeo ki iye. +{% endhint %} diff --git a/ach/origin/plazma/adminstration/faq.md b/ach/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..685fad80c --- /dev/null +++ b/ach/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Kicwoko ki kicwinyo ni kicwinyo ki cungu. +--- + +# ⁉️ Kicwoko ki kicwinyo + +{% hint style="info" %} + +### Pe romo kwo cako ma iye? + +[Cwiny me Discord mekit me](https://discord.gg/MmfC52K8A8) dokumenti me [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) ki tye ki kwo mekerani ma cwinywa i cwinywa! +{% endhint %} + +### Lok ma inongo i kompyuta pe kicwinyo. + +Consolet `no main manifest attribute, in plazma-(version).jar` gine ki kicwinyo,\ +Fail me donyo ni API me bedo, GitHub pe **Reobf Paperweight** kicoyo. + +Kicwinyo ni kicwinyo ki iye ma kicwoko ki i wiya. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Server pe kicwinyo ki iye ma kicwoko ki kicwinyo ki cungu. + +Plazma pe i cungu ma iye, kiketo ki cungu ki iye, dong i wiya i kompyuta pe kicwinyo ki iye ma kicwoko ki kicwinyo ki cungu. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Kicwinyo ki iye me [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] gine ki kwano i kompyuta. + +Kicwinyo ni kicwinyo ki iye ma kicwoko ki i wiya. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1 pe i wiya diff --git a/ach/origin/plazma/adminstration/getting-started/README.md b/ach/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..51179010b --- /dev/null +++ b/ach/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Kwon ma Plazma ki yoo kare ma server iye ki kwanyo. +--- + +# 👟 Cing i + +Kwon ma Plazma ki tye kwede ngom me cwinywa, kadi sistema ki dong i kom bedo ma i kom. + +| | Tye kwede | Tye kwede iye | +| :-------------: | --------: | ------------: | +| Akitekci | x64 | - | +| RAM | 8GB | 16GB | +| Dano me cwinywa | 1GB | 8GB | +| JRE | 17 | 21 | + +Icwinywa me kwo koni i kit ma pe ngom, [Visual Studio Code](https://code.visualstudio.com/download) me iye ma kwo yee kwanyo woko iye. + +*** + +## 1. JRE ki tye kwede + +Dano i kom bedo, Minecraft: **"Java"** Edition pe tye kwede me Java, kadi iye JRE[^1] ki dong i pe ki tye kwede. + +Plazma ni ki Mojang Studios ki [bedo ma pe iye](#user-content-fn-2)[^2], Plazma ki tye kwede ki JRE tye kwede. + +### 1.1 JRE ki gitye iye + +JRE ki dong i pe ki tye kwede, [kwanyo pe iye](#user-content-fn-3)[^3] ki gin [`cmd /k java --version`](#user-content-fn-4)[^4] ki tye kwede. + +Tye kwede iye kwede ki gitye [2 ngom](setup.md#id-2) woko. + +{% code title="Dano me cwinywa" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Kwon ma pe ki tye kwede, kadi ma iye kwanyo pe ki tye kwede, tye kwede iye, kadi [1.2 ngom](setup.md#id-1.2) ki tye kwede. + +{% code title="JRE ki pe tye kwede" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE ki tye kwede" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE moko + +Kwon gang ma JRE [miyo ni](#user-content-fn-5)[^5] Azul Zulu ki tye kwede. + +Kwede ki tye, [1.1 dong](setup.md#id-1.1) kadi kwede ki tye kwede i kom put me kwede ni iye moko. + +{% tabs %} +{% tab title="Windows" %} + +1. Ka ki tye kwede ki JRE **JDK 21** me `.msi` kwede ma [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) ki download. +2. Jokkwa kwede ma gin ma, `Doki` ki cwalo. +3. **Lok me cwalo, `Set JAVA_HOME variable` ki gengo ngolo,** `Doki` ki cwalo. +4. Ki cwalo ki tye kwede JRE ki tye ki `kwede` ki tye kwede. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) ki download **JDK 21** ma `.dmg` kwede me tye JRE ki tye. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Ka ki tye, calo kom me tye ki terminal ki gengo Azul Zulu repository me doki. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Kadi kwede, calo kom me tye ki terminal ki gengo JRE ki tye kwede. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Calo kom me tye ki terminal ki gengo JRE ki tye kwede. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma ki download + +Plazma ki nyutu ma kwo poto me doki me tye kwede. + +{% hint style="warning" %} + +### Maco doki `Reobf Paperclip` ki gengo. + +Kwo iyi kacel ma onongo ki iyi, [3 dong](setup.md#id-3) ki tye kwede ki tye kwede ki iye moko. +{% endhint %} + +
+ +Yom me kwo + +Poto me doki me kwede iyi `plazma-(kare me bedo)-1.20.4-R0.1-SNAPSHOT-(maping kacel).jar` ma onongo. + +- **Maping kacel**\ + Maping iyi ni Minecraft ma kwo doki me cwiny me lukalala ki dong kwede. + - **Reobf**\ + Reobfuscation, Spigot maping ma kwo doki ma ngec ki dong kwede.\ + 1.20.5 woko i kom mukene. + - **Mojmap**\ + Mojang maping, Minecraft maping iyi. +- **Kare me bedo**\ + Kare me bedo ni doki me cwiny me server ki doki me lukalala ki dong kwede. + - **Paperclip**\ + PaperMC timo ki yom Paper mukene ki dong kwede, kare me bedo ni kwo download ma kwo cwalo me server. + - **Bundler**\ + Minecraft kare me bedo ki dong kwede. + +
+ +*** + +## 3. Lok ma cwalo ki gengo + +Plazma ki yom ma kwo, server ki cwalo me cwiny ma kwo, [lok ma cwalo ki gengo](#user-content-fn-6)[^6] ki tye kwede. + +[Flags.sh](https://flags.sh) ki tye kwede ki [yom ma kwo](#user-content-fn-7)[^7]\ +Plazma ma [tito me memory](#user-content-fn-8)[^8] i kom kom iye kwo mukene iyi mukene. + +Lok me tye kare dongo download ki gengo lok ma cwalo ki gengo.\ +**Dongo download ki gengo tye kwede kare ma i kom yom me kare me bedo pe JRE ki tye kwede.** + +*** + +## 4. Failo ki yom + +Iyi dongo download ki gengo me Plazma ki weko i kom kwede ki tye ki tye kwede. + +{% hint style="warning" %} + +### Dongo me kwede tye i kom ma pe tye, calo ma cwalo ki gengo. + +Bet ma Plazma pe JRE ki tye kwede ma pe tye, ki iye moko. +{% endhint %} + +Iyi dongo download ki gengo me cwalo ki gengo. Windows tye, Lok ma cwalo ki gengo ki tye, kare **lok ma cwalo** ki tye ki iye moko. + +*** + +## 5. EULA dok ma cwalo + +Lok ma cwalo ki gengo, folder ki `eula.txt` ki tye kwede. + +EULA[^9] ni [Mojang Studios](#user-content-fn-10)[^10] ki lok me dong ma pe tye kwede ki iye moko. + +EULA ki tye kwede, server ki tye ki tye kwede. EULA ki yom me dong ma pe tye kwede, EULA ki kwede mukene pe i kom iye moko [tito me dong](#user-content-fn-11)[^11]. + +EULA ki kwede, `eula=false` me cwalo ki `eula=true` ki i kom ma cwalo. + +*** + +## 6. Lok me yom dok ma cwalo (Windows) + +Lok ma tye, lok me yom me cwiny me cwalo, **kare me cwalo** pe **router** ki tye kwede ki dong kwede. + +Windows tye, kare me cwalo ki [3 dong](setup.md#id-3) ki tye kwede, polo me fowadi ki tye kwede. + +{% hint style="info" %} + +### Iyi kwede ma Windows kare me cwalo pe [**UPnP**](#user-content-fn-12)[^12] ki tye kwede ki dong kwede. + +Router ki UPnP pe tye kwede, router ki yom ma pe tye, ngolo ma cwalo ki kwede. + +Tye, [Ngrok](https://ngrok.com/) ki tye kwede ki dong kwede, ki iye moko. +{% endhint %} + +{% hint style="warning" %} + +### Linux woko macOS i kom (jun) UNIX pe, kare me cwalo ki dong kwede, router service ki yom me dong ma pe tye, ngolo ma cwalo ki kwede. + +{% endhint %} + +### 6.1 Polo me fowadi ki dong kwede ki tye kwede + +Lok me tye kare ma cwalo ki dong kwede ki tye kwede, ki iye moko. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Maco cwalo ki tye `Keto` ma pe tye, `Keto` me fowadi ki tye kwede ki tye kwede ki iye moko. + +### 6.2 Server ki yom + +{% tabs %} +{% tab title="Yom ma fowadi" %} +Polo me fowadi ki tye ki dong kwede, ki iye moko. + +Server ki yom ma fowadi ki dong kwede ki tye kwede ki dong kwede. +{% endtab %} + +{% tab title="UPnP me fowadi ki dong kwede" %} +Server folder ki `purpur.yml` ki tye, `network.upnp-port-forwarding` me cwalo `keto` ki dong kwede. + +Kadi kwede, server me cwalo ki dong kwede, Plazma ki yom me fowadi ki dong kwede. + +Iyi ni dok ma pe tye, UPnP mukene pe i kom iye moko, i kom iye moko, i kom iye moko, i kom iye moko, i kom iye moko. + +| Dok ma pe tye | Kwo mukene | +| ------------------------------- | ------------------------------------------- | +| `Lok ma tye kare (kare)` | Kare me fowadi mukene. | +| `Kare (kare) ki tye kwo mukene` | Doki me server ki tye ki dong kwede mukene. | +| `Lok ma tye kare (kare)` | Kare me fowadi mukene. | +| `Doki ma pe tye kare` | Router ki UPnP pe tye kwede. | + +Server ki tye, Plazma ki yom ma fowadi ki tye kwede. +{% endtab %} + +{% tab title="Ngrok me yom me doki ma cwalo" %} +Ngrok ki tye ki kwede ki dong kwede, kwede kwede kwede. + +1. [Ngrok homepage](https://ngrok.com/download) ki download `Windows (64-bit)` ZIP kwede. +2. Doki me download ki Ngrok ki server folder. +3. [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) ki tye ki [yom me dong](#user-content-fn-13)[^13]. +4. Server folder ki doki me tye kare me dong ki dok ma cwalo. +5. Doki ma tye kwede ki dong kwede, `start /b ngrok tcp --region jp 25565` ma cwalo ki dong kwede, `taskkill /f /t /im ngrok.exe` ki yom ma pe tye. +6. Kare ma pe tye ki dong kwede kwo mukene, `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` ma cwalo ki dong kwede. +7. Iyi ni doki me i kom dong kwede ki tye kwede. + {% endtab %} + +{% tab title="Local acel kikwero" %} +Local acel kikwero me server, cwiny pa 'cmd /k ipconfig' ki cwinyo ngec 'IPv4 address' ma kikwero. + +Kikwero, dok pa cwinyo ma cwinyo, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Kikwero ma '192.168.3.7' ma kikwero, kikwero me server, cwiny pa 'localhost' ma kikwero. + +Server me game pa PC mamegi, 'localhost' ma kikwero. +{% endtab %} +{% endtabs %} + +## 7. Lok ma itye + +Server ki kwo kikwero, ki kwo kikwero me server ki dano. + +Cwalo me Java Runtime Environment, Java Runtime. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java Runtime. + +[^2]: Plazma ki kwo Paper ki kwo Spigot, ki kwo Spigot ki kwo server platform ki kwo. + +[^3]: Windows key + R + +[^4]: Linux ma cwinyo 'java --version' pa terminal + +[^5]: JRE ni open source project mo, Minecraft server platform ki dong ma kwo. + +[^6]: Kwede **dong ma kwo** ma kwo. + +[^7]: Kwede 'Auto-restart' ki kwo server ki kwo kikwero. Cwalo 'Control + C' ki tye. + +[^8]: Dyang ma en aye kikwero ki kwo pe i temo. + + Kikwero, dyang ma en aye memory capacity ki 8GB, 4GB ma kwo pe i temo. + +[^9]: End-User License Agreement, Lok me kwo kikwero ki temo. Gin ma giketo ki [Minecraft lok ma en](https://www.minecraft.net/ko-kr/usage-guidelines) kacel iweko. + +[^10]: Microsoft Corporation. + +[^11]: Pa Uganda ma gin ma en i kit ma kwo tic ki lanyo me lawang i kano 32 me 1 me 9, **Korea Microsoft Corporation** ma en i kwo tic ki. + +[^12]: Universal Plug & Play. Plazma ma Purpur kicel i ngom miyo ma Purpur ki tye ka kompyuta me router kicel i ngom, ki tye ka server ki gengo ma kicel ki nyutu woko dong i port, ki tye ka port forwarding ma en odok i kompyuta. + +[^13]: En aco ni dong i Ngrok, i kompyuta ma en aco ni Google to GitHub, i Ngrok ki cok ma en aco. diff --git a/ach/origin/plazma/adminstration/getting-started/customization.md b/ach/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..573542055 --- /dev/null +++ b/ach/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Kube me nino ma kwo iye i kompyuta. +--- + +# 🎨 I kompyuta diff --git a/ach/origin/plazma/adminstration/reference/arguments.md b/ach/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..9650d6d23 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **Cik mat**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **Cik mat**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Cik mat**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **Cik mat**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **Cik mat**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **Cik mat**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **Cik mat**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `False` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` + +{% hint style="warning" %} + +### 해당 속성은 1.20.5 이후 시작 인수로 이동 될 예정입니다. + +{% endhint %} + +처음 시작시 적용되는 구성 최적화를 더 엄격하게 적용합니다. + +활성화 하면 서버가 더욱 빨라지고 안전해지지만, 일부 기믹을 차단하거나 게임 플레이에 큰 영향을 줄 수 있습니다. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **Cik mat**: `Boolean` +- **Kel ma kic**: `false` +- **Kicel ma kicel**: Timings ki Plazma ki ngec pe i tye ka cok + +Gin ma Aikar Timings API ki i yam mek ikom ki Plazma + +Keto kwede API ki i yam mek icwek i ngec pe tye ka cok, onongo kwanyo kwede ki lanyik + +*** + +## Dwog ma en aye + +Dwog ma en aye `-jar *.jar` ki ngec pe i tye ka cok, Plazma ki tye ka ngec me kenyo i kom + +### Lok ma en aye + +Dwog ma en aye `-jar *.jar` ki ngec pe i tye ka cok, ngom ma program ki tye ka ngec me kenyo i kom + +Pi mara, `nogui` dwog ma en aye ki cok,\ +ka i kom Plazma ki tye ka ngec me kenyo i kom `nogui` dwog ma en aye ki cok + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Dwog ma en aye pe + +#### `bukkit-settings` + +- **Lok pa dano**: `b` +- **Kit ma en aye**: `bukkit.yml` + +Lok ma nying [Dano me Bukkit](../reference/configurations/bukkit.md) ki tye ka cok + +#### `command-settings` + +- **Lok pa dano**: `c` +- **Kit ma en aye**: `commands.yml` + +Lok ma nying [Dano me Bukit Kwany](../reference/configurations/bukkit.md) ki tye ka cok + +#### `config` + +- **Lok pa dano**: `c` +- **Kit ma en aye**: `server.properties` + +Lok ma nying [Dano me Server](../reference/configurations/property.md) ki tye ka cok + +#### `demo` + +Dwog ma en aye kulu ki gengo me server + +#### `eraseCache` + +Dwog ma en aye kacel ki kare ma kacel mukene + +#### `forceUpgrade` + +Dwog ma en aye ki yam mek kwede mukene [Upgrde](#user-content-fn-12)[^12] + +#### `help` + +- **Lok pa dano**: `?` + +Lok ma en aye pe kulu ki gengo me dwog ma en aye + +#### `initSettings` + +Dwog ma en aye ki gengo me kicel ma kicel kacel ki lobo + +#### `jfrProfile` + +JFR profiling ki gengo me cok + +#### `max-players` + +- **Lok pa dano**: `s`, `size` +- **Kit ma en aye**: `(dano me server)` + +Kicel ma kicel me [Lacot](#user-content-fn-14)[^14] ki tye ka cok + +#### `nogui` + +Dwog ma en aye ki gengo me lok pa maleng + +#### `nojline` + +JLine ki gengo me lok pa maleng i yam mek mukene + +#### `online-mode` + +- **Lok pa dano**: `o` +- **Kit ma en aye**: `(dano me server)` + +Kicel ki yam mek Mojang authentication server tye ka cok + +**Kicel me Velocity dok Proksi ma kicel ma kicel [EULA](../getting-started/README.md#id-5) ki dogi ki tye ka cok.** + +#### `paper-settings` + +- **Lok pa dano**: `paper` +- **Kit ma en aye**: `paper.yml` + +{% hint style="warning" %} + +### Dwog ma en aye ki yam mek 1.19.4 i kom ki dogi + +{% endhint %} + +Kicel ma kicel me PaperSpigot dano ki tye ka cok + +Kicel ma kicel me lok pa dano ma Plazma + +#### `paper-settings-directory` + +- **Lok pa dano**: `paper-dir` +- **Kit ma en aye**: `config` + +Dano me [Paper](../reference/configurations/paper/README.md) ki tye ka cok ki kicel + +#### `plazma-settings-directory` + +- **Lok pa dano**: `plazma-dir` + +Dano me [Plazma](../reference/configurations/plazma/README.md) ki tye ka cok ki kicel + +#### `plugins` + +- **Lok pa dano**: `p` +- **Kit ma en aye**: `plugins` + +Lok ma nying me dano ki tye ka cok + +#### `pufferfish-settings` + +- **Lok pa dano**: `pufferfish` +- **Kit ma en aye**: `pufferfish.yml` + +Dano me [Pufferfish](../reference/configurations/pufferfish.md) ki tye ka cok ki kicel + +#### `purpur-settings` + +- **Lok pa dano**: `purpur` +- **Kit ma en aye**: `purpur.yml` + +Dano me [Purpur](../reference/configurations/purpur/README.md) ki tye ka cok ki kicel + +#### `safeMode` + +(Lok pa kicel) Kicel ma kicel me dok kwac me server + +#### `server-ip` + +- **Lok pa dano**: `h`, `host` +- **Kit ma en aye**: `(dano me server)` + +Lok ma nying me dok kwac me server ki tye ka cok ki kicel + +#### `server-port` + +- **Lok pa dano**: `p`, `port` +- **Kit ma en aye**: `(dano me server)` + +Lok ma nying me port ki tye ka cok ki kicel + +#### `server-name` + +- **Kit ma en aye**: `A Plazma Server` + +Lok ma nying me ngom ki tye ka cok ki kicel + +#### `spigot-settings` + +- **Lok pa dano**: `S` +- **Kit ma en aye**: `spigot.yml` + +Dano me [Spigot](../reference/configurations/spigot.md) ki tye ka cok ki kicel + +#### `version` + +- **Lok pa dano**: `v` + +Plazma dong ki tye ka cok + +#### `world-dir` + +- **Lok pa dano**: `W`, `universe`, `world-container` +- **Kit ma en aye**: `(doki me server)` + +Lok ma nying me doki ki tye ka cok ki kicel + +#### `world-name` + +- **Lok pa dano**: `w`, `world` +- **Kit ma en aye**: `(dano me server)` + +Dwog ma en aye ki gengo me doki + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Keto kwede i kom ma en aye ki gengo me doki ki tye ka cok + +[^3]: Pi mara, `Plazma.iKnowWhatIAmDoing` ki yam mek `true` ki dong i kom, `-DPlazma.iKnowWhatIAmDoing=true` ki tye ka cok ngene `-DPlazma.iKnowWhatIAmDoing` ki tye ka cok + +[^4]: Pi mara, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Kit ma en acoya. + +[^6]: Kit ma en acoya. + +[^7]: Kiliyenti. + +[^8]: Lok me bedo ki server ma tye ka romo itwero woko. + +[^9]: Gin ma Purpur AFK kwanyo kede ki dong pe itye ka kwo kwanyo player. + +[^10]: Sync Chunk Write System, Lok me gengo chunk me sync. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: 게임에서 `월드 최적화` 도 이와 같은 원리로 동작합니다. + +[^13]: Internet Protocol, IP. + +[^14]: `레벨 2` 이상의 관리자는 제외합니다. diff --git a/ach/origin/plazma/adminstration/reference/commands.md b/ach/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..50464793b --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Cwinya i Plazma ki tek ma kicayo iye. +--- + +# 🖥️ Cwinya diff --git a/ach/origin/plazma/adminstration/reference/configurations/bukkit.md b/ach/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0813f8ada --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Kwo koni kare ma bukkit.yml me tier pa node mamegi? +--- + +# 🪣 Bukkit diff --git a/ach/origin/plazma/adminstration/reference/configurations/paper/README.md b/ach/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..ff0ccdeb6 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Lok ma kiketo ki folder config ma yoo i yom cwinyeno. +--- + +# 🛩️ Paper diff --git a/ach/origin/plazma/adminstration/reference/configurations/paper/global.md b/ach/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..50fab504a --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Tyeke i paper-global.yml kiketo ki ni ki bot lanyo. +--- + +# 🛩️ Paper (Dok ngom) diff --git a/ach/origin/plazma/adminstration/reference/configurations/paper/world.md b/ach/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..2cdb88c4c --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Papil (paper-world.yml tye kiketo gang mito ada mako kede i kom. +--- + +# 🛩️ Papil (Duny pa Lutino) diff --git a/ach/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ach/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e32f333d7 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Lok ma kiketo ki folder config ma yoo i yom cwinyeno. +--- + +# ✨ Plazma diff --git a/ach/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ach/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a836b1569 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (전역 구성) diff --git a/ach/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ach/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..fe18c3e76 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Cwiny pa dano diff --git a/ach/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ach/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/ach/origin/plazma/adminstration/reference/configurations/property.md b/ach/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..ee8f5dead --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Kube server.properties ma kwo ada ada i kom. +--- + +# 🪨 Server.properties diff --git a/ach/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ach/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..c20dfa587 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Dokot pa pufferfish.yml ma en odoko pe iye ni en aye i pwony. +--- + +# 🐡 Pufferfish diff --git a/ach/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ach/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..1b3a95d52 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml pa lub node mapecek kwede onino kicoyo. +--- + +# 🦑 Purpur diff --git a/ach/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ach/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..7ca7092d2 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml pa lub node mapecek kwede onino kicoyo. +--- + +# 🦑 Purpur (lok me pwonyo) diff --git a/ach/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ach/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..212a25256 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml pa lub node mapecek kwede onino kicoyo. +--- + +# 🦑 Purpur (Dunia me yenyutu) diff --git a/ach/origin/plazma/adminstration/reference/configurations/spigot.md b/ach/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..2734af39c --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Tye kacel spigot.yml ma gicel ki i loke dano. +--- + +# 🚰 Spigot diff --git a/ach/origin/plazma/adminstration/reference/permissions.md b/ach/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..10cc26571 --- /dev/null +++ b/ach/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Monyo me Plazma ki nyingi. +--- + +# 🛡️ Nyingi diff --git a/ach/origin/plazma/developers.md b/ach/origin/plazma/developers.md new file mode 100644 index 000000000..d3f7d8273 --- /dev/null +++ b/ach/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Cwinywa ki woko ki Plazma ki kwo tic me cwinywa i mekerani me tye ka cwinywa. +--- + +# ⚙️ Lubango Lwoc diff --git a/ach/origin/thunderbolt/README.md b/ach/origin/thunderbolt/README.md new file mode 100644 index 000000000..a44a1d097 --- /dev/null +++ b/ach/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt tye ka Plazma ki yec macok mekwaro ma gicoyo woko kicoyo ki Flavor me yom cwinywa i pa server platform. +--- + +# 🌩️ Dok otyeko ki Thunderbolt diff --git a/ach/origin/volt/README.md b/ach/origin/volt/README.md new file mode 100644 index 000000000..20c87f25f --- /dev/null +++ b/ach/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt kiketo Plazma ma kicoyo nying ma giketo i Paperweight server platform ma gicel i ngom open source templet. +--- + +# ⚡ Volt Development Guide diff --git a/af/origin/README.md b/af/origin/README.md new file mode 100644 index 000000000..932f8b6b8 --- /dev/null +++ b/af/origin/README.md @@ -0,0 +1,41 @@ +--- +description: As daar enige vrae is, vra asseblief deur Discord of GitHub Besprekings. +--- + +# 🏠 Welkom by die Dokumentasie Portal + +{% hint style="info" %} + +**Die dokumente van Plazma is tans masjienvertaal.** + +[![Vertalingsstatus](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Neem deel aan die dokumentvertaling by [https://translate.plazmamc.org/](https://translate.plazmamc.org/) om die dokument te verbeter. + +{% endhint %} + +### As daar 'n probleem is terwyl jy Plazma gebruik, wat moet gedoen word? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### As jy belangstel in Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### As jy jou eie bedienerplatform met Volt wil skep? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `BORG` Indien jy meer inligting benodig oor Minecraft verwant. + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/af/origin/SUMMARY.md b/af/origin/SUMMARY.md new file mode 100644 index 000000000..0b27aa5f5 --- /dev/null +++ b/af/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Inhoudsopgawe + +- [🏠 Welkom by die Dokumente Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Gebruiks Dokumente](plazma/README.md) +- [❓ Wat is Plazma?](plazma/about/README.md) + - [⬇️ Aflaai](plazma/about/downloads.md) + - [✅ Ondersteunde Weergawes](plazma/about/supported-versions.md) +- [⚒️ Bedieningsgids vir bedieners](plazma/administration/README.md) + - [👟 Begin hier](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Verwysing](plazma/administration/reference/README.md) + - [🖥️ Opdragte](plazma/administration/reference/commands.md) + - [🛡️ Regte](plazma/administration/reference/permissions.md) + - [🎛️ Argumente en Eienskappe](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Eienskap](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globale Konfigurasie](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Wêreldwye samestelling](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globale Konfigurasie](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Wêreldwye samestelling](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globale Konfigurasie](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Wêreldwye samestelling](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Gevorderd](plazma/administration/expert/README.md) + - [🧹 Optimaliseer](plazma/administration/expert/optimize.md) + - [🔀 Proksi](plazma/administration/expert/proxy.md) + - [↩️ Vanilliseer](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blokkering](plazma/administration/expert/xray.md) + - [⚠️ Swakhede en Oplossings](plazma/administration/expert/fix-exploits.md) + - [⁉️ Gereelde Vrae](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Ontwikkelaar Gids](plazma/developers.md) + - [✏️ Bydrae](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Gebruiksgids](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Ontwikkelingsgids](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Laai Alles Af](plazma/about/downloads-all.md) diff --git a/af/origin/miscellaneous/README.md b/af/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/af/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/af/origin/plazma/README.md b/af/origin/plazma/README.md new file mode 100644 index 000000000..5f2f497f3 --- /dev/null +++ b/af/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma is 'n Minecraft: Java Edition oop-bronbedienerplatform met eksperimentele optimalisering op papier en aanpassing van verskeie speel-meganismes." +--- + +# ✨ Plazma Gebruiksdokumente + +## 👋 Welkom by Plazma Dokumente + +Welkom by die Plazma-gebruiksgids! + +{% hint style="info" %} + +**Kan jy nie die probleem oplos deur die handleiding te raadpleeg nie?** + +[Amptelike Discord-bediener](https://discord.gg/MmfC52K8A8) of [GitHub-besprekings](https://github.com/PlazmaMC/PlazmaBukkit/discussions) vir gemeenskapsvrae! + +{% endhint %} + +### Oor Plazma + +> Leer meer oor wat Plazma se bedienerplatform behels. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Vir Administrateurs + +> Skep jou eie bediener met behulp van Plazma. + +{% content-ref url="administrasie/" %} +[administrasie](administrasie/) +{% endcontent-ref %} + +### Vir Ontwikkelaars + +> Ontwikkel derdepartyprojekte met behulp van Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/af/origin/plazma/about/README.md b/af/origin/plazma/about/README.md new file mode 100644 index 000000000..88537cef2 --- /dev/null +++ b/af/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Leer meer oor wat Plazma se bedienerplatform behels. +--- + +# ❓ Wat is Plazma? + +- **Plazma** is 'n server platform gebaseer op [Paper](https://github.com/PaperMC/Paper) wat slegs die voordele van [Andromeda](https://github.com/EarendelArchived/Andromeda) en [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) meebring. +- Ons streef daarna om altyd hoë stabiliteit en kragtige prestasie, vinnige opdaterings en 'n wye verskeidenheid funksies te bied. + +## 📋 Doelwitte van Plazma + +- Ons streef daarna om 'n server platform te wees met vinnige opdaterings en hoë stabiliteit. +- Ons streef daarna om 'n wye verskeidenheid funksies en kragtige prestasie te bied, soos 'n mod platform. +- Ons streef daarna om 'n vry platform te skep waarvan die Vanilla patches aangepas kan word. + +## ⚙️ Belangrikste kenmerke + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Die vinnigste opdaterings**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) sorg dat die patches van Plazma altyd op datum gehou word, wat die vinnigste opdaterings onder die Paper-gebaseerde bediener platforms bied. +6. **Geoptimaliseerde standaard konfigurasie lêers**\ + Die standaard toegepaste konfigurasie lêers is geoptimaliseer, dus jy hoef nie die konfigurasie lêers self te optimaliseer nie. +7. **Sistematies werkende multi-threading**\ + Asynkroniseer stelsel meganisme wat nie verband hou met die speletjie se meganisme nie, om die vertraging te verminder en die bediener te optimaliseer. +8. **Blokkering van onnodige geheue gebruik**\ + Die kombineer van data met soortgelyke waardes om geheue gebruik te verminder. + +## ✨ Gebruik Gevalle + +- **Platform wat selfs ingewikkelde invoegtoepassings behoorlik hanteer**\ + Die Plazma word op die bediener van die ontwikkelaar [IPECTER](https://github.com/IPECTER) gebruik.\ + Dit het 'n selfgemaakte invoegtoepassing wat met NMS en refleksie werk, en daar is 'n groot hoeveelheid komplekse en uitgebreide datapakke wat baie geïmplementeer is,\ + sonder om prestasie te verloor, kan dit meer as 100 spelers hanteer. +- **Platform wat vinnige prestasie in RPG-bedieners behou**\ + Op 'n enkele groep is dit moontlik om 100 spelers sonder TPS-vermindering stabiel te hanteer, en\ + met 4 groepe kon 'n totaal van 250 spelers gemaklik speel. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Baie stroomers se gekose platform**\ + Word deur baie stroomers se kykers gebruik as 'n emmer vir deelname. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Laai Af + +Jy kan Plazma aflaai van die onderstaande bladsy. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Wil jy meer inligting oor die ondersteunde weergawes kry? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugins en Paper, Pufferfish, Purpur plugins. + +[^2]: Deur Microsoft Corporation. + +[^3]: As jy die chat rapportering stelsel deaktiveer, word die chat slegs op die bediener hanteer en kan jy Mojang se chat sporing voorkom. + +[^4]: Tyd wat die spel staak om die stelsel meganisme te laat werk. diff --git a/af/origin/plazma/about/downloads-all.md b/af/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..b9f9b689c --- /dev/null +++ b/af/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma uitvoerlêer aflaai volledige weergawe +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Weergawe | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/af/origin/plazma/about/downloads.md b/af/origin/plazma/about/downloads.md new file mode 100644 index 000000000..3ddbd8541 --- /dev/null +++ b/af/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Laai Plazma nou af en probeer dit self uit. +--- + +# ⬇️ Laai Af + +#### Wil jy meer inligting oor die ondersteunde weergawes kry? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Die aflaaibestand hieronder is vir algemene gebruikers se uitvoeringslêer.** + +As jy 'n ontwikkelaar is en 'n ander tipe lêer benodig, sien asseblief die onderstaande bladsy. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WeergaweAflaai
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Aflaai +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/af/origin/plazma/about/patches-list.md b/af/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..64f8e830e --- /dev/null +++ b/af/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor al die funksies wat by Plazma toegevoeg is. +--- + +# 📑 Ingeslote opdaterings diff --git a/af/origin/plazma/about/supported-versions.md b/af/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..52d1542b6 --- /dev/null +++ b/af/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Kyk na die Minecraft: Java Edition weergawe wat deur Plazma ondersteun word." +--- + +# ✅ Weergawe-ondersteuningsstatus + +{% hint style="info" %} + +**Plazma is ontwikkel sedert 1.19.4, en wees daarvan verseker dat weergawes onder 1.19.4 nie ontwikkel word nie.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Afrikaanse%20afwagting +[idv]: +[atv]: https://badge.plazmamc.org/2/Ondersteun +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/geen%20inligting +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Gemiddeld +[100]: https://badge.plazmamc.org/percent/100 + +![In afwachting van vrijgave][wtr] ![In ontwikkeling][idv] ![Ondersteun][atv] ![Ondersteuning van functies gestopt][fse] ![Ondersteuning beëindig][eol] + +| Weergawe | Stabiliteit en funksie ondersteuning | Bou-status | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Bouwstatus](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![bou status](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![bou status](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/af/origin/plazma/administration/README.md b/af/origin/plazma/administration/README.md new file mode 100644 index 000000000..cd8356ea0 --- /dev/null +++ b/af/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Skep jou eie bediener met behulp van Plazma. +--- + +# ⚒️ Bedieningsgids vir bedieners diff --git a/af/origin/plazma/administration/diagnosis/README.md b/af/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..dc76fee79 --- /dev/null +++ b/af/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit hoe om te reageer wanneer 'n probleem ontstaan het. +--- + +# 🧾 진단 diff --git a/af/origin/plazma/administration/diagnosis/plugins.md b/af/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..22f9d9b8f --- /dev/null +++ b/af/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Vind uit hoe om die plugin reg te stel as dit nie behoorlik werk nie. +--- + +# 📜 플러그인 diff --git a/af/origin/plazma/administration/expert/README.md b/af/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..f8f17b3a7 --- /dev/null +++ b/af/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor die professionele hantering van Plazma. +--- + +# 🎓 Gevorderd diff --git a/af/origin/plazma/administration/expert/fix-exploits.md b/af/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..2f9f6b818 --- /dev/null +++ b/af/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor bekende kwetsbaarhede en hoe om dit op te los. +--- + +# ⚠️ Bekende kwetsbaarhede en oplossingsmetodes diff --git a/af/origin/plazma/administration/expert/optimize.md b/af/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..29c98f623 --- /dev/null +++ b/af/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Vind uit hoe om Plazma te optimaliseer. +--- + +# 🧹 Optimalisering diff --git a/af/origin/plazma/administration/expert/proxy.md b/af/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..2c4c20fa0 --- /dev/null +++ b/af/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Leer hoe om die "Velocity"-proksiplatform veilig op te stel. +--- + +# 🔀 Proksie diff --git a/af/origin/plazma/administration/expert/vanillaize.md b/af/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..f0608db2f --- /dev/null +++ b/af/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Leer hoe om die herstel van die Paper en vanilla patches te doen. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper voeg nie opsies by vir die meeste pleisters wat Vanilla se foute regstel nie.** + +Plazma werk tans aan 'n konfigurasie wat sulke foute kan deaktiveer. + +Daarom is hierdie gids nog in wording en die inligting kan enige tyd verander. + +{% endhint %} diff --git a/af/origin/plazma/administration/expert/xray.md b/af/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..3806b708c --- /dev/null +++ b/af/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor verskeie ingeboude metodes om X-straal te blok. +--- + +# 🩻 Blokkeer X-straal diff --git a/af/origin/plazma/administration/faq.md b/af/origin/plazma/administration/faq.md new file mode 100644 index 000000000..914ad755a --- /dev/null +++ b/af/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Lees meer oor gereelde vrae. +--- + +# ⁉️ Gereelde Vrae + +{% hint style="info" %} + +**Kan jy nie die antwoord vind wat jy soek nie?** + +[Amptelike Discord-bediener](https://discord.gg/MmfC52K8A8) of [GitHub-besprekings](https://github.com/PlazmaMC/PlazmaBukkit/discussions) vir gemeenskapsvrae! + +{% endhint %} + +### Plazma begin nie + +As daar 'n foutmelding is soos `geen hoof manifest atribuut, in plazma-(weergawe).jar`,\ +moet jy die ontwikkelings-API-lêer aflaai, **Reobf Paperweight**, vanaf die GitHub-bladsy. + +Raadpleeg die volgende bladsy vir meer inligting. + +{% content-ref url="beginner/" %} +[beginner](beginner#id-2) +{% endcontent-ref %} + +### 'n Waarskuwing word elke keer as die bediener begin, vertoon + +Plazma bevat 'n paar onstabiele opdaterings en kan dus altyd foutief wees, daarom word sulke waarskuwings by die begin van die bediener vertoon. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Hierdie waarskuwing kan gedeaktiveer word deur die [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] stelsel eienskap te gebruik. + +Raadpleeg die volgende bladsy vir meer inligting. + +{% content-ref url="verwysing/argumente.md" %} +[argumente.md](verwysing/argumente.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Beskikbaar vanaf 1.20.1 diff --git a/af/origin/plazma/administration/getting-started/README.md b/af/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..2e18d2daa --- /dev/null +++ b/af/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Leer hoe om 'n bediener met Plazma te skep. +--- + +# 👟 Begin + +Om Plazma stabiel te gebruik, moet jou stelsel aan die volgende vereistes voldoen. + +| | Minimum | Aanbeveel | +| :---------: | ------- | --------- | +| Argitektuur | x64 | - | +| RAM | 8GB | 16GB | +| Stoorplek | 1GB | 8GB | +| JDK | 17 | 21 | + +Om die konfigurasie lêer aanpassing vlot te doen, is dit ook goed om 'n redigeerder soos [Visual Studio Code](https://code.visualstudio.com/download) te installeer. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Korrek afdruk" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime-omgewing Zulu21.32+17-CA (bou 21.0.2+13-LTS) +OpenJDK 64-biet Bediener-VM Zulu21.32+17-CA (bou 21.0.2+13-LTS, gemengde modus, deling) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' is nie 'n interne of eksterne bevel, 'n uitvoerbare program, of +'n bat-lêer nie. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Onherkenbare opsie: --weergawe +Fout: Kon nie die Java Virtuele Masjien skep nie. +Fout: 'n fatale uitsondering het plaasgevind. Program sal afsluit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Eerstens, laai **JDK 21** in `.msi`-formaat van [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) af. +2. Voer die afgelaaide installasiewizard uit en klik op `Volgende`. +3. Aktiveer `Set JAVA_HOME variable` in die middel van die venster aan die linkerkant en klik dan op `Volgende`. +4. Druk op `Installeer` om die JRE-installasie te voltooi. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt installeer gnupg ca-certificates curl --geen-aanbevolen-installatie --geen-aanbevolen-suggesties -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [onderteken-deur=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stabiel hoof" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Voer dan die volgende bevel in die terminaal uit om JRE te installeer. + +```bash +sudo apt installeer --geen-aanbevolen-installatie --geen-aanbevolen-suggesties -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf installeer -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf installeer -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma aflaai + +Plazma bied verskeie uitvoerbaarleêrformate aan. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Meer inligting + +Die uitvoerbaarleër se naam word bepaal as `plazma-(weergawe-bestuurder)-1.20.4-R0.1-SNAPSHOT-(karteringsvorm).jar`. + +- **Karteringsvorm**\ + Kartering is 'n soort kaart wat die werklike en die vervloeiingskode van Minecraft met mekaar verbind. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-gekarteer, 'n vanilla Minecraft kartering. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Weergawe-bestuurder**\ + Die weergawe-bestuurder is 'n lêerbestuurder wat nodig is vir die bedryf van die bediener en wat die biblioteke en lêers op die bediener toepas. + - **Paperclip**\ + Ontwikkel deur die PaperMC-span vir die bestuur van Paper en ander afgeleide platforms, laai biblioteke af en pas dit toe op die bediener. + - **Bundler**\ + Die vanilje-Minecraft-weergawe-bestuurder. + +
+ +*** + +## 3. Begin skripsie skep + +Om Plazma maklik te begin en die bediener outomaties te herlaai, moet jy 'n [begin skripsie](#user-content-fn-6)[^6] skep. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Jy kan die begin skripsie deur die onderste regterkant aflaai-knoppie aflaai.\ +**Maak seker dat die afgelaaide begin skripsie ooreenstem met jou bedryfstelsel.** + +*** + +## 4. Lêers opruim + +Jy moet nou die afgelaaide begin skripsie en Plazma na 'n nuwe vouer skuif. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Voer die begin skripsie uit. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA-goedkeuring + +Nadat jy die begin skripsie een keer uitgevoer het, word 'n `eula.txt`-lêer in die vouer geskep. + +EULA[^9] is 'n gebruikerslisensie-ooreenkoms waarmee jy moet instem om van die dienste van [Mojang Studios](#user-content-fn-10)[^10] gebruik te maak. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Om met die EULA saam te stem, verander `eula=false` na `eula=true` in die `eula.txt`-lêer en stoor dit. + +*** + +## 6. Toelaat van eksterne toegang (Windows) + +Moderne bedryfstelsels blok standaard eksterne toegang om gevaarlike toegang te voorkom deur die **firewall** en **router**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +As jou router nie UPnP ondersteun nie, moet jy na die spesifieke paneel van jou router soek, aangesien dit vir elke router verskil. + +Jy kan ook [Ngrok](https://ngrok.com/) gebruik om 'n tydelike adres te skep. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Kontroleer of port forwarding nodig is + +Voer die volgende in die uitvoeringsvenster in en voer dit uit. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +As die uitset `True` is, is jy klaar, maar as dit `False` is, moet jy port forwarding instel. + +### 6.2 Koppel aan die bediener + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Die adres wat gebruik word om met die bediener te verbind, kan hier bevestig word: [hier](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Daarna, as jy die bediener herlaai, sal Plazma outomaties poort deurstuur probeer. + +Hierdie is die sukses van UPnP volgens die boodskap wat op die konsole verskyn, en op die konsole sal dit soos `[UPnP] (boodskap)` wees. + +| Boodskap | Betekenis | +| ------------------------------------- | -------------------------------------------------------- | +| `Poort suksesvol oopgemaak (poort)` | Poortdeurstuur suksesvol. | +| `Poort (poort) is reeds oop` | Ander diens gebruik reeds daardie poort. | +| `Misluk om poort oop te maak (poort)` | Poortdeurstuur misluk. | +| `Diens is nie beskikbaar nie` | Router ondersteun nie UPnP nie. | + +As die bediener afgesluit word, sal Plazma outomaties die poort sluit. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Laai die `Windows (64-bit)` ZIP lêer vanaf die [Ngrok webwerf](https://ngrok.com/download) af. +2. Plaas die afgelaaide Ngrok in die bediener se gids. +3. Skep 'n outorisasie token by die [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Voer die opdrag wat in die `Command Line` in die bediener se gids verskyn, uit. +5. Voeg `start /b ngrok tcp --region jp 25565` by die boonste gedeelte van die uitvoeringskript en `taskkill /f /t /im ngrok.exe` by die onderste gedeelte by. +6. Die adres van die bediener sal wees `0.tcp.jp.ngrok.io:12345` soos aangedui deur die `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` boodskap op die konsole. +7. Jy kan nou van buite die bediener bereik deur die genoemde adres. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Byvoorbeeld, as die volgende na die uitvoering van die opdrag verskyn: + +```log +Windows IP konfigurasie + +Ethernet-adapter Ethernet: + + Gekoppelde DNS-suffix. . . . : + IPv4-adres. . . . . . . . . : 192.168.3.7 + Subnet-masker . . . . . . . : 255.255.255.0 + Standaard gateway . . . . . . : 192.168.3.1 + +``` + +Jy kan die bediener bereik deur die `192.168.3.7` adres wat in die IPv4 adres verskyn, te gebruik. + +Indien die bediener en die spel op dieselfde rekenaar hardloop, kan jy met `localhost` verbind. +{% endtab %} +{% endtabs %} + +## 7. Groei + +As die bediener suksesvol begin het en behoorlik funksioneer, is dit nou tyd om die bediener aan te pas. + +Leer hoe om die bediener aan te pas deur die volgende handleiding te volg. + +{% inhoudsverwysing url="next-step.md" %} +[next-step.md](next-step.md) +{% endinhoudsverwysing %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma se basis Papier is gegrond op Spigot, wat op sy beurt op die amptelike bediener platform gebaseer is. + +[^3]: Windows sleutel + R + +[^4]: Vir Linux, hardloop `java --version` in die terminal + +[^5]: JRE is een van die oopbronprojekte en het verskeie variasies soos die Minecraft bediener platform. + +[^6]: Dikwels bekend as 'n **aandrywer**. + +[^7]: Deur 'Auto-herlaai' te aktiveer, sal die bediener outomaties herlaai. Jy kan die bediener stop deur `Control + C` in te tik. + +[^8]: Dit word nie aanbeveel om meer as die helfte van die stelsel te gebruik nie. + + Byvoorbeeld, as die totale geheuekapasiteit van die stelsel 8GB is, word dit nie aanbeveel om meer as 4GB in te stel nie. + +[^9]: Eindgebruikerlisensie-ooreenkoms, finale gebruikerslisensie-ooreenkoms. Vir meer inligting, besoek die [Minecraft webwerf](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Volgens artikel 32(1)(9) van die Wet op die Bevordering van die Speelbedryf in Suid-Korea, kan regsstappe teen **Koreaanse Microsoft Corporation** geneem word. + +[^12]: Universal Plug & Play. Purpur wat ingesluit is in Plazma kommunikeer outomaties met die router deur hierdie tegnologie om slegs die poort te open wanneer die bediener in werking is, wat beteken dat jy nie self poort deurstuur hoef te doen nie. + +[^13]: Indien daar geen rekening is nie, kan jy by Ngrok registreer deur jou Google- of GitHub-rekening te gebruik. diff --git a/af/origin/plazma/administration/getting-started/customization.md b/af/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..7c893ee5e --- /dev/null +++ b/af/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,118 @@ +--- +description: Leer hoe om die bediener aan te pas vir gebruikers. +--- + +# 🎨 Gebruikersaanpassing + +Die rede waarom aangepaste bedienerplatforms soos Plazma gebruik word, sonder om die amptelike bedienerplatform wat deur Mojang Studios voorsien word, te gebruik, is dat dit die moontlikheid van sterk **aanpassing** bied. + +Hieronder is verskeie maniere om Plazma aan te pas en te benut. + +## Konfigurasie wysig + +Die basiese metode om Plazma aan te pas is deur die konfigurasie te wysig. + +Plazma bied kragtige konfigurasie-instellings, van die spel se meganika tot die eienskappe van monsters. + +Raadpleeg die onderstaande bladsy vir 'n uiteensetting oor Plazma se konfigurasie. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Plugin gebruik + +{% hint style="success" %} + +**Plazma ondersteun normaalweg alle op papier-gebaseerde plugins.** + +Vir Spigot-plugins kan dit weens 'n verandering in die kartering vanaf 1.20.5 na Paper dalk nie behoorlik werk nie, maar +die meeste plugins wat op Paper, Pufferfish en Purpur gebaseer is, werk almal in Plazma, +en as dit nie behoorlik werk nie, is dit 'n fout in Plazma, so meld dit asseblief [hier.](../diagnosis/plugins.md) + +{% endhint %} + +Dit is 'n belangrike rede om Plazma te gebruik en die sterkste manier om Plazma te personaliseer. +Die kragtige plugin-ekosisteem van Plazma maak dit maklik om die bediener te personaliseer. + +Daar is verskeie maniere om plugins te soek en af te laai. Sommige plugins word op openbare bergingsdiens opgelaai, terwyl ander op GitHub of hul eie webwerwe opgelaai word. + +{% hint style="caution" %} + +**Plugins kan direk tot die stelsel toegang verkry!** + +Gebruik dienste soos VirusTotal om altyd te verseker dat plugins veilig is voordat dit toegepas word, +of laai plugins af van betroubare dienste. + +{% endhint %} + +Daar is verskeie dienste beskikbaar vir die aflaai van plugins. Onder andere dienste soos [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) keur plugins goed voordat dit opgelaai word, en verseker dat slegs veilige plugins versprei word. + +### Pas 'n plugin toe + +Nadat jy 'n plugin afgelaai het, is dit tyd om dit toe te pas. + +1. Plugins is in `.jar`- of `Java-uitvoerbare lêer`-formaat. + Sommige plugins is in 'n saamgepersde lêer, waar jy die saamgepersde lêer moet uitpak en gebruik as die lêer 'bukkit', 'spigot' of 'paper' in die naam het, en + as daar 'fat' lêers saam is, gebruik die 'fat' lêer. +2. Plaas die afgelaai lêer in die `plugins`-vouer van die bediener en (her)begin die bediener. +3. As Plazma begin, sal daar nuwe inhoud op die konsole wees. + Dit beteken dat Plazma die plugins suksesvol gelaai het. +4. Selfs al het Plazma die plugins suksesvol gelaai, kan dit wees dat die plugins nie begin het nie. + Met die `/plugins`-bevel kan jy die plugins wat tans op die bediener gelaai is, sien. + As die naam van die geïnstalleerde plugin nie in rooi nie, maar in groen is, is die plugin suksesvol gelaai. + +As die plugin nie suksesvol gelaai het nie, kan jy op die volgende bladsy 'n oplossing vir die probleem vind. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Gebruik van datapakket + +Datapakke is 'n manier om die spel aan te pas, soortgelyk aan hulpbronne-pakket. + +Met datapakke kan jy nuwe entiteite en uitdagings by die spel voeg. + +{% hint style="caution" %} + +**Datapakke kan die wêreld beskadig!** + +Sommige gebrekkige datapakke kan die wêreld beskadig en dit kan nie ongedaan gemaak word nie. + +Dit word aanbeveel om die wêreld te rugsteun voordat datapakke toegepas word. + +{% endhint %} + +Datapakke kan ook van verskeie dienste afgelaai word, soos [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) en ander. + +Plaas die datapakket in die `datapacks`-vouer van die bediener se wêreld as jy dit afgelaai het. +As die vouer nie bestaan nie, skep dit en voeg die datapakket toe. + +{% hint style="warning" %} + +**Sommige [datapakket](#user-content-fn-2) werk nie korrek nadat dit die eerste keer toegepas is nie.** + +Dit word aanbeveel om die bediener **2 keer** te herlaai as dit nie korrek toegepas is nie. + +{% endhint %} + +Datapakket kan maklik beskadig word wanneer Minecraft opdateer. + +Dit is belangrik om die bediener genoeg te toets voordat dit opdateer, omdat die bediener kan bots as die datapakket heeltemal beskadig is. + +{% hint style="info" %} + +**Na die bedieningsbevel kan jy `safeMode` agter die bediener se aanvangsbevel plaas om al die datapakket te deaktiveer voordat die bediener begin.** + +[Vir meer inligting, sien `Verwysings > Argumente en eienskappe`.](../reference/arguments.md) + +{% endhint %} + +Bevestig die toegepaste datapakke met die `/datapack list`-bevel. + +*** + +[^1]: Of Minecraft: Bedrock-uitgawe se byvoegings. + +[^2]: Voeg entiteite en meer by. diff --git a/af/origin/plazma/administration/getting-started/next-step.md b/af/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..80e9f3790 --- /dev/null +++ b/af/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Leer hoe om die bediener aan te pas vir gebruikers. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Hieronder is verskeie maniere om Plazma aan te pas en te benut. + +## Konfigurasie wysig + +Die basiese metode om Plazma aan te pas is deur die konfigurasie te wysig. + +Plazma bied kragtige konfigurasie-instellings, van die spel se meganika tot die eienskappe van monsters. + +Raadpleeg die onderstaande bladsy vir 'n uiteensetting oor Plazma se konfigurasie. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Plugin gebruik + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Dit is 'n belangrike rede om Plazma te gebruik en die sterkste manier om Plazma te personaliseer. Die kragtige plugin-ekosisteem van Plazma maak dit maklik om die bediener te personaliseer. + +Daar is verskeie maniere om plugins te soek en af te laai. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Daar is verskeie dienste beskikbaar vir die aflaai van plugins. Onder andere dienste soos [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) keur plugins goed voordat dit opgelaai word, en verseker dat slegs veilige plugins versprei word. + +### Pas 'n plugin toe + +Nadat jy 'n plugin afgelaai het, is dit tyd om dit toe te pas. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Plaas die afgelaai lêer in die `plugins`-vouer van die bediener en (her)begin die bediener. +3. As Plazma begin, sal daar nuwe inhoud op die konsole wees. Dit beteken dat Plazma die plugins suksesvol gelaai het. +4. Selfs al het Plazma die plugins suksesvol gelaai, kan dit wees dat die plugins nie begin het nie. Met die `/plugins`-bevel kan jy die plugins wat tans op die bediener gelaai is, sien. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +As die plugin nie suksesvol gelaai het nie, kan jy op die volgende bladsy 'n oplossing vir die probleem vind. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Gebruik van datapakket + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Met datapakke kan jy nuwe entiteite en uitdagings by die spel voeg. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Sommige gebrekkige datapakke kan die wêreld beskadig en dit kan nie ongedaan gemaak word nie. + +Dit word aanbeveel om die wêreld te rugsteun voordat datapakke toegepas word. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Plaas die datapakket in die `datapacks`-vouer van die bediener se wêreld as jy dit afgelaai het. As die vouer nie bestaan nie, skep dit en voeg die datapakket toe. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Dit word aanbeveel om die bediener **2 keer** te herlaai as dit nie korrek toegepas is nie. +{% endhint %} + +Datapakket kan maklik beskadig word wanneer Minecraft opdateer. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Bevestig die toegepaste datapakke met die `/datapack list`-bevel. + +*** + +## Optimalisering + +Plazma het baie optimaliseringspatches wat toegepas is. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proksi + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Vir inligting oor veilige en korrekte proksi-instellings, sien die volgende bladsy. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Veiligheid + +Minecraft het so 'n gevorderde mods dat dit maklik is om 'n [swakheid-aanval-enjin](#user-content-fn-3)[^3] aanlyn te kry. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Toestemming instellings + +Sommige inprop se administratiewe bevele het swakhede wat nie behoorlik ingestel is nie. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokkering + +X-Ray is een van die swakhede wat maklik in basiese optimaliseringskliënte gebruik kan word. + +Plazma bied 'n konfigurasie wat X-Ray standaard kan blokkeer. + +Raadpleeg die volgende bladsy vir inligting oor hoe om X-Ray te blokkeer. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Witlys + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Gebruik `/whitelist query` om te sien watter spelers toegang het. + +*** + +[^1]: Of Minecraft: Bedrock-uitgawe se byvoegings. + +[^2]: Voeg entiteite en meer by. + +[^3]: Gewoonlik genoem as "hacks". + +[^4]: As die konfigurasie nie geoptimaliseer is nie, of as Plazma oud is, of as nuwe swakhede ontdek word, kan dit wees dat dit nie geblokkeer is nie. + +[^5]: Spelers maak verbinding met die bediener deur die Ngrok-proksi-bedieners, en die Ngrok-adres wat by elke herlaaiing uitgereik word, verander. diff --git a/af/origin/plazma/administration/reference/README.md b/af/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..df7a352db --- /dev/null +++ b/af/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Leer hoe om die standaard aanpasbaarheid met Plazma te gebruik. +--- + +# 📜 리퍼런스 + +Plazma bied verskeie aanpasbaarheid metodes aan. + +Van hierdie metodes kan jy dadelik gebruik maak sonder enige ekstra werk. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Amptelike Discord-bediener](https://discord.gg/MmfC52K8A8) of [GitHub-besprekings](https://github.com/PlazmaMC/PlazmaBukkit/discussions) vir gemeenskapsvrae! +{% endhint %} + +*** + +## 🖥️ Opdrag + +> Opdragte stel jou in staat om inligting in die spel te versamel of die speelomgewing aan te pas. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permissies + +> Permissies bepaal die omvang waarbinne spelers kan interaksie hê. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumente en Eienskappe + +> Argumente en eienskappe het 'n algemene invloed op hoe Plazma werk. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Opset + +> Opset is die mees basiese manier om Plazma aan te pas. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/af/origin/plazma/administration/reference/arguments.md b/af/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..e151883c4 --- /dev/null +++ b/af/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Leer meer oor beginargumente en stelsel eienskappe. +--- + +# 🎛️ Argumente en eienskappe + +Die beginwaarde en stelselkenmerke is waardes wat by die uitvoering van Plazma [gebruik word](#user-content-fn-1)[^1], wat 'n algemene invloed op die werking van Plazma het. + +[Posisie wat by die opdrag gevoeg word](#user-content-fn-2)[^2] sal verdeel word in **beginargument** en **sisteemeienskappe** volgens die. + +*** + +## Stelsel eienskap + +Stelsel eienskappe word voor `-jar` ingevoer en word deur die JVM voor Plazma geïnisialiseer verwerk. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Gebruiksmetode + +Stelsel eienskappe word tussen `java` en `-jar` as Java-opdragargumente ingevoer. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` dui aan dat die argument nie ingebou is in die JVM nie, maar 'n spesiale argument vir Plazma is, + +As geen waarde vir eienskappe ingevoer word nie, word die waarde [`true` vasgestel](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Algemene stelsel eienskappe + +#### `convertLegacySigns` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Blyf opgedateerde tekens wat nie meer gebruik word nie. + +#### `debug.entities` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke rakende entiteitsinligting. + +#### `debug.rewriteForIDE` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer NMS-revisie om korrek inligting vanaf die IDE te laai en hersien interne weergawe-inligting. + +#### `disable.watchdog` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die Spigot se Wagter-waarskuwingstelsel. + +#### `letMeReload` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die bevestigingsboodskap vir die `/reload` opdrag. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +As jy 'n pluginontwikkelaar is en jy moet jou plugin opdateer, gebruik hotswap in plaas van `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer plugins wat standaard in- en uitvoerstelsels gebruik. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Waarsku wanneer afgeskafte formaat in die geselskapkomponent opgespoor word. + +#### `Paper.bypassHostCheck` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die bedienerspatroonkontrole wanneer 'n speler aansluit. + +#### `Paper.debugDynamicMissingKeys` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke vir ontbrekende sleutels in NBT-voorwerpe. + +#### `Paper.debugInvalidSkullProfiles` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke vir ongeldige skildprofielinligting. + +Dit log al die ongeldige skildblokke in die wêreld saam met hul posisies. + +#### `Paper.disableChannelLimit` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die plugin-klasprioritiseringstelsel. + +Dit is nuttig as daar probleme is met plugin-skaduwees. + +#### `Paper.disableFlushConsolidate` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die Netty flush-konsolidasie stelsel. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Verstekwaarde**: `750` + +As daar meer entiteite as die ingestelde waarde is, word dit in meerdere pakkette verdeel vir oordrag. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Verstekwaarde**: `8192` + +Stel die maksimum grootte van pakkette wat die bediener op 'n slag kan ontvang, in. + +#### `Paper.ignoreJavaVersion` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer Java-weergawe kontrole. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Dit kan lei tot permanente skade aan wêrelde en algemene lêers, en die hele spel se meganika kan ontwrig word. + +Enige probleme wat deur hierdie aksie veroorsaak word, is die verantwoordelikheid van die individu en Plamza bied geen ondersteuning vir dit nie. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Verstekwaarde**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Verstekwaarde**: `80` + +Stel die maksimum lengte van karakters in 'n tekenbordlyn in. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Verstekwaarde**: `(wêreldweergawe) + 1` + +Stel die weergawe van die eerste wêreldopdateringsinligting in. + +Dit is nuttig wanneer 'n groot aantal blokke opgedateer moet word, maar word andersins nie gebruik nie. + +#### `Paper.parseYamlCommentsByDefault` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `True` + +Aktiveer die hantering van YAML-lêeropmerkings standaard. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Verstekwaarde**: `30` + +As geen data ontvang word van 'n speler vir die tydperk (in sekondes) wat hier ingestel is nie, word die speler gekick. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Ignoreer die kommentaar van die bedienereienskappe. + +#### `Paper.debug-sync-loads` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke vir sinchroniese blok skryf. + +#### `Paper.enable-sync-chunk-writes` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer die [standaard blok skryf stelsel](#user-content-fn-10)[^10] van Minecraft. + +Dit skryf elke blok een vir een weg, wat tot ernstige prestasie-verlies lei. + +#### `Paper.explicit-flush` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer die ekspliciete spoel van die netwerkkanale. + +#### `Paper.strict-thread-checks` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Log altyd foute wat nie op die hoofdraad plaasvind nie. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Waarsku wanneer 'n geskeduleerde taak 'n oormatige vertraging het. + +#### `Paperclip.patchOnly` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +As jy die standaard uitvoerlêer gebruik, pas slegs die patch toe sonder om die bediener te begin. + +#### `Plazma.aggressiveOptimize` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` +- **Botsing**: `Plazma.disableConfigOptimization` + +Verhoog die aanvanklike konfigurasie kragtiger. + +Die aktivering sal die bediener vinniger en veiliger maak, maar kan 'n groot invloed hê op die speel van die spel. + +#### `Plazma.disableConfigOptimization` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` +- **Botsing**: `Plazma.aggressiveOptimize` + +Optimeer nie die aanvanklike konfigurasie nie. + +Hierdie stel die standaard konfigurasie van Paper in. + +#### `Plazma.iWeetWatEkDoen` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` + +Deaktiveer Plazma branding en gebruik die vanilla bediener favicon. + +#### `Plazma.useVanillaConfiguration` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` +- **Botsing**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Dit kan 'n groot impak hê op bediener veiligheid en prestasie. + +Enige probleme wat deur hierdie eienskap veroorsaak word, is die verantwoordelikheid van die bedieneradministrateur. +{% endhint %} + +Stel die aanvanklike konfigurasie in op die standaardwaardes wat Mojang verskaf. + +Dit deaktiveer enige kwesbaarheidspats wat deur Paper geïmplementeer is. + +Kwesbaarheidspats kan weer geaktiveer word in die Paper- of Plazma-konfigurasie. + +#### `Plazma.vanillaize` + +- **Vorm**: `Boolean` +- **Verstek**: `true` +- **Botsing**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Stel die aanvanklike konfigurasie nader aan vanilla in. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Verouderde eienskap + +Die onderstaande stelsel eienskap is 'n verouderde eienskap. + +#### `timings.bypassMax` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` +- **Verouderd**: Timings is verwyder uit Plazma sedert + +Besluit of die waarde wat na Aikar se Timings API gestuur kan word, die maksimum mag oorskry. + +Selfs al doen jy dit, as dit nie deur die API hanteer word nie, sal 'n spoedbeperking toegepas word. + +*** + +## Beginargument + +Die beginargument word na `-jar *.jar` ingevoer en word saam met Plazma geïnisialiseer en verwerk. + +### Gebruiksaanwysing + +Stelsel eienskappe word as programopdragargumente na `-jar *.jar` ingevoer. + +Byvoorbeeld, as jy die `nogui` beginargument wil toepas,\ +dan sal Plazma die `nogui` argument tydens inisialisering verwerk. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Volledige beginargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Verwysing**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Verwysing**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Verwysing**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Begin die bediener met 'n demonstrasiewêreld. + +#### `eraseCache` + +Verwyder oorblywende kas lêers na wêreldopgradering. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Druk die volledige beginargumente en beskrywings van Plazma uit. + +#### `initSettings` + +Skep slegs konfigurasie lêers en sluit die bediener af. + +#### `jfrProfile` + +Aktiveer JFR profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Verwysing**: `(bedieners eienskap)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Deaktiveer die grafiese gebruikerskoppelvlak paneel. + +#### `nojline` + +Deaktiveer JLine en gebruik 'n vanielie-konsole. + +#### `online-mode` + +- **Alias**: `o` +- **Verwysing**: `(bedieners eienskap)` + +Kies of die speler deur die Mojang verifikasiebediener geverifieer moet word. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Verwysing**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Stel die ligging van die verouderde PaperSpigot konfigurasie lêer in. + +Dit word gebruik om bestaande konfigurasie na 'n nuwe konfigurasie lêer oor te dra en word daarna nie meer gebruik nie. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Verwysing**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Verwysing**: `plugins` + +Stel die ligging van die invoegtoepassing vouer in. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Verwysing**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Verwysing**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Begin die bediener in veilige modus en stel dit in op volledige vanielie. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Verwysing**: `(bedieners eienskap)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Verwysing**: `(bedieners eienskap)` + +Stel die bediener se poort in. + +#### `server-name` + +- **Verwysing**: `A Plazma Server` + +Stel die bediener se naam in. + +#### `spigot-settings` + +- **Alias**: `S` +- **Verwysing**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Druk die Plazma weergawe uit. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Verwysing**: `(bediener vouer)` + +Stel die ligging waar wêreld lêers gestoor word in. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Verwysing**: `(bedieners eienskap)` + +Stel die naam van die wêreld lêer in. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Die posisie wat verwerk word, verander afhangende van die bygevoegde posisie. + +[^3]: Byvoorbeeld, as jy `Plazma.iKnowWhatIAmDoing` na `true` wil stel (aktiveer), sal dit dieselfde werk as om slegs `-DPlazma.iKnowWhatIAmDoing` in te voer in plaas van `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Byvoorbeeld, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Gebeurtenisdetektor. + +[^6]: Gebeurtenisdetektor. + +[^7]: Kliënt. + +[^8]: 'n Sein wat aandui dat dit korrek met die bediener soos 'n hartklop verbind is. + +[^9]: Met Purpur se AFK-verbanfunksie kan jy spelers wat afwesig is ook verban. + +[^10]: Sync Chunk Write System, sinkroniseer chunk skryfstelsel. + +[^11]: `WAARSKUWING! Plazma kan onverwagte probleme veroorsaak, so maak seker om dit deeglik te toets voordat jy dit op 'n openbare bediener gebruik.` + +[^12]: In die spel werk `wêreldoptimalisering` ook op hierdie beginsel. + +[^13]: Administrateurs van `vlak 2` en hoër word uitgesluit. + +[^14]: Internetprotokol, IP. diff --git a/af/origin/plazma/administration/reference/commands.md b/af/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..e43ed90dc --- /dev/null +++ b/af/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor die opdragte wat beskikbaar is in Plazma. +--- + +# 🖥️ Opdragte diff --git a/af/origin/plazma/administration/reference/configurations/README.md b/af/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..864737949 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Opset is die mees basiese manier om Plazma aan te pas. +--- + +# 🧾 구성 + +*** + +## 🪨 Eienskap + +> Eienskappe is die mees basiese samestellingslêer wat in Minecraft beskikbaar is. Deur eienskappe te gebruik, kan die basiese meganismes van die spel verander word. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Samestelling + +> Bukkit Samestelling is die mees basiese samestellingslêer wat deur Plazma beskikbaar gestel word. Deur Bukkit Samestelling te gebruik, kan die basiese meganismes van 'n Minecraft-bediener verander word. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Samestelling + +> Spigot Samestelling maak dit moontlik om die fynere meganismes van die spel, spelerhantering, opdragte, en boodskappe te wysig. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Samestelling + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish Samestelling maak dit moontlik om die wêreld en entiteitshanterings van Plazma te verander. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Samestelling + +> Purpur eienskappe maak dit moontlik om die algehele basiese data van die spel te wysig. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Samestelling + +> Plazma Samestelling maak dit moontlik om die funksies van Plazma aan te pas vir die gebruiker. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/af/origin/plazma/administration/reference/configurations/bukkit.md b/af/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..9b265bc47 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in bukkit.yml beteken. +--- + +# 🪣 Bukkit diff --git a/af/origin/plazma/administration/reference/configurations/paper/README.md b/af/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..ff410548d --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat die doel van elke lêer in die konfigurasie lêer is. +--- + +# 🛩️ Papier diff --git a/af/origin/plazma/administration/reference/configurations/paper/global.md b/af/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f73ca433d --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in paper-global.yml beteken. +--- + +# 🌏 전역 구성 diff --git a/af/origin/plazma/administration/reference/configurations/paper/world.md b/af/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..c4688d9d3 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Vind uit wat elke nodus in paper-world.yml beteken. +--- + +# 🏳️ 세계별 구성 + +Wêreldwyd diff --git a/af/origin/plazma/administration/reference/configurations/plazma/README.md b/af/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5b63dce31 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat die doel van elke lêer in die konfigurasie lêer is. +--- + +# ✨ Plazma diff --git a/af/origin/plazma/administration/reference/configurations/plazma/global.md b/af/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..e0581ff03 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in plazma-global.yml beteken. +--- + +# 🌏 전역 구성 diff --git a/af/origin/plazma/administration/reference/configurations/plazma/world.md b/af/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..b4f52ba64 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Verstaan wat elke node in plazma-world.yml beteken. +--- + +# 🏳️ 세계별 구성 diff --git a/af/origin/plazma/administration/reference/configurations/plazma/worlds.md b/af/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..7fcde6b75 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Verstaan wat elke node in plazma-world.yml beteken. +--- + +# ✨ Plazma (samestelling van wêrelde) diff --git a/af/origin/plazma/administration/reference/configurations/property.md b/af/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..493e1f365 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke node in server.eienskappe beteken. +--- + +# 🪨 Server.eienskappe diff --git a/af/origin/plazma/administration/reference/configurations/pufferfish.md b/af/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7942eb43d --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in pufferfish.yml beteken. +--- + +# 🐡 Pufferfish diff --git a/af/origin/plazma/administration/reference/configurations/purpur/README.md b/af/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dad5fe4f2 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in purpur.yml beteken. +--- + +# 🦑 Purpur diff --git a/af/origin/plazma/administration/reference/configurations/purpur/global.md b/af/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..a25cf9740 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in purpur.yml beteken. +--- + +# 🌏 전역 구성 diff --git a/af/origin/plazma/administration/reference/configurations/purpur/world.md b/af/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..5fb8935d9 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in purpur.yml beteken. +--- + +# 🏳️ 세계별 구성 diff --git a/af/origin/plazma/administration/reference/configurations/spigot.md b/af/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..9aba1b717 --- /dev/null +++ b/af/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in spigot.yml beteken. +--- + +# 🚰 Spigot diff --git a/af/origin/plazma/administration/reference/permissions.md b/af/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..1549858eb --- /dev/null +++ b/af/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Vind uit oor die regte van Plazma. +--- + +# 🛡️ Regte + +Toestemming is 'n eenvoudige sekuriteitsinstrument wat die omvang bepaal waarbinne spelers op die bediener met mekaar kan interaksioneer. + +Om toestemming behoorlik te gebruik en maklik te wysig, moet jy plugins soos [LuckPerms](https://luckperms.net) gebruik. + +*** + +## Begrip van basiese toestemmingsisteem + +Minecraft bied basiese bestuursgroep-toestemmings aan. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Spelers**\ + Gewoonlik die standaard toestemmingsgroep vir alle spelers. +2. **Bemiddelaar**\ + Kan spawngbeskerming ignoreer. +3. **Wêreldbestuurder**\ + Kan alle bevele en bevelblokke wat met wêreldbestuur verband hou, gebruik.\ + Dit is die standaard toestemmingsgroep vir datapakke en bevelblokke. +4. **Bestuurder**\ + Kan alle bevele wat met spelerbestuur verband hou, gebruik. +5. **Hoofbestuurder**\ + Kan alle bevele insluitend bedienerbestuur gebruik.\ + Dit is die standaard toestemmingsgroep vir konsole en operateurs. + +*** + +## Toestemming instel + +*** + +## Algemene toestemming + +*** + +#### `toelaat.ry.(Namespaced Key)` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om op 'n entiteit te klim deur dit te 'shift' en met die entiteit te interaksioneer. + +As jy op 'n entiteit klim, kan jy die entiteit se beweging met die 'bewegingsleutel' beheer en met die 'springleutel' spring of vlieg. + +Die [Namespaced ID](#user-content-fn-2)[^2] van die entiteit word ingevoer in die `(Namespaced Key)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `toelaat.spesiaal.(Naamruimte Sleutel)` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om die spesiale vaardighede van 'n entiteit te gebruik terwyl hulle dit ry. + +Nie alle entiteite se spesiale vaardighede is beskikbaar nie. Raadpleeg die lys van alle beskikbare spesiale vaardighede hieronder. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Plaas jou idee op [Plazma Discord](https://plazmamc.org/discord) of [GitHub Besprekings](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Sien alle beskikbare spesiale vaardighede + +- **`kruip`**\ + Druk die `spring sleutel` om te ontplof.\ + As 'n speler die `toelaat.kragtige.kruiper` toestemming het, kan jy die `spring sleutel` ingedruk hou om dit te laai. +- **`dolfyn`**\ + Druk die `spring sleutel` om te duik. +- **`spook`**\ + Druk die `spring sleutel` om vlamme te skiet. +- **`verwelk`**\ + Deur `interaksie` te gebruik, skiet jy 'n verwelk kop af. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.opdrag.kompas` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/kompas` opdrag](commands.md#compass) toe. + +#### `bukkit.opdrag.krediete` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/krediete (Speler)` opdrag](commands.md#credits) toe. + +Voer `.ander` agter die toestemming naam in om dit vir ander spelers toe te laat. + +#### `bukkit.opdrag.demonstrasie` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/demonstrasie (Speler)` opdrag](commands.md#demo) toe. + +Voer `.ander` agter die toestemming naam in om dit vir ander spelers toe te laat. + +#### `bukkit.opdrag.piek` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/piek (Speler)` opdrag](commands.md#ping) toe. + +Voer `.ander` agter die toestemming naam in om dit vir ander spelers toe te laat. + +#### `bukkit.opdrag.ram` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/ram` opdrag](commands.md#ram) toe. + +#### `bukkit.opdrag.rambalk` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/rambalk (Speler)` opdrag](commands.md#rambar) toe. + +Voer `.ander` agter die toestemming naam in om dit vir ander spelers toe te laat. + +#### `bukkit.opdrag.herlaai` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/herlaai` opdrag](commands.md#restart) toe. + +#### `bukkit.opdrag.tps` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/tps` opdrag](commands.md#tps) toe. + +#### `bukkit.opdrag.tpsbalk` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/tpsbalk (Speler)` opdrag](commands.md#tpsbar) toe. + +Voer `.ander` agter die toestemming naam in om dit vir ander spelers toe te laat. + +#### `bukkit.opdrag.tydmetings` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/tydmetings` opdrag](commands.md#timings) toe. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Kyk na [Spark](https://spark.lucko.me/docs/Command-Usage) vir soortgelyke funksionaliteit oorweeg. +{% endhint %} + +#### `bukkit.opdrag.opdop` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die [`/opdop` opdrag](commands.md#uptime) toe. + +#### `minecraft.opdrag.speelmodus.(Speelmodus)` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat die gebruik van die `/speelmodus (Speelmodus) (Speler)` opdrag toe. + +Voer `.ander` agter die toestemming naam in om dit vir ander spelers toe te laat. + +#### `papier.antixray.deurloop` + +- **Standaard Verskaf**: `Geen` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Dit sal beide kante se prestasie verbeter. + +> Kyk na die volgende bladsy vir X-straal instellings. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.deurloop-beweeg-te-vinnig-kontrole` + +- **Standaard Verskaf**: `Geen` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.aambeeld.kleur` + +- **Standaard Verskaf**: `Geen` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.aambeeld.formaat` + +- **Standaard Verskaf**: `Geen` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.aambeeld.miniberig` + +- **Standaard Verskaf**: `Geen` + +Laat die gebruik van [MiniMessage etikette](https://docs.advntr.dev/minimessage/format.html) op aambeelde toe. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.aambeeld.verwyder_kursief` + +- **Standaard Verskaf**: `Geen` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.boek.kleur.teken` + +- **Standaard Verskaf**: `Geen` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.verbyIdleKick` + +- **Standaard Verskaf**: `Geen` + +Sluit spelers uit van die idle kick lys. + +#### `purpur.debuur.f3n` + +- **Standaard Verskaf**: `Wêreld Bestuurder` + +Laat spelers toe om die spelmodus te verander met die `F3 + N` sleutel kombinasie. + +Dit sal nie werk as die speler nie die regte spelmodus toestemming het nie. + +#### `purpur.aflaai.spawners` + +- **Standaard Verskaf**: `Geen` + +As jy 'n spawner blok met die regte item breek, laat dit die spawner blok val. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderkis.rye.(Nommerteks)` + +- **Standaard Verskaf**: `Geen` + +Verander die grootte van die Ender Chest. + +Jy kan `een`, `twee`, `drie`, `vier`, `vyf`, `ses` in `Nommerteks` invoer. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventaris_totem` + +- **Standaard Verskaf**: `Geen` + +Laat die werking van die onsterflikheid totem in die inventaris toe. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om die verbindingstoegrens te ignoreer. + +#### `purpur.mending_shift_click` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om 'n voorwerp wat hulle dra te herstel deur `kniel en interaksie`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om spawners te plaas. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Standaard Verskaf**: `Geen` + +Laat spelers direk na die Nether dimensie spring as hulle 'n Nether portal gebruik. + +#### `purpur.sign.color` + +- **Standaard Verskaf**: `Geen` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Standaard Verskaf**: `Geen` + +Laat toe dat skilders die verwarrende kode`(&o)` gebruik. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Standaard Verskaf**: `Geen` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om TNT ontploffing te stop deur `interaksie` met 'n skêr. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Voorsiene toestemming + +#### `plazma.bypass.ncr-require` + +- **Standaard Verskaf**: `Geen` + +Laat spelers toe om aan te sluit sonder dat [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) mod geïnstalleer is. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Byvoorbeeld: `ender_dragon` diff --git a/af/origin/plazma/adminstration/README.md b/af/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..cd8356ea0 --- /dev/null +++ b/af/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Skep jou eie bediener met behulp van Plazma. +--- + +# ⚒️ Bedieningsgids vir bedieners diff --git a/af/origin/plazma/adminstration/expert/README.md b/af/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..f8f17b3a7 --- /dev/null +++ b/af/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor die professionele hantering van Plazma. +--- + +# 🎓 Gevorderd diff --git a/af/origin/plazma/adminstration/expert/fix-exploits.md b/af/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..2f9f6b818 --- /dev/null +++ b/af/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor bekende kwetsbaarhede en hoe om dit op te los. +--- + +# ⚠️ Bekende kwetsbaarhede en oplossingsmetodes diff --git a/af/origin/plazma/adminstration/expert/optimize.md b/af/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..29c98f623 --- /dev/null +++ b/af/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Vind uit hoe om Plazma te optimaliseer. +--- + +# 🧹 Optimalisering diff --git a/af/origin/plazma/adminstration/expert/vanillaize.md b/af/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..55f6be86a --- /dev/null +++ b/af/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Leer hoe om die herstel van die Paper en vanilla patches te doen. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper bied nie 'n opsie vir die meeste patches om vanilla foute op te los nie. + +Plazma werk tans aan 'n konfigurasie wat sulke foute kan deaktiveer. + +Daarom is hierdie gids nog in wording en die inligting kan enige tyd verander. +{% endhint %} diff --git a/af/origin/plazma/adminstration/faq.md b/af/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..75eac93fa --- /dev/null +++ b/af/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Lees meer oor gereelde vrae. +--- + +# ⁉️ Gereelde Vrae + +{% hint style="info" %} + +### Kan jy nie die antwoord vind wat jy soek nie? + +Raadpleeg die [amptelike Discord-bedienaar](https://discord.gg/MmfC52K8A8) of [GitHub-kwessies](https://github.com/PlazmaMC/PlazmaBukkit/issues) om vrae aan die gemeenskap te vra! +{% endhint %} + +### Die program hardloop nie met 'n boodskap nie + +As daar 'n foutmelding is soos `geen hoof manifest atribuut, in plazma-(weergawe).jar`,\ +moet jy die ontwikkelings-API-lêer aflaai, **Reobf Paperweight**, vanaf die GitHub-bladsy. + +Raadpleeg die volgende bladsy vir meer inligting. + +{% content-ref url="beginner/" %} +[beginner](beginner#id-2) +{% endcontent-ref %} + +### 'n Waarskuwing word elke keer as die bediener begin, vertoon + +Plazma bevat 'n paar onstabiele opdaterings en kan dus altyd foutief wees, daarom word sulke waarskuwings by die begin van die bediener vertoon. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Hierdie waarskuwing kan gedeaktiveer word deur die [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] stelsel eienskap te gebruik. + +Raadpleeg die volgende bladsy vir meer inligting. + +{% content-ref url="verwysing/argumente.md" %} +[argumente.md](verwysing/argumente.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Beskikbaar vanaf 1.20.1 diff --git a/af/origin/plazma/adminstration/getting-started/README.md b/af/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..47627d162 --- /dev/null +++ b/af/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Leer hoe om 'n bediener met Plazma te skep. +--- + +# 👟 Begin + +Om Plazma stabiel te gebruik, moet jou stelsel aan die volgende vereistes voldoen. + +| | Minimum | Aanbeveel | +| :---------: | ------: | --------: | +| Argitektuur | x64 | - | +| RAM | 8GB | 16GB | +| Stoorplek | 1GB | 8GB | +| JRE | 17 | 21 | + +Om die konfigurasie lêer aanpassing vlot te doen, is dit ook goed om 'n redigeerder soos [Visual Studio Code](https://code.visualstudio.com/download) te installeer. + +*** + +## 1. Installeer JRE + +Soos die naam aandui, is Minecraft: **"Java"**-uitgawe in Java ontwikkel, en vir uitvoering is JRE[^1] nodig. + +Aangesien Plazma op die amptelike bedienerplatform van Mojang Studios gebaseer is, moet JRE ook geïnstalleer word om Plazma te gebruik. + +### 1.1 Kontroleer JRE beskikbaarheid + +Om te sien of JRE op jou stelsel geïnstalleer is, voer `cmd /k java --version` in die [uitvoeringsvenster](#user-content-fn-3)[^3] in en voer dit uit. + +As dit soos volg vertoon, spring na [Stap 2](setup.md#id-2). + +{% code title="Korrek uitvoer" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Indien dit nie so vertoon nie, of as dit soos hieronder vertoon, beteken dit dat JRE nie beskikbaar is of te oud is, en die [1.2-stap](setup.md#id-1.2) moet uitgevoer word. + +{% code title="JRE nie geïnstalleer nie" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE is te oud" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Installeer JRE + +In hierdie gids word Azul Zulu as een van die [tipes JRE](#user-content-fn-5)[^5] gebruik. + +Na installasie, voer [Stap 1.1](setup.md#id-1.1) weer uit om te bevestig dat die installasie korrek voltooi is. + +{% tabs %} +{% tab title="Windows" %} + +1. Eerstens, laai **JDK 21** in `.msi`-formaat van [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) af. +2. Voer die afgelaaide installasiewizard uit en klik op `Volgende`. +3. Aktiveer `Set JAVA_HOME variable` in die middel van die venster aan die linkerkant en klik dan op `Volgende`. +4. Druk op `Installeer` om die JRE-installasie te voltooi. + {% endtab %} + +{% tab title="macOS" %} +Laai **JDK 21** in `.dmg`-formaat van [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) af en voer die afgelaaide installasiewizard uit om JRE te installeer. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Voer eers die volgende bevel in die terminaal uit om die Azul Zulu-opslag by APT by te voeg. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Voer dan die volgende bevel in die terminaal uit om JRE te installeer. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Voer die volgende bevel in om JRE te installeer. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma aflaai + +Plazma bied verskeie uitvoerbaarleêrformate aan. + +{% hint style="warning" %} + +### Gewoonlik gebruik jy `Reobf Paperclip`. + +Die volgende inligting is vir ontwikkelaars of diegene wat belangstel in die eienskappe van elke tipe.\ +As jy 'n gewone gebruiker is, kan jy gerus [Stap 3](setup.md#id-3) oorslaan sonder probleme. +{% endhint %} + +
+ +Meer inligting + +Die uitvoerbaarleër se naam word bepaal as `plazma-(weergawe-bestuurder)-1.20.4-R0.1-SNAPSHOT-(karteringsvorm).jar`. + +- **Karteringsvorm**\ + Kartering is 'n soort kaart wat die werklike en die vervloeiingskode van Minecraft met mekaar verbind. + - **Reobf**\ + Reobfuscation, ook bekend as Spigot-kartering, word hoofsaaklik in die meeste NMS-invoegtoepassings gebruik.\ + Vanaf 1.20.5 sal dit nie meer gebruik word nie. + - **Mojmap**\ + Mojang-kartering, die vanilje-Minecraft-kartering. +- **Weergawe-bestuurder**\ + Die weergawe-bestuurder is 'n lêerbestuurder wat nodig is vir die bedryf van die bediener en wat die biblioteke en lêers op die bediener toepas. + - **Paperclip**\ + Ontwikkel deur die PaperMC-span vir die bestuur van Paper en ander afgeleide platforms, laai biblioteke af en pas dit toe op die bediener. + - **Bundler**\ + Die vanilje-Minecraft-weergawe-bestuurder. + +
+ +*** + +## 3. Begin skripsie skep + +Om Plazma maklik te begin en die bediener outomaties te herlaai, moet jy 'n [begin skripsie](#user-content-fn-6)[^6] skep. + +Jy kan 'n begin skripsie deur [Flags.sh](https://flags.sh) skep.\ +Net voer jou [geheue wat gebruik moet word](#user-content-fn-8)[^8] in en die opdrag sal outomaties geoptimaliseer word. + +Jy kan die begin skripsie deur die onderste regterkant aflaai-knoppie aflaai.\ +**Maak seker dat die afgelaaide begin skripsie ooreenstem met jou bedryfstelsel.** + +*** + +## 4. Lêers opruim + +Jy moet nou die afgelaaide begin skripsie en Plazma na 'n nuwe vouer skuif. + +{% hint style="warning" %} + +### Die vouernaam moet beslis sonder spasies wees en in Engels gestel word. + +Andersins kan Plazma of JRE moontlik nie korrek werk nie. +{% endhint %} + +Voer die begin skripsie uit. Vir Windows, moet jy by die Seleksie van die firewall-toestemming beslis **Toelaat** kies. + +*** + +## 5. EULA-goedkeuring + +Nadat jy die begin skripsie een keer uitgevoer het, word 'n `eula.txt`-lêer in die vouer geskep. + +EULA[^9] is 'n gebruikerslisensie-ooreenkoms waarmee jy moet instem om van die dienste van [Mojang Studios](#user-content-fn-10)[^10] gebruik te maak. + +As jy nie met die EULA saamstem nie, kan jy nie die bediener begin nie, en as jy die EULA oortree, kan jy gestraf word met die opskorting van jou rekening ens. [sanksies](#user-content-fn-11)[^11]. + +Om met die EULA saam te stem, verander `eula=false` na `eula=true` in die `eula.txt`-lêer en stoor dit. + +*** + +## 6. Toelaat van eksterne toegang (Windows) + +Moderne bedryfstelsels blok standaard eksterne toegang om gevaarlike toegang te voorkom deur die **firewall** en **router**. + +Vir Windows, aangesien jy in [Stap 3](setup.md#id-3) die firewall toegelaat het, hoef jy net port forwarding te doen. + +{% hint style="info" %} + +### Hierdie gids gaan uit van Windows-bedryfstelsels en die gebruik van [**UPnP**](#user-content-fn-12)[^12] in die router. + +As jou router nie UPnP ondersteun nie, moet jy na die spesifieke paneel van jou router soek, aangesien dit vir elke router verskil. + +Jy kan ook [Ngrok](https://ngrok.com/) gebruik om 'n tydelike adres te skep. +{% endhint %} + +{% hint style="warning" %} + +### Linux of macOS ens. (semi-) UNIX-stelsels vereis verskillende instellings vir elke firewalldiens, soek dus die inligting self. + +{% endhint %} + +### 6.1 Kontroleer of port forwarding nodig is + +Voer die volgende in die uitvoeringsvenster in en voer dit uit. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +As die uitset `True` is, is jy klaar, maar as dit `False` is, moet jy port forwarding instel. + +### 6.2 Koppel aan die bediener + +{% tabs %} +{% tab title="Externally toegang" %} +As poort deurstuur nie nodig is nie, of as poort deurstuur reeds suksesvol voltooi is, kan jy nou met die bediener verbind. + +Die adres wat gebruik word om met die bediener te verbind, kan hier bevestig word: [hier](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP poortdeurstuurpoging" %} +In die `purpur.yml` van die bediener se gids aktiveer jy `network.upnp-port-forwarding` deur dit na `true` te stel. + +Daarna, as jy die bediener herlaai, sal Plazma outomaties poort deurstuur probeer. + +Hierdie is die sukses van UPnP volgens die boodskap wat op die konsole verskyn, en op die konsole sal dit soos `[UPnP] (boodskap)` wees. + +| Boodskap | Betekenis | +| ------------------------------------- | ---------------------------------------- | +| `Poort suksesvol oopgemaak (poort)` | Poortdeurstuur suksesvol. | +| `Poort (poort) is reeds oop` | Ander diens gebruik reeds daardie poort. | +| `Misluk om poort oop te maak (poort)` | Poortdeurstuur misluk. | +| `Diens is nie beskikbaar nie` | Router ondersteun nie UPnP nie. | + +As die bediener afgesluit word, sal Plazma outomaties die poort sluit. +{% endtab %} + +{% tab title="Ngrok vir tydelike adres skep" %} +Die gebruik van Ngrok is nuttig vir korttermyn toetse, deelname of speel saam met vriende. + +1. Laai die `Windows (64-bit)` ZIP lêer vanaf die [Ngrok webwerf](https://ngrok.com/download) af. +2. Plaas die afgelaaide Ngrok in die bediener se gids. +3. Skep 'n outorisasie token by die [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Voer die opdrag wat in die `Command Line` in die bediener se gids verskyn, uit. +5. Voeg `start /b ngrok tcp --region jp 25565` by die boonste gedeelte van die uitvoeringskript en `taskkill /f /t /im ngrok.exe` by die onderste gedeelte by. +6. Die adres van die bediener sal wees `0.tcp.jp.ngrok.io:12345` soos aangedui deur die `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` boodskap op die konsole. +7. Jy kan nou van buite die bediener bereik deur die genoemde adres. + {% endtab %} + +{% tab title="Lokaal toegang" %} +Indien jy vanaf 'n plaaslike rekenaar met die bediener wil verbind, kan jy die `cmd /k ipconfig` in die uitvoeringsvenster hardloop en die `IPv4 adres` wat verskyn, gebruik om te verbind. + +Byvoorbeeld, as die volgende na die uitvoering van die opdrag verskyn: + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Jy kan die bediener bereik deur die `192.168.3.7` adres wat in die IPv4 adres verskyn, te gebruik. + +Indien die bediener en die spel op dieselfde rekenaar hardloop, kan jy met `localhost` verbind. +{% endtab %} +{% endtabs %} + +## 7. Ontwikkelingsfase + +As die bediener suksesvol begin het en behoorlik funksioneer, is dit nou tyd om die bediener aan te pas. + +Leer hoe om die bediener aan te pas deur die volgende gids te volg. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java uitvoeringsomgewing. + +[^2]: Plazma se basis Papier is gegrond op Spigot, wat op sy beurt op die amptelike bediener platform gebaseer is. + +[^3]: Windows sleutel + R + +[^4]: Vir Linux, hardloop `java --version` in die terminal + +[^5]: JRE is een van die oopbronprojekte en het verskeie variasies soos die Minecraft bediener platform. + +[^6]: Dikwels bekend as 'n **aandrywer**. + +[^7]: Deur 'Auto-herlaai' te aktiveer, sal die bediener outomaties herlaai. Jy kan die bediener stop deur `Control + C` in te tik. + +[^8]: Dit word nie aanbeveel om meer as die helfte van die stelsel te gebruik nie. + + Byvoorbeeld, as die totale geheuekapasiteit van die stelsel 8GB is, word dit nie aanbeveel om meer as 4GB in te stel nie. + +[^9]: Eindgebruikerlisensie-ooreenkoms, finale gebruikerslisensie-ooreenkoms. Vir meer inligting, besoek die [Minecraft webwerf](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Volgens artikel 32(1)(9) van die Wet op die Bevordering van die Speelbedryf in Suid-Korea, kan regsstappe teen **Koreaanse Microsoft Corporation** geneem word. + +[^12]: Universal Plug & Play. Purpur wat ingesluit is in Plazma kommunikeer outomaties met die router deur hierdie tegnologie om slegs die poort te open wanneer die bediener in werking is, wat beteken dat jy nie self poort deurstuur hoef te doen nie. + +[^13]: Indien daar geen rekening is nie, kan jy by Ngrok registreer deur jou Google- of GitHub-rekening te gebruik. diff --git a/af/origin/plazma/adminstration/getting-started/customization.md b/af/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..9ff160be3 --- /dev/null +++ b/af/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Leer hoe om die bediener aan te pas vir gebruikers. +--- + +# 🎨 Gebruikersaanpassing diff --git a/af/origin/plazma/adminstration/reference/arguments.md b/af/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..c16d37efa --- /dev/null +++ b/af/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Leer meer oor beginargumente en stelsel eienskappe. +--- + +# 🎛️ Argumente en eienskappe + +Beginveranderlikes en stelsel eienskappe is waardes wat by die Plazma-uitvoering gevoeg word as [opdragte wat gebruik word](#user-content-fn-1)[^1],\ +om waardes toe te laat om verander te word nadat Plazma uitgevoer is. + +Na gelang van die posisie waar dit by die opdrag gevoeg word, word dit verdeel in **beginargumente** en **stelsel eienskappe**. + +*** + +## Stelsel eienskap + +Stelsel eienskappe word voor `-jar` ingevoer en word deur die JVM voor Plazma geïnisialiseer verwerk. + +{% hint style="warning" %} + +### As jy stelsel eienskappe wysig, kan dit die werking van Plazma en die JVM verander en 'n groot impak op die spel hê! + +As jy nie seker is watter rol elke stelsel eienskap speel nie, **moet jy dit beslis nie gebruik nie!** +{% endhint %} + +### Gebruiksmetode + +Stelsel eienskappe word tussen `java` en `-jar` as Java-opdragargumente ingevoer. + +Byvoorbeeld, as jy die `Plazma.dummyProperty` stelsel eienskap wil toepas,\ +word die volgende ingevoer waar die waarde `37` na die eienskap toegevoeg word en Plazma geïnisialiseer word. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` dui aan dat die argument nie ingebou is in die JVM nie, maar 'n spesiale argument vir Plazma is, + +As geen waarde ingevoer word nie, word die waarde [`true` vasgestel.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Die Paperweight-reeks bedienerplatforms sluit 'n `.` in by die eienskapsnaam om stelsel eienskappe vir elke platform te onderskei. + +In sommige termeinale soos Windows Powershell mag hierdie argumente nie toegelaat word nie, dus moet `"` aan beide kante van die argument [toegevoeg word.](#user-content-fn-4)[^4] +{% endhint %} + +### Algemene stelsel eienskappe + +#### `convertLegacySigns` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Blyf opgedateerde tekens wat nie meer gebruik word nie. + +#### `debug.entities` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke rakende entiteitsinligting. + +#### `debug.rewriteForIDE` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer NMS-revisie om korrek inligting vanaf die IDE te laai en hersien interne weergawe-inligting. + +#### `disable.watchdog` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die Spigot se Wagter-waarskuwingstelsel. + +#### `letMeReload` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die bevestigingsboodskap vir die `/reload` opdrag. + +{% hint style="danger" %} + +### Die `/reload` opdrag is baie onstabiel, dus enige probleme wat voorkom na die gebruik van `/reload` is die verantwoordelikheid van die gebruiker self. + +As jy 'n pluginontwikkelaar is en jy moet jou plugin opdateer, gebruik hotswap in plaas van `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer plugins wat standaard in- en uitvoerstelsels gebruik. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Waarsku wanneer afgeskafte formaat in die geselskapkomponent opgespoor word. + +#### `Paper.bypassHostCheck` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die bedienerspatroonkontrole wanneer 'n speler aansluit. + +#### `Paper.debugDynamicMissingKeys` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke vir ontbrekende sleutels in NBT-voorwerpe. + +#### `Paper.debugInvalidSkullProfiles` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke vir ongeldige skildprofielinligting. + +Dit log al die ongeldige skildblokke in die wêreld saam met hul posisies. + +#### `Paper.disableChannelLimit` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die limiet van 128 plugin-kanale per speler[^5]. + +#### `Paper.disableClassPrioritization` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die plugin-klasprioritiseringstelsel. + +Dit is nuttig as daar probleme is met plugin-skaduwees. + +#### `Paper.disableFlushConsolidate` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer die Netty flush-konsolidasie stelsel. + +#### `Paper.excessiveTELimit` + +- **Vorm**: `Integer` +- **Verstekwaarde**: `750` + +As daar meer entiteite as die ingestelde waarde is, word dit in meerdere pakkette verdeel vir oordrag. + +#### `Paper.filterThreshold` + +- **Vorm**: `Integer` +- **Verstekwaarde**: `8192` + +Stel die maksimum grootte van pakkette wat die bediener op 'n slag kan ontvang, in. + +#### `Paper.ignoreJavaVersion` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Deaktiveer Java-weergawe kontrole. + +{% hint style="danger" %} + +### Dit kan veroorsaak dat die JVM probeer om toegang tot nie-bestaande kodes te verkry! + +Dit kan lei tot permanente skade aan wêrelde en algemene lêers, en die hele spel se meganika kan ontwrig word. + +Enige probleme wat deur hierdie aksie veroorsaak word, is die verantwoordelikheid van die individu en Plamza bied geen ondersteuning vir dit nie. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Vorm**: `Integer` +- **Verstekwaarde**: `64` + +Stel 'n limiet vir die naam van plugin-kanale[^6]. + +#### `Paper.maxSignLength` + +- **Vorm**: `Integer` +- **Verstekwaarde**: `80` + +Stel die maksimum lengte van karakters in 'n tekenbordlyn in. + +#### `Paper.minPrecachedDatafixVersion` + +- **Vorm**: `Integer` +- **Verstekwaarde**: `(wêreldweergawe) + 1` + +Stel die weergawe van die eerste wêreldopdateringsinligting in. + +Dit is nuttig wanneer 'n groot aantal blokke opgedateer moet word, maar word andersins nie gebruik nie. + +#### `Paper.parseYamlCommentsByDefault` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `True` + +Aktiveer die hantering van YAML-lêeropmerkings standaard. + +#### `Paper.playerConnection.keepAlive` + +- **Vorm**: `Integer` +- **Verstekwaarde**: `30` + +As geen data ontvang word van 'n speler vir die tydperk (in sekondes) wat hier ingestel is nie, word die speler gekick. + +Gewoonlik stuur die spel[^7] voortdurend [hartklopseine](#user-content-fn-8)[^8] na die bediener, dus word die speler nie gekick nie, maar as die spel nie reageer nie, word dit as 'n kras beskou en die speler word gekick. + +#### `Paper.skipServerPropertiesComments` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Ignoreer die kommentaar van die bedienereienskappe. + +#### `Paper.debug-sync-loads` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer debug-logboeke vir sinchroniese blok skryf. + +#### `Paper.enable-sync-chunk-writes` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer die [standaard blok skryf stelsel](#user-content-fn-10)[^10] van Minecraft. + +Dit skryf elke blok een vir een weg, wat tot ernstige prestasie-verlies lei. + +#### `Paper.explicit-flush` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Aktiveer die ekspliciete spoel van die netwerkkanale. + +#### `Paper.strict-thread-checks` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Log altyd foute wat nie op die hoofdraad plaasvind nie. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +Waarsku wanneer 'n geskeduleerde taak 'n oormatige vertraging het. + +#### `Paperclip.patchOnly` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `False` + +As jy die standaard uitvoerlêer gebruik, pas slegs die patch toe sonder om die bediener te begin. + +#### `Plazma.aggressiveOptimize` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` + +{% hint style="warning" %} + +### Hierdie eienskap sal na beginargumente skuif na 1.20.5. + +{% endhint %} + +Pas strenger konfigurasie-optimalisering toe by die aanvang van die spel. + +As dit geaktiveer word, sal die bediener vinniger en veiliger word, maar dit kan sekere meganismes blokkeer of 'n groot invloed op spel speel hê. + +#### `Plazma.iWeetWatEkDoen` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` + +Onderdruk die waarskuwing[^11] wat verskyn wanneer Plazma geïnisieer word. + +### Verouderde eienskap + +Die onderstaande stelsel eienskap is 'n verouderde eienskap. + +#### `timings.bypassMax` + +- **Vorm**: `Boolean` +- **Verstekwaarde**: `false` +- **Verouderd**: Timings is verwyder uit Plazma sedert + +Besluit of die waarde wat na Aikar se Timings API gestuur kan word, die maksimum mag oorskry. + +Selfs al doen jy dit, as dit nie deur die API hanteer word nie, sal 'n spoedbeperking toegepas word. + +*** + +## Beginargument + +Die beginargument word na `-jar *.jar` ingevoer en word saam met Plazma geïnisialiseer en verwerk. + +### Gebruiksaanwysing + +Stelsel eienskappe word as programopdragargumente na `-jar *.jar` ingevoer. + +Byvoorbeeld, as jy die `nogui` beginargument wil toepas,\ +dan sal Plazma die `nogui` argument tydens inisialisering verwerk. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Volledige beginargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Verwysing**: `bukkit.yml` + +Stel die naam en ligging van die [Bukkit-konfigurasie lêer](../reference/configurations/bukkit.md) in. + +#### `command-settings` + +- **Alias**: `c` +- **Verwysing**: `commands.yml` + +Stel die naam en ligging van die [Bukkit-opdragkonfigurasie lêer](../reference/configurations/bukkit.md) in. + +#### `config` + +- **Alias**: `c` +- **Verwysing**: `server.properties` + +Stel die naam en ligging van die [bedieningseienskappe](../reference/configurations/property.md) lêer in. + +#### `demo` + +Begin die bediener met 'n demonstrasiewêreld. + +#### `eraseCache` + +Verwyder oorblywende kas lêers na wêreldopgradering. + +#### `forceUpgrade` + +Ignoreer die weergawe en dwing die wêreld om op te gradeer. + +#### `help` + +- **Alias**: `?` + +Druk die volledige beginargumente en beskrywings van Plazma uit. + +#### `initSettings` + +Skep slegs konfigurasie lêers en sluit die bediener af. + +#### `jfrProfile` + +Aktiveer JFR profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Verwysing**: `(bedieners eienskap)` + +Stel die maksimum toegelate [spelers](#user-content-fn-14)[^14] getal in. + +#### `nogui` + +Deaktiveer die grafiese gebruikerskoppelvlak paneel. + +#### `nojline` + +Deaktiveer JLine en gebruik 'n vanielie-konsole. + +#### `online-mode` + +- **Alias**: `o` +- **Verwysing**: `(bedieners eienskap)` + +Kies of die speler deur die Mojang verifikasiebediener geverifieer moet word. + +**As jy nie Velocity of ander proksi gebruik nie, kan jy [EULA](../getting-started/README.md#id-5) oortree en gestraf word.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Verwysing**: `paper.yml` + +{% hint style="warning" %} + +### Hierdie argument is na 1.19.4 gestaak + +{% endhint %} + +Stel die ligging van die verouderde PaperSpigot konfigurasie lêer in. + +Dit word gebruik om bestaande konfigurasie na 'n nuwe konfigurasie lêer oor te dra en word daarna nie meer gebruik nie. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Verwysing**: `config` + +Stel die naam en ligging van die [Paper konfigurasie lêer](../reference/configurations/paper/README.md) se vouer in. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Stel die naam en ligging van die [Plazma konfigurasie lêer](../reference/configurations/plazma/README.md) se vouer in. + +#### `plugins` + +- **Alias**: `p` +- **Verwysing**: `plugins` + +Stel die ligging van die invoegtoepassing vouer in. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Verwysing**: `pufferfish.yml` + +Stel die naam en ligging van die [Pufferfish konfigurasie lêer](../reference/configurations/pufferfish.md) in. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Verwysing**: `purpur.yml` + +Stel die naam en ligging van die [Purpur konfigurasie lêer](../reference/configurations/purpur/README.md) in. + +#### `safeMode` + +Begin die bediener in veilige modus en stel dit in op volledige vanielie. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Verwysing**: `(bedieners eienskap)` + +Stel die bediener se gasheer naam of [internetprotokol](#user-content-fn-13)[^13] adres in. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Verwysing**: `(bedieners eienskap)` + +Stel die bediener se poort in. + +#### `server-name` + +- **Verwysing**: `A Plazma Server` + +Stel die bediener se naam in. + +#### `spigot-settings` + +- **Alias**: `S` +- **Verwysing**: `spigot.yml` + +Stel die naam en ligging van die [Spigot konfigurasie lêer](../reference/configurations/spigot.md) in. + +#### `version` + +- **Alias**: `v` + +Druk die Plazma weergawe uit. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Verwysing**: `(bediener vouer)` + +Stel die ligging waar wêreld lêers gestoor word in. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Verwysing**: `(bedieners eienskap)` + +Stel die naam van die wêreld lêer in. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Die posisie wat verwerk word, verander afhangende van die bygevoegde posisie. + +[^3]: Byvoorbeeld, as jy `Plazma.iKnowWhatIAmDoing` na `true` wil stel (aktiveer), sal dit dieselfde werk as om slegs `-DPlazma.iKnowWhatIAmDoing` in te voer in plaas van `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Byvoorbeeld, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Gebeurtenisdetektor. + +[^6]: Gebeurtenisdetektor. + +[^7]: Kliënt. + +[^8]: 'n Sein wat aandui dat dit korrek met die bediener soos 'n hartklop verbind is. + +[^9]: Met Purpur se AFK-verbanfunksie kan jy spelers wat afwesig is ook verban. + +[^10]: Sync Chunk Write System, sinkroniseer chunk skryfstelsel. + +[^11]: `WAARSKUWING! Plazma kan onverwagte probleme veroorsaak, so maak seker om dit deeglik te toets voordat jy dit op 'n openbare bediener gebruik.` + +[^12]: In die spel werk `wêreldoptimalisering` ook op hierdie beginsel. + +[^13]: Internetprotokol, IP. + +[^14]: Administrateurs van `vlak 2` en hoër word uitgesluit. diff --git a/af/origin/plazma/adminstration/reference/commands.md b/af/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..e43ed90dc --- /dev/null +++ b/af/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Leer meer oor die opdragte wat beskikbaar is in Plazma. +--- + +# 🖥️ Opdragte diff --git a/af/origin/plazma/adminstration/reference/configurations/bukkit.md b/af/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..9b265bc47 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in bukkit.yml beteken. +--- + +# 🪣 Bukkit diff --git a/af/origin/plazma/adminstration/reference/configurations/paper/README.md b/af/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..ff410548d --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat die doel van elke lêer in die konfigurasie lêer is. +--- + +# 🛩️ Papier diff --git a/af/origin/plazma/adminstration/reference/configurations/paper/global.md b/af/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..5974df2ba --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in paper-global.yml beteken. +--- + +# 🛩️ Papier (globale samestelling) diff --git a/af/origin/plazma/adminstration/reference/configurations/paper/world.md b/af/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..7dd077a21 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in paper-world.yml beteken. +--- + +# 🛩️ Papier (samestelling van wêrelde) diff --git a/af/origin/plazma/adminstration/reference/configurations/plazma/README.md b/af/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5b63dce31 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat die doel van elke lêer in die konfigurasie lêer is. +--- + +# ✨ Plazma diff --git a/af/origin/plazma/adminstration/reference/configurations/plazma/global.md b/af/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..977c67451 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in plazma-global.yml beteken. +--- + +# ✨ Plazma (globale samestelling) diff --git a/af/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/af/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..b8bee9a1d --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Wêreldwye samestelling diff --git a/af/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/af/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..7fcde6b75 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Verstaan wat elke node in plazma-world.yml beteken. +--- + +# ✨ Plazma (samestelling van wêrelde) diff --git a/af/origin/plazma/adminstration/reference/configurations/property.md b/af/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..493e1f365 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke node in server.eienskappe beteken. +--- + +# 🪨 Server.eienskappe diff --git a/af/origin/plazma/adminstration/reference/configurations/pufferfish.md b/af/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7942eb43d --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in pufferfish.yml beteken. +--- + +# 🐡 Pufferfish diff --git a/af/origin/plazma/adminstration/reference/configurations/purpur/README.md b/af/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dad5fe4f2 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in purpur.yml beteken. +--- + +# 🦑 Purpur diff --git a/af/origin/plazma/adminstration/reference/configurations/purpur/global.md b/af/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..486150da5 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in purpur.yml beteken. +--- + +# 🦑 Pers (globale samestelling) diff --git a/af/origin/plazma/adminstration/reference/configurations/purpur/world.md b/af/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..7b4297fd8 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in purpur.yml beteken. +--- + +# 🦑 Purper (samestelling van wêreld) diff --git a/af/origin/plazma/adminstration/reference/configurations/spigot.md b/af/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..9aba1b717 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Vind uit wat elke nodus in spigot.yml beteken. +--- + +# 🚰 Spigot diff --git a/af/origin/plazma/adminstration/reference/permissions.md b/af/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..190fa7305 --- /dev/null +++ b/af/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Vind uit oor die regte van Plazma. +--- + +# 🛡️ Regte diff --git a/af/origin/plazma/developers.md b/af/origin/plazma/developers.md new file mode 100644 index 000000000..8c0a3a723 --- /dev/null +++ b/af/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Ontwikkel derdepartyprojekte met behulp van Plazma. +--- + +# ⚙️ Ontwikkelaarshandleiding diff --git a/af/origin/thunderbolt/README.md b/af/origin/thunderbolt/README.md new file mode 100644 index 000000000..0f6c29516 --- /dev/null +++ b/af/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt is 'n Plazma-gebaseerde bedienerplatform wat eksperimentele pleisters onderskei as Flavor om direk te gebruik. +--- + +# 🌩️ Thunderbolt Gebruiksgids diff --git a/af/origin/volt/README.md b/af/origin/volt/README.md new file mode 100644 index 000000000..f6bed3c37 --- /dev/null +++ b/af/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt is 'n oopbron-sjabloon wat gebaseer is op Plazma en wat jou in staat stel om jou eie Paperweight-bedienerplatform te ontwikkel. +--- + +# ⚡ Volt Ontwikkelingsgids diff --git a/ar/origin/README.md b/ar/origin/README.md new file mode 100644 index 000000000..7ff355066 --- /dev/null +++ b/ar/origin/README.md @@ -0,0 +1,41 @@ +--- +description: إذا كان لديك أي أسئلة، يرجى طرحها عبر Discord أو مناقشات GitHub. +--- + +# 🏠 مرحبًا بك في بوابة الوثائق + +{% hint style="info" %} + +**تم ترجمة وثائق Plazma حاليًا بواسطة الآلة.** + +[![حالة الترجمة](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) في مشاركة ترجمة المستندات لتحسين المستندات. + +{% endhint %} + +### هل واجهت مشكلة أثناء استخدام Plazma؟ + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### هل أنت مهتم بـ Thunderbolt؟ + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### هل ترغب في إنشاء منصة خادم خاصة بك باستخدام Volt؟ + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` هل تحتاج إلى مزيد من المعلومات المتعلقة بـ Minecraft؟ + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ar/origin/SUMMARY.md b/ar/origin/SUMMARY.md new file mode 100644 index 000000000..ffc02a8cd --- /dev/null +++ b/ar/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# جدول المحتويات + +- [🏠 مرحبًا بك في بوابة الوثائق](README.md) + - [⚛️ غيثاب](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 ديسكورد](https://discord.gg/MmfC52K8A8) + - [📊 إحصائيات](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ وثائق استخدام بلازما](plazma/README.md) +- [❓ ما هو بلازما؟](plazma/about/README.md) + - [⬇️ تحميل](plazma/about/downloads.md) + - [✅ حالة دعم الإصدار](plazma/about/supported-versions.md) +- [⚒️ دليل إدارة الخادم](plazma/administration/README.md) + - [👟 البدء](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 المرجع](plazma/administration/reference/README.md) + - [🖥️ الأوامر](plazma/administration/reference/commands.md) + - [🛡️ الأذونات](plazma/administration/reference/permissions.md) + - [🎛️ الوسائط والخصائص](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 الخصائص](plazma/administration/reference/configurations/property.md) + - [🪣 بوكيت](plazma/administration/reference/configurations/bukkit.md) + - [🚰 سبيجوت](plazma/administration/reference/configurations/spigot.md) + - [🛩️ بيبر](plazma/administration/reference/configurations/paper/README.md) + - [🌏 التكوين العالمي](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ تكوين حسب العالم](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 التكوين العالمي](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ تكوين حسب العالم](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 التكوين العالمي](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ تكوين حسب العالم](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 متقدم](plazma/administration/expert/README.md) + - [🧹 تحسين](plazma/administration/expert/optimize.md) + - [🔀 وكيل](plazma/administration/expert/proxy.md) + - [↩️ تحويل إلى النسخة الأصلية](plazma/administration/expert/vanillaize.md) + - [🩻 حجب الأشعة السينية](plazma/administration/expert/xray.md) + - [⚠️ الثغرات وكيفية حلها](plazma/administration/expert/fix-exploits.md) + - [⁉️ الأسئلة الشائعة](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ دليل المطور](plazma/developers.md) + - [✏️ المساهمة](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ جافادوكس](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ دليل استخدام الرعد](thunderbolt/README.md) + +## فولت + +- [⚡ دليل تطوير فولت](volt/README.md) + +## متنوع + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ عرض التنزيل الكامل](plazma/about/downloads-all.md) diff --git a/ar/origin/miscellaneous/README.md b/ar/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ar/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ar/origin/plazma/README.md b/ar/origin/plazma/README.md new file mode 100644 index 000000000..a387dd456 --- /dev/null +++ b/ar/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma هو منصة خادم مفتوحة المصدر لـ Minecraft: Java Edition تضيف الأمثلة التجريبية المستندة إلى الورق وتخصيص عدة آليات للعب." +--- + +# ✨ وثائق استخدام بلازما + +## 👋 مرحبًا بك في وثائق بلازما + +مرحبًا بك في دليل استخدام Plazma! + +{% hint style="info" %} + +**هل لا يمكنك حل المشكلة من خلال الدليل؟** + +[الخادم الرسمي لديسكورد](https://discord.gg/MmfC52K8A8) أو من خلال [مناقشات GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)، جرب أن تسأل المجتمع! + +{% endhint %} + +### حول Plazma + +> تعرف على منصة الخادم Plazma. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### للمسؤولين + +> !جرب إنشاء خادم خاص باستخدام Plazma + +{% content-ref url="administration/" %} +[الإدارة](administration/) +{% endcontent-ref %} + +### للمطورين + +> !جرب تطوير مشروع الطرف الثالث باستخدام Plazma + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ar/origin/plazma/about/README.md b/ar/origin/plazma/about/README.md new file mode 100644 index 000000000..38dc11775 --- /dev/null +++ b/ar/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: تعرف على منصة الخادم Plazma. +--- + +# ❓ ما هو Plazma؟ + +- **Plazma** هو منصة خادم مبنية على [Paper](https://github.com/PaperMC/Paper) التي تأخذ فقط مزايا من [Andromeda](https://github.com/EarendelArchived/Andromeda) و [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- نحن نبذل جهودًا لتوفير الاستقرار العالي والأداء القوي والتحديث السريع ومجموعة واسعة من الميزات. + +## 📋 أهداف Plazma + +- نحن نسعى لنكون منصة خادم تحتوي على تحديثات سريعة واستقرار عالي. +- نحن نسعى لتوفير مجموعة واسعة من الميزات وأداء قوي لا يقل عن منصة الوضع. +- نحن نسعى لإنشاء منصة حرة يمكن تخصيص تصحيحات Vanilla عليها. + +## ⚙️ الميزات الرئيسية + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **أسرع تحديث**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) يضمن أن التصحيحات المضمنة في Plazma تبقى دائمًا محدثة، مما يوفر أسرع تحديث بين منصات خوادم الورق. +6. **تكوين ملفات الأساسيات بشكل مثالي**\ + تم تحسين ملفات التكوين الأساسية بحيث لا يلزم تكوينها يدويًا. +7. **تشغيل متعدد الخيوط بشكل منظم**\ + يقوم بتجانس أنظمة الميكانيكا غير المتعلقة باللعبة بشكل غير متزامن لتقليل [أوقات الانتظار](#user-content-fn-4)[^4] وتحسين أداء الخادم. +8. **منع استخدام المساحة غير الضرورية**\ + يجمع البيانات ذات القيم المماثلة معًا لتقليل استخدام الذاكرة. + +## ✨ حالات الاستخدام + +- **منصة تتعامل بشكل صحيح مع الإضافات المعقدة أيضًا**\ + يتم استخدام Plazma على خادم المطور [IPECTER](https://github.com/IPECTER).\ + بالرغم من تطبيق العديد من الإضافات الضخمة والمعقدة ومجموعة كبيرة من حزم البيانات التي تعمل بـ NMS والانعكاس،\ + إلا أنه يستوعب أكثر من 100 لاعب بدون تراجع في الأداء. +- **منصة تحافظ على أداء سريع حتى على خوادم RPG**\ + تم الحفاظ على 100 لاعب في عملية مستقرة بدون تراجع في TPS على مجموعة واحدة،\ + وكان بإمكان 250 لاعبًا اللعب بسلاسة على 4 مجموعات. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **المنصة التي اختارها العديد من البثوث**\ + تم اختيارها كدلوقت لمشاركة المشاهدين من قبل العديد من بثوث الفيديو. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ تنزيل + +يمكنك تنزيل Plazma من الصفحة أدناه. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### هل ترغب في مزيد من المعلومات حول دعم الإصدارات؟ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: الإضافات لـ Bukkit, CraftBukkit, Spigot والإضافات لـ Paper, Pufferfish, Purpur. + +[^2]: بواسطة Microsoft Corporation. + +[^3]: بتعطيل نظام الإبلاغ عن الدردشة، يتم معالجة الدردشة فقط على الخادم ويتم منع تتبع الدردشة من قبل Mojang. + +[^4]: الوقت الذي يتوقف فيه اللعب لبضع لحظات لتشغيل آلية النظام. diff --git a/ar/origin/plazma/about/downloads-all.md b/ar/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..21f57046c --- /dev/null +++ b/ar/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: عرض كامل لتنزيل ملف تشغيل Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| الإصدار | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ar/origin/plazma/about/downloads.md b/ar/origin/plazma/about/downloads.md new file mode 100644 index 000000000..7dad9e43e --- /dev/null +++ b/ar/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: قم بتنزيل Plazma الآن وجربه بنفسك مباشرة. +--- + +# ⬇️ تنزيل + +#### هل ترغب في مزيد من المعلومات حول دعم الإصدارات؟ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**التنزيل أدناه هو ملف تنفيذ للاستخدام العام.** + +إذا كنت مطورًا وتحتاج إلى نوع مختلف من الملف، يرجى الرجوع إلى الصفحة أدناه. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
الإصدارتحميل
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + تنزيل +
1.20.1 + تحميل +
1.19.4 + تحميل +
+ +*** diff --git a/ar/origin/plazma/about/patches-list.md b/ar/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..aae18611c --- /dev/null +++ b/ar/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: تعرف على جميع الميزات المضافة إلى Plazma. +--- + +# 📑 التصحيحات المضمنة diff --git a/ar/origin/plazma/about/supported-versions.md b/ar/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..1bdc78766 --- /dev/null +++ b/ar/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "اكتشف الإصدارات التي تدعمها Plazma في Minecraft: Java Edition." +--- + +# ✅ حالة دعم الإصدار + +{% hint style="info" %} + +**تم تطوير Plazma بدءًا من الإصدار 1.19.4 ، ولا يتم تطوير الإصدارات السابقة لـ 1.19.4.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/عادي +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| الإصدار | الاستقرار ودعم الوظائف | حالة البناء | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![حالة البناء](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![حالة البناء](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![حالة البناء](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ar/origin/plazma/administration/README.md b/ar/origin/plazma/administration/README.md new file mode 100644 index 000000000..3af28d560 --- /dev/null +++ b/ar/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: "!جرب إنشاء خادم خاص باستخدام Plazma" +--- + +# ⚒️ دليل إدارة الخادم diff --git a/ar/origin/plazma/administration/diagnosis/README.md b/ar/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..dca3a1f3e --- /dev/null +++ b/ar/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية التعامل عند حدوث مشكلة. +--- + +# 🧾 진단 diff --git a/ar/origin/plazma/administration/diagnosis/plugins.md b/ar/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..c548e8a9d --- /dev/null +++ b/ar/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية حل مشكلة عدم عمل الإضافة بشكل صحيح. +--- + +# 📜 플러그인 diff --git a/ar/origin/plazma/administration/expert/README.md b/ar/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..c5bb0912a --- /dev/null +++ b/ar/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية التعامل المهني مع Plazma. +--- + +# 🎓 تعمق diff --git a/ar/origin/plazma/administration/expert/fix-exploits.md b/ar/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..ca52ab934 --- /dev/null +++ b/ar/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: تعرف على الثغرات المعروفة وكيفية حلها. +--- + +# ⚠️ الثغرات المعروفة وطرق الحل diff --git a/ar/origin/plazma/administration/expert/optimize.md b/ar/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..de8107740 --- /dev/null +++ b/ar/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية تحسين Plazma. +--- + +# 🧹 التحسين diff --git a/ar/origin/plazma/administration/expert/proxy.md b/ar/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..96add6459 --- /dev/null +++ b/ar/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية تأمين منصة الوكيل 'Velocity' بأمان. +--- + +# 🔀 الوكيل diff --git a/ar/origin/plazma/administration/expert/vanillaize.md b/ar/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..dc8e8d111 --- /dev/null +++ b/ar/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: تعرف على كيفية استعادة تصحيح Paper و Vanilla. +--- + +# ↩️ التبنيلة + +{% hint style="warning" %} + +**Paper لا تضيف خيارات إلى معظم التصحيحات لـ الخطأ البسيط.** + +Plazma حاليًا تعمل على تعطيل تلك التصحيحات كجزء من التكوين. + +لذلك، هذا الدليل لا يزال قيد الكتابة، وقد تتغير المعلومات في أي وقت. + +{% endhint %} diff --git a/ar/origin/plazma/administration/expert/xray.md b/ar/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..831b01fc2 --- /dev/null +++ b/ar/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: تعرف على الطرق المختلفة المضمنة لمنع الأشعة السينية. +--- + +# 🩻 منع الأشعة السينية diff --git a/ar/origin/plazma/administration/faq.md b/ar/origin/plazma/administration/faq.md new file mode 100644 index 000000000..0c4483422 --- /dev/null +++ b/ar/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: تعرف على الأسئلة المتكررة. +--- + +# ⁉️ الأسئلة المتكررة + +{% hint style="info" %} + +**هل لم تجد الإجابة التي تبحث عنها؟** + +[الخادم الرسمي لديسكورد](https://discord.gg/MmfC52K8A8) أو من خلال [مناقشات GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)، جرب أن تسأل المجتمع! + +{% endhint %} + +### لا يمكن بدء Plazma + +إذا ظهرت `no main manifest attribute, in plazma-(version).jar` على الكونسول،\ +فإن الملف الذي تم تنزيله هو ملف API للتطوير، يجب عليك تنزيل **Reobf Paperweight** من صفحة GitHub. + +يرجى الرجوع إلى الصفحة التالية لمزيد من التفاصيل. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### تظهر تحذيرات عند بدء تشغيل الخادم + +يحتوي Plazma على بعض التصحيحات غير المستقرة وقد تعمل بشكل غير صحيح دائمًا، لذا يتم طباعة تحذيرات مثل هذه عند بدء تشغيل الخادم. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +يمكن تعطيل هذه التحذيرات باستخدام خاصية النظام [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +يرجى الرجوع إلى الصفحة التالية لمزيد من التفاصيل. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: متاحة اعتبارًا من الإصدار 1.20.1 diff --git a/ar/origin/plazma/administration/getting-started/README.md b/ar/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..0141c88d6 --- /dev/null +++ b/ar/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: تعرف على كيفية إنشاء خادم باستخدام Plazma. +--- + +# 👟 البدء + +لاستخدام Plazma بشكل مستقر، يجب أن يفي النظام بمتطلبات التالية. + +| | الحد الأدنى | الموصى به | +| :---------------: | ----------- | --------- | +| البنية | x64 | - | +| الذاكرة العشوائية | 8GB | 16GB | +| مساحة التخزين | 1GB | 8GB | +| JDK | 17 | 21 | + +لضمان تعديل ملف التكوين بسهولة، من الجيد تثبيت محرر مثل [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="الناتج الصحيح" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +بيئة تشغيل OpenJDK Zulu21.32+17-CA (البناء 21.0.2+13-LTS) +OpenJDK 64 بت خادم VM Zulu21.32+17-CA (البناء 21.0.2+13-LTS، وضع مختلط، مشاركة) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' غير معروف كأمر داخلي أو خارجي، برنامج قابل للتنفيذ، أو +ملف دفعي. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +خيار غير معترف به: --version +خطأ: تعذر إنشاء الآلة الافتراضية لـ Java. +خطأ: حدث استثناء قاتل. سيتم الخروج من البرنامج. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. أولًا، قم بتنزيل JDK 21 من [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) بتنسيق `.msi`. +2. قم بتشغيل معالج التثبيت الذي تم تنزيله وانقر على `التالي`. +3. بعد ذلك، انتقل إلى القائمة الموجودة في منتصف الجزء الأيسر من النافذة وقم بتفعيل `تعيين متغير JAVA_HOME`، ثم انقر على `التالي`. +4. اضغط على `تثبيت` لإكمال تثبيت JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +ثم، قم بتشغيل الأمر التالي في الطرفية لتثبيت JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. تحميل بلازما + +تقدم بلازما مجموعة متنوعة من ملفات التشغيل. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +تعرف على المزيد + +اسم الملف التنفيذي هو `plazma-(مدير الإصدار)-1.20.4-R0.1-SNAPSHOT-(نوع التعيين).jar`. + +- **نوع التعيين** + التعيين يعد نوعًا من الخريطة التي تربط بين الشفرة الفعلية لـ Minecraft والشفرة المشفرة. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + مُعدلة من قِبل Mojang، وهي تعني تعيين Minecraft الأصلي. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **مدير الإصدار** + مدير الإصدار هو الشخص الذي يمكن أن يُعتبر مشغل الخادم الذي يحتاج إلى مكتبات لتشغيل الخادم وتطبيق تصحيحات على ملفات الخادم. + - **Paperclip** + مدير إصدار Minecraft الأصلي. + - **Bundler** + مدير الإصدار Minecraft الأصلي. + +
+ +*** + +## 3. إنشاء نص بدء + +لبدء بلازما بسهولة وإعادة تشغيل الخادم تلقائيًا، يجب عليك إنشاء [نص بدء](#user-content-fn-6). + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +يمكنك تنزيل نص البدء من خلال زر التنزيل في الزاوية السفلى اليسرى.\ +**تأكد من أن نص البدء الذي تم تنزيله متوافق مع نظام التشغيل الخاص بك.** + +*** + +## 4. تنظيف الملفات + +الآن، قم بنقل نص البدء الذي تم تنزيله وبلازما إلى مجلد جديد. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +الآن، قم بتشغيل نص البدء. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. موافقة EULA + +بمجرد تشغيل نص البدء مرة واحدة، سيتم إنشاء ملف `eula.txt` في المجلد. + +EULA[^9] هو اتفاقية ترخيص يجب عليك الموافقة عليها من خلال استخدام خدمات [Mojang Studios](#user-content-fn-10). + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +للموافقة على EULA، قم بتغيير `eula=false` إلى `eula=true` في ملف `eula.txt` واحفظ التغييرات. + +*** + +## 6. السماح بالوصول الخارجي (Windows) + +تمنع الأنظمة الحديثة من الوصول الخارجي لحماية ضد الوصول الخطير من الخارج عبر جدران الحماية وجهاز التوجيه. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +إذا كان جهاز التوجيه لا يدعم UPnP، فيجب عليك البحث عن الإعدادات الخاصة بجهاز التوجيه لأنها تختلف حسب الجهاز. + +يمكنك أيضًا إنشاء عنوان مؤقت باستخدام [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 التحقق من ضرورة إعادة توجيه المنفذ + +أدخل الأمر التالي في نافذة التشغيل وقم بتشغيله. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +إذا كانت النتيجة `True`، يمكنك الانتهاء هنا، وإذا كانت `False`، فيجب عليك تكوين إعادة توجيه المنفذ. + +### 6.2 الاتصال بالخادم + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +يمكنك التحقق من العنوان المستخدم للوصول إلى الخادم [هنا](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +ثم، بعد إعادة تشغيل الخادم، سيحاول Plazma توجيه المنفذ تلقائيًا. + +النجاح أو الفشل في UPnP يعتمد على الرسالة التي تظهر في وحدة التحكم، حيث تظهر على سبيل المثال `[UPnP] (الرسالة)`. + +| رسالة | المعنى | +| ------------------------------ | ------------------------------------------------------ | +| `تم فتح المنفذ بنجاح (المنفذ)` | نجاح توجيه المنفذ. | +| `المنفذ (المنفذ) مفتوح بالفعل` | المنفذ قيد الاستخدام بواسطة خدمة أخرى. | +| `فشل في فتح المنفذ (المنفذ)` | فشل توجيه المنفذ. | +| `الخدمة غير متوفرة` | جهاز التوجيه لا يدعم UPnP. | + +عند إيقاف تشغيل الخادم، سيقوم Plazma تلقائيًا بإغلاق المنافذ. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. قم بتنزيل ملف ZIP 'Windows (64-bit)' من [موقع Ngrok](https://ngrok.com/download). +2. ضع ملف Ngrok الذي قمت بتنزيله في مجلد الخادم. +3. قم بإنشاء رمز مصادقة من [لوحة تحكم Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. قم بتشغيل الأمر الذي يظهر في 'Command Line' في مجلد الخادم. +5. أضف السطر `start /b ngrok tcp --region jp 25565` في أعلى النص البرمجي، وأضف `taskkill /f /t /im ngrok.exe` في الأسفل. +6. في أعلى وحدة التحكم، ستجد `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`، حيث يكون `0.tcp.jp.ngrok.io:12345` هو عنوان الخادم. +7. يمكنك الآن الاتصال من الخارج باستخدام هذا العنوان. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +على سبيل المثال، عندما يتم عرض الناتج بعد تشغيل الأمر، + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +يمكنك الاتصال بالخادم من الجهاز المحلي باستخدام `192.168.3.7` المعروض كعنوان IPv4. + +إذا كان الخادم واللعبة تعملان على نفس الكمبيوتر، يمكنك الاتصال باستخدام 'localhost'. +{% endtab %} +{% endtabs %} + +## 7. النمو + +إذا كنت قد بدأت الخادم بنجاح ويعمل بشكل صحيح، فإن الآن حان وقت تخصيص الخادم. + +تعرف من خلال هذا الدليل على كيفية تخصيص الخادم. + +{% content-ref url="الخطوة-التالية.md" %} +[الخطوة-التالية.md](الخطوة-التالية.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: يعتمد Paper الذي يقوم عليه Plazma على Spigot، ويعتمد Spigot على منصة الخادم الرسمية. + +[^3]: مفتاح Windows + R + +[^4]: في حالة Linux، استخدم 'java --version' في الطرفية. + +[^5]: JRE هو مشروع مفتوح المصدر، مثل منصة خوادم Minecraft التي تأتي بأنواع متعددة. + +[^6]: عمومًا يُعرف باسم **مشغل**. + +[^7]: عند تمكين 'إعادة التشغيل التلقائي'، سيتم إعادة تشغيل الخادم تلقائيًا. يمكنك إدخال 'Control + C' للخروج. + +[^8]: لا يُنصح بتجاوز نصف سعة النظام. + + على سبيل المثال، إذا كانت سعة الذاكرة الكلية للنظام 8 جيجابايت، فلا يُنصح بتعيين قيمة تزيد عن 4 جيجابايت. + +[^9]: اتفاقية ترخيص المستخدم النهائي، اتفاقية ترخيص استخدام المستخدم النهائي. لمزيد من التفاصيل، يُرجى زيارة [موقع Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: شركة مايكروسوفت. + +[^11]: في كوريا الجنوبية، وفقًا للمادة 32 (1) (9) من قانون تعزيز صناعة الألعاب، يمكن رفع دعوى قانونية ضد **شركة مايكروسوفت كوريا**. + +[^12]: توصيل وتشغيل عالمي. يتيح Purpur المضمن في Plazma التواصل مع الموجه تلقائيًا باستخدام هذه التقنية، مما يعني أنه ليس هناك حاجة لإعداد توجيه المنفذ يدويًا عند تشغيل الخادم. + +[^13]: إذا لم يكن لديك حساب، يمكنك التسجيل في Ngrok باستخدام حساب Google أو GitHub. diff --git a/ar/origin/plazma/administration/getting-started/customization.md b/ar/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..4274dd762 --- /dev/null +++ b/ar/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,123 @@ +--- +description: تعرف على كيفية تخصيص الخادم. +--- + +# 🎨 تخصيص المستخدم + +السبب وراء استخدام منصة الخادم المعدلة مثل Plazma بدلاً من استخدام منصة الخادم الرسمية المقدمة من Mojang Studios هو القدرة القوية على التخصيص التي يمكن أن تكون متاحة. + +فيما يلي بعض الطرق لتخصيص واستخدام Plazma. + +## تعديل التكوين + +أساسيات تخصيص Plazma هي تعديل التكوين مباشرة. + +Plazma يوفر إعدادات تكوين قوية تتضمن آليات اللعبة وخصائص المخلوقات. + +يرجى الرجوع إلى الصفحة التالية لمزيد من المعلومات حول تكوين Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## استخدام الإضافات + +{% hint style="success" %} + +**Plazma تدعم بشكل طبيعي جميع الإضافات القائمة على الورق.** + +بالنسبة لإضافات Spigot ، قد لا تعمل بعضها بسبب تغييرات التعيين في Paper اعتبارًا من الإصدار 1.20.5، +ولكن العديد من الإضافات التي تعتمد على Paper مثل Paper و Pufferfish و Purpur تعمل جميعًا على Plazma، +وإذا لم تعمل بشكل صحيح ، فهذا يعتبر خطأ في Plazma لذا يرجى [الإبلاغ عنه على الفور.](../diagnosis/plugins.md) + +{% endhint %} + +هذا هو السبب الرئيسي لاستخدام Plazma وأقوى طريقة لتخصيص Plazma. +بيئة الإضافات القوية لـ Plazma تسمح بتخصيص الخادم بسهولة. + +هناك عدة طرق للبحث عن الإضافات وتنزيلها. بعض الإضافات +تُرفع إلى خدمات مستودع عام وبعضها يتم تحميله على GitHub أو موقع الويب الخاص بها. + +{% hint style="caution" %} + +**الإضافات يمكنها الوصول مباشرة إلى النظام!** + +قبل تطبيق الإضافات، استخدم خدمات مثل VirusTotal للتحقق من سلامتها دائمًا، أو +قم بتنزيل الإضافات من خدمات موثوقة. + +{% endhint %} + +هناك العديد من الخدمات المستخدمة لتنزيل الإضافات. من بينها، [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) وغيرها من الخدمات تخضع الإضافات لعملية تقييم قبل تحميلها، ويتم التعامل مع الإضافات غير الآمنة على الفور لضمان تداول الإضافات الآمنة فقط. + +### تطبيق الإضافات + +بمجرد تنزيل الإضافات، الآن حان الوقت لتطبيقها. + +1. الإضافات عادة ما تكون بصيغة `.jar` أو `ملف تنفيذي جافا`.\ + بعض الإضافات قد تكون مضغوطة، في هذه الحالة + قم بفك الضغط واستخدم الملف الذي يحتوي على `bukkit`, `spigot` أو `paper` في اسمه، + وفي حال وجود ملف يحتوي على `fat` يجب استخدام الملف `fat`. +2. ضع الملف الذي تم تنزيله في مجلد `plugins` في مجلد الخادم وأعد تشغيل الخادم. +3. عند بدء تشغيل Plazma، ستظهر محتويات جديدة على الواجهة. + هذا يعني أن Plazma قد قامت بتحميل الإضافات بنجاح. +4. حتى إذا تم تحميل الإضافات بنجاح، قد لا تبدأ الإضافات بالعمل. + يمكنك استخدام الأمر `/plugins` لعرض الإضافات المحملة حاليًا على الخادم. + إذا كانت أسماء الإضافات التي قمت بتثبيتها ليست باللون الأحمر + بل الأخضر، فهذا يعني أن الإضافات قد تم تحميلها بنجاح. + +إذا لم يتم تحميل الإضافات بشكل صحيح، يمكنك العثور على حلول للمشكلة في الصفحة التالية. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## استخدام حزم البيانات + +حزم البيانات هي طريقة لتخصيص Minecraft بشكل أساسي، +تشبه [حزم الموارد](#user-content-fn-1)[^1]. + +من خلال حزم البيانات، يمكنك إجراء تعديلات على جزء من اللعبة مثل إضافة مجموعات جديدة من الكائنات والتحديات. + +{% hint style="caution" %} + +**حزم البيانات يمكن أن تلحق ضررًا بالعالم!** + +بعض حزم البيانات المعطوبة يمكن أن تلحق ضررًا بالعالم، وهذا لا يمكن التراجع عنه. + +لذلك، يُنصح بعمل نسخ احتياطية للعالم قبل تطبيق حزم البيانات. + +{% endhint %} + +يمكنك تنزيل حزم البيانات من عدة خدمات مثل [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) وغيرها. + +بمجرد تنزيل حزم البيانات، يمكنك وضعها في مجلد `datapacks` في مجلد العالم في الخادم لتطبيقها. +إذا لم يكن هناك مجلد، يمكنك إنشاؤه لإضافة الحزم. + +{% hint style="warning" %} + +**في بعض [حزم البيانات](#user-content-fn-2)[^2]، قد لا تعمل بشكل صحيح عند التطبيق الأول.** + +للتأكد من ذلك، يُوصى بإعادة تشغيل الخادم **مرتين**. + +{% endhint %} + +حزم البيانات يمكن أن تتلف بسهولة مع تحديثات Minecraft. + +خاصة عند تلف حزم البيانات بشكل كامل، يمكن أن يؤدي ذلك إلى تعطل الخادم، +لذا من المهم إجراء اختبارات كافية قبل تحديث الخادم. + +{% hint style="info" %} + +**يمكنك تعطيل جميع حزم البيانات وبدء الخادم بإدخال `safeMode` بعد أمر بدء التشغيل.** + +[لمزيد من التفاصيل، انظر `المراجع > الوسائط والخصائص`.](../reference/arguments.md) + +{% endhint %} + +يمكنك التحقق من الحزم المطبقة باستخدام الأمر `/datapack list`. + +*** + +[^1]: أو إضافة Minecraft: Bedrock Edition. + +[^2]: إضافة مجموعات جديدة من الكائنات والتحديات. diff --git a/ar/origin/plazma/administration/getting-started/next-step.md b/ar/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..5ca834181 --- /dev/null +++ b/ar/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: تعرف على كيفية تخصيص الخادم. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +فيما يلي بعض الطرق لتخصيص واستخدام Plazma. + +## تعديل التكوين + +أساسيات تخصيص Plazma هي تعديل التكوين مباشرة. + +Plazma يوفر إعدادات تكوين قوية تتضمن آليات اللعبة وخصائص المخلوقات. + +يرجى الرجوع إلى الصفحة التالية لمزيد من المعلومات حول تكوين Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## استخدام الإضافات + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +هذا هو السبب الرئيسي لاستخدام Plazma وأقوى طريقة لتخصيص Plazma. بيئة الإضافات القوية لـ Plazma تسمح بتخصيص الخادم بسهولة. + +هناك عدة طرق للبحث عن الإضافات وتنزيلها. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +هناك العديد من الخدمات المستخدمة لتنزيل الإضافات. من بينها، [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) وغيرها من الخدمات تخضع الإضافات لعملية تقييم قبل تحميلها، ويتم التعامل مع الإضافات غير الآمنة على الفور لضمان تداول الإضافات الآمنة فقط. + +### تطبيق الإضافات + +بمجرد تنزيل الإضافات، الآن حان الوقت لتطبيقها. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. ضع الملف الذي تم تنزيله في مجلد `plugins` في مجلد الخادم وأعد تشغيل الخادم. +3. عند بدء تشغيل Plazma، ستظهر محتويات جديدة على الواجهة. هذا يعني أن Plazma قد قامت بتحميل الإضافات بنجاح. +4. حتى إذا تم تحميل الإضافات بنجاح، قد لا تبدأ الإضافات بالعمل. يمكنك استخدام الأمر `/plugins` لعرض الإضافات المحملة حاليًا على الخادم. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +إذا لم يتم تحميل الإضافات بشكل صحيح، يمكنك العثور على حلول للمشكلة في الصفحة التالية. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## استخدام حزم البيانات + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +من خلال حزم البيانات، يمكنك إجراء تعديلات على جزء من اللعبة مثل إضافة مجموعات جديدة من الكائنات والتحديات. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +بعض حزم البيانات المعطوبة يمكن أن تلحق ضررًا بالعالم، وهذا لا يمكن التراجع عنه. + +لذلك، يُنصح بعمل نسخ احتياطية للعالم قبل تطبيق حزم البيانات. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +بمجرد تنزيل حزم البيانات، يمكنك وضعها في مجلد `datapacks` في مجلد العالم في الخادم لتطبيقها. إذا لم يكن هناك مجلد، يمكنك إنشاؤه لإضافة الحزم. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +للتأكد من ذلك، يُوصى بإعادة تشغيل الخادم **مرتين**. +{% endhint %} + +حزم البيانات يمكن أن تتلف بسهولة مع تحديثات Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +يمكنك التحقق من الحزم المطبقة باستخدام الأمر `/datapack list`. + +*** + +## التحسينات + +تم تطبيق العديد من تصحيحات التحسين على Plazma. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## الوكيل + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +لمزيد من المعلومات حول ضبط الوكيل بشكل آمن وصحيح، يرجى الرجوع إلى الصفحة أدناه. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## الأمان + +تطورت Minecraft إلى درجة يمكن للمستخدمين العثور بسهولة على [محرك هجوم الثغرات](#user-content-fn-3)[^3] عبر الإنترنت. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### ضبط الأذونات + +قد تحتوي أوامر الإدارة لبعض الإضافات على ثغرات إذا لم يتم ضبط الأذونات بشكل صحيح. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### منع X-Ray + +يُعتبر X-Ray واحدة من الثغرات التي يمكن استغلالها بسهولة حتى في عملاء التحسين الأساسيين. + +توفر Plazma تكوينًا يمكن من خلاله منع X-Ray بشكل افتراضي. + +يرجى الرجوع إلى الصفحة أدناه لمزيد من التفاصيل حول كيفية منع X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### القائمة البيضاء + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +لعرض اللاعبين المسموح لهم بالوصول، استخدم `/whitelist query`. + +*** + +[^1]: أو إضافة Minecraft: Bedrock Edition. + +[^2]: إضافة مجموعات جديدة من الكائنات والتحديات. + +[^3]: يُشار عادةً إلى ذلك باسم "التعديل". + +[^4]: قد لا تكون الثغرات محظورة في حال عدم تحسين التكوين أو كون Plazma قديمًا أو وجود ثغرات جديدة. + +[^5]: يتم الوصول إلى الخادم عندما يقوم اللاعبون بالاتصال من خلال خادم الوكيل Ngrok، ويتم تغيير عنوان Ngrok الصادر مع كل إعادة تشغيل. diff --git a/ar/origin/plazma/administration/reference/README.md b/ar/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..e9e994d66 --- /dev/null +++ b/ar/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: تعرف على طرق تخصيص Plazma الأساسية المقدمة. +--- + +# 📜 리퍼런스 + +تقدم Plazma العديد من طرق التخصيص المختلفة. + +من بينها، هذه الطرق الأربعة يمكن استخدامها مباشرة دون الحاجة إلى أي عمل إضافي. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[الخادم الرسمي لديسكورد](https://discord.gg/MmfC52K8A8) أو من خلال [مناقشات GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)، جرب أن تسأل المجتمع! +{% endhint %} + +*** + +## 🖥️ الأوامر + +> تسمح الأوامر بجمع المعلومات داخل اللعبة أو تخصيص بيئة اللعب للمستخدم. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ الصلاحيات + +> تحدد الصلاحيات نطاق تفاعل اللاعبين. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ المعاملات والخصائص + +> المعاملات والخصائص تؤثر بشكل عام على عمل Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 الإعداد + +> الإعداد هو أساس طريقة تخصيص Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ar/origin/plazma/administration/reference/arguments.md b/ar/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..81697bc40 --- /dev/null +++ b/ar/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: تعرف على معلمات البداية وخصائص النظام. +--- + +# 🎛️ معلمات البداية والخصائص + +المعاملات البدئية والخصائص النظامية هي قيم تُضاف إلى [الأوامر المستخدمة](#user-content-fn-1)[^1] في تشغيل Plazma، وتؤثر بشكل عام على عمل Plazma. + +[위치 추가 명령어](#user-content-fn-2)[^2]에 따라 **시작 매개변수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## خصائص النظام + +تُدخل خصائص النظام قبل `-jar` لتُعالج في JVM قبل تهيئة Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### كيفية الاستخدام + +يُدخل خصائص النظام كوسيطة أمر Java بين `java` و`-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` يشير إلى أن هذه السمة ليست مضمنة في JVM وإنما هي سمة مخصصة لـ Plazma، + +속성에 아무 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### جميع خصائص النظام + +#### `convertLegacySigns` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يقوم بتحديث تنسيقات اللافتات المتوقفة. + +#### `debug.entities` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يُفعل سجل التصحيح المتعلق بمعلومات الكيانات. + +#### `debug.rewriteForIDE` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل تفعيل مراجعة NMS ليمكن IDE من استيراد المعلومات بشكل صحيح،\ +وإعادة تعيين معلومات الإصدار الداخلي تلقائيًا. + +#### `disable.watchdog` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل نظام تحذير Watchdog في Spigot. + +#### `letMeReload` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل رسالة تأكيد أمر `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +إذا كنت مطورًا لمكون إضافي وتحتاج إلى تحديثه، استخدم الهوت سواب بدلاً من `/reload`. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل نظام ترتيب الفئات الإضافية. + +يكون مفيدًا في حالة حدوث مشاكل في شيد الإضافات. + +#### `Paper.disableFlushConsolidate` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل نظام تجميع Netty flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **القيمة الافتراضية**: `750` + +يقسم الكيانات الزائدة لترسل عبر حزم متعددة. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **القيمة الافتراضية**: `8192` + +يحدد حجم أقصى للحزم التي يمكن للخادم استقبالها في مرة واحدة. + +#### `Paper.ignoreJavaVersion` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل التحقق من إصدار Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +قد يؤدي ذلك إلى تلف دائم في الملفات مثل العالم، وتعطيل ميكانيكية اللعبة بأكملها. + +يتحمل المستخدم كل المشاكل التي تنشأ عن استخدامه لهذا، ولا تقدم Plamza أي دعم لهذا. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **القيمة الافتراضية**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **القيمة الافتراضية**: `80` + +يحدد الحد الأقصى لعدد الأحرف التي يمكن إدخالها في سطر لافتة. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **القيمة الافتراضية**: `(إصدار العالم) + 1` + +يحدد إصدار المعلومات الأولية للتحديثات التي يجب تطبيقها أولاً. + +يكون مفيدًا في حالة الحاجة إلى تحديث كميات كبيرة من الشنكات، ولا يستخدم في الحالات الأخرى. + +#### `Paper.parseYamlCommentsByDefault` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `True` + +يفعل معالجة تعليقات ملف YAML تلقائيًا. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **القيمة الافتراضية**: `30` + +عندما لا يتم استقبال أي بيانات من اللاعب لمدة (ثانية) محددة، يتم طرد اللاعب. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تجاهل تعليقات خصائص الخادم. + +#### `Paper.debug-sync-loads` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تمكين سجلات التصحيح لإنشاء شحنات متزامنة. + +#### `Paper.enable-sync-chunk-writes` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تمكين نظام [إنشاء الشحنات الأساسي](#user-content-fn-10)[^10] في ماين كرافت. + +يؤدي هذا إلى تأخير أداء كبير نظرًا للقيام بحفظ كل شحنة بترتيب. + +#### `Paper.explicit-flush` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تمكين تفريغ الشبكة بشكل صريح. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `false` + +يعطل تسمية Plazma ويستخدم رمزاً أساسيًا للخادم. + +#### `Plazma.useVanillaConfiguration` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `false` +- **تعارض**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +يمكن أن يؤثر هذا بشكل كبير على سلامة الخادم وأدائه. + +جميع المشاكل التي تنشأ عن استخدام هذه الخاصية تقع على عاتق مدير الخادم. +{% endhint %} + +يقدم التكوين الأول باستخدام القيم الافتراضية المقدمة من Mojang. + +يعطل جميع تصحيحات الثغرات التي تم تطبيقها من قبل Paper. + +يمكن إعادة تفعيل تصحيحات الثغرات في تكوين Paper أو تكوين Plazma. + +#### `Plazma.vanillaize` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `true` +- **تعارض**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +يضبط التكوين الأول ليكون أقرب إلى البيئة الأصلية. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### الخاصية متوقفة عن الاستخدام + +الخصائص النظامية التالية هي خصائص متوقفة عن الاستخدام. + +#### `timings.bypassMax` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `false` +- **متوقف عن الاستخدام**: بعد إزالة Timings من Plazma + +تحديد ما إذا كان يمكن تجاوز الحد الأقصى للقيم التي يمكن نقلها إلى واجهة برمجة التطبيقات لـ Aikar. + +إذا لم يتم معالجة الاستثناء في API، سيتم تطبيق حد السرعة. + +*** + +## معلمة البداية + +تُدخل المعلمة البداية بعد `-jar *.jar` لتهيئة Plazma ومعالجتها مع القيمة. + +### كيفية الاستخدام + +تُدخل الخصائص النظامية كوسيطات برنامج بعد `-jar *.jar`. + +على سبيل المثال، إذا كنت ترغب في تطبيق معلمة البداية `nogui`،\ +يمكنك إدخالها كالتالي لتعالج Plazma المعلمة `nogui` أثناء التهيئة. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### المعلمة الكاملة للبداية + +#### `bukkit-settings` + +- **الاسم المستعار**: `b` +- **القيمة الافتراضية**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **الاسم المستعار**: `c` +- **القيمة الافتراضية**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **الاسم المستعار**: `c` +- **القيمة الافتراضية**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +ابدأ الخادم بعالم العرض. + +#### `eraseCache` + +احذف ملفات الذاكرة المؤقتة المتبقية بعد ترقية العالم. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **الاسم المستعار**: `?` + +اعرض المعلمات الكاملة لبداية Plazma وشرحها. + +#### `initSettings` + +أنشئ ملف التكوين فقط وأغلق الخادم. + +#### `jfrProfile` + +تمكين تحليل الأداء JFR. + +#### `max-players` + +- **الاسم المستعار**: `s`, `size` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +قم بتعطيل لوحة واجهة الرسوميات. + +#### `nojline` + +قم بتعطيل JLine واستخدام واجهة الأوامر الافتراضية. + +#### `وضع-الانترنت` + +- **الاسم المستعار**: `o` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يختار ما إذا كان سيرقص اللاعبين مع خادم التحقق من Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **الاسم المستعار**: `paper` +- **القيمة الافتراضية**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +يحدد موقع ملف تكوين PaperSpigot الذي تم إيقاف استخدامه. + +يتم استخدام ذلك لنقل التكوين القديم إلى ملف تكوين جديد وبعد ذلك لم يعد مستخدمًا. + +#### `paper-settings-directory` + +- **الاسم المستعار**: `paper-dir` +- **القيمة الافتراضية**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **الاسم المستعار**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **الاسم المستعار**: `p` +- **القيمة الافتراضية**: `plugins` + +يحدد موقع مجلد الإضافات. + +#### `pufferfish-settings` + +- **الاسم المستعار**: `pufferfish` +- **القيمة الافتراضية**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **الاسم المستعار**: `purpur` +- **القيمة الافتراضية**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `وضع-آمن` + +(وضع آمن) يبدأ الخادم بحالة فانيليا كاملة. + +#### `عنوان-الخادم` + +- **الاسم المستعار**: `h`, `host` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `منفذ-الخادم` + +- **الاسم المستعار**: `p`, `port` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يحدد منفذ الخادم. + +#### `اسم-الخادم` + +- **القيمة الافتراضية**: `خادم Plazma` + +يحدد اسم الخادم. + +#### `spigot-settings` + +- **الاسم المستعار**: `S` +- **القيمة الافتراضية**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `النسخة` + +- **الاسم المستعار**: `v` + +يطبع إصدار Plazma. + +#### `مجلد-العالم` + +- **الاسم المستعار**: `W`, `universe`, `world-container` +- **القيمة الافتراضية**: `(مجلد الخادم)` + +يحدد موقع حفظ ملفات العالم. + +#### `اسم-العالم` + +- **الاسم المستعار**: `w`, `world` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يحدد اسم ملف العالم. + +*** + +[^1]: `جافا (...) -jar server.jar (...)` + +[^2]: يتغير موقع معالجة الوسيط اعتمادًا على الموقع الذي يتم إضافته. + +[^3]: على سبيل المثال، عندما تريد تعيين (تنشيط) `Plazma.iKnowWhatIAmDoing` إلى `true`، يمكنك كتابة `-DPlazma.iKnowWhatIAmDoing` بدلاً من `-DPlazma.iKnowWhatIAmDoing=true` وستعمل بنفس الطريقة. + +[^4]: على سبيل المثال، `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: جهاز استشعار الأحداث. + +[^6]: جهاز استشعار الأحداث. + +[^7]: عميل. + +[^8]: إشارة تعلن عن اتصال صحيح بين الخادم والقلب. + +[^9]: باستخدام ميزة طرد AFK في Purpur، يمكن طرد اللاعبين الغائبين. + +[^10]: نظام كتابة شظايا متزامن، Sync Chunk Write System. + +[^11]: `تحذير! قد يسبب Plazma مشاكل غير متوقعة، لذا تأكد من اختباره بشكل جيد قبل استخدامه على خادم عام.` + +[^12]: يعمل 'أفضلية العالم' في اللعبة بنفس المبدأ. + +[^13]: يستثنى المشرفون من 'المستوى 2' وما فوق. + +[^14]: بروتوكول الإنترنت، IP. diff --git a/ar/origin/plazma/administration/reference/commands.md b/ar/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..5847e4add --- /dev/null +++ b/ar/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: تعرف على الأوامر المتاحة في Plazma. +--- + +# 🖥️ الأوامر diff --git a/ar/origin/plazma/administration/reference/configurations/README.md b/ar/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..e3669848f --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: الإعداد هو أساس طريقة تخصيص Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 الخصائص + +> الخصائص هي أبسط ملف تكوين يقدمه Minecraft. باستخدام الخصائص، يمكنك تغيير الآليات الأساسية للعبة. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 تكوين Bukkit + +> تكوين Bukkit هو أبسط ملف تكوين يقدمه Plazma. باستخدام تكوين Bukkit، يمكنك تغيير الآليات الأساسية لخادم Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 تكوين Spigot + +> تكوين Spigot يسمح بتعديل تفاصيل اللعبة، معالجة اللاعبين، عمل الأوامر والرسائل وغيرها. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ تكوين Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 تكوين Pufferfish + +> تكوين Pufferfish يمكن تغيير معالجة العوالم والكائنات في Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 تكوين Purpur + +> تكوين Purpur يسمح بتعديل البيانات الأساسية للعبة بشكل شامل. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ تكوين Plazma + +> تكوين Plazma يسمح بتخصيص وظائف Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ar/origin/plazma/administration/reference/configurations/bukkit.md b/ar/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..58812d13f --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: اكتشف ما يعنيه كل عقد في bukkit.yml. +--- + +# 🪣 بوكيت diff --git a/ar/origin/plazma/administration/reference/configurations/paper/README.md b/ar/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b5d47aa3b --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: تحقق من غرض كل ملف في مجلد config. +--- + +# 🛩️ ورقة diff --git a/ar/origin/plazma/administration/reference/configurations/paper/global.md b/ar/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..cd545b4e3 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقد في paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ar/origin/plazma/administration/reference/configurations/paper/world.md b/ar/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..8a445b4de --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: تحقق من معنى كل عقد في paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +العالمي diff --git a/ar/origin/plazma/administration/reference/configurations/plazma/README.md b/ar/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..090065c49 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: تحقق من غرض كل ملف في مجلد config. +--- + +# ✨ بلازما diff --git a/ar/origin/plazma/administration/reference/configurations/plazma/global.md b/ar/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..dd9e592a2 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ar/origin/plazma/administration/reference/configurations/plazma/world.md b/ar/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..c292278f1 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ar/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ar/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..18c6d364a --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في plazma-world.yml. +--- + +# ✨ Plazma (تكوين العالم) diff --git a/ar/origin/plazma/administration/reference/configurations/property.md b/ar/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..d5cbc8c5b --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في server.properties. +--- + +# 🪨 Server.properties diff --git a/ar/origin/plazma/administration/reference/configurations/pufferfish.md b/ar/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..440d6c7f8 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في pufferfish.yml. +--- + +# 🐡 سمكة البوفريش diff --git a/ar/origin/plazma/administration/reference/configurations/purpur/README.md b/ar/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..c858a8125 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: اكتشف معنى كل عقد في purpur.yml. +--- + +# 🦑 بوربور diff --git a/ar/origin/plazma/administration/reference/configurations/purpur/global.md b/ar/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..94857dc21 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: اكتشف معنى كل عقد في purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/ar/origin/plazma/administration/reference/configurations/purpur/world.md b/ar/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..491644192 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: اكتشف معنى كل عقد في purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ar/origin/plazma/administration/reference/configurations/spigot.md b/ar/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..c4a1c5886 --- /dev/null +++ b/ar/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقد في spigot.yml. +--- + +# 🚰 سبيجوت diff --git a/ar/origin/plazma/administration/reference/permissions.md b/ar/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..95eee3bd9 --- /dev/null +++ b/ar/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: تعرف على أذونات Plazma. +--- + +# 🛡️ أذونة + +الصلاحيات هي أداة أمان بسيطة تحدد نطاق تفاعل اللاعب داخل الخادم. + +يجب استخدام الإضافات مثل [LuckPerms](https://luckperms.net) للاستفادة الكاملة من الصلاحيات وتعديلها بسهولة. + +*** + +## فهم نظام الصلاحيات الأساسي + +يوفر Minecraft مجموعات صلاحيات إدارية أساسية. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **اللاعب**\ + هو مجموعة صلاحيات تُمنح عادة لجميع اللاعبين. +2. **الوسيط**\ + يمكن تجاهل حماية الانبعاث. +3. **مدير العالم**\ + يمكن استخدام جميع الأوامر وكتل الأوامر المتعلقة بإدارة العالم.\ + هو مجموعة صلاحيات تُطبق افتراضيًا على حزم البيانات وكتل الأوامر. +4. **المدير**\ + يمكن استخدام جميع الأوامر المتعلقة بإدارة اللاعبين. +5. **المدير العام**\ + يمكن استخدام جميع الأوامر، بما في ذلك إدارة الخادم.\ + هو مجموعة صلاحيات تُطبق افتراضيًا على وحدة التحكم والمشرفين. + +*** + +## تعيين الصلاحيات + +*** + +## الصلاحيات الكاملة + +*** + +#### `allow.ride.(Namespaced Key)` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بالانحناء والتفاعل مع الكيان لركوبه. + +عند ركوب الكيان، يمكن للاعب التحكم في حركة الكيان باستخدام مفاتيح الحركة، والقفز أو التحليق باستخدام مفتاح القفز. + +يتم إدخال [Namespaced ID](#user-content-fn-2)[^2] للكيان في `(Namespaced Key)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب باستخدام مهارات الكيان أثناء ركوبه. + +ليست جميع مهارات الكيان متاحة. يرجى الرجوع إلى القائمة الكاملة للمهارات الخاصة المتاحة. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +نشر أفكارك على [Plazma Discord](https://plazmamc.org/discord) أو [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +عرض المهارات الخاصة المتاحة حاليًا + +- **`crepper`**\ + عند الضغط على مفتاح القفز، سينفجر.\ + إذا كان للاعب أذونة `allow.powered.creeper`، فيمكنه الضغط المطول على مفتاح القفز للشحن. +- **`dolphin`**\ + عند الضغط على مفتاح القفز، سيقوم بالاندفاع. +- **`phantom`**\ + عند الضغط على مفتاح القفز، سيطلق اللهب. +- **`wither`**\ + عند التفاعل، سيطلق رأس الويذر. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/compass` الأمر](commands.md#compass). + +#### `bukkit.command.credits` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/credits (Player)` الأمر](commands.md#credits). + +عند كتابة `.other` بعد اسم الإذن، يسمح بالاستخدام للاعب آخر. + +#### `bukkit.command.demo` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/demo (Player)` الأمر](commands.md#demo). + +عند كتابة `.other` بعد اسم الإذن، يسمح بالاستخدام للاعب آخر. + +#### `bukkit.command.ping` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/ping (Player)` الأمر](commands.md#ping). + +عند كتابة `.other` بعد اسم الإذن، يسمح بالاستخدام للاعب آخر. + +#### `bukkit.command.ram` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/ram` الأمر](commands.md#ram). + +#### `bukkit.command.rambar` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/rambar (Player)` الأمر](commands.md#rambar). + +عند كتابة `.other` بعد اسم الإذن، يسمح بالاستخدام للاعب آخر. + +#### `bukkit.command.restart` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/restart` الأمر](commands.md#restart). + +#### `bukkit.command.tps` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/tps` الأمر](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/tpsbar (Player)` الأمر](commands.md#tpsbar). + +عند كتابة `.other` بعد اسم الإذن، يسمح بالاستخدام للاعب آخر. + +#### `bukkit.command.timings` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/timings` الأمر](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +لمعرفة المزيد عن الأوامر المشابهة، يرجى التحقق من [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام [`/uptime` الأمر](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **الافتراضي**: `مدير العالم` + +يسمح باستخدام الأمر `/gamemode (GameMode) (Player)`. + +عند كتابة `.other` بعد اسم الإذن، يسمح بالاستخدام للاعب آخر. + +#### `paper.antixray.bypass` + +- **الافتراضي**: `لا شيء` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +هذا سيؤدي إلى تحسين الأداء لكلا الجانبين. + +> لمعرفة كيفية ضبط حظر الأشعة السينية، يرجى الرجوع إلى الصفحة التالية. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **الافتراضي**: `لا شيء` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **الافتراضي**: `لا شيء` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **الافتراضي**: `لا شيء` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **الافتراضي**: `لا شيء` + +يسمح باستخدام علامات [MiniMessage](https://docs.advntr.dev/minimessage/format.html) في السنادي. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **الافتراضي**: `لا شيء` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **الافتراضي**: `لا شيء` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **الافتراضي**: `لا شيء` + +يستثني اللاعب من طرد الخمول. + +#### `purpur.debug.f3n` + +- **الافتراضي**: `مدير العالم` + +يسمح للاعب بتغيير وضع اللعبة باستخدام مفتاح `F3 + N`. + +لن يعمل إذا لم يكن لديه الإذن المطلوب لهذا الوضع. + +#### `purpur.drop.spawners` + +- **الافتراضي**: `لا شيء` + +عند تنقيب كتلة البيض، سيتم إسقاط كتلة البيض. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **الافتراضي**: `لا شيء` + +يغير حجم صندوق النهاية. + +يمكن إدخال `one`, `two`, `three`, `four`, `five`, `six` في `(NumberString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **الافتراضي**: `لا شيء` + +يسمح بعمل الصندوق الواقي حتى عند وجود توتم الخلود في المخزن. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بتجاوز الحد الأقصى لعدد اللاعبين المتصلين. + +#### `purpur.mending_shift_click` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بإصلاح العناصر التي يحملها عندما يكون `جلوسًا والتفاعل`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بتثبيت مولدات الوحوش. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بالانتقال على الفور عند استخدام بوابة النيذر. + +#### `purpur.sign.color` + +- **الافتراضي**: `لا شيء` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **الافتراضي**: `لا شيء` + +يسمح باستخدام رمز التشويش `(&o)` على اللافتات. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **الافتراضي**: `لا شيء` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بمنع انفجار TNT عن طريق التفاعل بالمقص. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### الصلاحيات المقررة + +#### `plazma.bypass.ncr-require` + +- **الافتراضي**: `لا شيء` + +يسمح للاعب بالانضمام دون وجود تثبيت لمود [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: المشغل. + +[^2]: مثال: `ender_dragon` diff --git a/ar/origin/plazma/adminstration/README.md b/ar/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..3af28d560 --- /dev/null +++ b/ar/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: "!جرب إنشاء خادم خاص باستخدام Plazma" +--- + +# ⚒️ دليل إدارة الخادم diff --git a/ar/origin/plazma/adminstration/almraja/README.md b/ar/origin/plazma/adminstration/almraja/README.md new file mode 100644 index 000000000..3501e333a --- /dev/null +++ b/ar/origin/plazma/adminstration/almraja/README.md @@ -0,0 +1,2 @@ +# 📜 المراجع + diff --git a/ar/origin/plazma/adminstration/almraja/mlfat-altkwyn/README.md b/ar/origin/plazma/adminstration/almraja/mlfat-altkwyn/README.md new file mode 100644 index 000000000..9bb04f8be --- /dev/null +++ b/ar/origin/plazma/adminstration/almraja/mlfat-altkwyn/README.md @@ -0,0 +1,2 @@ +# 🎨 ملفات التكوين + diff --git a/ar/origin/plazma/adminstration/expert/README.md b/ar/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..c5bb0912a --- /dev/null +++ b/ar/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية التعامل المهني مع Plazma. +--- + +# 🎓 تعمق diff --git a/ar/origin/plazma/adminstration/expert/fix-exploits.md b/ar/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..ca52ab934 --- /dev/null +++ b/ar/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: تعرف على الثغرات المعروفة وكيفية حلها. +--- + +# ⚠️ الثغرات المعروفة وطرق الحل diff --git a/ar/origin/plazma/adminstration/expert/optimize.md b/ar/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..de8107740 --- /dev/null +++ b/ar/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية تحسين Plazma. +--- + +# 🧹 التحسين diff --git a/ar/origin/plazma/adminstration/expert/vanillaize.md b/ar/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..a7c789993 --- /dev/null +++ b/ar/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: تعرف على كيفية استعادة تصحيح Paper و Vanilla. +--- + +# ↩️ التبنيلة + +{% hint style="warning" %} + +### Paper لا تقدم خيارات لمعظم تصحيحات أخطاء Vanilla. + +Plazma حاليًا تعمل على تعطيل تلك التصحيحات كجزء من التكوين. + +لذلك، هذا الدليل لا يزال قيد الكتابة، وقد تتغير المعلومات في أي وقت. +{% endhint %} diff --git a/ar/origin/plazma/adminstration/faq.md b/ar/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..c1bf322cf --- /dev/null +++ b/ar/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: تعرف على الأسئلة المتكررة. +--- + +# ⁉️ الأسئلة المتكررة + +{% hint style="info" %} + +### هل لا تستطيع العثور على الإجابة التي تبحث عنها؟ + +!تواصل مع المجتمع عبر [خادم Discord الرسمي](https://discord.gg/MmfC52K8A8) أو [مشاكل GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues) +{% endhint %} + +### لا يتم تشغيلها مع ظهور رسالة + +إذا ظهرت `no main manifest attribute, in plazma-(version).jar` على الكونسول،\ +فإن الملف الذي تم تنزيله هو ملف API للتطوير، يجب عليك تنزيل **Reobf Paperweight** من صفحة GitHub. + +يرجى الرجوع إلى الصفحة التالية لمزيد من التفاصيل. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### تظهر تحذيرات عند بدء تشغيل الخادم + +يحتوي Plazma على بعض التصحيحات غير المستقرة وقد تعمل بشكل غير صحيح دائمًا، لذا يتم طباعة تحذيرات مثل هذه عند بدء تشغيل الخادم. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +يمكن تعطيل هذه التحذيرات باستخدام خاصية النظام [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +يرجى الرجوع إلى الصفحة التالية لمزيد من التفاصيل. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: متاحة اعتبارًا من الإصدار 1.20.1 diff --git a/ar/origin/plazma/adminstration/getting-started/README.md b/ar/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..87cdfedac --- /dev/null +++ b/ar/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,318 @@ +--- +description: تعرف على كيفية إنشاء خادم باستخدام Plazma. +--- + +# 👟 البدء + +لاستخدام Plazma بشكل مستقر، يجب أن يفي النظام بمتطلبات التالية. + +| | الحد الأدنى | الموصى به | +| :---------------: | ----------: | --------: | +| البنية | x64 | - | +| الذاكرة العشوائية | 8GB | 16GB | +| مساحة التخزين | 1GB | 8GB | +| JRE | 17 | 21 | + +لضمان تعديل ملف التكوين بسهولة، من الجيد تثبيت محرر مثل [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. تثبيت JRE + +كما يوحي الاسم، تم تطوير Minecraft: **"Java"** Edition باستخدام Java، ولذا فإنه يتطلب JRE[^1] للتشغيل. + +نظرًا لأن Plazma مبني على منصة الخوادم الرسمية لشركة Mojang Studios، يجب تثبيت JRE أيضًا لاستخدام Plazma. + +### 1.1 التحقق من وجود JRE + +للتحقق من تثبيت JRE على النظام، افتح نافذة التشغيل واكتب [`cmd /k java --version`](#user-content-fn-4)[^4] وقم بتشغيله. + +إذا كانت النتيجة كما يلي، انتقل إلى [الخطوة 2](setup.md#id-2). + +{% code title="النتيجة الصحيحة" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +إذا لم تكن النتيجة كما السابق أو كانت كما يلي، فهذا يعني أن JRE غير مثبت أو قديم للغاية، ويجب عليك إجراء [الخطوة 1.2](setup.md#id-1.2). + +{% code title="لم يتم تثبيت JRE" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE قديم للغاية" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 تثبيت JRE + +في هذا الدليل، سنستخدم Azul Zulu كـ [أحد أنواع JRE](#user-content-fn-5)[^5]. + +بعد الانتهاء من التثبيت، قم بإعادة تنفيذ [الخطوة 1.1](setup.md#id-1.1) للتحقق من نجاح التثبيت بشكل صحيح. + +{% tabs %} +{% tab title="Windows" %} + +1. أولًا، قم بتنزيل JDK 21 من [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) بتنسيق `.msi`. +2. قم بتشغيل معالج التثبيت الذي تم تنزيله وانقر على `التالي`. +3. بعد ذلك، انتقل إلى القائمة الموجودة في منتصف الجزء الأيسر من النافذة وقم بتفعيل `تعيين متغير JAVA_HOME`، ثم انقر على `التالي`. +4. اضغط على `تثبيت` لإكمال تثبيت JRE. + {% endtab %} + +{% tab title="macOS" %} +قم بتنزيل JDK 21 بتنسيق `.dmg` من [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) ثم قم بتشغيل معالج التثبيت لتثبيت JRE. +{% endtab %} + +{% tab title="ديبيان/أوبونتو" %} +أولاً، قم بتشغيل الأمر التالي في الطرفية لإضافة مستودع Azul Zulu إلى APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +ثم، قم بتشغيل الأمر التالي في الطرفية لتثبيت JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="فيدورا/RHEL" %} +يمكنك تثبيت JRE عن طريق إدخال الأمر التالي. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. تحميل بلازما + +تقدم بلازما مجموعة متنوعة من ملفات التشغيل. + +{% hint style="warning" %} + +### في معظم الحالات، يُستخدم `Reobf Paperclip`. + +المحتوى أدناه موجه لأولئك الذين يرغبون في معرفة المزيد عن المطورين أو خصائص كل نوع. +{% endhint %} + +
+ +تعرف على المزيد + +اسم الملف التنفيذي هو `plazma-(مدير الإصدار)-1.20.4-R0.1-SNAPSHOT-(نوع التعيين).jar`. + +- **نوع التعيين** + التعيين يعد نوعًا من الخريطة التي تربط بين الشفرة الفعلية لـ Minecraft والشفرة المشفرة. + - **Reobf** + إعادة التشفير، يُعرف أيضًا باسم تعيين Spigot ويُستخدم في معظم إضافات NMS. سيتم إيقاف استخدامه ابتداءً من الإصدار 1.20.5. + - **Mojmap** + تعيين Mojang، تعيين Minecraft الأصلي. +- **مدير الإصدار** + مدير الإصدار هو الشخص الذي يمكن أن يُعتبر مشغل الخادم الذي يحتاج إلى مكتبات لتشغيل الخادم وتطبيق تصحيحات على ملفات الخادم. + - **Paperclip** + مدير إصدار Minecraft الأصلي. + - **Bundler** + مدير الإصدار Minecraft الأصلي. + +
+ +*** + +## 3. إنشاء نص بدء + +لبدء بلازما بسهولة وإعادة تشغيل الخادم تلقائيًا، يجب عليك إنشاء [نص بدء](#user-content-fn-6). + +يمكنك إنشاء [نص بدء](#user-content-fn-7) من خلال [Flags.sh](https://flags.sh)\ +بمجرد إدخال [ذاكرة الوصول العشوائي المستخدمة في بلازما](#user-content-fn-8)، سيتم تحسين الأمر تلقائيًا. + +يمكنك تنزيل نص البدء من خلال زر التنزيل في الزاوية السفلى اليسرى.\ +**تأكد من أن نص البدء الذي تم تنزيله متوافق مع نظام التشغيل الخاص بك.** + +*** + +## 4. تنظيف الملفات + +الآن، قم بنقل نص البدء الذي تم تنزيله وبلازما إلى مجلد جديد. + +{% hint style="warning" %} + +### يجب أن يكون اسم المجلد بدون مسافات ويجب أن يكون باللغة الإنجليزية. + +إلا فقد لا تعمل بلازما أو JRE بشكل صحيح. +{% endhint %} + +الآن، قم بتشغيل نص البدء. في حالة نظام Windows، يجب عليك اختيار **السماح** في نافذة اختيار السماح بجدار الحماية. + +*** + +## 5. موافقة EULA + +بمجرد تشغيل نص البدء مرة واحدة، سيتم إنشاء ملف `eula.txt` في المجلد. + +EULA[^9] هو اتفاقية ترخيص يجب عليك الموافقة عليها من خلال استخدام خدمات [Mojang Studios](#user-content-fn-10). + +إذا لم توافق على EULA، فلن تتمكن من بدء الخادم، وفي حالة التجاوز من EULA، قد تتعرض لعقوبات مثل تعليق الحساب. + +للموافقة على EULA، قم بتغيير `eula=false` إلى `eula=true` في ملف `eula.txt` واحفظ التغييرات. + +*** + +## 6. السماح بالوصول الخارجي (Windows) + +تمنع الأنظمة الحديثة من الوصول الخارجي لحماية ضد الوصول الخطير من الخارج عبر جدران الحماية وجهاز التوجيه. + +في حالة نظام Windows، بمجرد تفعيل الوصول في [3 خطوات](setup.md#id-3)، يجب تكوين إعادة توجيه المنفذ فقط. + +{% hint style="info" %} + +### يفترض هذا الدليل استخدام نظام التشغيل Windows و [**UPnP**](#user-content-fn-12) المتاح في جهاز التوجيه. + +إذا كان جهاز التوجيه لا يدعم UPnP، فيجب عليك البحث عن الإعدادات الخاصة بجهاز التوجيه لأنها تختلف حسب الجهاز. + +يمكنك أيضًا إنشاء عنوان مؤقت باستخدام [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} + +### في حالة أنظمة التشغيل بنظام (شبه) UNIX مثل Linux أو macOS، تختلف طرق إعداد خدمة جدار الحماية حسب الخدمة، لذلك يجب عليك البحث عن المعلومات بنفسك. + +{% endhint %} + +### 6.1 التحقق من ضرورة إعادة توجيه المنفذ + +أدخل الأمر التالي في نافذة التشغيل وقم بتشغيله. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +إذا كانت النتيجة `True`، يمكنك الانتهاء هنا، وإذا كانت `False`، فيجب عليك تكوين إعادة توجيه المنفذ. + +### 6.2 الاتصال بالخادم + +{% tabs %} +{% tab title="الوصول من الخارج" %} +إذا لم يكن هناك حاجة لإعداد توجيه المنفذ أو إذا نجحت بالفعل في إعداد توجيه المنفذ، يمكنك الآن الاتصال بالخادم. + +يمكنك التحقق من العنوان المستخدم للوصول إلى الخادم [هنا](https://ip.pe.kr/). +{% endtab %} + +{% tab title="محاولة توجيه المنفذ باستخدام UPnP" %} +في ملف 'purpur.yml' في مجلد الخادم، قم بتمكين 'network.upnp-port-forwarding' إلى 'true'. + +ثم، بعد إعادة تشغيل الخادم، سيحاول Plazma توجيه المنفذ تلقائيًا. + +النجاح أو الفشل في UPnP يعتمد على الرسالة التي تظهر في وحدة التحكم، حيث تظهر على سبيل المثال `[UPnP] (الرسالة)`. + +| رسالة | المعنى | +| ------------------------------ | -------------------------------------- | +| `تم فتح المنفذ بنجاح (المنفذ)` | نجاح توجيه المنفذ. | +| `المنفذ (المنفذ) مفتوح بالفعل` | المنفذ قيد الاستخدام بواسطة خدمة أخرى. | +| `فشل في فتح المنفذ (المنفذ)` | فشل توجيه المنفذ. | +| `الخدمة غير متوفرة` | جهاز التوجيه لا يدعم UPnP. | + +عند إيقاف تشغيل الخادم، سيقوم Plazma تلقائيًا بإغلاق المنافذ. +{% endtab %} + +{% tab title="إنشاء عنوان مؤقت باستخدام Ngrok" %} +طريقة استخدام Ngrok مفيدة للاختبارات القصيرة الأمد، أو اللعب مع الأصدقاء، أو الانضمام إلى اللعب مع الآخرين. + +1. قم بتنزيل ملف ZIP 'Windows (64-bit)' من [موقع Ngrok](https://ngrok.com/download). +2. ضع ملف Ngrok الذي قمت بتنزيله في مجلد الخادم. +3. قم بإنشاء رمز مصادقة من [لوحة تحكم Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. قم بتشغيل الأمر الذي يظهر في 'Command Line' في مجلد الخادم. +5. أضف السطر `start /b ngrok tcp --region jp 25565` في أعلى النص البرمجي، وأضف `taskkill /f /t /im ngrok.exe` في الأسفل. +6. في أعلى وحدة التحكم، ستجد `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`، حيث يكون `0.tcp.jp.ngrok.io:12345` هو عنوان الخادم. +7. يمكنك الآن الاتصال من الخارج باستخدام هذا العنوان. + {% endtab %} + +{% tab title="الوصول من الجهاز المحلي" %} +إذا كنت تحاول الاتصال بالخادم من الجهاز المحلي، قم بتشغيل `cmd /k ipconfig` في نافذة التشغيل للوصول إلى `عنوان IPv4` الذي تم عرضه. + +على سبيل المثال، عندما يتم عرض الناتج بعد تشغيل الأمر، + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +يمكنك الاتصال بالخادم من الجهاز المحلي باستخدام `192.168.3.7` المعروض كعنوان IPv4. + +إذا كان الخادم واللعبة تعملان على نفس الكمبيوتر، يمكنك الاتصال باستخدام 'localhost'. +{% endtab %} +{% endtabs %} + +## 7. مرحلة التطوير + +إذا كنت قد بدأت الخادم بنجاح ويعمل بشكل صحيح، فإن الآن حان وقت تخصيص الخادم. + +تعرف على كيفية تخصيص الخادم من خلال الدليل أدناه. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: بيئة تشغيل Java، بيئة تشغيل Java. + +[^2]: يعتمد Paper الذي يقوم عليه Plazma على Spigot، ويعتمد Spigot على منصة الخادم الرسمية. + +[^3]: مفتاح Windows + R + +[^4]: في حالة Linux، استخدم 'java --version' في الطرفية. + +[^5]: JRE هو مشروع مفتوح المصدر، مثل منصة خوادم Minecraft التي تأتي بأنواع متعددة. + +[^6]: عمومًا يُعرف باسم **مشغل**. + +[^7]: عند تمكين 'إعادة التشغيل التلقائي'، سيتم إعادة تشغيل الخادم تلقائيًا. يمكنك إدخال 'Control + C' للخروج. + +[^8]: لا يُنصح بتجاوز نصف سعة النظام. + + على سبيل المثال، إذا كانت سعة الذاكرة الكلية للنظام 8 جيجابايت، فلا يُنصح بتعيين قيمة تزيد عن 4 جيجابايت. + +[^9]: اتفاقية ترخيص المستخدم النهائي، اتفاقية ترخيص استخدام المستخدم النهائي. لمزيد من التفاصيل، يُرجى زيارة [موقع Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: شركة مايكروسوفت. + +[^11]: في كوريا الجنوبية، وفقًا للمادة 32 (1) (9) من قانون تعزيز صناعة الألعاب، يمكن رفع دعوى قانونية ضد **شركة مايكروسوفت كوريا**. + +[^12]: توصيل وتشغيل عالمي. يتيح Purpur المضمن في Plazma التواصل مع الموجه تلقائيًا باستخدام هذه التقنية، مما يعني أنه ليس هناك حاجة لإعداد توجيه المنفذ يدويًا عند تشغيل الخادم. + +[^13]: إذا لم يكن لديك حساب، يمكنك التسجيل في Ngrok باستخدام حساب Google أو GitHub. diff --git a/ar/origin/plazma/adminstration/getting-started/customization.md b/ar/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..4b60fd136 --- /dev/null +++ b/ar/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: تعرف على كيفية تخصيص الخادم. +--- + +# 🎨 تخصيص المستخدم diff --git a/ar/origin/plazma/adminstration/reference/arguments.md b/ar/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..4b1c95506 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: تعرف على معلمات البداية وخصائص النظام. +--- + +# 🎛️ معلمات البداية والخصائص + +تُمكن معلمات البداية وخصائص النظام من تغيير القيم التي يتم إضافتها إلى تشغيل Plazma بعد التنفيذ،\ +والتي لا يمكن تغييرها بعد تشغيل Plazma. + +تنقسم إلى **معلمات البداية** و**خصائص النظام** وفقًا لمكان إضافتها إلى الأوامر. + +*** + +## خصائص النظام + +تُدخل خصائص النظام قبل `-jar` لتُعالج في JVM قبل تهيئة Plazma. + +{% hint style="warning" %} + +### تعديل خصائص النظام يمكن أن يؤدي إلى تغيير في عمل Plazma وJVM، وقد يؤثر بشكل كبير على اللعبة! + +إذا لم تكن متأكدًا من دور كل خاصية نظامية، **فلا تستخدمها أبدًا!** +{% endhint %} + +### كيفية الاستخدام + +يُدخل خصائص النظام كوسيطة أمر Java بين `java` و`-jar`. + +على سبيل المثال، عند محاولة تطبيق خاصية النظام `Plazma.dummyProperty`،\ +سيتم إدخال القيمة `37` بعد هذه الخاصية لتهيئة Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` يشير إلى أن هذه السمة ليست مضمنة في JVM وإنما هي سمة مخصصة لـ Plazma، + +إذا لم يتم إدخال أي قيمة، سيتم تثبيت القيمة على [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### تحتوي منصات الخادم من سلسلة Paperweight على نقطة في اسم الخاصية لتمييز خصائص النظام لكل منصة. + +في بعض الطرفيات مثل Windows Powershell، قد لا تسمح ببعض هذه السمات، لذا يجب إضافة `"` في كلا الطرفين للسمة.]\(#user-content-fn-4)[^4] +{% endhint %} + +### جميع خصائص النظام + +#### `convertLegacySigns` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يقوم بتحديث تنسيقات اللافتات المتوقفة. + +#### `debug.entities` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يُفعل سجل التصحيح المتعلق بمعلومات الكيانات. + +#### `debug.rewriteForIDE` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل تفعيل مراجعة NMS ليمكن IDE من استيراد المعلومات بشكل صحيح،\ +وإعادة تعيين معلومات الإصدار الداخلي تلقائيًا. + +#### `disable.watchdog` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل نظام تحذير Watchdog في Spigot. + +#### `letMeReload` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل رسالة تأكيد أمر `/reload`. + +{% hint style="danger" %} + +### نظرًا لعدم استقرار أمر `/reload`، فإن جميع المشاكل التي تظهر بعد استخدام `/reload` تكون مسؤولية المستخدم نفسه. + +إذا كنت مطورًا لمكون إضافي وتحتاج إلى تحديثه، استخدم الهوت سواب بدلاً من `/reload`. +{% endhint %} + +#### `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. + +#### `Paper.excessiveTELimit` + +- **النوع**: `Integer` +- **القيمة الافتراضية**: `750` + +يقسم الكيانات الزائدة لترسل عبر حزم متعددة. + +#### `Paper.filterThreshold` + +- **النوع**: `Integer` +- **القيمة الافتراضية**: `8192` + +يحدد حجم أقصى للحزم التي يمكن للخادم استقبالها في مرة واحدة. + +#### `Paper.ignoreJavaVersion` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +يعطل التحقق من إصدار Java. + +{% hint style="danger" %} + +### هذا قد يسمح لـ JVM بالوصول إلى رمز غير موجود! + +قد يؤدي ذلك إلى تلف دائم في الملفات مثل العالم، وتعطيل ميكانيكية اللعبة بأكملها. + +يتحمل المستخدم كل المشاكل التي تنشأ عن استخدامه لهذا، ولا تقدم Plamza أي دعم لهذا. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **النوع**: `Integer` +- **القيمة الافتراضية**: `64` + +يحدد الحد الأقصى لاسم قناة الإضافة. + +#### `Paper.maxSignLength` + +- **النوع**: `Integer` +- **القيمة الافتراضية**: `80` + +يحدد الحد الأقصى لعدد الأحرف التي يمكن إدخالها في سطر لافتة. + +#### `Paper.minPrecachedDatafixVersion` + +- **النوع**: `Integer` +- **القيمة الافتراضية**: `(إصدار العالم) + 1` + +يحدد إصدار المعلومات الأولية للتحديثات التي يجب تطبيقها أولاً. + +يكون مفيدًا في حالة الحاجة إلى تحديث كميات كبيرة من الشنكات، ولا يستخدم في الحالات الأخرى. + +#### `Paper.parseYamlCommentsByDefault` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `True` + +يفعل معالجة تعليقات ملف YAML تلقائيًا. + +#### `Paper.playerConnection.keepAlive` + +- **النوع**: `Integer` +- **القيمة الافتراضية**: `30` + +عندما لا يتم استقبال أي بيانات من اللاعب لمدة (ثانية) محددة، يتم طرد اللاعب. + +عادة ما يستمر اللعب في إرسال [إشارة نبضية](#user-content-fn-8)[^8] إلى الخادم، لذلك لا يتم الطرد، ولكن عندما لا يستجيب اللعب لتعارض الألعاب يعتبر ذلك تعطلًا ويتم طرد اللاعب من الخادم. + +#### `Paper.skipServerPropertiesComments` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تجاهل تعليقات خصائص الخادم. + +#### `Paper.debug-sync-loads` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تمكين سجلات التصحيح لإنشاء شحنات متزامنة. + +#### `Paper.enable-sync-chunk-writes` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تمكين نظام [إنشاء الشحنات الأساسي](#user-content-fn-10)[^10] في ماين كرافت. + +يؤدي هذا إلى تأخير أداء كبير نظرًا للقيام بحفظ كل شحنة بترتيب. + +#### `Paper.explicit-flush` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تمكين تفريغ الشبكة بشكل صريح. + +#### `Paper.strict-thread-checks` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +تسجيل الأخطاء التي تحدث خارج الخط الرئيسي دائمًا. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +إخراج تحذير عندما يكون للمهام المجدولة تأخير زائد. + +#### `Paperclip.patchOnly` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `False` + +عند استخدام الملف التنفيذي المضمن، يتم تطبيق التصحيح فقط دون بدء الخادم. + +#### `Plazma.aggressiveOptimize` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `false` + +{% hint style="warning" %} + +### سيتم نقل هذه الخاصية كمعلمة بدء بعد الإصدار 1.20.5. + +{% endhint %} + +تطبيق تحسينات التكوين التي تطبق عند بدء التشغيل بشكل أكثر صرامة. + +عند التفعيل، يصبح الخادم أسرع وأكثر أمانًا ولكن قد يؤدي إلى حظر بعض الحيل أو تأثير كبير على اللعب. + +#### `Plazma.iKnowWhatIAmDoing` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `false` + +كبح تحذيرات بدء تشغيل Plazma. + +### الخاصية متوقفة عن الاستخدام + +الخصائص النظامية التالية هي خصائص متوقفة عن الاستخدام. + +#### `timings.bypassMax` + +- **النوع**: `Boolean` +- **القيمة الافتراضية**: `false` +- **متوقف عن الاستخدام**: بعد إزالة Timings من Plazma + +تحديد ما إذا كان يمكن تجاوز الحد الأقصى للقيم التي يمكن نقلها إلى واجهة برمجة التطبيقات لـ Aikar. + +إذا لم يتم معالجة الاستثناء في API، سيتم تطبيق حد السرعة. + +*** + +## معلمة البداية + +تُدخل المعلمة البداية بعد `-jar *.jar` لتهيئة Plazma ومعالجتها مع القيمة. + +### كيفية الاستخدام + +تُدخل الخصائص النظامية كوسيطات برنامج بعد `-jar *.jar`. + +على سبيل المثال، إذا كنت ترغب في تطبيق معلمة البداية `nogui`،\ +يمكنك إدخالها كالتالي لتعالج Plazma المعلمة `nogui` أثناء التهيئة. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### المعلمة الكاملة للبداية + +#### `bukkit-settings` + +- **الاسم المستعار**: `b` +- **القيمة الافتراضية**: `bukkit.yml` + +تعيين اسم وموقع [ملف تكوين بوكيت](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **الاسم المستعار**: `c` +- **القيمة الافتراضية**: `commands.yml` + +تعيين اسم وموقع [ملف تكوين أوامر بوكيت](../reference/configurations/bukkit.md). + +#### `config` + +- **الاسم المستعار**: `c` +- **القيمة الافتراضية**: `server.properties` + +تعيين اسم وموقع [ملف خصائص الخادم](../reference/configurations/property.md). + +#### `demo` + +ابدأ الخادم بعالم العرض. + +#### `eraseCache` + +احذف ملفات الذاكرة المؤقتة المتبقية بعد ترقية العالم. + +#### `forceUpgrade` + +قم بترقية العالم بشكل قسري دون النظر في الإصدار. + +#### `help` + +- **الاسم المستعار**: `?` + +اعرض المعلمات الكاملة لبداية Plazma وشرحها. + +#### `initSettings` + +أنشئ ملف التكوين فقط وأغلق الخادم. + +#### `jfrProfile` + +تمكين تحليل الأداء JFR. + +#### `max-players` + +- **الاسم المستعار**: `s`, `size` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +تعيين الحد الأقصى المسموح به لعدد اللاعبين. + +#### `nogui` + +قم بتعطيل لوحة واجهة الرسوميات. + +#### `nojline` + +قم بتعطيل JLine واستخدام واجهة الأوامر الافتراضية. + +#### `وضع-الانترنت` + +- **الاسم المستعار**: `o` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يختار ما إذا كان سيرقص اللاعبين مع خادم التحقق من Mojang. + +**قد تتعرض لعقوبات إذا لم تلتزم بـ [EULA](../getting-started/README.md#id-5) إذا لم تستخدم Velocity أو بروكسي آخر.** + +#### `paper-settings` + +- **الاسم المستعار**: `paper` +- **القيمة الافتراضية**: `paper.yml` + +{% hint style="warning" %} + +### تم إيقاف استخدام هذه الوظيفة بعد 1.19.4 + +{% endhint %} + +يحدد موقع ملف تكوين PaperSpigot الذي تم إيقاف استخدامه. + +يتم استخدام ذلك لنقل التكوين القديم إلى ملف تكوين جديد وبعد ذلك لم يعد مستخدمًا. + +#### `paper-settings-directory` + +- **الاسم المستعار**: `paper-dir` +- **القيمة الافتراضية**: `config` + +يحدد اسم وموقع مجلد يحتوي على [ملف تكوين Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **الاسم المستعار**: `plazma-dir` + +يحدد اسم وموقع مجلد يحتوي على [ملف تكوين Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **الاسم المستعار**: `p` +- **القيمة الافتراضية**: `plugins` + +يحدد موقع مجلد الإضافات. + +#### `pufferfish-settings` + +- **الاسم المستعار**: `pufferfish` +- **القيمة الافتراضية**: `pufferfish.yml` + +يحدد اسم وموقع [ملف تكوين Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **الاسم المستعار**: `purpur` +- **القيمة الافتراضية**: `purpur.yml` + +يحدد اسم وموقع [ملف تكوين Purpur](../reference/configurations/purpur/README.md). + +#### `وضع-آمن` + +(وضع آمن) يبدأ الخادم بحالة فانيليا كاملة. + +#### `عنوان-الخادم` + +- **الاسم المستعار**: `h`, `host` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يحدد اسم مضيف الخادم أو عنوان [بروتوكول الإنترنت](#user-content-fn-13)[^13]. + +#### `منفذ-الخادم` + +- **الاسم المستعار**: `p`, `port` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يحدد منفذ الخادم. + +#### `اسم-الخادم` + +- **القيمة الافتراضية**: `خادم Plazma` + +يحدد اسم الخادم. + +#### `spigot-settings` + +- **الاسم المستعار**: `S` +- **القيمة الافتراضية**: `spigot.yml` + +يحدد اسم وموقع [ملف تكوين Spigot](../reference/configurations/spigot.md). + +#### `النسخة` + +- **الاسم المستعار**: `v` + +يطبع إصدار Plazma. + +#### `مجلد-العالم` + +- **الاسم المستعار**: `W`, `universe`, `world-container` +- **القيمة الافتراضية**: `(مجلد الخادم)` + +يحدد موقع حفظ ملفات العالم. + +#### `اسم-العالم` + +- **الاسم المستعار**: `w`, `world` +- **القيمة الافتراضية**: `(خصائص الخادم)` + +يحدد اسم ملف العالم. + +*** + +[^1]: `جافا (...) -jar server.jar (...)` + +[^2]: يتغير موقع معالجة الوسيط اعتمادًا على الموقع الذي يتم إضافته. + +[^3]: على سبيل المثال، عندما تريد تعيين (تنشيط) `Plazma.iKnowWhatIAmDoing` إلى `true`، يمكنك كتابة `-DPlazma.iKnowWhatIAmDoing` بدلاً من `-DPlazma.iKnowWhatIAmDoing=true` وستعمل بنفس الطريقة. + +[^4]: على سبيل المثال، `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: جهاز استشعار الأحداث. + +[^6]: جهاز استشعار الأحداث. + +[^7]: عميل. + +[^8]: إشارة تعلن عن اتصال صحيح بين الخادم والقلب. + +[^9]: باستخدام ميزة طرد AFK في Purpur، يمكن طرد اللاعبين الغائبين. + +[^10]: نظام كتابة شظايا متزامن، Sync Chunk Write System. + +[^11]: `تحذير! قد يسبب Plazma مشاكل غير متوقعة، لذا تأكد من اختباره بشكل جيد قبل استخدامه على خادم عام.` + +[^12]: يعمل 'أفضلية العالم' في اللعبة بنفس المبدأ. + +[^13]: بروتوكول الإنترنت، IP. + +[^14]: يستثنى المشرفون من 'المستوى 2' وما فوق. diff --git a/ar/origin/plazma/adminstration/reference/commands.md b/ar/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..5847e4add --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: تعرف على الأوامر المتاحة في Plazma. +--- + +# 🖥️ الأوامر diff --git a/ar/origin/plazma/adminstration/reference/configurations/bukkit.md b/ar/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..58812d13f --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: اكتشف ما يعنيه كل عقد في bukkit.yml. +--- + +# 🪣 بوكيت diff --git a/ar/origin/plazma/adminstration/reference/configurations/paper/README.md b/ar/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b5d47aa3b --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: تحقق من غرض كل ملف في مجلد config. +--- + +# 🛩️ ورقة diff --git a/ar/origin/plazma/adminstration/reference/configurations/paper/global.md b/ar/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..821a6caf5 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقد في paper-global.yml. +--- + +# 🛩️ ورقة (التكوين العالمي) diff --git a/ar/origin/plazma/adminstration/reference/configurations/paper/world.md b/ar/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..8a0719dff --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقد في paper-world.yml. +--- + +# 🛩️ ورقة (تكوين العالم) diff --git a/ar/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ar/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..090065c49 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: تحقق من غرض كل ملف في مجلد config. +--- + +# ✨ بلازما diff --git a/ar/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ar/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..d60f3080d --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في plazma-global.yml. +--- + +# ✨ Plazma (تكوين عالمي) diff --git a/ar/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ar/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..3d02a58f4 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ تكوين حسب العالم diff --git a/ar/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ar/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..18c6d364a --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في plazma-world.yml. +--- + +# ✨ Plazma (تكوين العالم) diff --git a/ar/origin/plazma/adminstration/reference/configurations/property.md b/ar/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..d5cbc8c5b --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في server.properties. +--- + +# 🪨 Server.properties diff --git a/ar/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ar/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..440d6c7f8 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقدة في pufferfish.yml. +--- + +# 🐡 سمكة البوفريش diff --git a/ar/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ar/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..c858a8125 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: اكتشف معنى كل عقد في purpur.yml. +--- + +# 🦑 بوربور diff --git a/ar/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ar/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..98f070788 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: اكتشف معنى كل عقد في purpur.yml. +--- + +# 🦑 البنفسجي (تكوين عام) diff --git a/ar/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ar/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..160ad8f4f --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: اكتشف معنى كل عقد في purpur.yml. +--- + +# 🦑 Purpur (تكوين العالم) diff --git a/ar/origin/plazma/adminstration/reference/configurations/spigot.md b/ar/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..c4a1c5886 --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: تحقق من معنى كل عقد في spigot.yml. +--- + +# 🚰 سبيجوت diff --git a/ar/origin/plazma/adminstration/reference/permissions.md b/ar/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..69800ee2c --- /dev/null +++ b/ar/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: تعرف على أذونات Plazma. +--- + +# 🛡️ أذونة diff --git a/ar/origin/plazma/developers.md b/ar/origin/plazma/developers.md new file mode 100644 index 000000000..97e05434f --- /dev/null +++ b/ar/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: "!جرب تطوير مشروع الطرف الثالث باستخدام Plazma" +--- + +# ⚙️ دليل المطور diff --git a/ar/origin/thunderbolt/README.md b/ar/origin/thunderbolt/README.md new file mode 100644 index 000000000..316c2e40e --- /dev/null +++ b/ar/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 패치를 Flavor로 구분하여 직접 사용해볼 수 있도록 하는 Plazma 기반 서버 플랫폼입니다. +--- + +# 🌩️ دليل استخدام Thunderbolt diff --git a/ar/origin/volt/README.md b/ar/origin/volt/README.md new file mode 100644 index 000000000..4354de540 --- /dev/null +++ b/ar/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt هو قالب مفتوح المصدر يمكنك من تطوير منصة خادم Paperweight الخاصة بك بناءً على Plazma. +--- + +# ⚡ دليل تطوير Volt diff --git a/bg/origin/README.md b/bg/origin/README.md new file mode 100644 index 000000000..1285d6c5e --- /dev/null +++ b/bg/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Ако имате въпроси, моля, ги задайте чрез Discord или GitHub Дискусии. +--- + +# 🏠 Добре дошли в портала за документи + +{% hint style="info" %} + +**Документите на Plazma в момента са преведени от машина.** + +[![Статус на превода](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) тук може да се включите в превода на документи и да помогнете за подобряването на документацията. + +{% endhint %} + +### Ако възникнат проблеми по време на използването на Plazma, какво да направите? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Интересувате се от Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Искате ли да създадете собствена си сървърна платформа с Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Ако ви трябват повече информация свързана с Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/bg/origin/SUMMARY.md b/bg/origin/SUMMARY.md new file mode 100644 index 000000000..de69e449f --- /dev/null +++ b/bg/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Съдържание + +- [🏠 Добре дошли в портала за документи](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Документация за използване на Plazma](plazma/README.md) +- [❓ Какво е Plazma?](plazma/about/README.md) + - [⬇️ Изтегляне](plazma/about/downloads.md) + - [✅ Състояние на поддържаните версии](plazma/about/supported-versions.md) +- [⚒️ Ръководство за управление на сървъра](plazma/administration/README.md) + - [👟 Започване](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Справка](plazma/administration/reference/README.md) + - [🖥️ Команди](plazma/administration/reference/commands.md) + - [🛡️ Права](plazma/administration/reference/permissions.md) + - [🎛️ Аргументи и свойства](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Свойство](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Глобална конфигурация](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Световни конфигурации](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Глобална конфигурация](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Световни конфигурации](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Глобална конфигурация](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Световни конфигурации](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Експертен режим](plazma/administration/expert/README.md) + - [🧹 Оптимизация](plazma/administration/expert/optimize.md) + - [🔀 Прокси](plazma/administration/expert/proxy.md) + - [↩️ Ванилизация](plazma/administration/expert/vanillaize.md) + - [🩻 Блокиране на X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Уязвимости и тяхното отстраняване](plazma/administration/expert/fix-exploits.md) + - [⁉️ Често задавани въпроси](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Ръководство за разработчици](plazma/developers.md) + - [✏️ Сътрудничество](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Ръководство за използване на Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Ръководство за разработка на Volt](volt/README.md) + +## Разни + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Изтегляне на цялото съдържание](plazma/about/downloads-all.md) diff --git a/bg/origin/miscellaneous/README.md b/bg/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/bg/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/bg/origin/plazma/README.md b/bg/origin/plazma/README.md new file mode 100644 index 000000000..0e4cdb03e --- /dev/null +++ b/bg/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma е отворена платформа за сървъри за Minecraft: Java Edition, която добавя експериментална оптимизация върху хартия и персонализирани функции за игрови механизми." +--- + +# ✨ Документация за използване на Plazma + +## 👋 Добре дошли в документацията на Plazma + +Добре дошли в документацията за използване на Plazma! + +{% hint style="info" %} + +**Не можете ли да решите проблема чрез инструкциите?** + +[Официален сървър на Discord](https://discord.gg/MmfC52K8A8) или задайте въпроси на общността чрез [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Относно Plazma + +> Научете повече за каква платформа е Plazma. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### За администратори + +> Създайте собствен сървър с помощта на Plazma. + +{% content-ref url="administration/" %} +[администрация](administration/) +{% endcontent-ref %} + +### За разработчици + +> Разработете проекти от трети страни с помощта на Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/bg/origin/plazma/about/README.md b/bg/origin/plazma/about/README.md new file mode 100644 index 000000000..ebacbfd59 --- /dev/null +++ b/bg/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Научете повече за каква платформа е Plazma. +--- + +# ❓ Какво е Plazma? + +- **Plazma** е базиран на [Paper](https://github.com/PaperMC/Paper) платформа за сървъри, която взема само предимствата от [Andromeda](https://github.com/EarendelArchived/Andromeda) и [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Винаги се стремим да предоставяме висока стабилност, мощност, бързи актуализации и обширни функции. + +## 📋 Целите на Plazma + +- Постоянно се стремим да станем сървърна платформа с бързи актуализации и висока стабилност. +- Ние се стремим да предоставим обширни функции и мощна производителност, не по-малко от модовата платформа. +- Ние се стремим да създадем свободна платформа, която позволява персонализиране на пачовете на ванилата. + +## ⚙️ Основни характеристики + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Най-бързите актуализации**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) гарантира, че включените пачове в Plazma винаги са актуални, предлагайки най-бързите актуализации сред сървърните платформи на базата на Paper. +6. **Оптимизирани конфигурационни файлове**\ + Конфигурационните файлове по подразбиране са оптимизирани, така че не е необходимо да ги оптимизирате ръчно. +7. **Систематично работещи многонишкови процеси**\ + Асинхронизиране на системни механизми, които не са свързани с механизмите на играта, намалява [времето на забавяне](#user-content-fn-4)[^4] и оптимизира сървъра. +8. **Предотвратяване на излишно използване на памет**\ + Данните с подобни стойности се сливат за намаляване на използването на паметта. + +## ✨ Приложения + +- **Платформа, която обработва дори сложни плъгини правилно**\ + Използва се Plazma на сървъра на разработчика [IPECTER](https://github.com/IPECTER).\ + Собствен плъгин, работещ с NMS и рефлексия, с голям брой сложни и обемни datapacks,\ + приема над 100 играчи без намаляване на производителността. +- **Платформа, която поддържа бърза производителност дори на RPG сървъри**\ + Успешно поддържа 100 играчи без падане на TPS в единичен кластер,\ + и 250 играчи на общо 4 кластера могат да играят комфортно. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Избрана от много стриймъри платформа**\ + Използва се като ведро за участието на гледачите на много стриймъри. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Изтегляне + +Можете да изтеглите Plazma от страницата по-долу. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Искате ли да научите повече за поддържаните версии? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Плъгини за Bukkit, CraftBukkit, Spigot и Paper, Pufferfish, Purpur. + +[^2]: по-долу Microsoft Corporation. + +[^3]: Ако деактивирате системата за чатови сигнализации, чатът ще се обработва изцяло на сървъра и ще предотврати проследяването на чатовете от Mojang. + +[^4]: Време, през което играта спира да работи, за да може системният механизъм да функционира. diff --git a/bg/origin/plazma/about/downloads-all.md b/bg/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..5c1ffa56a --- /dev/null +++ b/bg/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma изпълним файл изтегляне на целия файл +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Версия | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/bg/origin/plazma/about/downloads.md b/bg/origin/plazma/about/downloads.md new file mode 100644 index 000000000..63207cd5e --- /dev/null +++ b/bg/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Изтеглете Plazma сега и го използвайте директно. +--- + +# ⬇️ Изтегляне + +#### Искате ли да научите повече за поддържаните версии? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Изтеглянето по-долу е изпълним файл за обикновени потребители.** + +Ако сте разработчик и се нуждаете от друг вид файл, моля, обърнете се към следната страница. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВерсияИзтегляне
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Изтегляне +
1.20.1 + Изтегляне +
1.19.4 + Изтегляне +
+ +*** diff --git a/bg/origin/plazma/about/patches-list.md b/bg/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..8c01a25e8 --- /dev/null +++ b/bg/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Научете повече за всички функции, добавени към Plazma. +--- + +# 📑 Включени пачове diff --git a/bg/origin/plazma/about/supported-versions.md b/bg/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..e22ab4d02 --- /dev/null +++ b/bg/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Научете се за версията на Minecraft: Java Edition, която се поддържа от Plazma." +--- + +# ✅ Състояние на поддръжката на версията + +{% hint style="info" %} + +**Plazma се разработва след версия 1.19.4 и версии по-малки от 1.19.4 не се разработват.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: +[atv]: https://badge.plazmamc.org/2/поддръжка +[fse]: +[eol]: +[ukn]: +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/нормално +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![в процес на разработка][idv] ![поддръжка][atv] ![прекратена поддръжка на функции][fse] ![поддръжката е прекратена][eol] + +| Версия | Стабилност и поддръжка на функциите | Състояние на сглобяване | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![състояние на сградата](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Състояние на сградата](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Състояние на сградата](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/bg/origin/plazma/administration/README.md b/bg/origin/plazma/administration/README.md new file mode 100644 index 000000000..f1b94f551 --- /dev/null +++ b/bg/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Създайте собствен сървър с помощта на Plazma. +--- + +# ⚒️ Ръководство за управление на сървъри diff --git a/bg/origin/plazma/administration/diagnosis/README.md b/bg/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..7f8fee8cb --- /dev/null +++ b/bg/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Научете как да се справите, когато възникне проблем. +--- + +# 🧾 진단 diff --git a/bg/origin/plazma/administration/diagnosis/plugins.md b/bg/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..4ca2f2ae5 --- /dev/null +++ b/bg/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Научете как да решите проблема, когато плъгинът не работи правилно. +--- + +# 📜 플러그인 diff --git a/bg/origin/plazma/administration/expert/README.md b/bg/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b27f0074d --- /dev/null +++ b/bg/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Научете как да работите професионално с Plazma. +--- + +# 🎓 Advanced diff --git a/bg/origin/plazma/administration/expert/fix-exploits.md b/bg/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..1b4e68c50 --- /dev/null +++ b/bg/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Научете за известните уязвимости и начините за тяхното отстраняване. +--- + +# ⚠️ Известни уязвимости и начини за отстраняване diff --git a/bg/origin/plazma/administration/expert/optimize.md b/bg/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..e826b680c --- /dev/null +++ b/bg/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Научете как да оптимизирате Plazma. +--- + +# 🧹 Оптимизация diff --git a/bg/origin/plazma/administration/expert/proxy.md b/bg/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..a29ffe343 --- /dev/null +++ b/bg/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Научете как да конфигурирате платформата за прокси "Velocity" по безопасен начин. +--- + +# 🔀 Прокси diff --git a/bg/origin/plazma/administration/expert/vanillaize.md b/bg/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..3ea1aa8da --- /dev/null +++ b/bg/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Научете как да възстановите пача на хартия и ванилия. +--- + +# ↩️ Ванилизация + +{% hint style="warning" %} + +**Paper не добавя опции в повечето пачове за оправяне на грешки във ванилата.** + +В момента Plazma разработва конфигурация, която позволява деактивиране на такива поправки. + +Този справочник все още се създава и информацията в него може да се промени по всяко време. + +{% endhint %} diff --git a/bg/origin/plazma/administration/expert/xray.md b/bg/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..4ef3c18b9 --- /dev/null +++ b/bg/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Научете повече за различните вградени методи за блокиране на X-Ray. +--- + +# 🩻 Блокиране на X-Ray diff --git a/bg/origin/plazma/administration/faq.md b/bg/origin/plazma/administration/faq.md new file mode 100644 index 000000000..30a75d55e --- /dev/null +++ b/bg/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Научете повече за често задавани въпроси. +--- + +# ⁉️ Често задавани въпроси + +{% hint style="info" %} + +**Не можете ли да намерите желания отговор?** + +[Официален сървър на Discord](https://discord.gg/MmfC52K8A8) или задайте въпроси на общността чрез [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma не се стартира + +Ако в конзолата се извежда `no main manifest attribute, in plazma-(version).jar`,\ +това означава, че файла, който сте изтеглили, е API файл за разработка и трябва да изтеглите **Reobf Paperweight** от страницата на GitHub. + +За повече информация, вижте следната страница. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Предупреждение се извежда всеки път при стартиране на сървъра + +Plazma включва някои нестабилни поправки и винаги има вероятност за неизправност, поради което извежда това предупреждение при стартиране на сървъра. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Това предупреждение може да бъде деактивирано с помощта на системното свойство [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +За повече информация, вижте следната страница. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: На разположение от версия 1.20.1 diff --git a/bg/origin/plazma/administration/getting-started/README.md b/bg/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..3c9e1dafa --- /dev/null +++ b/bg/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Научете как да създадете сървър с Plazma. +--- + +# 👟 Започване + +За стабилно използване на Plazma, системата трябва да отговаря на следните изисквания. + +| | Минимални | Препоръчителни | +| :------------------------: | --------- | -------------- | +| Архитектура | x64 | - | +| RAM | 8GB | 16GB | +| Пространство за съхранение | 1GB | 8GB | +| JDK | 17 | 21 | + +За улеснение на редакцията на конфигурационни файлове, е добре да инсталирате редактор като [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Правилно изход" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Неразпозната опция: --version +Грешка: Не може да се създаде виртуалната машина Java. +Грешка: Възникна фатално изключение. Програмата ще излезе. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Първоначално изтеглете **JDK 21** от [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) във формат `.msi`. +2. Стартирайте изтегления инсталационен мастър и кликнете `Next`. +3. **Активирайте `Set JAVA_HOME variable` от менюто в средата наляво на прозореца,** след което кликнете `Next`. +4. Натиснете `Install`, за да завършите инсталацията на JRE. + {% крайнаКартка %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% крайнаКартка %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +След това инсталирайте JRE, като изпълните следната команда в терминал. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% крайнаКартка %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% крайнаКартка %} +{% крайниКартки %} + +*** + +## 2. Изтегляне на Plazma + +Plazma предоставя различни видове изпълними файлове. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Научете повече + +Името на изпълнимия файл е `plazma-(версия на управителя)-1.20.4-R0.1-SNAPSHOT-(форма на мапиране).jar`. + +- **Форма на мапиране**\ + Мапирането е вида на карта, която свързва реалния код на Minecraft със затрудненият код. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, мапингът на ваниловия Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Управител на версии**\ + Управителят на версии е лаунчър, който се използва за зареждането на библиотеки и пачването на файлове на сървъра, необходим за стартирането на сървъра. + - **Paperclip**\ + Представлява управител, разработен от екипа на PaperMC за Paper и други платформи, който изтегля библиотеки и прилага пачове към сървъра. + - **Bundler**\ + Управителят на версии на оригиналния Minecraft. + +
+ +*** + +## 3. Създаване на стартиращ скрипт + +За да стартирате Plazma лесно и автоматично да рестартирате сървъра, трябва да създадете [стартиращ скрипт](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Можете да изтеглите стартиращия скрипт чрез бутона за изтегляне в долната лява част.\ +**Уверете се, че изтегленият стартиращ скрипт съответства на операционната ви система.** + +*** + +## 4. Подреждане на файлове + +Сега преместете изтегления стартиращ скрипт и Plazma в нова папка. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Сега стартирайте стартиращия скрипт. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Съгласие с EULA + +След като стартирате стартиращия скрипт, ще бъде създаден файл `eula.txt` в папката. + +EULA[^9] е договор за лицензиране, с който трябва да се съгласите, за да използвате услугите на [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +За да се съгласите с EULA, променете `eula=false` в `eula=true` във файла `eula.txt` и го запазете. + +*** + +## 6. Разрешаване на външен достъп (Windows) + +Съвременните операционни системи по подразбиране блокират външни достъпи с помощта на **защитна стена** и **рутер**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Ако вашият рутер не поддържа UPnP, тъй като панелите на рутерите се различават, трябва да търсите информация самостоятелно. + +Можете също да използвате [Ngrok](https://ngrok.com/), за да създадете временен адрес. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Проверка за необходимост от пренасочване на портове + +Въведете и изпълнете следната команда в командния ред. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ако изходът е `True`, можете да спрете тук, но ако е `False`, трябва да настроите пренасочването на портовете. + +### 6.2 Свързване към сървъра + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Адресът за свързване към сървъра може да бъде проверен [тук](https://ip.pe.kr/). +{% крайнаКартка %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +След това рестартирайте сървъра и Plazma автоматично ще опита да пренасочи портовете. + +Успеха на UPnP се определя от съобщенията, изведени в конзолата, като се използва `[UPnP] (съобщение)`. + +| Съобщение | Значение | +| ----------------------------------- | ------------------------------------------------ | +| `Успешно отворен порт (порт)` | Успешно пренасочване на порта. | +| `Порт (порт) вече е отворен` | Друга услуга използва този порт. | +| `Неуспешно отваряне на порт (порт)` | Неуспешно пренасочване на порта. | +| `Услугата не е достъпна` | Рутера не поддържа UPnP. | + +Когато сървъра се изключи, Plazma автоматично затваря портовете. +{% крайнаКартка %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Изтеглете ZIP файла `Windows (64-bit)` от [Ngrok уебсайт](https://ngrok.com/download). +2. Поставете изтегления Ngrok в папката на сървъра. +3. Генерирайте [уникален токен за удостоверяване](#user-content-fn-13)[^13] от [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Изпълнете командата, която се показва в `Command Line` в папката на сървъра. +5. Добавете `start /b ngrok tcp --region jp 25565` в началото на скрипта и `taskkill /f /t /im ngrok.exe` в края му. +6. Адресът на сървъра ще бъде `0.tcp.jp.ngrok.io:12345` от първия ред на конзолата. +7. Сега можете да се свържете + {% крайнаКартка %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Например, след изпълнение на командата, ако виждате следното, + +```log +Windows IP конфигурация + +Ethernet адаптер Ethernet: + + Суфикс за DNS на връзката. . . . : + IPv4 адрес. . . . . . . . . : 192.168.3.7 + Мрежова маска . . . . . . . : 255.255.255.0 + Основен шлюз . . . . . . : 192.168.3.1 + +``` + +Можете да се свържете със сървъра от локалната мрежа, като опитате да се свържете с адреса `192.168.3.7`, който се появява в IPv4. + +Ако сървърът и играта се изпълняват на същия компютър, можете да използвате `localhost` за достъп. +{% крайнаКартка %} +{% крайниКартки %} + +## 7. Развитие + +След успешно стартиране на сървъра и докато той работи правилно, сега е време да персонализирате сървъра. + +Научете как да персонализирате сървъра си, следвайки това ръководство. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, базиран на Spigot, който от своя страна е базиран на официалната платформа на сървъра Spigot. + +[^3]: Клавиш Windows + R + +[^4]: За Linux използвайте `java --version` в терминала + +[^5]: JRE е един от проектите с отворен код и има множество варианти като платформа за сървър на Minecraft. + +[^6]: Обикновено се нарича **изпълнител**. + +[^7]: Когато активирате функцията "Автоматично рестартиране", сървърът ще се рестартира автоматично. Можете да го спрете, като натиснете `Control + C`. + +[^8]: Не се препоръчва да използвате повече от половината от ресурсите на системата. + + Например, ако общият капацитет на паметта на системата е 8GB, не е препоръчително да настроите повече от 4GB. + +[^9]: Споразумение за лицензионно споразумение с крайния потребител. За повече информация, моля, посетете [уебсайта на Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорация Майкрософт. + +[^11]: В случая с Република Корея, съгласно член 32, параграф 1, точка 9 от Закона за насърчаване на игралната индустрия, **Korean Microsoft Corporation** има право да предприеме правни действия. + +[^12]: Универсална включваема и играбелна технология. Чрез тази технология Purpur, включен в Plazma, автоматично комуникира с рутера и отваря портове само когато сървърът е активен, което означава, че няма нужда от ръчно пренасочване на портове. + +[^13]: При липса на акаунт, се регистрирайте в Ngrok чрез акаунт в Google или GitHub. diff --git a/bg/origin/plazma/administration/getting-started/customization.md b/bg/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..e9cfa3a0e --- /dev/null +++ b/bg/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,114 @@ +--- +description: Научете как да персонализирате сървъра. +--- + +# 🎨 Персонализация на потребителския интерфейс + +Причината да използвате модифицирана платформа на сървъра като Plazma вместо официалната платформа, предоставена от Mojang Studios, е, че можете да извършвате мощно **персонализиране**. + +По-долу са няколко начина за персонализиране и използване на Plazma. + +## Промяна на конфигурацията + +Най-основният начин за персонализиране на Plazma е чрез промяна на конфигурацията. + +Plazma предоставя мощни настройки за конфигурация, включително механизми на играта и свойства на чудовищата. + +За повече информация относно конфигурацията на Plazma, вижте следната страница. + +{% content-ref url="../reference/configurations/" %} +[конфигурации](../reference/configurations/) +{% endcontent-ref %} + +## Използване на допълнения + +{% hint style="успех" %} + +**Plazma поддържа всички плъгини, базирани на Paper.** + +За някои от Spigot плъгините, поради промените в мапирането на Paper от версия 1.20.5, е възможно да не работят, но повечето плъгини, базирани на Paper като Paper, Pufferfish и Purpur, работят нормално на Plazma. Ако не работят правилно, моля [докладвайте проблема тук.](../diagnosis/plugins.md) + +{% endhint %} + +Това е основната причина за използването на Plazma и най-мощният начин за персонализиране на Plazma. +Силната плъгин екосистема на Plazma позволява лесно персонализиране на сървъра. + +Има няколко начина за намиране и изтегляне на плъгини. Някои плъгини се качват в обществени хранилища, докато други се качват на GitHub или собствени сайтове. + +{% hint style="внимание" %} + +**Плъгините имат директен достъп до системата!** + +Преди да приложите плъгин, винаги проверявайте дали е безопасен, използвайки услуги като VirusTotal или изтегляйте плъгини от надеждни източници. + +{% endhint %} + +Има няколко услуги за изтегляне на плъгини. Сред тях, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) извършват проверка преди качване на плъгини, за да осигурят, че се разпространяват само безопасни плъгини. + +### Прилагане на плъгини + +След като сте изтеглили плъгините, е време да ги приложите. + +1. Плъгините са във формат `.jar` или `Java изпълним файл`.\ + Някои плъгини са в компресирани файлове, които трябва да се разархивират. В такъв случай, използвайте файла, който включва `bukkit`, `spigot` или `paper` в името и файлът, който съдържа `fat`. +2. Поставете изтегления файл в папката `plugins` на сървъра и (ре)стартирайте сървъра. +3. При стартиране на Plazma, ще видите ново съдържание в конзолата. + Това означава, че Plazma успешно е заредил плъгините. +4. Въпреки че Plazma е заредил плъгините успешно, те може да не са стартирали правилно. + С командата `/plugins` можете да видите заредените плъгини на сървъра. + Ако името на плъгина не е червено, а е зелено, то плъгинът е зареден успешно. + +Ако плъгините не са заредени правилно, можете да намерите решение на следната страница. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Използване на данни + +Данните са начин за персонализиране на Minecraft, подобно на [ресурсни пакети](#user-content-fn-1)[^1]. + +С данни може да се добавят нови видове същества и предизвикателства в играта, като се променят части от нея. + +{% hint style="внимание" %} + +**Данните могат да повредят света!** + +Някои повредени данни могат да повредят света и това не може да се отмени. + +Затова се препоръчва да се направи резервно копие на света преди прилагането на данни. + +{% endhint %} + +Данните могат да се изтеглят от различни услуги като [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) и други. + +След като изтеглите данните, можете да ги приложите, като ги поставите в папката `datapacks` на света на сървъра. +Ако няма такава папка, просто я създайте и добавете данните в нея. + +{% hint style="warning" %} + +**За някои [данни](#user-content-fn-2)[^2] може да е необходимо да бъдат приложени два пъти, за да се приложат успешно.** + +В тези случаи се препоръчва да се рестартира сървъра **2 пъти** след приложването на данните. + +{% endhint %} + +Данните могат лесно да бъдат повредени при обновяване на версията на Minecraft. + +Особено когато данните са напълно повредени, е важно да се извърши достатъчно тестове преди обновяване на сървъра, за да се избегнат сблъсъци. + +{% hint style="info" %} + +**След стартирането на сървъра, можете да въведете `safeMode` след командата за стартиране, за да деактивирате всички данни.** + +[За повече информация вижте `Референции > Аргументи и свойства`](../reference/arguments.md) + +{% endhint %} + +Приложените данни могат да бъдат проверени с командата `/datapack list`. + +*** + +[^1]: Или в Minecraft: Bedrock Edition като аддон. + +[^2]: Добавяне на нови видове същества и други. diff --git a/bg/origin/plazma/administration/getting-started/next-step.md b/bg/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..4e10caf65 --- /dev/null +++ b/bg/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Научете как да персонализирате сървъра. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +По-долу са няколко начина за персонализиране и използване на Plazma. + +## Промяна на конфигурацията + +Най-основният начин за персонализиране на Plazma е чрез промяна на конфигурацията. + +Plazma предоставя мощни настройки за конфигурация, включително механизми на играта и свойства на чудовищата. + +За повече информация относно конфигурацията на Plazma, вижте следната страница. + +{% content-ref url="../reference/configurations/" %} +[конфигурации](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Използване на допълнения + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Това е основната причина за използването на Plazma и най-мощният начин за персонализиране на Plazma. Силната плъгин екосистема на Plazma позволява лесно персонализиране на сървъра. + +Има няколко начина за намиране и изтегляне на плъгини. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Има няколко услуги за изтегляне на плъгини. Сред тях, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) извършват проверка преди качване на плъгини, за да осигурят, че се разпространяват само безопасни плъгини. + +### Прилагане на плъгини + +След като сте изтеглили плъгините, е време да ги приложите. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Поставете изтегления файл в папката `plugins` на сървъра и (ре)стартирайте сървъра. +3. При стартиране на Plazma, ще видите ново съдържание в конзолата. Това означава, че Plazma успешно е заредил плъгините. +4. Въпреки че Plazma е заредил плъгините успешно, те може да не са стартирали правилно. С командата `/plugins` можете да видите заредените плъгини на сървъра. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Ако плъгините не са заредени правилно, можете да намерите решение на следната страница. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Използване на данни + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +С данни може да се добавят нови видове същества и предизвикателства в играта, като се променят части от нея. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Някои повредени данни могат да повредят света и това не може да се отмени. + +Затова се препоръчва да се направи резервно копие на света преди прилагането на данни. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +След като изтеглите данните, можете да ги приложите, като ги поставите в папката `datapacks` на света на сървъра. Ако няма такава папка, просто я създайте и добавете данните в нея. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +В тези случаи се препоръчва да се рестартира сървъра **2 пъти** след приложването на данните. +{% endhint %} + +Данните могат лесно да бъдат повредени при обновяване на версията на Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Приложените данни могат да бъдат проверени с командата `/datapack list`. + +*** + +## Оптимизация + +Plazma има много оптимизационни пачове. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Прокси + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +За информация относно безопасната и правилната настройка на проксито, вижте следната страница. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Сигурност + +Minecraft се развива толкова много, че дори в онлайн среда е лесно достъпен [двигател за атаки с уязвимости](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Настройки за разрешения + +При някои администраторски команди на плъгини може да съществуват уязвимости, ако разрешенията не са правилно настроени. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Блокиране на X-Ray + +X-Ray е една от уязвимостите, лесно достъпни дори в основния оптимизационен клиент. + +Plazma предлага конфигурация, която може да блокира X-Ray по подразбиране. + +Моля, прегледайте следната страница за информация относно методите за блокиране на X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Бял списък + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +За да видите списъка на играчите, които имат позволение за влизане, използвайте `/whitelist query`. + +*** + +[^1]: Или в Minecraft: Bedrock Edition като аддон. + +[^2]: Добавяне на нови видове същества и други. + +[^3]: Обикновено се нарича "хакерство". + +[^4]: В случай че конфигурацията не е оптимизирана, Plazma е стара или ако са открити нови уязвимости, те може да не са блокирани. + +[^5]: Когато играч влиза в сървъра, това става чрез Ngrok прокси сървър и адресът на Ngrok се променя с всяко рестартиране. diff --git a/bg/origin/plazma/administration/reference/README.md b/bg/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..45f1ea630 --- /dev/null +++ b/bg/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Открийте как да персонализирате основните методи, предоставени от Plazma. +--- + +# 📜 리퍼런스 + +Plazma предлага различни методи за персонализация. + +Сред тях, четирите метода по-долу са методи за персонализация, които могат да бъдат използвани веднага без допълнителни действия. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Официален сървър на Discord](https://discord.gg/MmfC52K8A8) или задайте въпроси на общността чрез [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Команди + +> Командите позволяват на играчите да събират информация в играта или да персонализират игровата среда. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Права + +> Правата определят обхвата, в който играчите могат да взаимодействат. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Аргументи и свойства + +> Аргументите и свойствата оказват общо влияние върху функционирането на Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Конфигурация + +> Конфигурацията е най-основният начин за персонализиране на Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/bg/origin/plazma/administration/reference/arguments.md b/bg/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..f1234a316 --- /dev/null +++ b/bg/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Научете повече за началните аргументи и системните свойства. +--- + +# 🎛️ Аргументи и свойства + +Началните аргументи и системните свойства са стойности, които се добавят към [командите, използвани за стартиране на Plazma](#user-content-fn-1)[^1], които оказват общо влияние върху функционирането на Plazma. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## Системни свойства + +Системните свойства се въвеждат пред `-jar` и се обработват от JVM преди инициализирането на Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Начин на използване + +Системните свойства се въвеждат като Java командни аргументи между `java` и `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` указва, че този аргумент не е вграден в JVM, а е специфичен за Plazma, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Целият списък със системни свойства + +#### `convertLegacySigns` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Актуализира формата на спрени плочи. + +#### `debug.entities` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за информация за съществата. + +#### `debug.rewriteForIDE` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира NMS ревизията за правилно зареждане на дебъг информация в IDE и автоматично пренася вътрешната версия. + +#### `disable.watchdog` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира системата за предупреждения на Watchdog в Spigot. + +#### `letMeReload` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира съобщението за повторно зареждане на командата `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Ако сте разработчик на плъгини и трябва да актуализирате плъгина, използвайте хотсуап вместо `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира плъгините, използващи стандартната система за вход и изход. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Предупреждава, когато се забележи спрян формат при четене на чат компоненти. + +#### `Paper.bypassHostCheck` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира проверката на съвпадение на шаблоните на сървъра, когато играч се свърже със сървъра. + +#### `Paper.debugDynamicMissingKeys` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за липсващи ключове в NBT обекти. + +#### `Paper.debugInvalidSkullProfiles` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за невалидни профили на глави. + +Това включва логове за всички невалидни глави в света, заедно с техните позиции. + +#### `Paper.disableChannelLimit` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира системата за приоритет на класовете на плъгините. + +Полезно е, ако има проблеми с плъгиновата сянка. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира системата за консолидация на Netty flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Стойност по подразбиране**: `750` + +Ако броят на съществата надхвърли тази стойност, те се изпращат в множество пакети. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Стойност по подразбиране**: `8192` + +Задава максималния размер на пакета, който сървърът може да приеме едновременно. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира проверката на версията на Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Това може да причини трайно повреда на файловете като светове и цялостната механика на играта. + +Всички проблеми, произтичащи от това, са ваша отговорност, а Plamza не предоставя никаква поддръжка по този въпрос. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Стойност по подразбиране**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Стойност по подразбиране**: `80` + +Задава максималната дължина на текста на един ред на табела. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Стойност по подразбиране**: `(версия на света) + 1` + +Задава версията на информацията за обновяване на света, която трябва да се инициализира първа. + +Полезно е при големи обновявания на чанковете, но в противен случай не се използва. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `True` + +Активира обработката на коментарите в YAML файловете. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Стойност по подразбиране**: `30` + +Изгонва играчите, които не изпращат никакви данни за време (в секунди). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Игнорира коментарите в сървърните свойства. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за синхронно създаване на чанкове. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира [стандартната система за създаване на чанкове](#user-content-fn-10)[^10] на Minecraft. + +Това води до сериозно забавяне, тъй като всяка част се запазва последователно. + +#### `Paper.explicit-flush` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира Explicit Flushing на мрежовия канал. + +#### `Paper.strict-thread-checks` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Винаги записва грешките, които не са в основния ни нишки. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Извежда предупреждение, ако резервираната задача има прекалено голямо забавяне. + +#### `Paperclip.patchOnly` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Приложва само пачове без да стартира сървъра, когато се използва вграденият изпълним файл. + +#### `Plazma.aggressiveOptimize` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` +- **Конфликт**: `Plazma.disableConfigOptimization` + +Усилва началната конфигурация. + +Активирането на това прави сървъра по-бърз и по-сигурен, но може да има голямо въздействие върху играта. + +#### `Plazma.disableConfigOptimization` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` +- **Конфликт**: `Plazma.aggressiveOptimize` + +Не оптимизира началната конфигурация. + +Това оставя използването на основната конфигурация на Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` + +Деактивира маркирането на Plazma и използва стандартния серверен фавикон на ванилата. + +#### `Plazma.useVanillaConfiguration` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` +- **Конфликт**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Това може значително да засегне сигурността и производителността на сървъра. + +Всички проблеми, които възникват при използването на тази характеристика, са отговорност на администратора на сървъра. +{% endhint %} + +Предоставя началната конфигурация със стойностите по подразбиране, предоставени от Mojang. + +Това деактивира всички пачове за уязвимости, приложени от Paper. + +Пачовете за уязвимости могат да бъдат отново активирани в Paper конфигурацията или в Plazma конфигурацията. + +#### `Plazma.vanillaize` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `true` +- **Конфликт**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Задава началната конфигурация по-близо до ванилата. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Свойство, което е спряло да се използва + +Долните системни свойства са спрели да се използват. + +#### `timings.bypassMax` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` +- **Прекратено използване**: От момента на премахването на Timings от Plazma + +Определя дали може да се надвишава максималният брой стойности, които могат да бъдат изпратени към Aikar Timings API. + +Ако не се обработи изключение в API, се прилага ограничение на скоростта. + +*** + +## Стартов аргумент + +Стартовият аргумент се въвежда след `-jar *.jar` и се обработва заедно с инициализацията на Plazma. + +### Начин на използване + +Системните свойства се въвеждат като аргументи на програмата след `-jar *.jar`. + +Например, ако искате да приложите стартов аргумент `nogui`,\ +следващото въвеждане ще причини Plazma да обработи аргумента `nogui` по време на инициализацията си. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Целият стартов аргумент + +#### `bukkit-settings` + +- **Псевдоним**: `b` +- **Стойност по подразбиране**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Псевдоним**: `c` +- **Стойност по подразбиране**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Псевдоним**: `c` +- **Стойност по подразбиране**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Стартира сървъра в режим демонстрация. + +#### `eraseCache` + +Премахва останалите кеш файлове след ъпгрейд на света. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Псевдоним**: `?` + +Извежда целия стартов аргумент и описание на Plazma. + +#### `initSettings` + +Създава само конфигурационния файл и затваря сървъра. + +#### `jfrProfile` + +Активира JFR профилирането. + +#### `max-players` + +- **Псевдоними**: `s`, `size` +- **Стойност по подразбиране**: `(server properties)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Изключва графичния интерфейс на панела. + +#### `nojline` + +Изключва JLine и използва стандартната конзола. + +#### `online-mode` + +- **Псевдоним**: `o` +- **Стойност по подразбиране**: `(server properties)` + +Избира дали да се проверяват играчите с Mojang аутентикационния сървър. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Псевдоним**: `paper` +- **Стойност по подразбиране**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Задава местоположението на спряните PaperSpigot конфигурационни файлове. + +Това се използва за преместване на съществуващи конфигурации към нови файлове, след което не се използва повече. + +#### `paper-settings-directory` + +- **Псевдоним**: `paper-dir` +- **Стойност по подразбиране**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Псевдоним**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Псевдоним**: `p` +- **Стойност по подразбиране**: `plugins` + +Задава местоположението на папката с плъгини. + +#### `pufferfish-settings` + +- **Псевдоним**: `pufferfish` +- **Стойност по подразбиране**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Псевдоним**: `purpur` +- **Стойност по подразбиране**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Стартира сървъра в режим на пълно ванилия. + +#### `server-ip` + +- **Псевдоними**: `h`, `host` +- **Стойност по подразбиране**: `(server properties)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Псевдоними**: `p`, `port` +- **Стойност по подразбиране**: `(server properties)` + +Задава порта на сървъра. + +#### `server-name` + +- **Стойност по подразбиране**: `A Plazma Server` + +Задава името на сървъра. + +#### `spigot-settings` + +- **Псевдоним**: `S` +- **Стойност по подразбиране**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Псевдоним**: `v` + +Извежда версията на Plazma. + +#### `world-dir` + +- **Псевдоними**: `W`, `universe`, `world-container` +- **Стойност по подразбиране**: `(сървър папка)` + +Задава местоположението, където се съхраняват световните файлове. + +#### `world-name` + +- **Псевдоними**: `w`, `world` +- **Стойност по подразбиране**: `(server properties)` + +Задава името на световния файл. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Позицията на аргументите се променя в зависимост от добавеното място. + +[^3]: Например, ако искате да активирате `Plazma.iKnowWhatIAmDoing` като `true`, вместо да въведете `-DPlazma.iKnowWhatIAmDoing=true`, само въвеждането на `-DPlazma.iKnowWhatIAmDoing` ще работи също. + +[^4]: Например, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Сензор за събития. + +[^6]: Сензор за събития. + +[^7]: Клиент. + +[^8]: Сигнал, който уведомява, че сървърът е свързан нормално, като сърдечния ритъм. + +[^9]: С функцията за изгонване на AFK на Purpur можете да изгоните играчи, които са напуснали мястото си. + +[^10]: Система за синхронно записване на чанкове, Sync Chunk Write System. + +[^11]: `ВНИМАНИЕ! Plazma може да предизвика неочаквани проблеми, затова се уверете, че сте я тествали изчерпателно преди да я използвате на публичен сървър.` + +[^12]: В играта `Световна оптимизация` работи по същия начин. + +[^13]: Администратори от `Ниво 2` и нагоре се изключват. + +[^14]: Интернет протокол, IP. diff --git a/bg/origin/plazma/administration/reference/commands.md b/bg/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..24572985c --- /dev/null +++ b/bg/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Научете повече за наличните команди в Plazma. +--- + +# 🖥️ Команди diff --git a/bg/origin/plazma/administration/reference/configurations/README.md b/bg/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..a0645c95d --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Конфигурацията е най-основният начин за персонализиране на Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Характеристика + +> Характеристиката е основният конфигурационен файл, предоставен от Minecraft. Използвайки характеристиката, можете да промените основните механизми на играта. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Конфигурация + +> Bukkit конфигурацията е основният конфигурационен файл, предоставен от Plazma. Използвайки Bukkit конфигурацията, можете да промените основните механизми на сървъра на Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Конфигурация + +> Spigot конфигурацията позволява редакция на детайлните механизми на играта, обработката на играчите, функционирането на командите и съобщенията. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Конфигурация + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish конфигурацията позволява промяна на обработката на световете и ентититата в Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Конфигурация + +> Purpur характеристиката позволява редакция на общите данни на играта. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Конфигурация + +> Plazma конфигурацията позволява персонализиране на функциите на Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/bg/origin/plazma/administration/reference/configurations/bukkit.md b/bg/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0f88d79e9 --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Научете какво означава всяко възел в bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/bg/origin/plazma/administration/reference/configurations/paper/README.md b/bg/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..a81b843bc --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво е предназначението на всеки файл в папката config. +--- + +# 🛩️ Хартия diff --git a/bg/origin/plazma/administration/reference/configurations/paper/global.md b/bg/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..3d16b106c --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всеки възел на paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/bg/origin/plazma/administration/reference/configurations/paper/world.md b/bg/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..e9b9c4a68 --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Преведете какво означава всеки възел на paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Световен diff --git a/bg/origin/plazma/administration/reference/configurations/plazma/README.md b/bg/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..32af5f4af --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво е предназначението на всеки файл в папката config. +--- + +# ✨ Плазма diff --git a/bg/origin/plazma/administration/reference/configurations/plazma/global.md b/bg/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..2184eda27 --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко от възлите в plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/bg/origin/plazma/administration/reference/configurations/plazma/world.md b/bg/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..ca112c91f --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко отделно възел на plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/bg/origin/plazma/administration/reference/configurations/plazma/worlds.md b/bg/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..b5307b4ac --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко отделно възел на plazma-world.yml. +--- + +# ✨ Plazma (състав на световете) diff --git a/bg/origin/plazma/administration/reference/configurations/property.md b/bg/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..5e035b7da --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко от възлите на server.properties. +--- + +# 🪨 Server.properties diff --git a/bg/origin/plazma/administration/reference/configurations/pufferfish.md b/bg/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..4f405260c --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко възел в pufferfish.yml. +--- + +# 🐡 Риба-балон diff --git a/bg/origin/plazma/administration/reference/configurations/purpur/README.md b/bg/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..b91be7597 --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Анализирайте какво означава всяко възел в purpur.yml. +--- + +# 🦑 Пурпур diff --git a/bg/origin/plazma/administration/reference/configurations/purpur/global.md b/bg/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..ead29d453 --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Анализирайте какво означава всяко възел в purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/bg/origin/plazma/administration/reference/configurations/purpur/world.md b/bg/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..3e8c13ce0 --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Анализирайте какво означава всяко възел в purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/bg/origin/plazma/administration/reference/configurations/spigot.md b/bg/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..c932d7f4f --- /dev/null +++ b/bg/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Научете какво означава всяко отделно възел на spigot.yml. +--- + +# 🚰 Spigot diff --git a/bg/origin/plazma/administration/reference/permissions.md b/bg/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..bfdbbf55a --- /dev/null +++ b/bg/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Научете повече за правата на Plazma. +--- + +# 🛡️ Права + +Правата са просто средство за сигурност, което определя обхвата, в който играчите на сървъра могат да взаимодействат един с друг. + +За правилно използване и лесна редакция на правата трябва да използвате плъгини като [LuckPerms](https://luckperms.net). + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Предоставяне по подразбиране**: `Няма` + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +След като въведете `.other` след името на разрешението, позволява използването на други играчи. + +#### `bukkit.command.demo` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +След като въведете `.other` след името на разрешението, позволява използването на други играчи. + +#### `bukkit.command.ping` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +След като въведете `.other` след името на разрешението, позволява използването на други играчи. + +#### `bukkit.command.restart` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +След като въведете `.other` след името на разрешението, позволява използването на други играчи. + +#### `bukkit.command.timings` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Предоставя се по подразбиране**: `Световен администратор` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **Предоставя се по подразбиране**: `Световен администратор` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +След като въведете `.other` след името на разрешението, позволява използването на други играчи. + +#### `paper.antixray.bypass` + +- **Предоставяне по подразбиране**: `Няма` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Предоставяне по подразбиране**: `Няма` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Предоставяне по подразбиране**: `Няма` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Предоставяне по подразбиране**: `Няма` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Предоставяне по подразбиране**: `Няма` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Предоставяне по подразбиране**: `Няма` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **Предоставя се по подразбиране**: `Световен администратор` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **Предоставяне по подразбиране**: `Няма` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Предоставяне по подразбиране**: `Няма` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Предоставяне по подразбиране**: `Няма` + +불사의 토템이 인벤토리에 있어도 작동하도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява играчите да игнорират ограничението за броя на влизащите. + +#### `purpur.mending_shift_click` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява на играчите да поправят предметите, които държат, като `се карайки`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява на играчите да инсталират моб спаунери. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява на играчите да бързо телепортират, когато използват Недер портал. + +#### `purpur.sign.color` + +- **Предоставяне по подразбиране**: `Няма` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява използването на магически код `(&o)` на табелите. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Предоставяне по подразбиране**: `Няма` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява на играчите да спират експлозията на TNT, като `се карайки` с ножица. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Предоставя се предварително разрешение + +#### `plazma.bypass.ncr-require` + +- **Предоставяне по подразбиране**: `Няма` + +Позволява на играчите да влизат, дори ако не е инсталиран модът [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Оператор. + +[^2]: Пример: `ender_dragon` diff --git a/bg/origin/plazma/adminstration/README.md b/bg/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..f1b94f551 --- /dev/null +++ b/bg/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Създайте собствен сървър с помощта на Plazma. +--- + +# ⚒️ Ръководство за управление на сървъри diff --git a/bg/origin/plazma/adminstration/expert/README.md b/bg/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b27f0074d --- /dev/null +++ b/bg/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Научете как да работите професионално с Plazma. +--- + +# 🎓 Advanced diff --git a/bg/origin/plazma/adminstration/expert/fix-exploits.md b/bg/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..1b4e68c50 --- /dev/null +++ b/bg/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Научете за известните уязвимости и начините за тяхното отстраняване. +--- + +# ⚠️ Известни уязвимости и начини за отстраняване diff --git a/bg/origin/plazma/adminstration/expert/optimize.md b/bg/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..e826b680c --- /dev/null +++ b/bg/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Научете как да оптимизирате Plazma. +--- + +# 🧹 Оптимизация diff --git a/bg/origin/plazma/adminstration/expert/vanillaize.md b/bg/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..a079a0668 --- /dev/null +++ b/bg/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Научете как да възстановите пача на хартия и ванилия. +--- + +# ↩️ Ванилизация + +{% hint style="warning" %} + +### Paper не предлага възможности за повечето пачове за отстраняване на грешки във ванилията. + +В момента Plazma разработва конфигурация, която позволява деактивиране на такива поправки. + +Този справочник все още се създава и информацията в него може да се промени по всяко време. +{% endhint %} diff --git a/bg/origin/plazma/adminstration/faq.md b/bg/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..95afe3de7 --- /dev/null +++ b/bg/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Научете повече за често задавани въпроси. +--- + +# ⁉️ Често задавани въпроси + +{% hint style="info" %} + +### Не можете да намерите желания отговор? + +Попитайте общността чрез [официалния Discord сървър](https://discord.gg/MmfC52K8A8) или [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Не успява да се изпълни със съобщение за грешка + +Ако в конзолата се извежда `no main manifest attribute, in plazma-(version).jar`,\ +това означава, че файла, който сте изтеглили, е API файл за разработка и трябва да изтеглите **Reobf Paperweight** от страницата на GitHub. + +За повече информация, вижте следната страница. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Предупреждение се извежда всеки път при стартиране на сървъра + +Plazma включва някои нестабилни поправки и винаги има вероятност за неизправност, поради което извежда това предупреждение при стартиране на сървъра. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Това предупреждение може да бъде деактивирано с помощта на системното свойство [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +За повече информация, вижте следната страница. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: На разположение от версия 1.20.1 diff --git a/bg/origin/plazma/adminstration/getting-started/README.md b/bg/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..78c7f97b4 --- /dev/null +++ b/bg/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Научете как да създадете сървър с Plazma. +--- + +# 👟 Започване + +За стабилно използване на Plazma, системата трябва да отговаря на следните изисквания. + +| | Минимални | Препоръчителни | +| :------------------------: | --------: | -------------: | +| Архитектура | x64 | - | +| RAM | 8GB | 16GB | +| Пространство за съхранение | 1GB | 8GB | +| JRE | 17 | 21 | + +За улеснение на редакцията на конфигурационни файлове, е добре да инсталирате редактор като [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Инсталиране на JRE + +Както се разбира от името, Minecraft: **"Java"** Edition е разработен на Java и изисква JRE[^1] за стартиране. + +Понеже Plazma се базира на официалната сървърна платформа на Mojang Studios[^2], за да използвате Plazma, трябва да инсталирате JRE. + +### 1.1 Проверка на наличността на JRE + +За да проверите дали JRE е инсталиран на системата, въведете [`cmd /k java --version`](#user-content-fn-4)[^4] в [командния ред](#user-content-fn-3) и го стартирайте. + +Ако получите следния изход, преминете към [стъпка 2](setup.md#id-2). + +{% code title="Правилен изход" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Ако не получите този изход или получите следния, значи JRE липсва или е твърде стар и трябва да изпълните [стъпка 1.2](setup.md#id-1.2). + +{% code title="JRE липсва" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE е твърде стар" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Инсталиране на JRE + +В това ръководство използваме Azul Zulu като [един от видовете](#user-content-fn-5)[^5] на JRE. + +След като инсталирате, проверете дали инсталацията е успешна, като повторите [стъпка 1.1](setup.md#id-1.1). + +{% tabs %} +{% tab title="Windows" %} + +1. Първоначално изтеглете **JDK 21** от [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) във формат `.msi`. +2. Стартирайте изтегления инсталационен мастър и кликнете `Next`. +3. **Активирайте `Set JAVA_HOME variable` от менюто в средата наляво на прозореца,** след което кликнете `Next`. +4. Натиснете `Install`, за да завършите инсталацията на JRE. + {% крайнаКартка %} + +{% tab title="macOS" %} +Изтеглете **JDK 21** във формат `.dmg` от [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) и инсталирайте JRE. +{% крайнаКартка %} + +{% tab title="Debian/Ubuntu" %} +Добавете хранилището на Azul Zulu към APT, като изпълните следната команда в терминал. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +След това инсталирайте JRE, като изпълните следната команда в терминал. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% крайнаКартка %} + +{% tab title="Fedora/RHEL" %} +Можете да инсталирате JRE, като изпълните следната команда. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% крайнаКартка %} +{% крайниКартки %} + +*** + +## 2. Изтегляне на Plazma + +Plazma предоставя различни видове изпълними файлове. + +{% hint style="warning" %} + +### Предимно използвайте `Reobf Paperclip`. + +Следното е за тези, които се интересуват от разработчика или характеристиките на всяка форма.\ +Ако сте обикновен потребител, може да прескочите до [стъпка 3](setup.md#id-3) без проблем. +{% endhint %} + +
+ +Научете повече + +Името на изпълнимия файл е `plazma-(версия на управителя)-1.20.4-R0.1-SNAPSHOT-(форма на мапиране).jar`. + +- **Форма на мапиране**\ + Мапирането е вида на карта, която свързва реалния код на Minecraft със затрудненият код. + - **Reobf**\ + Реобфускация, наричана също и Спигот мапиране, използва се в повечето NMS плъгини.\ + Използва се до версия 1.20.5. + - **Mojmap**\ + Моанг мапиране, оригиналното мапиране на Minecraft. +- **Управител на версии**\ + Управителят на версии е лаунчър, който се използва за зареждането на библиотеки и пачването на файлове на сървъра, необходим за стартирането на сървъра. + - **Paperclip**\ + Представлява управител, разработен от екипа на PaperMC за Paper и други платформи, който изтегля библиотеки и прилага пачове към сървъра. + - **Bundler**\ + Управителят на версии на оригиналния Minecraft. + +
+ +*** + +## 3. Създаване на стартиращ скрипт + +За да стартирате Plazma лесно и автоматично да рестартирате сървъра, трябва да създадете [стартиращ скрипт](#user-content-fn-6)[^6]. + +Можете да генерирате стартиращ скрипт чрез [Flags.sh](https://flags.sh).\ +Само въведете желаната от вас памет за Plazma, за да се оптимизира автоматично. + +Можете да изтеглите стартиращия скрипт чрез бутона за изтегляне в долната лява част.\ +**Уверете се, че изтегленият стартиращ скрипт съответства на операционната ви система.** + +*** + +## 4. Подреждане на файлове + +Сега преместете изтегления стартиращ скрипт и Plazma в нова папка. + +{% hint style="warning" %} + +### Името на папката трябва задължително да бъде без интервали и на английски език. + +В противен случай Plazma или JRE може да не функционират правилно. +{% endhint %} + +Сега стартирайте стартиращия скрипт. За Windows, трябва да изберете **Разрешаване** при избора на прозореца за разрешения на защитната стена. + +*** + +## 5. Съгласие с EULA + +След като стартирате стартиращия скрипт, ще бъде създаден файл `eula.txt` в папката. + +EULA[^9] е договор за лицензиране, с който трябва да се съгласите, за да използвате услугите на [Mojang Studios](#user-content-fn-10)[^10]. + +Без съгласие с EULA не може да стартирате сървъра и в случай на нарушение на EULA може да бъдете наказан, като ви се спре достъпа до акаунта и други [санкции](#user-content-fn-11)[^11]. + +За да се съгласите с EULA, променете `eula=false` в `eula=true` във файла `eula.txt` и го запазете. + +*** + +## 6. Разрешаване на външен достъп (Windows) + +Съвременните операционни системи по подразбиране блокират външни достъпи с помощта на **защитна стена** и **рутер**. + +В случая с Windows, след като сте разрешили в [стъпка 3](setup.md#id-3), трябва само да пренасочите портовете. + +{% hint style="info" %} + +### Това ръководство предполага, че използвате Windows и рутер, който поддържа [**UPnP**](#user-content-fn-12)[^12]. + +Ако вашият рутер не поддържа UPnP, тъй като панелите на рутерите се различават, трябва да търсите информация самостоятелно. + +Можете също да използвате [Ngrok](https://ngrok.com/), за да създадете временен адрес. +{% endhint %} + +{% hint style="warning" %} + +### За Linux или macOS и други (полу) UNIX операционни системи, настройките на защитната стена се различават в зависимост от услугата, затова трябва да търсите информация самостоятелно. + +{% endhint %} + +### 6.1 Проверка за необходимост от пренасочване на портове + +Въведете и изпълнете следната команда в командния ред. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ако изходът е `True`, можете да спрете тук, но ако е `False`, трябва да настроите пренасочването на портовете. + +### 6.2 Свързване към сървъра + +{% tabs %} +{% tab title="Външно свързване" %} +Ако не е необходимо пренасочване на портове или вече сте го настроили успешно, вече можете да се свържете със сървъра. + +Адресът за свързване към сървъра може да бъде проверен [тук](https://ip.pe.kr/). +{% крайнаКартка %} + +{% tab title="Опит за UPnP през портово пренасочване" %} +В `purpur.yml` на сървъра активирайте `network.upnp-port-forwarding` на `true`. + +След това рестартирайте сървъра и Plazma автоматично ще опита да пренасочи портовете. + +Успеха на UPnP се определя от съобщенията, изведени в конзолата, като се използва `[UPnP] (съобщение)`. + +| Съобщение | Значение | +| ----------------------------------- | -------------------------------- | +| `Успешно отворен порт (порт)` | Успешно пренасочване на порта. | +| `Порт (порт) вече е отворен` | Друга услуга използва този порт. | +| `Неуспешно отваряне на порт (порт)` | Неуспешно пренасочване на порта. | +| `Услугата не е достъпна` | Рутера не поддържа UPnP. | + +Когато сървъра се изключи, Plazma автоматично затваря портовете. +{% крайнаКартка %} + +{% tab title="Създаване на временен адрес с Ngrok" %} +Ngrok е полезен за краткосрочни тестове, сътрудничество или игра с приятели. + +1. Изтеглете ZIP файла `Windows (64-bit)` от [Ngrok уебсайт](https://ngrok.com/download). +2. Поставете изтегления Ngrok в папката на сървъра. +3. Генерирайте [уникален токен за удостоверяване](#user-content-fn-13)[^13] от [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Изпълнете командата, която се показва в `Command Line` в папката на сървъра. +5. Добавете `start /b ngrok tcp --region jp 25565` в началото на скрипта и `taskkill /f /t /im ngrok.exe` в края му. +6. Адресът на сървъра ще бъде `0.tcp.jp.ngrok.io:12345` от първия ред на конзолата. +7. Сега можете да се свържете + {% крайнаКартка %} + +{% tab title="Локален достъп" %} +При опит за достъп до сървъра от локалната мрежа, можете да се свържете чрез изпълнение на `cmd /k ipconfig` в командния прозорец и да използвате `IPv4 адреса`, който се появява в изхода. + +Например, след изпълнение на командата, ако виждате следното, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Можете да се свържете със сървъра от локалната мрежа, като опитате да се свържете с адреса `192.168.3.7`, който се появява в IPv4. + +Ако сървърът и играта се изпълняват на същия компютър, можете да използвате `localhost` за достъп. +{% крайнаКартка %} +{% крайниКартки %} + +## 7. Етап на развитие + +След успешно стартиране на сървъра и докато той работи правилно, сега е време да персонализирате сървъра. + +Научете как да персонализирате сървъра чрез ръководството по-долу. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java изпълнителна среда. + +[^2]: Paper, базиран на Spigot, който от своя страна е базиран на официалната платформа на сървъра Spigot. + +[^3]: Клавиш Windows + R + +[^4]: За Linux използвайте `java --version` в терминала + +[^5]: JRE е един от проектите с отворен код и има множество варианти като платформа за сървър на Minecraft. + +[^6]: Обикновено се нарича **изпълнител**. + +[^7]: Когато активирате функцията "Автоматично рестартиране", сървърът ще се рестартира автоматично. Можете да го спрете, като натиснете `Control + C`. + +[^8]: Не се препоръчва да използвате повече от половината от ресурсите на системата. + + Например, ако общият капацитет на паметта на системата е 8GB, не е препоръчително да настроите повече от 4GB. + +[^9]: Споразумение за лицензионно споразумение с крайния потребител. За повече информация, моля, посетете [уебсайта на Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорация Майкрософт. + +[^11]: В случая с Република Корея, съгласно член 32, параграф 1, точка 9 от Закона за насърчаване на игралната индустрия, **Korean Microsoft Corporation** има право да предприеме правни действия. + +[^12]: Универсална включваема и играбелна технология. Чрез тази технология Purpur, включен в Plazma, автоматично комуникира с рутера и отваря портове само когато сървърът е активен, което означава, че няма нужда от ръчно пренасочване на портове. + +[^13]: При липса на акаунт, се регистрирайте в Ngrok чрез акаунт в Google или GitHub. diff --git a/bg/origin/plazma/adminstration/getting-started/customization.md b/bg/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..a6fb7f243 --- /dev/null +++ b/bg/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Научете как да персонализирате сървъра. +--- + +# 🎨 Персонализация на потребителския интерфейс diff --git a/bg/origin/plazma/adminstration/reference/arguments.md b/bg/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..4e954c402 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Научете повече за началните аргументи и системните свойства. +--- + +# 🎛️ Аргументи и свойства + +Началните променливи и системните свойства са стойности, които се добавят към [командите](#user-content-fn-1)[^1], използвани за стартиране на Plazma, които позволяват промяна на стойностите, които не могат да бъдат променени след стартирането на Plazma. + +В зависимост от [местоположението на добавянето на команди](#user-content-fn-2)[^2], те се разделят на **начални аргументи** и **системни свойства**. + +*** + +## Системни свойства + +Системните свойства се въвеждат пред `-jar` и се обработват от JVM преди инициализирането на Plazma. + +{% hint style="warning" %} + +### Промяната на системните свойства може да промени начина на работа на Plazma и JVM и може да има сериозно въздействие върху играта! + +Ако не сте напълно уверени каква е ролята на всяко системно свойство, **никога не го използвайте!** +{% endhint %} + +### Начин на използване + +Системните свойства се въвеждат като Java командни аргументи между `java` и `-jar`. + +Например, ако искате да приложите системното свойство `Plazma.dummyProperty`, следното въвеждане ще доведе до инициализиране на Plazma със стойност `37` за това свойство. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` указва, че този аргумент не е вграден в JVM, а е специфичен за Plazma, + +ако не се въведе стойност, тя се фиксира като [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Платформите от серията Paperweight включват `.` в имената на своите свойства, за да разграничат системните свойства за всяка платформа. + +В някои терминали като Windows Powershell може да не се позволява това, затова трябва да добавите `"` в началото и края на аргумента.[^4] +{% endhint %} + +### Целият списък със системни свойства + +#### `convertLegacySigns` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Актуализира формата на спрени плочи. + +#### `debug.entities` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за информация за съществата. + +#### `debug.rewriteForIDE` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира NMS ревизията за правилно зареждане на дебъг информация в IDE и автоматично пренася вътрешната версия. + +#### `disable.watchdog` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира системата за предупреждения на Watchdog в Spigot. + +#### `letMeReload` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира съобщението за повторно зареждане на командата `/reload`. + +{% hint style="danger" %} + +### Понеже командата `/reload` е много нестабилна, всички проблеми, възникнали след нейното изпълнение, са отговорност на потребителя. + +Ако сте разработчик на плъгини и трябва да актуализирате плъгина, използвайте хотсуап вместо `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира плъгините, използващи стандартната система за вход и изход. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Предупреждава, когато се забележи спрян формат при четене на чат компоненти. + +#### `Paper.bypassHostCheck` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира проверката на съвпадение на шаблоните на сървъра, когато играч се свърже със сървъра. + +#### `Paper.debugDynamicMissingKeys` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за липсващи ключове в NBT обекти. + +#### `Paper.debugInvalidSkullProfiles` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за невалидни профили на глави. + +Това включва логове за всички невалидни глави в света, заедно с техните позиции. + +#### `Paper.disableChannelLimit` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира ограничението на броя канали на плъгин за всеки играч до 128.[^5] + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира системата за приоритет на класовете на плъгините. + +Полезно е, ако има проблеми с плъгиновата сянка. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира системата за консолидация на Netty flush. + +#### `Paper.excessiveTELimit` + +- **Тип**: `Цяло число` +- **Стойност по подразбиране**: `750` + +Ако броят на съществата надхвърли тази стойност, те се изпращат в множество пакети. + +#### `Paper.filterThreshold` + +- **Тип**: `Цяло число` +- **Стойност по подразбиране**: `8192` + +Задава максималния размер на пакета, който сървърът може да приеме едновременно. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Деактивира проверката на версията на Java. + +{% hint style="danger" %} + +### Това може да доведе до опит за достъп до несъществуващ код от страна на JVM! + +Това може да причини трайно повреда на файловете като светове и цялостната механика на играта. + +Всички проблеми, произтичащи от това, са ваша отговорност, а Plamza не предоставя никаква поддръжка по този въпрос. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Тип**: `Цяло число` +- **Стойност по подразбиране**: `64` + +Задава ограничение за имената на плъгин каналите.[^6] + +#### `Paper.maxSignLength` + +- **Тип**: `Цяло число` +- **Стойност по подразбиране**: `80` + +Задава максималната дължина на текста на един ред на табела. + +#### `Paper.minPrecachedDatafixVersion` + +- **Тип**: `Цяло число` +- **Стойност по подразбиране**: `(версия на света) + 1` + +Задава версията на информацията за обновяване на света, която трябва да се инициализира първа. + +Полезно е при големи обновявания на чанковете, но в противен случай не се използва. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `True` + +Активира обработката на коментарите в YAML файловете. + +#### `Paper.playerConnection.keepAlive` + +- **Тип**: `Цяло число` +- **Стойност по подразбиране**: `30` + +Изгонва играчите, които не изпращат никакви данни за време (в секунди). + +Обикновено играта[^7] продължава да изпраща [сигнали на сърцето](#user-content-fn-8)[^8] към сървъра, така че не бива да бъдете изгонени, но,]\(#user-content-fn-9)[^9] ако играта не отговаря, тя се счита за сблъсък и сървърът спира да обработва играчите и ги изгонва. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Игнорира коментарите в сървърните свойства. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира дебъг логовете за синхронно създаване на чанкове. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира [стандартната система за създаване на чанкове](#user-content-fn-10)[^10] на Minecraft. + +Това води до сериозно забавяне, тъй като всяка част се запазва последователно. + +#### `Paper.explicit-flush` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Активира Explicit Flushing на мрежовия канал. + +#### `Paper.strict-thread-checks` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Винаги записва грешките, които не са в основния ни нишки. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Извежда предупреждение, ако резервираната задача има прекалено голямо забавяне. + +#### `Paperclip.patchOnly` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `False` + +Приложва само пачове без да стартира сървъра, когато се използва вграденият изпълним файл. + +#### `Plazma.aggressiveOptimize` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` + +{% hint style="warning" %} + +### Това свойство ще бъде преместено като начален аргумент след версия 1.20.5. + +{% endhint %} + +Прилага по-строга конфигурационна оптимизация при първоначално стартиране. + +При активиране сървърът става по-бърз и по-сигурен, но може да блокира някои механизми или да окаже голямо въздействие върху игралния процес. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` + +Подтискане на предупреждението[^11], което се извежда при инициализиране на Plazma. + +### Свойство, което е спряло да се използва + +Долните системни свойства са спрели да се използват. + +#### `timings.bypassMax` + +- **Тип**: `Булев` +- **Стойност по подразбиране**: `false` +- **Прекратено използване**: От момента на премахването на Timings от Plazma + +Определя дали може да се надвишава максималният брой стойности, които могат да бъдат изпратени към Aikar Timings API. + +Ако не се обработи изключение в API, се прилага ограничение на скоростта. + +*** + +## Стартов аргумент + +Стартовият аргумент се въвежда след `-jar *.jar` и се обработва заедно с инициализацията на Plazma. + +### Начин на използване + +Системните свойства се въвеждат като аргументи на програмата след `-jar *.jar`. + +Например, ако искате да приложите стартов аргумент `nogui`,\ +следващото въвеждане ще причини Plazma да обработи аргумента `nogui` по време на инициализацията си. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Целият стартов аргумент + +#### `bukkit-settings` + +- **Псевдоним**: `b` +- **Стойност по подразбиране**: `bukkit.yml` + +Задава името и местоположението на [файла с конфигурация на Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Псевдоним**: `c` +- **Стойност по подразбиране**: `commands.yml` + +Задава името и местоположението на [файла с конфигурация на командите на Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Псевдоним**: `c` +- **Стойност по подразбиране**: `server.properties` + +Задава името и местоположението на [файла с настройки на сървъра](../reference/configurations/property.md). + +#### `demo` + +Стартира сървъра в режим демонстрация. + +#### `eraseCache` + +Премахва останалите кеш файлове след ъпгрейд на света. + +#### `forceUpgrade` + +Принудително [ъпгрейдира](#user-content-fn-12)[^12] света, без да обърне внимание на версията. + +#### `help` + +- **Псевдоним**: `?` + +Извежда целия стартов аргумент и описание на Plazma. + +#### `initSettings` + +Създава само конфигурационния файл и затваря сървъра. + +#### `jfrProfile` + +Активира JFR профилирането. + +#### `max-players` + +- **Псевдоними**: `s`, `size` +- **Стойност по подразбиране**: `(server properties)` + +Задава максималния брой [играчи](#user-content-fn-14)[^14] за разрешаване. + +#### `nogui` + +Изключва графичния интерфейс на панела. + +#### `nojline` + +Изключва JLine и използва стандартната конзола. + +#### `online-mode` + +- **Псевдоним**: `o` +- **Стойност по подразбиране**: `(server properties)` + +Избира дали да се проверяват играчите с Mojang аутентикационния сървър. + +**Ако не се използва Velocity или друг прокси, може да доведе до нарушаване на [EULA](../getting-started/README.md#id-5) и санкции.** + +#### `paper-settings` + +- **Псевдоним**: `paper` +- **Стойност по подразбиране**: `paper.yml` + +{% hint style="warning" %} + +### Този аргумент е спрян след версия 1.19.4 + +{% endhint %} + +Задава местоположението на спряните PaperSpigot конфигурационни файлове. + +Това се използва за преместване на съществуващи конфигурации към нови файлове, след което не се използва повече. + +#### `paper-settings-directory` + +- **Псевдоним**: `paper-dir` +- **Стойност по подразбиране**: `config` + +Задава името и местоположението на папката, в която се намират [файловете с конфигурация на Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Псевдоним**: `plazma-dir` + +Задава името и местоположението на папката, в която се намират [файловете с конфигурация на Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Псевдоним**: `p` +- **Стойност по подразбиране**: `plugins` + +Задава местоположението на папката с плъгини. + +#### `pufferfish-settings` + +- **Псевдоним**: `pufferfish` +- **Стойност по подразбиране**: `pufferfish.yml` + +Задава името и местоположението на [файла с конфигурация на Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Псевдоним**: `purpur` +- **Стойност по подразбиране**: `purpur.yml` + +Задава името и местоположението на [файла с конфигурация на Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Стартира сървъра в режим на пълно ванилия. + +#### `server-ip` + +- **Псевдоними**: `h`, `host` +- **Стойност по подразбиране**: `(server properties)` + +Задава името на хоста на сървъра или [интернет протокол](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Псевдоними**: `p`, `port` +- **Стойност по подразбиране**: `(server properties)` + +Задава порта на сървъра. + +#### `server-name` + +- **Стойност по подразбиране**: `A Plazma Server` + +Задава името на сървъра. + +#### `spigot-settings` + +- **Псевдоним**: `S` +- **Стойност по подразбиране**: `spigot.yml` + +Задава името и местоположението на [файла с конфигурация на Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Псевдоним**: `v` + +Извежда версията на Plazma. + +#### `world-dir` + +- **Псевдоними**: `W`, `universe`, `world-container` +- **Стойност по подразбиране**: `(сървър папка)` + +Задава местоположението, където се съхраняват световните файлове. + +#### `world-name` + +- **Псевдоними**: `w`, `world` +- **Стойност по подразбиране**: `(server properties)` + +Задава името на световния файл. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Позицията на аргументите се променя в зависимост от добавеното място. + +[^3]: Например, ако искате да активирате `Plazma.iKnowWhatIAmDoing` като `true`, вместо да въведете `-DPlazma.iKnowWhatIAmDoing=true`, само въвеждането на `-DPlazma.iKnowWhatIAmDoing` ще работи също. + +[^4]: Например, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Сензор за събития. + +[^6]: Сензор за събития. + +[^7]: Клиент. + +[^8]: Сигнал, който уведомява, че сървърът е свързан нормално, като сърдечния ритъм. + +[^9]: С функцията за изгонване на AFK на Purpur можете да изгоните играчи, които са напуснали мястото си. + +[^10]: Система за синхронно записване на чанкове, Sync Chunk Write System. + +[^11]: `ВНИМАНИЕ! Plazma може да предизвика неочаквани проблеми, затова се уверете, че сте я тествали изчерпателно преди да я използвате на публичен сървър.` + +[^12]: В играта `Световна оптимизация` работи по същия начин. + +[^13]: Интернет протокол, IP. + +[^14]: Администратори от `Ниво 2` и нагоре се изключват. diff --git a/bg/origin/plazma/adminstration/reference/commands.md b/bg/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..24572985c --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Научете повече за наличните команди в Plazma. +--- + +# 🖥️ Команди diff --git a/bg/origin/plazma/adminstration/reference/configurations/bukkit.md b/bg/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0f88d79e9 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Научете какво означава всяко възел в bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/bg/origin/plazma/adminstration/reference/configurations/paper/README.md b/bg/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..a81b843bc --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво е предназначението на всеки файл в папката config. +--- + +# 🛩️ Хартия diff --git a/bg/origin/plazma/adminstration/reference/configurations/paper/global.md b/bg/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..060020658 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всеки възел на paper-global.yml. +--- + +# 🛩️ Хартия (глобална конфигурация) diff --git a/bg/origin/plazma/adminstration/reference/configurations/paper/world.md b/bg/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..32da971d1 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Преведете какво означава всеки възел на paper-world.yml. +--- + +# 🛩️ Paper (състав на света) diff --git a/bg/origin/plazma/adminstration/reference/configurations/plazma/README.md b/bg/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..32af5f4af --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво е предназначението на всеки файл в папката config. +--- + +# ✨ Плазма diff --git a/bg/origin/plazma/adminstration/reference/configurations/plazma/global.md b/bg/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..222954d29 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко от възлите в plazma-global.yml. +--- + +# ✨ Плазма (глобална конфигурация) diff --git a/bg/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/bg/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..dbb9e9d57 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Състав на световните земи diff --git a/bg/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/bg/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..b5307b4ac --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко отделно възел на plazma-world.yml. +--- + +# ✨ Plazma (състав на световете) diff --git a/bg/origin/plazma/adminstration/reference/configurations/property.md b/bg/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..5e035b7da --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко от възлите на server.properties. +--- + +# 🪨 Server.properties diff --git a/bg/origin/plazma/adminstration/reference/configurations/pufferfish.md b/bg/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..4f405260c --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Разберете какво означава всяко възел в pufferfish.yml. +--- + +# 🐡 Риба-балон diff --git a/bg/origin/plazma/adminstration/reference/configurations/purpur/README.md b/bg/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..b91be7597 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Анализирайте какво означава всяко възел в purpur.yml. +--- + +# 🦑 Пурпур diff --git a/bg/origin/plazma/adminstration/reference/configurations/purpur/global.md b/bg/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..a62284f02 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Анализирайте какво означава всяко възел в purpur.yml. +--- + +# 🦑 Пурпур (глобална структура) diff --git a/bg/origin/plazma/adminstration/reference/configurations/purpur/world.md b/bg/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..c0f389a37 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Анализирайте какво означава всяко възел в purpur.yml. +--- + +# 🦑 Пурпур (състав на света) diff --git a/bg/origin/plazma/adminstration/reference/configurations/spigot.md b/bg/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..c932d7f4f --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Научете какво означава всяко отделно възел на spigot.yml. +--- + +# 🚰 Spigot diff --git a/bg/origin/plazma/adminstration/reference/permissions.md b/bg/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..4c8bac1c0 --- /dev/null +++ b/bg/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Научете повече за правата на Plazma. +--- + +# 🛡️ Права diff --git a/bg/origin/plazma/developers.md b/bg/origin/plazma/developers.md new file mode 100644 index 000000000..84f082b1f --- /dev/null +++ b/bg/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Разработете проекти от трети страни с помощта на Plazma. +--- + +# ⚙️ Ръководство за разработчици diff --git a/bg/origin/thunderbolt/README.md b/bg/origin/thunderbolt/README.md new file mode 100644 index 000000000..44ba70c6d --- /dev/null +++ b/bg/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt е базиран на платформата Plazma, която разделя експерименталните пачове на различни Flavor и позволява на потребителите да ги използват директно. +--- + +# 🌩️ Ръководство за използване на Thunderbolt diff --git a/bg/origin/volt/README.md b/bg/origin/volt/README.md new file mode 100644 index 000000000..0577de6c8 --- /dev/null +++ b/bg/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt е отворен източник шаблон, който ви позволява да разработите собствената си платформа за сървъри Paperweight, базирана на Plazma. +--- + +# ⚡ Ръководство за разработка на Volt diff --git a/bn/origin/README.md b/bn/origin/README.md new file mode 100644 index 000000000..c9e05456f --- /dev/null +++ b/bn/origin/README.md @@ -0,0 +1,41 @@ +--- +description: যদি কোন প্রশ্ন থাকে তাহলে দয়া করে Discord বা GitHub আলোচনায় প্রশ্ন করুন। +--- + +# 🏠 ডক পোর্টালে স্বাগতম + +{% hint style="info" %} + +**প্লাজমা ডকুমেন্টটি বর্তমানে যন্ত্র অনুবাদ অবস্থায় রয়েছে।** + +[![অনুবাদ অবস্থা](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) থেকে ডকুমেন্ট অনুবাদে অংশগ্রহণ করে দকুমেন্টগুলি উন্নত করুন। + +{% endhint %} + +### প্লাজমা ব্যবহার করার সময় সমস্যা হলে কী করবেন? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderbolt সম্পর্কে আগ্রহ থাকলে? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt দিয়ে নিজের সার্ভার প্ল্যাটফর্ম তৈরি করতে চান? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` আরও অনেক Minecraft সম্পর্কিত তথ্য প্রয়োজন হলে? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/bn/origin/SUMMARY.md b/bn/origin/SUMMARY.md new file mode 100644 index 000000000..b5f32d652 --- /dev/null +++ b/bn/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# সূচী + +- [🏠 ডক পোর্টালে স্বাগতম](README.md) + - [⚛️ গিটহাব](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 ডিসকর্ড](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## প্লাজমা + +- [✨ প্লাজমা ব্যবহার ডক](plazma/README.md) +- [❓ প্লাজমা কি?](plazma/about/README.md) + - [⬇️ ডাউনলোড](plazma/about/downloads.md) + - [✅ সমর্থিত সংস্করণ](plazma/about/supported-versions.md) +- [⚒️ সার্ভার পরিচালনা গাইড](plazma/administration/README.md) + - [👟 শুরু করুন](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 উল্লেখ](plazma/administration/reference/README.md) + - [🖥️ কমান্ড](plazma/administration/reference/commands.md) + - [🛡️ অনুমতি](plazma/administration/reference/permissions.md) + - [🎛️ আর্গুমেন্ট এবং গুন](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 গুণ](plazma/administration/reference/configurations/property.md) + - [🪣 বুকিট](plazma/administration/reference/configurations/bukkit.md) + - [🚰 স্পিগট](plazma/administration/reference/configurations/spigot.md) + - [🛩️ পেপার](plazma/administration/reference/configurations/paper/README.md) + - [🌏 গ্লোবাল কনফিগারেশন](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ বিশ্ব অনুযায়ী কনফিগারেশন](plazma/administration/reference/configurations/paper/world.md) + - [🐡 পাফারফিশ](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 পুরপুর](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 গ্লোবাল কনফিগারেশন](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ বিশ্ব অনুযায়ী কনফিগারেশন](plazma/administration/reference/configurations/purpur/world.md) + - [✨ প্লাজমা](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 গ্লোবাল কনফিগারেশন](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ বিশ্ব অনুযায়ী কনফিগারেশন](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 উন্নত](plazma/administration/expert/README.md) + - [🧹 অপটিমাইজেশন](plazma/administration/expert/optimize.md) + - [🔀 প্রক্সি](plazma/administration/expert/proxy.md) + - [↩️ ভ্যানিলাইজ](plazma/administration/expert/vanillaize.md) + - [🩻 এক্স-রে ব্লক](plazma/administration/expert/xray.md) + - [⚠️ সুরক্ষা সমস্যা এবং সমাধান](plazma/administration/expert/fix-exploits.md) + - [⁉️ প্রশ্নাবলী](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ ডেভেলপার গাইড](plazma/developers.md) + - [✏️ অবদান রইল](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ জাভাডক](https://jd.plazmamc.org/) + +## থান্ডারবোল্ট + +- [🌩️ থান্ডারবোল্ট ব্যবহার গাইড](thunderbolt/README.md) + +## ভোল্ট + +- [⚡ ভোল্ট উন্নয়ন গাইড](volt/README.md) + +## বিবিধ + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ সম্পূর্ণ ডাউনলোড](plazma/about/downloads-all.md) diff --git a/bn/origin/miscellaneous/README.md b/bn/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/bn/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/bn/origin/plazma/README.md b/bn/origin/plazma/README.md new file mode 100644 index 000000000..a14630917 --- /dev/null +++ b/bn/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma는 Paper ভিত্তিক প্রযোজ্য অপ্টিমাইজেশন এবং বিভিন্ন গেম মেকানিজম ব্যবহারে Minecraft: Java Edition এর জন্য ওপেন সোর্স সার্ভার প্ল্যাটফর্ম।" +--- + +# ✨ Plazma ব্যবহার ডকুমেন্টস + +## 👋 Plazma ডকুমেন্টসে আপনাকে স্বাগতম + +Plazma ব্যবহার ডকুমেন্টসে আপনাকে স্বাগতম! + +{% hint style="info" %} + +**আপনি বিবরণিত সমস্যার মাধ্যমে সমাধান করতে পারছেন না?** + +[আধিকারিক Discord সার্ভার](https://discord.gg/MmfC52K8A8) বা [GitHub আলোচনা](https://github.com/PlazmaMC/PlazmaBukkit/discussions) এ যোগ দিন এবং সম্প্রদায়ে প্রশ্ন করুন! + +{% endhint %} + +### Plazma সম্পর্কে + +> Plazma কী ধরনের সার্ভার প্ল্যাটফর্ম তা জানুন। + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### প্রশাসকদের জন্য + +> Plazma ব্যবহার করে আপনার নিজের সার্ভার তৈরি করুন। + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### ডেভেলপারদের জন্য + +> Plazma ব্যবহার করে থার্ড পার্টি প্রজেক্ট ডেভেলপ করুন। + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/bn/origin/plazma/about/README.md b/bn/origin/plazma/about/README.md new file mode 100644 index 000000000..1db9bda3a --- /dev/null +++ b/bn/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Plazma কী ধরনের সার্ভার প্ল্যাটফর্ম তা জানুন। +--- + +# ❓ প্লাজমা কি? + +- **প্লাজমা** একটি [Andromeda](https://github.com/EarendelArchived/Andromeda) এবং [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) থেকে সুবিধা নিয়ে এসেছে [Paper](https://github.com/PaperMC/Paper) ভিত্তিক সার্ভার প্ল্যাটফর্ম। +- সর্বদা উচ্চ স্থিতিশীলতা এবং শক্তিশালী কার্যক্ষমতা, দ্রুত আপডেট, প্রচুর বৈশিষ্ট্য প্রদানের জন্য প্রচেষ্টা করে যাচ্ছে। + +## 📋 প্লাজমার লক্ষ্য + +- দ্রুত আপডেট, উচ্চ স্থিতিশীলতা সম্পন্ন সার্ভার প্ল্যাটফর্ম হতে প্রচেষ্টা করছে। +- মোড প্ল্যাটফর্মের মতো প্রচুর বৈশিষ্ট্য এবং শক্তিশালী কার্যক্ষমতা প্রদানের জন্য প্রচেষ্টা করছে। +- ভ্যানিলা প্যাচগুলি ব্যবহারকারীর সাজানো প্ল্যাটফর্ম তৈরি করতে প্রচেষ্টা করছে। + +## ⚙️ গুরুত্বপূর্ণ বৈশিষ্ট্য + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **সর্বদা আপডেট**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) প্লাজমার অন্তর্ভুক্ত প্যাচগুলি সর্বদা আধুনিক রেখে রাখার জন্য সহায়ক, Paper ভিত্তিক সার্ভার প্ল্যাটফর্মের মধ্যে সর্বাধিক দ্রুত আপডেট প্রদান করে। +6. **ডিফল্ট কনফিগারেশন ফাইল অপটিমাইজেশন**\ + ডিফল্ট প্রয়োজন হলে কনফিগারেশন ফাইলগুলি অপটিমাইজ করা হয়েছে। +7. **প্রণালীগত ভাবে কাজ করা মাল্টিথ্রেড**\ + খেলার মেকানিজম এবং সম্পর্কিত নয় সিস্টেম মেকানিজমগুলি অ্যাসিংক্রোনাস করে, [বিলম্ব সময়](#user-content-fn-4)[^4] কমিয়ে সার্ভারকে অপটিমাইজ করে। +8. **অপ্রয়োজনীয় স্থান ব্যবহার নিষেধ**\ + একই মানের ডেটা গুলি সমস্তকে একত্রিত করে মেমোরি ব্যবহার হারানো হয়। + +## ✨ ব্যবহারের ঘটনা + +- **জটিল প্লাগইনগুলির সঠিক প্ল্যাটফর্ম**\ + ডেভেলপার [IPECTER](https://github.com/IPECTER) এর সার্ভারে Plazma ব্যবহার করা হচ্ছে।\ + NMS এবং রিফ্লেকশনের মাধ্যমে কাজ করে স্ব-প্লাগইন, জটিল এবং বৃহত্তর আকারের ডেটা প্যাক প্রয়োগ করা হচ্ছে, + 100 জনের অধিক প্লেয়ারকে কার্যক্ষমতা হ্রাস ছাড়াই গ্রহণ করা হচ্ছে। +- **RPG সার্ভারে দ্রুত কার্যক্ষমতা রক্ষা**\ + একক ক্লাস্টারে 100 জন প্লেয়ারকে টিপিএস কমাবিনা স্থিতিশীলভাবে রাখা হয়েছিল এবং, + 4 টি ক্লাস্টারে মোট 250 জন প্লেয়ার সুবিধাজনকভাবে খেলতে পারেছিলেন। +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **অনেক স্ট্রিমার দ্বারা নির্বাচিত প্ল্যাটফর্ম**\ + এটি অনেক স্ট্রিমারদের দর্শক অংশগ্রহণের বালতি হিসাবে নির্বাচিত এবং ব্যবহৃত হচ্ছে। + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ ডাউনলোড + +নীচের পৃষ্ঠায় প্লাজমা ডাউনলোড করতে পারেন। + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### সমর্থিত সংস্করণের বিস্তারিত তথ্য জানতে চান? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot প্লাগইন এবং Paper, Pufferfish, Purpur প্লাগইন। + +[^2]: এটার নীচে Microsoft Corporation। + +[^3]: চ্যাট রিপোর্টিং সিস্টেম অক্ষম করলে চ্যাট পূর্নাঙ্কভাবে সার্ভারের মধ্যে প্রসেস হয় এবং Mojang-এর চ্যাট ট্র্যাকিং বন্ধ করা যায়। + +[^4]: সিস্টেম মেকানিজমের কাজ করতে একটু সময় নিতে হয় যাতে খেলা থামে। diff --git a/bn/origin/plazma/about/downloads-all.md b/bn/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..dd73bda5c --- /dev/null +++ b/bn/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: প্লাজমা এক্সিকিউটেবল ফাইল ডাউনলোড সম্পূর্ণ দেখুন +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| সংস্করণ | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/bn/origin/plazma/about/downloads.md b/bn/origin/plazma/about/downloads.md new file mode 100644 index 000000000..f357bfa49 --- /dev/null +++ b/bn/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: এখনই Plazma ডাউনলোড করুন এবং নিজে ব্যবহার করুন। +--- + +# ⬇️ ডাউনলোড + +#### সমর্থিত সংস্করণের বিস্তারিত তথ্য জানতে চান? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**নীচে ডাউনলোড করা হচ্ছে সাধারণ ব্যবহারকারীর জন্য এক্সিকিউটেবল ফাইল।** + +আপনি একজন ডেভেলপার এবং অন্যান্য ধরণের ফাইল প্রয়োজন করলে, দয়া করে নীচের পৃষ্ঠাটি দেখুন। + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
সংস্করণডাউনলোড
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + ডাউনলোড +
1.20.1 + ডাউনলোড +
1.19.4 + ডাউনলোড +
+ +*** diff --git a/bn/origin/plazma/about/patches-list.md b/bn/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..8ae373d99 --- /dev/null +++ b/bn/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Plazma에 추가된 모든 기능에 대해 জানুন। +--- + +# 📑 অন্তর্ভুক্ত প্যাচ diff --git a/bn/origin/plazma/about/supported-versions.md b/bn/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..542e99087 --- /dev/null +++ b/bn/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Plazma দ্বারা সমর্থিত Minecraft: Java Edition সংস্করণ খুঁজে নিন।" +--- + +# ✅ সংস্করণ সমর্থন অবস্থা + +{% hint style="info" %} + +**Plazma 1.19.4 এর পরে উন্নত হয়েছে, 1.19.4 এর কম সংস্করণ উন্নত করা হয়নি।** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/রিলিজ%20অপেক্ষারত +[idv]: https://badge.plazmamc.org/1/ডেভেলপমেন্টে +[atv]: https://badge.plazmamc.org/2/সমর্থিত +[fse]: https://badge.plazmamc.org/6/ফিচার%20সমর্থন%20বন্ধ +[eol]: https://badge.plazmamc.org/4/সমর্থন%20সমাপ্ত +[ukn]: https://badge.plazmamc.org/0/তথ্য%20নেই +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/সাধারণ +[100]: https://badge.plazmamc.org/percent/100 + +![অপেক্ষারত রিলিজ][wtr] ![ডেভেলপমেন্টে][idv] ![সমর্থিত][atv] ![ফিচার সমর্থন বন্ধ][fse] ![সমর্থন সমাপ্ত][eol] + +| সংস্করণ | স্থিতিশীলতা এবং কার্য সমর্থন | বিল্ড অবস্থা | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![বিল্ড অবস্থা](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![বিল্ড অবস্থা](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![বিল্ড অবস্থা](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/bn/origin/plazma/administration/README.md b/bn/origin/plazma/administration/README.md new file mode 100644 index 000000000..65d38e40a --- /dev/null +++ b/bn/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma ব্যবহার করে আপনার নিজের সার্ভার তৈরি করুন। +--- + +# ⚒️ সার্ভার পরিচালনা গাইড diff --git a/bn/origin/plazma/administration/diagnosis/README.md b/bn/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..41abdbc87 --- /dev/null +++ b/bn/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: সমস্যা উঠলে কীভাবে প্রতিষ্ঠান করবেন তা জানুন। +--- + +# 🧾 진단 diff --git a/bn/origin/plazma/administration/diagnosis/plugins.md b/bn/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..131d4b5f4 --- /dev/null +++ b/bn/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: প্লাগইন সঠিকভাবে কাজ না করলে সমস্যা সমাধানের উপায় জানুন। +--- + +# 📜 플러그인 diff --git a/bn/origin/plazma/administration/expert/README.md b/bn/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..6a317058a --- /dev/null +++ b/bn/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: প্লাজমা সম্পর্কে পেশাদারভাবে জানুন। +--- + +# 🎓 এডভান্সড diff --git a/bn/origin/plazma/administration/expert/fix-exploits.md b/bn/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..318e63291 --- /dev/null +++ b/bn/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: পরিচিত ভুলবুঝার সমস্যা এবং তা সমাধানের উপায় জানুন। +--- + +# ⚠️ পরিচিত ভুলবুঝার সমস্যা এবং তা সমাধানের উপায় diff --git a/bn/origin/plazma/administration/expert/optimize.md b/bn/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..a96a2fbc3 --- /dev/null +++ b/bn/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: প্লাজমা অপটিমাইজেশনের উপায় জানুন। +--- + +# 🧹 অপটিমাইজেশন diff --git a/bn/origin/plazma/administration/expert/proxy.md b/bn/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..8d816cf05 --- /dev/null +++ b/bn/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: '"Velocity" প্ল্যাটফর্ম এর প্রক্সি সুরক্ষিতভাবে কিভাবে কনফিগার করতে হয় তা জানুন।' +--- + +# 🔀 প্রক্সি diff --git a/bn/origin/plazma/administration/expert/vanillaize.md b/bn/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..e36f9b927 --- /dev/null +++ b/bn/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper এবং ভ্যানিলা প্যাচ পুনরুদ্ধার করার উপায় জানুন। +--- + +# ↩️ ভ্যানিলাইজ + +{% hint style="warning" %} + +**Paper는 ভ্যানিলা-র ত্রুটি সমাধানে অধিকাংশ প্যাচে একটি বিকল্প যোগ করে না।** + +বর্তমানে Plazma এমন সমস্যা সমাধান বিন্যাস করেছে যাতে এগুলি নিষ্ক্রিয় করা যায়। + +এই কারণে এই গাইডটি এখনও লেখার অধীনে আছে এবং সবসময় তথ্য পরিবর্তনের সম্ভাবনা রয়েছে। + +{% endhint %} diff --git a/bn/origin/plazma/administration/expert/xray.md b/bn/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..ef761a790 --- /dev/null +++ b/bn/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray를 বাধা দেওয়ার বিভিন্ন অংশগুলি সম্পর্কে জানুন। +--- + +# 🩻 X-Ray বন্ধ diff --git a/bn/origin/plazma/administration/faq.md b/bn/origin/plazma/administration/faq.md new file mode 100644 index 000000000..8d737ae23 --- /dev/null +++ b/bn/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: 자주 জিজ্ঞাসিত প্রশ্ন সম্পর্কে জানুন। +--- + +# ⁉️ জিজ্ঞাসিত প্রশ্ন + +{% hint style="info" %} + +**আপনি কি পছন্দ করা উত্তর খুঁজতে পারছেন না?** + +[আধিকারিক Discord সার্ভার](https://discord.gg/MmfC52K8A8) বা [GitHub আলোচনা](https://github.com/PlazmaMC/PlazmaBukkit/discussions) এ যোগ দিন এবং সম্প্রদায়ে প্রশ্ন করুন! + +{% endhint %} + +### প্লাজমা চালু হচ্ছে না + +যদি কনসোলে `no main manifest attribute, in plazma-(version).jar` মেসেজ প্রিন্ট হয়,\ +তাহলে ডাউনলোড করা ফাইলটি ডেভেলপমেন্ট API ফাইল এবং GitHub পেজ থেকে **Reobf Paperweight** ডাউনলোড করতে হবে। + +বিস্তারিত জানতে নিচের পেজটি দেখুন। + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### সার্ভার চালু হওয়ার সময় সবসময় সতর্কতা দেখানো হয় + +Plazma-তে কিছু অস্থির প্যাচ থাকতে পারে এবং সার্ভারে সবসময় অপ্রত্যাশিত সমস্যা হতে পারে, তাই সার্ভার চালু হওয়ার সময় এই ধরনের সতর্কতা মেসেজ প্রিন্ট করে। + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +উক্ত সতর্কতা মেসেজটি ব্যবহার করে অনলাইনে নিষ্ক্রিয় করা যেতে পারে [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] সিস্টেম প্রপার্টির মাধ্যমে। + +বিস্তারিত জানতে নিচের পেজটি দেখুন। + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1 থেকে পাওয়া যাবে diff --git a/bn/origin/plazma/administration/getting-started/README.md b/bn/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..1e384df23 --- /dev/null +++ b/bn/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Plazmaর সার্ভার তৈরি করার উপায় জানুন। +--- + +# 👟 শুরু করুন + +Plazma একটি স্থিতিশীলভাবে ব্যবহার করতে, সিস্টেমটি নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে। + +| | ন্যূনতম | পছন্দসূচী | +| :---------: | ------- | --------- | +| আর্কিটেকচার | x64 | - | +| র‍্যাম | 8GB | 16GB | +| সংরক্ষণাগার | 1GB | 8GB | +| JDK | 17 | 21 | + +সঠিক কনফিগারেশন ফাইল সম্পাদনা করার জন্য, [Visual Studio Code](https://code.visualstudio.com/download) ইত্যাদি এডিটর ইনস্টল করা উচিত। + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="সঠিক আউটপুট" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' একটি অভ্যন্তরীণ বা বাহ্যিক কমান্ড, ক্রিয়াশীল প্রোগ্রাম, বা ব্যাচ ফাইল নয়। +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-ম্যাপড, ভ্যানিলা Minecraft ম্যাপিং। 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP কনফিগারেশন + +ইথারনেট অ্যাডাপ্টার ইথারনেট: + + সংযুক্ত DNS সাফিক্স. . . . : + IPv4 ঠিকানা. . . . . . . . . : 192.168.3.7 + সাবনেট মাস্ক . . . . . . . : 255.255.255.0 + ডিফল্ট গেটওয়ে . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. উন্নয়ন করা + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +নীচের বিবরণটি দিয়ে সার্ভার কিভাবে কাস্টমাইজ করা যায় তা জানুন। + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. অধিক তথ্যের জন্য [Minecraft ওয়েবসাইট](https://www.minecraft.net/ko-kr/usage-guidelines) দেখুন। + +[^10]: মাইক্রোসফট কর্পোরেশন। + +[^11]: বাংলাদেশের ক্ষেত্রে খেলার শিল্প উন্নয়ন আইন ৩২ ধারা ১ অনুচ্ছেদ ৯ অনুযায়ী **বাংলাদেশ মাইক্রোসফট কর্পোরেশন** কানুনীয়ভাবে অভিযোগ করতে পারে। + +[^12]: ইউনিভার্সাল প্লাগ এন্ড প্লে প্লে। Plazma এ অন্তর্ভুক্ত Purpur এই প্রযুক্তি দ্বারা অটোমেটিকলি রাউটার এবং সার্ভারের সাথে যোগাযোগ করে, যেটি পোর্ট খোলার প্রয়োজন হলে কেবলমাত্র সার্ভার চালু থাকলে, তাই পোর্ট ফরোয়ার্ডিং সরাসরি করতে হবে না। + +[^13]: অ্যাকাউন্ট না থাকলে Ngrok এ গুগল বা গিটহাব অ্যাকাউন্ট দিয়ে সাইন আপ করুন। diff --git a/bn/origin/plazma/administration/getting-started/customization.md b/bn/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..fe326142b --- /dev/null +++ b/bn/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: ব্যবহারকারীর অনুকূলকরণ করার উপায় জানুন। +--- + +# 🎨 ব্যবহারকারীর অনুকূলন + +মোজাং স্টুডিওস থেকে অফিসিয়াল সার্ভার প্ল্যাটফর্ম ব্যবহার না করে +Plazma এবং অন্যান্য সম্পাদিত সার্ভার প্ল্যাটফর্ম ব্যবহার করার কারণ হল এটি শক্তিশালী +**ব্যবহারকরণ** এর সম্ভাবনা আছে যা সবচেয়ে গুরুত্বপূর্ণ। + +নীচে কিছু Plazma ব্যবহারকরণ এবং প্রয়োগ উপায় দেয়া হয়েছে। + +## কনফিগারেশন সম্পাদনা + +Plazma কে ব্যবহারকরণ করার জন্য সবচেয়ে মৌলিক উপায় হল কনফিগারেশন সম্পাদনা করা। + +Plazma খেলার মেকানিজম থেকে মহান কনফিগারেশন সেটিংস প্রদান করে যেমন মবস এর গুণাবলী। + +Plazma এর কনফিগারেশন সম্পর্কে বিস্তারিত জানতে নীচের পেজটি দেখুন। + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## প্লাগইন ব্যবহার + +{% hint style="success" %} + +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, +Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 +모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. +Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 +공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 +사이트에 업로드하기도 합니다. + +{% hint style="caution" %} + +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, +신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. + +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 + 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, + `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. + 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. + `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. + 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, +[리소스팩](#user-content-fn-1)[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="caution" %} + +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. + +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. +폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} + +**일부 [데이터팩](#user-content-fn-2)[^2]의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. + +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, +서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} + +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md) + +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. diff --git a/bn/origin/plazma/administration/getting-started/next-step.md b/bn/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..9924f3765 --- /dev/null +++ b/bn/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: ব্যবহারকারীর অনুকূলকরণ করার উপায় জানুন। +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +নীচে কিছু Plazma ব্যবহারকরণ এবং প্রয়োগ উপায় দেয়া হয়েছে। + +## কনফিগারেশন সম্পাদনা + +Plazma কে ব্যবহারকরণ করার জন্য সবচেয়ে মৌলিক উপায় হল কনফিগারেশন সম্পাদনা করা। + +Plazma খেলার মেকানিজম থেকে মহান কনফিগারেশন সেটিংস প্রদান করে যেমন মবস এর গুণাবলী। + +Plazma এর কনফিগারেশন সম্পর্কে বিস্তারিত জানতে নীচের পেজটি দেখুন। + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## 플러그인 사용 + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. 폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +## 최적화 + +Plazma에는 많은 최적화 패치가 적용되어 있습니다. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 프록시 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +안전하고 올바른 프록시 설정에 대한 정보는 아래 페이지를 참고하세요. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 안전 + +Minecraft는 모드가 발달하여 온라인에서도 쉽게 [취약점 공격 엔진](#user-content-fn-3)[^3]을 구할 수 있습니다. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 권한 설정 + +일부 플러그인의 관리자 명령어는 권한이 제대로 설정되지 않은 취약점이 존재하기도 합니다. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray 차단 + +X-Ray는 기본적인 최적화 클라이언트에서도 쉽게 사용 가능한 취약점 중 하나입니다. + +Plazma에는 X-Ray를 기본적으로 차단할 수 있는 구성을 제공하고 있습니다. + +X-Ray 차단 방법과 설명은 아래 페이지를 참고하시기 바랍니다. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 화이트리스트 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +접속이 허용된 플레이어를 보려면 `/whitelist query` 를 사용합니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. + +[^3]: 일반적으로 "핵" 으로 불립니다. + +[^4]: 구성이 최적화되지 않았거나, Plazma가 오래되었거나, 새로 발견된 취약점의 경우 차단되어 있지 않을 수 있습니다. + +[^5]: 플레이어가 서버에 접속할 때 Ngrok 프록시 서버를 통해 접속되며, 매 재시작마다 발급되는 Ngrok 주소는 달라집니다. diff --git a/bn/origin/plazma/administration/reference/README.md b/bn/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..9a9c8e327 --- /dev/null +++ b/bn/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Plazma-এ ডিফল্ট প্রদানকৃত ব্যবহারকরণ পদ্ধতি জানুন। +--- + +# 📜 리퍼런스 + +Plazma-তে বিভিন্ন ব্যবহারকরণ পদ্ধতি উপলব্ধ করা হয়। + +যেগুলির মধ্যে, নিম্নলিখিত 4টি পদ্ধতি হল অতিরিক্ত কোন কাজ ছাড়াই ব্যবহার করা যেতে পারে। + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[আধিকারিক Discord সার্ভার](https://discord.gg/MmfC52K8A8) বা [GitHub আলোচনা](https://github.com/PlazmaMC/PlazmaBukkit/discussions) এ যোগ দিন এবং সম্প্রদায়ে প্রশ্ন করুন! +{% endhint %} + +*** + +## 🖥️ কমান্ড + +> কমান্ড খেলায় তথ্য সংগ্রহ করার অথবা প্লে এনভায়রনমেন্ট ব্যবহারকরণ করার সুযোগ প্রদান করে। + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ অনুমতি + +> অনুমতি খেলোয়ারের সাথে সম্প্রসারণ করার সীমা নির্ধারণ করে। + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ আর্গুমেন্ট এবং গুণ + +> আর্গুমেন্ট এবং গুণ Plazma-র কার্যকারিতায় প্রভাব ফেলে। + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 কনফিগারেশন + +> কনফিগারেশন Plazma-কে ব্যবহারকরণ করার জন্য সবচেয়ে মৌলিক পদ্ধতি। + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/bn/origin/plazma/administration/reference/arguments.md b/bn/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..7ea9a672d --- /dev/null +++ b/bn/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +শুরু অ্যার্গুমেন্ট এবং সিস্টেম গুণগুলি প্লাজমা এগিয়ে চলার [কমান্ড](#user-content-fn-1)[^1] এর মান হিসাবে ব্যবহার করা হয়, যা প্লাজমার পরিচালনায় সামগ্রিক প্রভাব ফেলে। + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 বিভক্ত হবে। + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +প্রোপার্টিতে কোনও মান প্রবেশ করানো না হলে মানটি [`true`তে স্থায়ী করা](#user-content-fn-3)[^3] হবে। + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **ধরন**: `বুলিয়ান` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` +- **স্পর্শ**: `Plazma.disableConfigOptimization` + +আদি কনফিগারেশন শক্তিশালীভাবে অপ্টাইজ করুন। + +এটি সক্রিয় করলে সার্ভারটি তাড়াতাড়ি এবং নিরাপদ হয়ে যায়, তবে গেম প্লেতে দ্বিধাহীন প্রভাব ফেলতে পারে। + +#### `Plazma.disableConfigOptimization` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` +- **স্পর্শ**: `Plazma.aggressiveOptimize` + +আদি কনফিগারেশন অপ্টাইজ করবেন না। + +এটি পেপারের ডিফল্ট কনফিগারেশন ব্যবহার করে। + +#### `Plazma.iKnowWhatIAmDoing` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Plazma ব্র্যান্ডিং বন্ধ করে এবং ভ্যানিলা ডিফল্ট সার্ভার ফেভিকনটি ব্যবহার করে। + +#### `Plazma.useVanillaConfiguration` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` +- **স্পর্শ**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +এটি সার্ভারের নিরাপত্তা এবং কর্মক্ষমতার উপর দৃঢ় প্রভাব ফেলতে পারে। + +এই গুণটি ব্যবহার করার ফলে সার্ভার পরিচালকের জবাবদিহিতার জন্য। +{% endhint %} + +আদি কনফিগারেশন মজাঙ্গ দ্বারা প্রদানের ডিফল্ট মানগুলি দেয়। + +এটি পেপারে প্যাচ প্রয়োগ করা পরিদৃশ্য বন্ধ করে। + +প্যাচ প্রয়োগ পেপার কনফিগারেশন বা প্লাজমা কনফিগারেশনে আবার চালু করা যেতে পারে। + +#### `Plazma.vanillaize` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `true` +- **স্পর্শ**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +আদি কনফিগারেশন ভ্যানিলাতে নিকট করা হয়। + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **উপনাম**: `সি` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **উপনাম**: `সি` +- **기본값**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(সুরক্ষিত মোড) সার্ভারটি পুরোপুরি ভ্যানিলা অবস্থায় চালু করুন। + +#### `server-ip` + +- **সংকেত**: `h`, `host` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **সংকেত**: `p`, `port` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +সার্ভারের পোর্ট সেট করুন। + +#### `server-name` + +- **স্ট্যান্ডার্ড মান**: `A Plazma Server` + +সার্ভারের নাম সেট করুন। + +#### `spigot-settings` + +- **সংকেত**: `S` +- **স্ট্যান্ডার্ড মান**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **সংকেত**: `v` + +Plazma সংস্করণ প্রদর্শন করুন। + +#### `world-dir` + +- **উপনাম**: `W`, `বিশ্ব`, `বিশ্ব-ধারক` +- **ডিফল্ট**: `(সার্ভার ফোল্ডার)` + +ওয়ার্ল্ড ফাইলটি সংরক্ষণ করার জায়গা সেট করে। + +#### `ওয়ার্ল্ড-নাম` + +- **উপনাম**: `w`, `ওয়ার্ল্ড` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +ওয়ার্ল্ড ফাইলের নাম সেট করে। + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: অ্যার্গুমেন্টগুলি প্রসেস করার জায়গা পরিবর্তিত হয় প্রয়োজনীয় স্থানের সাথে। + +[^3]: যেমন, `Plazma.iKnowWhatIAmDoing` কে সঠিকভাবে সেট করতে চাইলে, `-DPlazma.iKnowWhatIAmDoing=true` লিখতে হবে না, শুধুমাত্র `-DPlazma.iKnowWhatIAmDoing` লিখলেই কাজ হয়। + +[^4]: যেমন, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: ইভেন্ট ডিটেক্টর। + +[^6]: ইভেন্ট ডিটেক্টর। + +[^7]: ক্লায়েন্ট। + +[^8]: সার্ভারের সাথে সঠিকভাবে সংযোগিত আছেন এমন সূচনা যেমন হৃদয়ের ধ্বনি। + +[^9]: Purpur এর AFK বাহিত ব্যবহার করে অনুপস্থিত খেলোয়ারদেরও বাহিত করা যাবে। + +[^10]: সিঙ্ক চাঙ্ক রাইট সিস্টেম, Sync Chunk Write System। + +[^11]: \`সতর্কতা! প্লাজমা অপ্রত্যাশিত সমস্যা সৃষ্টি করতে পারে, তাই এটি ব্যবহার করার আগে এটি ভালোভাবে পরীক্ষা করুন এবং এটির পাবলিক সার্ভারে ব্যবহার করার আগে নিশ্চিত হন। + +[^12]: গেমে `ওয়ার্ল্ড অপটিমাইজেশন` এটা এই ধরনের একটি নীতিমালা অনুযায়ী কাজ করে। + +[^13]: `লেভেল 2` এর উপরের প্রশাসকদের বাদ দেওয়া হয়। + +[^14]: ইন্টারনেট প্রোটোকল, আইপি। diff --git a/bn/origin/plazma/administration/reference/commands.md b/bn/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..4d3732524 --- /dev/null +++ b/bn/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma에서 사용 가능한 명령어에 대해 알아보세요. +--- + +# 🖥️ কমান্ড diff --git a/bn/origin/plazma/administration/reference/configurations/README.md b/bn/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..f1bdd6064 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: কনফিগারেশন Plazma-কে ব্যবহারকরণ করার জন্য সবচেয়ে মৌলিক পদ্ধতি। +--- + +# 🧾 구성 + +*** + +## 🪨 গুণ + +> গুণগুলি মাইনক্রাফ্ট থেকে প্রদান করা সবচেয়ে মৌলিক কনফিগারেশন ফাইল। গুণগুলি ব্যবহার করে আপনি খেলার মৌলিক মেকানিজম পরিবর্তন করতে পারেন। + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 বুকিট কনফিগারেশন + +> বুকিট কনফিগারেশন প্লাজমা থেকে প্রদান করা সবচেয়ে মৌলিক কনফিগারেশন ফাইল। বুকিট কনফিগারেশন ব্যবহার করে মাইনক্রাফ্ট সার্ভারের মৌলিক মেকানিজম পরিবর্তন করতে পারেন। + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 স্পিগট কনফিগারেশন + +> স্পিগট কনফিগারেশন খেলার বিস্তারিত মেকানিজম, প্লেয়ার প্রসেসিং, কমান্ড ইত্যাদি সম্পাদনা এবং বার্তা পরিবর্তন করতে পারে। + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ পেপার কনফিগারেশন + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 পাফারফিশ + +> পাফারফিশ কনফিগারেশন প্লাজমার বিশ্ব এবং এন্টিটি প্রসেসিং পরিবর্তন করতে দেয়। + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 পুরপুর কনফিগারেশন + +> পুরপুর গুণ খেলার সামগ্রিক মৌলিক ডেটা সম্পাদন করতে পারে। + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ প্লাজমা কনফিগারেশন + +> প্লাজমা কনফিগারেশন প্লাজমার কার্যক্ষম করার সুযোগ দেয়। + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/bn/origin/plazma/administration/reference/configurations/bukkit.md b/bn/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..2adc7e129 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml এর প্রতিটি নোড কি মানে রাখে তা জানুন। +--- + +# 🪣 Bukkit diff --git a/bn/origin/plazma/administration/reference/configurations/paper/README.md b/bn/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..f35f630e7 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config ফোল্ডারের প্রতিটি ফাইলের উদ্দেশ্য কি জানুন। +--- + +# 🛩️ কাগজ diff --git a/bn/origin/plazma/administration/reference/configurations/paper/global.md b/bn/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..46b4a347a --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml এর প্রতিটি নোড এর অর্থ কী জানুন। +--- + +# 🌏 전역 구성 diff --git a/bn/origin/plazma/administration/reference/configurations/paper/world.md b/bn/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..3fa8a6db7 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: paper-world.yml-র প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🏳️ 세계별 구성 + +বিশ্বব্যাপী diff --git a/bn/origin/plazma/administration/reference/configurations/plazma/README.md b/bn/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..8ca12bdfb --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config ফোল্ডারের প্রতিটি ফাইলের উদ্দেশ্য কি জানুন। +--- + +# ✨ প্লাজমা diff --git a/bn/origin/plazma/administration/reference/configurations/plazma/global.md b/bn/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..56c424410 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: প্লাজমা-গ্লোবাল.yml ফাইলের প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🌏 전역 구성 diff --git a/bn/origin/plazma/administration/reference/configurations/plazma/world.md b/bn/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..ca95a1838 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml এর প্রতিটি নোড এর অর্থ কি জানুন। +--- + +# 🏳️ 세계별 구성 diff --git a/bn/origin/plazma/administration/reference/configurations/plazma/worlds.md b/bn/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..0b169f103 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml এর প্রতিটি নোড এর অর্থ কি জানুন। +--- + +# ✨ Plazma (বিশ্বগুলির গঠন) diff --git a/bn/origin/plazma/administration/reference/configurations/property.md b/bn/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..002dfa6ad --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties-এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🪨 Server.properties diff --git a/bn/origin/plazma/administration/reference/configurations/pufferfish.md b/bn/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..8316524d7 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🐡 পাফারফিশ diff --git a/bn/origin/plazma/administration/reference/configurations/purpur/README.md b/bn/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..69a33de90 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🦑 Purpur diff --git a/bn/origin/plazma/administration/reference/configurations/purpur/global.md b/bn/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..f4bb0adac --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🌏 전역 구성 diff --git a/bn/origin/plazma/administration/reference/configurations/purpur/world.md b/bn/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..0071d7397 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🏳️ 세계별 구성 diff --git a/bn/origin/plazma/administration/reference/configurations/spigot.md b/bn/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..a3cea83a5 --- /dev/null +++ b/bn/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml এর প্রতিটি নোড কি অর্থ বোঝার জন্য দেখুন। +--- + +# 🚰 Spigot diff --git a/bn/origin/plazma/administration/reference/permissions.md b/bn/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..79c1bbf46 --- /dev/null +++ b/bn/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Plazma-র অনুমতি সম্পর্কে জানুন। +--- + +# 🛡️ অনুমতি + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **기본 제공**: `세계 관리자` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.demo` + +- **기본 제공**: `세계 관리자` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ping` + +- **기본 제공**: `세계 관리자` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **기본 제공**: `세계 관리자` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **기본 제공**: `세계 관리자` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.restart` + +- **기본 제공**: `세계 관리자` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **기본 제공**: `세계 관리자` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **기본 제공**: `세계 관리자` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.timings` + +- **기본 제공**: `세계 관리자` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **기본 제공**: `세계 관리자` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **기본 제공**: `세계 관리자` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `paper.antixray.bypass` + +- **기본 제공**: `없음` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **기본 제공**: `없음` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **기본 제공**: `없음` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **기본 제공**: `없음` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **기본 제공**: `없음` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **기본 제공**: `없음` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **기본 제공**: `세계 관리자` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **기본 제공**: `없음` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **기본 제공**: `없음` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **기본 제공**: `없음` + +ইনভেন্টরিতে মৃত্যুরহিত টোটেমটি কাজ করতে দেওয়া হয়। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **기본 제공**: `없음` + +খেলোয়ারকে সংযোগের সীমা উপেক্ষা করতে দেওয়া হয়। + +#### `purpur.mending_shift_click` + +- **기본 제공**: `없음` + +খেলোয়ারকে `উপস্থিত হতে হবে এবং সাথে কাজ করতে হবে` যদি তার কাছে আইটেম থাকে। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **기본 제공**: `없음` + +খেলোয়ারকে স্পয়ানার স্থাপন করতে দেওয়া হয়। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **기본 제공**: `없음` + +খেলোয়ারকে নেদার পোর্টাল ব্যবহার করলে তাকে তাতে সরাসরি স্থানান্তর করতে দিন। + +#### `purpur.sign.color` + +- **기본 제공**: `없음` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **기본 제공**: `없음` + +টেক্সট মেকাপে ম্যাজিক কোড `(&o)` ব্যবহার করতে দেওয়া হয়। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **기본 제공**: `없음` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **기본 제공**: `없음` + +খেলোয়ারকে কাটার মাধ্যমে টিএনটি বিস্ফোরণ বাধা দেওয়া হয়। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### প্রদান প্রিভিলেজ + +#### `plazma.bypass.ncr-require` + +- **기본 제공**: `없음` + +খেলোয়ারকে [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) মোড ইনস্টল করা না থাকলেও সংযোগ করতে দেওয়া হয়। + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: অপারেটর। + +[^2]: উদাহরণ: `ender_dragon` diff --git a/bn/origin/plazma/adminstration/README.md b/bn/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..65d38e40a --- /dev/null +++ b/bn/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma ব্যবহার করে আপনার নিজের সার্ভার তৈরি করুন। +--- + +# ⚒️ সার্ভার পরিচালনা গাইড diff --git a/bn/origin/plazma/adminstration/expert/README.md b/bn/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..6a317058a --- /dev/null +++ b/bn/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: প্লাজমা সম্পর্কে পেশাদারভাবে জানুন। +--- + +# 🎓 এডভান্সড diff --git a/bn/origin/plazma/adminstration/expert/fix-exploits.md b/bn/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..318e63291 --- /dev/null +++ b/bn/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: পরিচিত ভুলবুঝার সমস্যা এবং তা সমাধানের উপায় জানুন। +--- + +# ⚠️ পরিচিত ভুলবুঝার সমস্যা এবং তা সমাধানের উপায় diff --git a/bn/origin/plazma/adminstration/expert/optimize.md b/bn/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..a96a2fbc3 --- /dev/null +++ b/bn/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: প্লাজমা অপটিমাইজেশনের উপায় জানুন। +--- + +# 🧹 অপটিমাইজেশন diff --git a/bn/origin/plazma/adminstration/expert/vanillaize.md b/bn/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..cb096d873 --- /dev/null +++ b/bn/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper এবং ভ্যানিলা প্যাচ পুনরুদ্ধার করার উপায় জানুন। +--- + +# ↩️ ভ্যানিলাইজ + +{% hint style="warning" %} + +### Paper는 ভ্যানিলার অভ্যন্তরীণ সমস্যা সমাধানে অধিকাংশ প্যাচ বিকল্প প্রদান করেনি। + +বর্তমানে Plazma এমন সমস্যা সমাধান বিন্যাস করেছে যাতে এগুলি নিষ্ক্রিয় করা যায়। + +এই কারণে এই গাইডটি এখনও লেখার অধীনে আছে এবং সবসময় তথ্য পরিবর্তনের সম্ভাবনা রয়েছে। +{% endhint %} diff --git a/bn/origin/plazma/adminstration/faq.md b/bn/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..a326ff23b --- /dev/null +++ b/bn/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: 자주 জিজ্ঞাসিত প্রশ্ন সম্পর্কে জানুন। +--- + +# ⁉️ জিজ্ঞাসিত প্রশ্ন + +{% hint style="info" %} + +### আপনি কি পছন্দের উত্তর খুঁজতে পারছেন না? + +[অফিসিয়াল Discord সার্ভার](https://discord.gg/MmfC52K8A8) বা [GitHub ইস্যু](https://github.com/PlazmaMC/PlazmaBukkit/issues) এর মাধ্যমে সম্প্রদায়ে প্রশ্ন করুন! +{% endhint %} + +### এক্সিকিউট করার সময় মেসেজ প্রিন্ট করা হচ্ছে না + +যদি কনসোলে `no main manifest attribute, in plazma-(version).jar` মেসেজ প্রিন্ট হয়,\ +তাহলে ডাউনলোড করা ফাইলটি ডেভেলপমেন্ট API ফাইল এবং GitHub পেজ থেকে **Reobf Paperweight** ডাউনলোড করতে হবে। + +বিস্তারিত জানতে নিচের পেজটি দেখুন। + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### সার্ভার চালু হওয়ার সময় সবসময় সতর্কতা দেখানো হয় + +Plazma-তে কিছু অস্থির প্যাচ থাকতে পারে এবং সার্ভারে সবসময় অপ্রত্যাশিত সমস্যা হতে পারে, তাই সার্ভার চালু হওয়ার সময় এই ধরনের সতর্কতা মেসেজ প্রিন্ট করে। + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +উক্ত সতর্কতা মেসেজটি ব্যবহার করে অনলাইনে নিষ্ক্রিয় করা যেতে পারে [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] সিস্টেম প্রপার্টির মাধ্যমে। + +বিস্তারিত জানতে নিচের পেজটি দেখুন। + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1 থেকে পাওয়া যাবে diff --git a/bn/origin/plazma/adminstration/getting-started/README.md b/bn/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..c9836d786 --- /dev/null +++ b/bn/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Plazmaর সার্ভার তৈরি করার উপায় জানুন। +--- + +# 👟 শুরু করুন + +Plazma একটি স্থিতিশীলভাবে ব্যবহার করতে, সিস্টেমটি নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে। + +| | ন্যূনতম | পছন্দসূচী | +| :---------: | ------: | --------: | +| আর্কিটেকচার | x64 | - | +| র‍্যাম | 8GB | 16GB | +| সংরক্ষণাগার | 1GB | 8GB | +| JRE | 17 | 21 | + +সঠিক কনফিগারেশন ফাইল সম্পাদনা করার জন্য, [Visual Studio Code](https://code.visualstudio.com/download) ইত্যাদি এডিটর ইনস্টল করা উচিত। + +*** + +## 1. JRE ইনস্টল + +নাম থেকেই বোঝা যায়, Minecraft: **"Java"** সংস্করণটি Java-তে তৈরি, চালানোর জন্য JRE[^1] প্রয়োজন। + +Plazma Mojang Studios-এর অফিসিয়াল সার্ভার প্ল্যাটফর্ম [ভিত্তিক](#user-content-fn-2)[^2], Plazma ব্যবহার করার জন্যও JRE ইনস্টল করা উচিত। + +### 1.1 JRE উপস্থিতি পরীক্ষা + +সিস্টেমে JRE ইনস্টল করা আছে কি না তা যাচাই করতে, [এক্সিকিউট উইন্ডো](#user-content-fn-3)[^3] এ [`cmd /k java --version`](#user-content-fn-4)[^4] টাইপ করে এবং এটি চালান। + +নিম্নলিখিত মত আউটপুট পেলে [2 তম ধাপ](setup.md#id-2) এ যান। + +{% code title="সঠিক আউটপুট" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +উপরের মত আউটপুট না পেলে, বা নিম্নলিখিত মত পেলে JRE নাই বা খুব পুরানো, তাহলে [1.2 তম ধাপ](setup.md#id-1.2) টি পূরণ করতে হবে। + +{% code title="JRE ইনস্টল হয়নি" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE가 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +본 가이드에서는 JRE의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](setup.md#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. অধিক তথ্যের জন্য [Minecraft ওয়েবসাইট](https://www.minecraft.net/ko-kr/usage-guidelines) দেখুন। + +[^10]: মাইক্রোসফট কর্পোরেশন। + +[^11]: বাংলাদেশের ক্ষেত্রে খেলার শিল্প উন্নয়ন আইন ৩২ ধারা ১ অনুচ্ছেদ ৯ অনুযায়ী **বাংলাদেশ মাইক্রোসফট কর্পোরেশন** কানুনীয়ভাবে অভিযোগ করতে পারে। + +[^12]: ইউনিভার্সাল প্লাগ এন্ড প্লে প্লে। Plazma এ অন্তর্ভুক্ত Purpur এই প্রযুক্তি দ্বারা অটোমেটিকলি রাউটার এবং সার্ভারের সাথে যোগাযোগ করে, যেটি পোর্ট খোলার প্রয়োজন হলে কেবলমাত্র সার্ভার চালু থাকলে, তাই পোর্ট ফরোয়ার্ডিং সরাসরি করতে হবে না। + +[^13]: অ্যাকাউন্ট না থাকলে Ngrok এ গুগল বা গিটহাব অ্যাকাউন্ট দিয়ে সাইন আপ করুন। diff --git a/bn/origin/plazma/adminstration/getting-started/customization.md b/bn/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..1f29b3f37 --- /dev/null +++ b/bn/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: ব্যবহারকারীর অনুকূলকরণ করার উপায় জানুন। +--- + +# 🎨 ব্যবহারকারীর অনুকূলন diff --git a/bn/origin/plazma/adminstration/reference/arguments.md b/bn/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..b247ba2d0 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **ধরন**: `বুলিয়ান` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **ধরন**: `পূর্ণসংখ্যা` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +{% hint style="warning" %} + +### 해당 속성은 1.20.5 이후 시작 인수로 이동 될 예정입니다. + +{% endhint %} + +처음 시작시 적용되는 구성 최적화를 더 엄격하게 적용합니다. + +활성화 하면 서버가 더욱 빨라지고 안전해지지만, 일부 기믹을 차단하거나 게임 플레이에 큰 영향을 줄 수 있습니다. + +#### `Plazma.iKnowWhatIAmDoing` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **ধরন**: `বুলিয়ান` +- **ডিফল্ট**: `মিথ্যা` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **উপনাম**: `সি` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **উপনাম**: `সি` +- **기본값**: `server.properties` + +[서버 속성](../reference/configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 [업그레이드](#user-content-fn-12)[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +허용되는 최대 [플레이어](#user-content-fn-14)[^14] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우 [EULA](../getting-started/README.md#id-5) 위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용이 중지되었습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(সুরক্ষিত মোড) সার্ভারটি পুরোপুরি ভ্যানিলা অবস্থায় চালু করুন। + +#### `server-ip` + +- **সংকেত**: `h`, `host` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +সার্ভারের হোস্ট নাম বা [ইন্টারনেট প্রোটোকল](#user-content-fn-13)[^13] ঠিকানা সেট করুন। + +#### `server-port` + +- **সংকেত**: `p`, `port` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +সার্ভারের পোর্ট সেট করুন। + +#### `server-name` + +- **স্ট্যান্ডার্ড মান**: `A Plazma Server` + +সার্ভারের নাম সেট করুন। + +#### `spigot-settings` + +- **সংকেত**: `S` +- **স্ট্যান্ডার্ড মান**: `spigot.yml` + +[Spigot কনফিগারেশন ফাইল](../reference/configurations/spigot.md) এর নাম এবং অবস্থান সেট করুন। + +#### `version` + +- **সংকেত**: `v` + +Plazma সংস্করণ প্রদর্শন করুন। + +#### `world-dir` + +- **উপনাম**: `W`, `বিশ্ব`, `বিশ্ব-ধারক` +- **ডিফল্ট**: `(সার্ভার ফোল্ডার)` + +ওয়ার্ল্ড ফাইলটি সংরক্ষণ করার জায়গা সেট করে। + +#### `ওয়ার্ল্ড-নাম` + +- **উপনাম**: `w`, `ওয়ার্ল্ড` +- **ডিফল্ট**: `(সার্ভার গুণ)` + +ওয়ার্ল্ড ফাইলের নাম সেট করে। + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: অ্যার্গুমেন্টগুলি প্রসেস করার জায়গা পরিবর্তিত হয় প্রয়োজনীয় স্থানের সাথে। + +[^3]: যেমন, `Plazma.iKnowWhatIAmDoing` কে সঠিকভাবে সেট করতে চাইলে, `-DPlazma.iKnowWhatIAmDoing=true` লিখতে হবে না, শুধুমাত্র `-DPlazma.iKnowWhatIAmDoing` লিখলেই কাজ হয়। + +[^4]: যেমন, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: ইভেন্ট ডিটেক্টর। + +[^6]: ইভেন্ট ডিটেক্টর। + +[^7]: ক্লায়েন্ট। + +[^8]: সার্ভারের সাথে সঠিকভাবে সংযোগিত আছেন এমন সূচনা যেমন হৃদয়ের ধ্বনি। + +[^9]: Purpur এর AFK বাহিত ব্যবহার করে অনুপস্থিত খেলোয়ারদেরও বাহিত করা যাবে। + +[^10]: সিঙ্ক চাঙ্ক রাইট সিস্টেম, Sync Chunk Write System। + +[^11]: \`সতর্কতা! প্লাজমা অপ্রত্যাশিত সমস্যা সৃষ্টি করতে পারে, তাই এটি ব্যবহার করার আগে এটি ভালোভাবে পরীক্ষা করুন এবং এটির পাবলিক সার্ভারে ব্যবহার করার আগে নিশ্চিত হন। + +[^12]: গেমে `ওয়ার্ল্ড অপটিমাইজেশন` এটা এই ধরনের একটি নীতিমালা অনুযায়ী কাজ করে। + +[^13]: ইন্টারনেট প্রোটোকল, আইপি। + +[^14]: `লেভেল 2` এর উপরের প্রশাসকদের বাদ দেওয়া হয়। diff --git a/bn/origin/plazma/adminstration/reference/commands.md b/bn/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..4d3732524 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma에서 사용 가능한 명령어에 대해 알아보세요. +--- + +# 🖥️ কমান্ড diff --git a/bn/origin/plazma/adminstration/reference/configurations/bukkit.md b/bn/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..2adc7e129 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml এর প্রতিটি নোড কি মানে রাখে তা জানুন। +--- + +# 🪣 Bukkit diff --git a/bn/origin/plazma/adminstration/reference/configurations/paper/README.md b/bn/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..f35f630e7 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config ফোল্ডারের প্রতিটি ফাইলের উদ্দেশ্য কি জানুন। +--- + +# 🛩️ কাগজ diff --git a/bn/origin/plazma/adminstration/reference/configurations/paper/global.md b/bn/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..786aebe09 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml এর প্রতিটি নোড এর অর্থ কী জানুন। +--- + +# 🛩️ কাগজ (গ্লোবাল কনফিগারেশন) diff --git a/bn/origin/plazma/adminstration/reference/configurations/paper/world.md b/bn/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..d76c36e05 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: paper-world.yml-র প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🛩️ কাগজ (পেপার) (প্রপার্টি বায়ুয়ান) diff --git a/bn/origin/plazma/adminstration/reference/configurations/plazma/README.md b/bn/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..8ca12bdfb --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config ফোল্ডারের প্রতিটি ফাইলের উদ্দেশ্য কি জানুন। +--- + +# ✨ প্লাজমা diff --git a/bn/origin/plazma/adminstration/reference/configurations/plazma/global.md b/bn/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..ba5562345 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: প্লাজমা-গ্লোবাল.yml ফাইলের প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# ✨ প্লাজমা (গ্লোবাল কনফিগারেশন) diff --git a/bn/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/bn/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..41b533285 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ বিশ্বের প্রকৃতি diff --git a/bn/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/bn/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..0b169f103 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml এর প্রতিটি নোড এর অর্থ কি জানুন। +--- + +# ✨ Plazma (বিশ্বগুলির গঠন) diff --git a/bn/origin/plazma/adminstration/reference/configurations/property.md b/bn/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..002dfa6ad --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties-এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🪨 Server.properties diff --git a/bn/origin/plazma/adminstration/reference/configurations/pufferfish.md b/bn/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..8316524d7 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🐡 পাফারফিশ diff --git a/bn/origin/plazma/adminstration/reference/configurations/purpur/README.md b/bn/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..69a33de90 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🦑 Purpur diff --git a/bn/origin/plazma/adminstration/reference/configurations/purpur/global.md b/bn/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..ba211d0e7 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🦑 পুরপুর (গ্লোবাল সেটিং) diff --git a/bn/origin/plazma/adminstration/reference/configurations/purpur/world.md b/bn/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..70bbc2e7d --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml এর প্রতিটি নোড কী অর্থ রাখে তা জানুন। +--- + +# 🦑 পুরপুর (বিশ্ব পরিকল্পনা) diff --git a/bn/origin/plazma/adminstration/reference/configurations/spigot.md b/bn/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..a3cea83a5 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml এর প্রতিটি নোড কি অর্থ বোঝার জন্য দেখুন। +--- + +# 🚰 Spigot diff --git a/bn/origin/plazma/adminstration/reference/permissions.md b/bn/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..3108f2df0 --- /dev/null +++ b/bn/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Plazma-র অনুমতি সম্পর্কে জানুন। +--- + +# 🛡️ অনুমতি diff --git a/bn/origin/plazma/developers.md b/bn/origin/plazma/developers.md new file mode 100644 index 000000000..c13d914d6 --- /dev/null +++ b/bn/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Plazma ব্যবহার করে থার্ড পার্টি প্রজেক্ট ডেভেলপ করুন। +--- + +# ⚙️ ডেভেলপার গাইড diff --git a/bn/origin/thunderbolt/README.md b/bn/origin/thunderbolt/README.md new file mode 100644 index 000000000..82c44b8ae --- /dev/null +++ b/bn/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 패치를 Flavor로 구분하여 직접 사용해볼 수 있도록 하는 Plazma 기반 서버 플랫폼입니다. +--- + +# 🌩️ Thunderbolt ব্যবহার গাইড diff --git a/bn/origin/volt/README.md b/bn/origin/volt/README.md new file mode 100644 index 000000000..78b0d6022 --- /dev/null +++ b/bn/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Paperweight সার্ভার প্লাটফর্ম তৈরি করতে পারে এমন একটি ওপেন সোর্স টেমপ্লেট। +--- + +# ⚡ Volt Development Guide diff --git a/ca/origin/README.md b/ca/origin/README.md new file mode 100644 index 000000000..ff03eaf24 --- /dev/null +++ b/ca/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Si tens alguna pregunta, si us plau, fes-la a través de Discord o de les Discussió de GitHub. +--- + +# 🏠 Benvingut al Portal de Docs + +{% hint style="info" %} + +**Els documents de Plazma estan actualment en un estat de traducció automàtica.** + +[![Estat de traducció](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Col·labora en la traducció de documents a [https://translate.plazmamc.org/](https://translate.plazmamc.org/) per millorar els documents. + +{% endhint %} + +### Si tens problemes mentre fas servir el Plazma, què has de fer? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Si tens interès en el Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Si vols crear la teva pròpia plataforma de servidor amb el Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `PATROCINADOR` Si necessites més informació relacionada amb Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ca/origin/SUMMARY.md b/ca/origin/SUMMARY.md new file mode 100644 index 000000000..6e5bf0f0b --- /dev/null +++ b/ca/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Taula de continguts + +- [🏠 Benvingut a Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documents d'ús de Plazma](plazma/README.md) +- [❓ Què és Plazma?](plazma/about/README.md) + - [⬇️ Descàrrega](plazma/about/downloads.md) + - [✅ Estat de suport de les versions](plazma/about/supported-versions.md) +- [⚒️ Guia de gestió del servidor](plazma/administration/README.md) + - [👟 Començar](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referència](plazma/administration/reference/README.md) + - [🖥️ Comandes](plazma/administration/reference/commands.md) + - [🛡️ Permisos](plazma/administration/reference/permissions.md) + - [🎛️ Arguments i propietats](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Propietat](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configuració global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Configuracions per països](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configuració global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Configuracions per països](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configuració global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Configuracions per països](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avançat](plazma/administration/expert/README.md) + - [🧹 Optimització](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Convertir a vanilla](plazma/administration/expert/vanillaize.md) + - [🩻 Bloqueig de raigs X](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilitats i solucions](plazma/administration/expert/fix-exploits.md) + - [⁉️ Preguntes freqüents](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Guia de desenvolupament](plazma/developers.md) + - [✏️ Contribuir](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Guia d'ús de Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Guia de desenvolupament de Volt](volt/README.md) + +## Miscel·lània + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Veure totes les descàrregues](plazma/about/downloads-all.md) diff --git a/ca/origin/miscellaneous/README.md b/ca/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ca/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ca/origin/plazma/README.md b/ca/origin/plazma/README.md new file mode 100644 index 000000000..189817004 --- /dev/null +++ b/ca/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma és una plataforma de servidor de codi obert per a Minecraft: Java Edition que afegeix optimització experimental basada en paper i característiques de personalització de mecanismes de joc." +--- + +# ✨ Documentació d'ús de Plazma + +## 👋 Benvingut a la documentació de Plazma + +Benvingut/da a la guia d'ús de Plazma! + +{% hint style="info" %} + +**No podeu resoldre el problema a través del manual?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) o [Debats de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) per preguntar a la comunitat! + +{% endhint %} + +### Sobre Plazma + +> Descobreix què és Plazma com a plataforma de servidor. + +{% content-ref url="about/" %} +[sobre](about/) +{% endcontent-ref %} + +### Per a administradors + +> Crea el teu propi servidor amb Plazma. + +{% content-ref url="administració/" %} +[administració](administració/) +{% endcontent-ref %} + +### Per a desenvolupadors + +> Desenvolupa projectes de tercers amb Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ca/origin/plazma/about/README.md b/ca/origin/plazma/about/README.md new file mode 100644 index 000000000..c5764c160 --- /dev/null +++ b/ca/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Descobreix què és Plazma com a plataforma de servidor. +--- + +# ❓ Què és Plazma? + +- **Plazma** és una plataforma de servidor basada en [Paper](https://github.com/PaperMC/Paper) que recull només els avantatges de [Andròmeda](https://github.com/EarendelArchived/Andromeda) i [Fusió](https://github.com/RuinedTechnologyUnify/Fusion). +- Estem treballant per proporcionar sempre una alta estabilitat, un rendiment potent, actualitzacions ràpides i una gran quantitat de funcions. + +## 📋 Objectius de Plazma + +- Estem treballant per convertir-nos en una plataforma de servidor amb actualitzacions ràpides i alta estabilitat. +- Estem treballant per oferir una gran quantitat de funcions i un rendiment potent, igual que una plataforma de mod. +- Estem treballant per crear una plataforma lliure on es pugui personalitzar fins i tot els parches de la vanília. + +## ⚙️ Característiques principals + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Actualitzacions més ràpides**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) manté sempre actualitzades les correccions incloses a Plazma, oferint les actualitzacions més ràpides entre les plataformes de servidor basades en Paper. +6. **Optimització dels fitxers de configuració bàsics**\ + Els fitxers de configuració per defecte estan optimitzats, evitant la necessitat d'optimitzar-los manualment. +7. **Funcionament sistemàtic de múltiples fils**\ + Asincronitza els mecanismes del sistema que no estan relacionats amb els mecanismes del joc per optimitzar el servidor i reduir els temps de retard[^4]. +8. **Bloqueig de l'ús d'espai innecessari**\ + Combina les dades amb valors similars en un de sol per reduir l'ús de memòria. + +## ✨ Casos d'ús + +- **Plataforma que gestiona fins i tot els plugins més complexos de manera adequada**\ + El servidor de l'IPECTER utilitza Plazma.\ + Amb plugins propis que funcionen amb NMS i reflexió, i una gran quantitat de paquets de dades complexos aplicats,\ + és capaç de suportar més de 100 jugadors sense cap descens de rendiment. +- **Plataforma que manté un rendiment ràpid fins i tot en servidors RPG**\ + Ha mantingut 100 jugadors en un sol clúster sense cap descens de TPS de manera estable,\ + i ha permès a 250 jugadors jugar còmodament en 4 clústers. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Plataforma escollida per molts streamers**\ + És utilitzada com a cub per a la participació dels espectadors de molts streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Descarregar + +Pots descarregar Plazma des de la següent pàgina. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Vols més informació sobre les versions compatibles? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plugins de Bukkit, CraftBukkit, Spigot i plugins de Paper, Pufferfish, Purpur. + +[^2]: Propietat de Microsoft Corporation. + +[^3]: En desactivar el sistema de denúncies de xat, el xat es processa únicament al servidor, evitant el seguiment del xat de Mojang. + +[^4]: Temps en què el joc es deté temporalment perquè funcioni el mecanisme del sistema. diff --git a/ca/origin/plazma/about/downloads-all.md b/ca/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..1f1e58e57 --- /dev/null +++ b/ca/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma executable descarregar visualització completa +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versió | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ca/origin/plazma/about/downloads.md b/ca/origin/plazma/about/downloads.md new file mode 100644 index 000000000..d1dbe9083 --- /dev/null +++ b/ca/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Ara mateix descarregueu Plazma i proveu-lo directament. +--- + +# ⬇️ Descarregar + +#### Vols més informació sobre les versions compatibles? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**El següent descàrrega és un fitxer executable per a usuaris normals.** + +Si ets un desenvolupador i necessites un altre tipus de fitxer, consulta la següent pàgina. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersióDescarregar
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + descarregar +
1.20.1 + Descarregar +
1.19.4 + Descarregar +
+ +*** diff --git a/ca/origin/plazma/about/patches-list.md b/ca/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..802cc218c --- /dev/null +++ b/ca/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Descobreix tots els funcionalitats afegides a Plazma. +--- + +# 📑 Patches inclosos diff --git a/ca/origin/plazma/about/supported-versions.md b/ca/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..004ee17b3 --- /dev/null +++ b/ca/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Descobreix les versions de Minecraft: Java Edition suportades a Plazma." +--- + +# ✅ Estat de suport de versions + +{% hint style="info" %} + +**Plazma és desenvolupa des de la versió 1.19.4, les versions anteriors a la 1.19.4 no estan sent desenvolupades.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Sense%20informació +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Esperant llançament][wtr] ![En desenvolupament][idv] ![En suport][atv] ![Suport de funcionalitats interromput][fse] ![Suport finalitzat][eol] + +| Versió | Estabilitat i suport de funcionalitats | Estat de construcció | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Estat de la construcció](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Estat de construcció](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Estat de construcció](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ca/origin/plazma/administration/README.md b/ca/origin/plazma/administration/README.md new file mode 100644 index 000000000..e91719658 --- /dev/null +++ b/ca/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Crea el teu propi servidor amb Plazma. +--- + +# ⚒️ Guia de gestió del servidor diff --git a/ca/origin/plazma/administration/diagnosis/README.md b/ca/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..bf9434d8b --- /dev/null +++ b/ca/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com gestionar quan es produeix un problema. +--- + +# 🧾 진단 diff --git a/ca/origin/plazma/administration/diagnosis/plugins.md b/ca/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..2a51176d6 --- /dev/null +++ b/ca/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com solucionar quan el connector no funciona correctament. +--- + +# 📜 플러그인 diff --git a/ca/origin/plazma/administration/expert/README.md b/ca/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..e2b57b7d2 --- /dev/null +++ b/ca/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com gestionar de manera professional el Plazma. +--- + +# 🎓 Avançat diff --git a/ca/origin/plazma/administration/expert/fix-exploits.md b/ca/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..e210d88e0 --- /dev/null +++ b/ca/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com solucionar les vulnerabilitats conegudes i com resoldre-les. +--- + +# ⚠️ Vulnerabilitats conegudes i com solucionar-les diff --git a/ca/origin/plazma/administration/expert/optimize.md b/ca/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..a386dd599 --- /dev/null +++ b/ca/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com optimitzar el Plazma. +--- + +# 🧹 Optimització diff --git a/ca/origin/plazma/administration/expert/proxy.md b/ca/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..c1aa7cba7 --- /dev/null +++ b/ca/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Descobriu com configurar de manera segura la plataforma de proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/ca/origin/plazma/administration/expert/vanillaize.md b/ca/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..34e281c87 --- /dev/null +++ b/ca/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Descobreix com restaurar el patch de Paper i Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper no afegeix opcions a la majoria de les correccions d'errors de la vainilla.** + +Actualment, Plazma està desenvolupant una configuració per desactivar aquestes correccions d'errors. + +Per tant, aquesta guia encara està en procés de redacció i la informació pot canviar en qualsevol moment. + +{% endhint %} diff --git a/ca/origin/plazma/administration/expert/xray.md b/ca/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..4f5f2ed65 --- /dev/null +++ b/ca/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Descobreix diverses maneres integrades de bloquejar els raigs X. +--- + +# 🩻 Bloqueig dels raigs X diff --git a/ca/origin/plazma/administration/faq.md b/ca/origin/plazma/administration/faq.md new file mode 100644 index 000000000..b6639d217 --- /dev/null +++ b/ca/origin/plazma/administration/faq.md @@ -0,0 +1,43 @@ +--- +description: Descobreix més sobre les preguntes freqüents. +--- + +# ⁉️ Preguntes freqüents + +{% hint style="info" %} + +**No trobeu la resposta que busqueu?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) o [Debats de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) per preguntar a la comunitat! + +{% endhint %} + +### Plazma no s'inicia + +Si apareix `no main manifest attribute, in plazma-(versió).jar` a la consola, el fitxer descarregat és un fitxer API de desenvolupament, heu de descarregar **Reobf Paperweight** de la pàgina de GitHub. + +Per obtenir més informació, consulteu la següent pàgina. + +{% content-ref url="getting-started/" %} +[inici](getting-started#id-2) +{% endcontent-ref %} + +### Es mostra un advertència cada vegada que el servidor s'inicia + +Plazma conté algunes correccions inestables i sempre pot funcionar incorrectament, per això mostra aquest missatge d'avís cada vegada que el servidor s'inicia. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Aquest missatge d'avís es pot desactivar utilitzant la propietat del sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Per obtenir més informació, consulteu la següent pàgina. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponible a partir de la versió 1.20.1 diff --git a/ca/origin/plazma/administration/getting-started/README.md b/ca/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..3acc3b1ba --- /dev/null +++ b/ca/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Descobreix com crear un servidor amb Plazma. +--- + +# 👟 Començar + +Per utilitzar Plazma de manera estable, el sistema ha de complir amb els següents requisits. + +| | Mínim | Recomanat | +| :--------------------: | ----- | --------- | +| Arquitectura | x64 | - | +| RAM | 8GB | 16GB | +| Espai d'emmagatzematge | 1GB | 8GB | +| JDK | 17 | 21 | + +Per a una edició de fitxers de configuració més fàcil, també és recomanable instal·lar un editor com [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Sortida correcta" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Entorn d'execució Zulu21.32+17-CA (compilació 21.0.2+13-LTS) +OpenJDK Màquina virtual de servidor de 64 bits Zulu21.32+17-CA (compilació 21.0.2+13-LTS, mode mixt, compartit) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' no és un comandament intern o extern, un programa executable o un +fitxer de processament per lots. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Opció no reconeguda: --versió +Error: No s'ha pogut crear la Màquina Virtual Java. +Error: Ha succeït una excepció fatal. El programa sortirà. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Primer, des de [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) baixeu **JDK 21** en format `.msi`. +2. Executeu l'assistent d'instal·lació descarregat i feu clic a 'Següent'. +3. Un cop activat 'Set JAVA_HOME variable' al menú central esquerre, feu clic a 'Següent'. +4. Feu clic a 'Instal·la' per completar la instal·lació de JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Després, executeu la següent comanda al terminal per instal·lar JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Descarregar Plazma + +Plazma ofereix diversos tipus de fitxers executables. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Més informació + +El nom del fitxer executable és `plazma-(gestor de versions)-1.20.4-R0.1-SNAPSHOT-(format de mapeig).jar`. + +- **Format de mapeig**\ + El mapeig és una mena de mapa que connecta el codi real de Minecraft amb el codi ofuscado. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mapeig de Mojang, és el mapeig del Minecraft de la vanila. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Gestor de versions**\ + El gestor de versions és una mena de llançador que necessita biblioteques per al funcionament del servidor i per aplicar patches als fitxers del servidor. + - **Paperclip**\ + Desenvolupat pel equip de PaperMC per a Paper i altres plataformes derivades, descarrega biblioteques i aplica patches al servidor. + - **Bundler**\ + Gestor de versions del Minecraft de base. + +
+ +*** + +## 3. Creació de l'script d'inici + +Per iniciar Plazma de manera senzilla i reiniciar el servidor automàticament, heu de crear un [script d'inici](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Podeu descarregar l'script d'inici fent clic al botó de descàrrega a la part inferior esquerra.\ +**Assegureu-vos que l'script d'inici descarregat és compatible amb el vostre sistema operatiu.** + +*** + +## 4. Neteja de fitxers + +Ara, mou l'script d'inici descarregat i Plazma a una nova carpeta. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Ara executeu l'script d'inici. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Acceptar l'EULA + +Després d'executar l'script d'inici, es crearà un fitxer `eula.txt` a la carpeta. + +L'EULA[^9] és un acord de llicència que has d'acceptar per utilitzar els serveis de [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Per acceptar l'EULA, canvieu `eula=false` a `eula=true` al fitxer `eula.txt` i deseu-lo. + +*** + +## 6. Permetre connexions externes (Windows) + +Els sistemes operatius moderns bloquegen els accessos externs per seguretat mitjançant el **firewall** i el **encaminador**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Si l'encaminador no suporta UPnP, heu de cercar informació específica per a cada encaminador, ja que cada panell és diferent. + +També podeu generar una adreça temporal amb [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Comprovar si cal fer reenviament de ports + +Introduïu la següent comanda a l'execució i executeu-la. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Si la sortida és `Verdader`, ja podeu acabar, però si és `Fals`, cal configurar el reenviament de ports. + +### 6.2 Connectar-se al servidor + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +L'adreça utilitzada per connectar-se al servidor es pot trobar [aquí](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +A continuació, en reiniciar el servidor, Plazma intentarà reenviar automàticament els ports. + +A continuació es mostra l'estat de l'èxit del UPnP segons el missatge que es mostra a la consola, que es visualitzarà com a `[UPnP] (missatge)`. + +| Missatge | Significat | +| ---------------------------------------- | -------------------------------------------------------- | +| `S'ha obert correctament el port (port)` | Reenviament de ports reeixit. | +| `El port (port) ja està obert` | Un altre servei està utilitzant el port. | +| `Error en obrir el port (port)` | Reenviament de ports fallit. | +| `El servei no està disponible` | El router no suporta UPnP. | + +Quan el servidor es tanca, Plazma tanca automàticament el port. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Baixeu el fitxer ZIP de `Windows (64-bit)` des de la [pàgina web de Ngrok](https://ngrok.com/download). +2. Col·loqueu l'arxiu Ngrok descarregat a la carpeta del servidor. +3. A la [pàgina web de Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) genereu un token d'autenticació. +4. Executeu la comanda que es mostra a la finestra `Command Line` de la carpeta del servidor. +5. Afegiu `start /b ngrok tcp --region jp 25565` a la part superior de l'script d'inici i `taskkill /f /t /im ngrok.exe` a la part inferior. +6. A la part superior de la consola, l'adreça `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` serà l'adreça del servidor. +7. Ara podeu connectar-vos des de l'extern utilitzant aquesta adreça. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Per exemple, si després d'executar la comanda es mostra el següent: + +```log +Windows IP configuració + +Adaptador d'Ethernet Ethernet: + + Sufix de DNS connectat. . . . : + Adreça IPv4. . . . . . . . . : 192.168.3.7 + Màscara de subxarxa . . . . . . . : 255.255.255.0 + Passarel·la predeterminada . . . . . . : 192.168.3.1 + +``` + +Podeu connectar-vos al servidor des de l'ordinador local utilitzant l'adreça IPv4 indicada com a `192.168.3.7`. + +Si el servidor i el joc s'estan executant al mateix PC, podeu connectar-vos utilitzant `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Crecer + +Si heu iniciat el servidor amb èxit i aquest funciona correctament, ara és moment de personalitzar-lo. + +Descobriu com personalitzar el servidor seguint les instruccions següents. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, la base de Plazma, es basa en Spigot, que és la plataforma oficial del servidor basada en Spigot. + +[^3]: Tecla Windows + R + +[^4]: En el cas de Linux, executeu `java --version` a la terminal. + +[^5]: JRE és un dels projectes de codi obert i té diversos tipus com les plataformes de servidor de Minecraft. + +[^6]: Generalment conegut com a **llançador**. + +[^7]: En activar "Reinici automàtic", el servidor es reiniciarà automàticament. Podeu sortir introduint `Control + C`. + +[^8]: No es recomana superar la meitat de la capacitat del sistema. + + Per exemple, si la capacitat total de memòria del sistema és de 8 GB, no es recomana configurar-la per sobre dels 4 GB. + +[^9]: Acord de llicència per a l'usuari final, acord de llicència per a l'usuari final. Per obtenir més informació, consulteu el [lloc web de Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Corporació Microsoft. + +[^11]: Segons l'article 32.1.9 de la Llei de Promoció de la Indústria dels Jocs de Corea, es pot presentar una denúncia legal contra **Microsoft Korea Co., Ltd.** a Corea. + +[^12]: Universal Plug & Play. Purpur, inclosa en Plazma, utilitza aquesta tecnologia per comunicar-se automàticament amb el router només quan el servidor està en marxa, de manera que no cal reenviar els ports manualment. + +[^13]: Si no teniu un compte, registreu-vos a Ngrok amb un compte de Google o GitHub. diff --git a/ca/origin/plazma/administration/getting-started/customization.md b/ca/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..13365e700 --- /dev/null +++ b/ca/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,121 @@ +--- +description: Descobreix com personalitzar el servidor. +--- + +# 🎨 Personalització + +La raó per la qual s'utilitza una plataforma de servidor modificada com Plazma en lloc de la plataforma oficial de servidors proporcionada per Mojang Studios és la gran capacitat de **personalització** que ofereix. + +A continuació es mostren diverses maneres de personalitzar i utilitzar Plazma. + +## Modificació de la configuració + +La manera més bàsica de personalitzar Plazma és modificar la configuració. + +Plazma ofereix una configuració potent que inclou mecanismes de joc i propietats de mobs. + +Consulteu la pàgina següent per obtenir més informació sobre la configuració de Plazma. + +{% content-ref url="../reference/configurations/" %} +[configuracions](../reference/configurations/) +{% endcontent-ref %} + +## Ús de plugins + +{% hint style="èxit" %} + +**Plazma dóna suport a tots els connectors basats en Paper de manera normal.** + +En el cas dels connectors Spigot, a partir de la versió 1.20.5, a causa dels canvis de mapeig de Paper, alguns poden no funcionar correctament, +però la majoria dels connectors basats en Paper com Paper, Pufferfish i Purpur funcionen a Plazma sense problemes, +i si algun d'ells no funciona correctament, és un error de Plazma, si us plau, [informeu-nos immediatament.](../diagnosis/plugins.md) + +{% endhint %} + +És la raó principal per utilitzar Plazma i la forma més potent de personalitzar-lo. +L'ecosistema de connectors potent de Plazma permet personalitzar els servidors fàcilment. + +Hi ha diverses maneres de trobar i descarregar connectors. Alguns connectors es pugen a serveis de magatzematge públics i altres es pugen a GitHub o a llocs web propis. + +{% hint style="advertència" %} + +**Els connectors poden accedir directament al sistema!** + +Utilitzeu serveis com VirusTotal per assegurar-vos sempre que els connectors són segurs abans d'aplicar-los, +i descarregueu els connectors de serveis fiables. + +{% endhint %} + +Hi ha diversos serveis per descarregar connectors. D'entre ells, serveis com [Fòrum de SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisen els connectors abans de ser pujats i eliminen els que no són segurs, assegurant la distribució només de connectors segurs. + +### Aplicació de connectors + +Un cop descarregats els connectors, ara és el moment d'aplicar-los. + +1. Els connectors són fitxers `.jar` o fitxers executables de Java.\ + Alguns connectors poden estar comprimits, en aquest cas, + descomprimeix-los i si el nom conté `bukkit`, `spigot` o `paper`, + utilitza el fitxer que conté `fat`. +2. Poseu els fitxers descarregats a la carpeta `plugins` del servidor i reinicieu-lo (o inicieu-lo de nou). +3. Quan s'inicia Plazma, es mostrarà informació nova a la consola. + Això significa que Plazma ha carregat els connectors correctament. +4. Tot i que Plazma hagi carregat els connectors correctament, poden no iniciar-se. + Amb la comanda `/plugins` podeu veure els connectors carregats al servidor. + Si el nom del connector no és + vermell sino verd, vol dir que s'ha carregat correctament. + +Si els connectors no s'han carregat correctament, podeu trobar solucions a la següent pàgina. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Ús de paquets de dades + +Els paquets de dades són una forma de personalitzar el Minecraft similar als [paquets de recursos](#user-content-fn-1)[^1]. + +Amb els paquets de dades podeu afegir noves entitats i reptes al joc i modificar parts del joc. + +{% hint style="advertència" %} + +**Els paquets de dades poden danyar el món!** + +Alguns paquets de dades defectuosos poden danyar el món i això no es pot desfer. + +Per tant, és recomanable fer una còpia de seguretat del món abans d'aplicar paquets de dades. + +{% endhint %} + +Els paquets de dades es poden descarregar de diversos serveis com [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) i altres. + +Un cop descarregats els paquets de dades, els podeu aplicar posant-los a la carpeta `datapacks` del món del servidor. +Si la carpeta no existeix, podeu crear-la i afegir-hi els paquets de dades. + +{% hint style="warning" %} + +**Alguns [paquets de dades](#user-content-fn-2)[^2] poden no aplicar-se correctament la primera vegada.** + +Per a aquests casos, es recomana reiniciar el servidor **2 vegades**. + +{% endhint %} + +Els paquets de dades poden resultar fàcilment danyats amb cada actualització del Minecraft. + +Especialment si un paquet de dades es danya totalment, el servidor pot fallar, +per tant, és important fer proves completes abans d'actualitzar el servidor. + +{% hint style="info" %} + +**Després de l'ordre d'inici del servidor, podeu introduir `safeMode` per desactivar tots els paquets de dades i iniciar el servidor.** + +[Consulteu `Referència > Arguments` per obtenir més informació.](../reference/arguments.md) + +{% endhint %} + +Podeu comprovar els paquets de dades aplicats amb la comanda `/datapack list`. + +*** + +[^1]: O bé amb els add-ons de Minecraft: Bedrock Edition. + +[^2]: Afegir noves entitats, etc. diff --git a/ca/origin/plazma/administration/getting-started/next-step.md b/ca/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..11ad0ddd3 --- /dev/null +++ b/ca/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Descobreix com personalitzar el servidor. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +A continuació es mostren diverses maneres de personalitzar i utilitzar Plazma. + +## Modificació de la configuració + +La manera més bàsica de personalitzar Plazma és modificar la configuració. + +Plazma ofereix una configuració potent que inclou mecanismes de joc i propietats de mobs. + +Consulteu la pàgina següent per obtenir més informació sobre la configuració de Plazma. + +{% content-ref url="../reference/configurations/" %} +[configuracions](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Ús de plugins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +És la raó principal per utilitzar Plazma i la forma més potent de personalitzar-lo. L'ecosistema de connectors potent de Plazma permet personalitzar els servidors fàcilment. + +Hi ha diverses maneres de trobar i descarregar connectors. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Hi ha diversos serveis per descarregar connectors. D'entre ells, serveis com [Fòrum de SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisen els connectors abans de ser pujats i eliminen els que no són segurs, assegurant la distribució només de connectors segurs. + +### Aplicació de connectors + +Un cop descarregats els connectors, ara és el moment d'aplicar-los. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Poseu els fitxers descarregats a la carpeta `plugins` del servidor i reinicieu-lo (o inicieu-lo de nou). +3. Quan s'inicia Plazma, es mostrarà informació nova a la consola. Això significa que Plazma ha carregat els connectors correctament. +4. Tot i que Plazma hagi carregat els connectors correctament, poden no iniciar-se. Amb la comanda `/plugins` podeu veure els connectors carregats al servidor. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Si els connectors no s'han carregat correctament, podeu trobar solucions a la següent pàgina. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Ús de paquets de dades + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Amb els paquets de dades podeu afegir noves entitats i reptes al joc i modificar parts del joc. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Alguns paquets de dades defectuosos poden danyar el món i això no es pot desfer. + +Per tant, és recomanable fer una còpia de seguretat del món abans d'aplicar paquets de dades. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Un cop descarregats els paquets de dades, els podeu aplicar posant-los a la carpeta `datapacks` del món del servidor. Si la carpeta no existeix, podeu crear-la i afegir-hi els paquets de dades. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Per a aquests casos, es recomana reiniciar el servidor **2 vegades**. +{% endhint %} + +Els paquets de dades poden resultar fàcilment danyats amb cada actualització del Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Podeu comprovar els paquets de dades aplicats amb la comanda `/datapack list`. + +*** + +## Optimització + +Plazma té moltes correccions d'optimització aplicades. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Per obtenir informació sobre la configuració segura i correcta del proxy, consulteu la pàgina següent. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Seguretat + +Amb el desenvolupament de mods, és fàcil trobar motors d'atac de vulnerabilitats en línia en Minecraft. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Configuració de permisos + +Alguns comandaments d'administrador de plugins poden tenir vulnerabilitats si els permisos no estan configurats correctament. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blocatge X-Ray + +X-Ray és una de les vulnerabilitats més fàcils d'utilitzar fins i tot en clients d'optimització bàsica. + +Plazma ofereix una configuració per bloquejar X-Ray per defecte. + +Consulteu la següent pàgina per obtenir informació i instruccions sobre com bloquejar X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Llista blanca + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Per veure els jugadors amb accés permès, utilitzeu `/whitelist query`. + +*** + +[^1]: O bé amb els add-ons de Minecraft: Bedrock Edition. + +[^2]: Afegir noves entitats, etc. + +[^3]: Normalment conegut com a "hacks". + +[^4]: Si la configuració no està optimitzada, si Plazma és antic o si hi ha vulnerabilitats noves, pot ser que no estiguin bloquejades. + +[^5]: Els jugadors es connecten al servidor a través del servidor de proxy Ngrok i cada vegada que es reinicia, l'adreça de Ngrok assignada canvia. diff --git a/ca/origin/plazma/administration/reference/README.md b/ca/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..03309c0ef --- /dev/null +++ b/ca/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Descobreix com personalitzar de forma bàsica a Plazma. +--- + +# 📜 리퍼런스 + +A Plazma ofereix diverses formes de personalització. + +D'aquestes, quatre formes poden ser utilitzades sense cap tasca addicional. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) o [Debats de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) per preguntar a la comunitat! +{% endhint %} + +*** + +## 🖥️ Ordres + +> Les ordres permeten recopilar informació dins del joc o personalitzar l'entorn de joc. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permisos + +> Els permisos defineixen l'abast d'interacció del jugador. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Arguments i atributs + +> Els arguments i atributs tenen un impacte general en el funcionament de Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configuració + +> La configuració és la manera més bàsica de personalitzar Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ca/origin/plazma/administration/reference/arguments.md b/ca/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..a6182c366 --- /dev/null +++ b/ca/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Aprengui sobre els arguments d'inici i les propietats del sistema. +--- + +# 🎛️ Arguments d'inici i propietats + +Els arguments d'inici i les propietats del sistema són valors afegits a l'[ordre utilitzada per executar Plazma](#user-content-fn-1)[^1], i tenen un impacte general en el funcionament de Plazma. + +[Posició afegida a la comanda](#user-content-fn-2)[^2] que es divideix en **paràmetres d'inici** i **proprietats del sistema**. + +*** + +## Propietats del sistema + +Les propietats del sistema es col·loquen davant de `-jar` i es processen pel JVM abans que Plazma s'inicialitzi. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Ús + +Les propietats del sistema s'introdueixen com a arguments de comandament de Java entre `java` i `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indica que l'argument no està integrat al JVM sinó que és un argument exclusiu afegit a Plazma, + +Si no s'introdueix cap valor als paràmetres, el valor es fixa a [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Totes les propietats del sistema + +#### `convertLegacySigns` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Actualitza el format dels rètols obsolets. + +#### `debug.entities` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració relacionats amb la informació de les entitats. + +#### `debug.rewriteForIDE` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la revisió de NMS per aconseguir que la informació de depuració es carregui correctament a l'IDE i remaptegi automàticament la informació de la versió interna. + +#### `disable.watchdog` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita el sistema d'advertències Watchdog de Spigot. + +#### `letMeReload` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita el missatge de confirmació del comandament `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Si ets un desenvolupador de plugins i necessites actualitzar un plugin, utilitza l'hotswap en lloc de `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita els plugins que fan servir el sistema d'entrada i sortida estàndard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Adverteix quan es detecta un format obsolet en els components de xat. + +#### `Paper.bypassHostCheck` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la verificació de coincidència del patró del servidor quan un jugador es connecta. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració per a claus que falten en objectes NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració per a perfils de crani incorrectes. + +Això registra tots els blocs de crani incorrectes al món amb les seves coordenades. + +#### `Paper.disableChannelLimit` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita el sistema de prioritat de classes de plugins. + +Útil en cas de problemes amb els plugins ombra. + +#### `Paper.disableFlushConsolidate` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la consolidació de Netty flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valor per defecte**: `750` + +Divideix l'enviament d'entitats en paquets múltiples si supera el valor establert. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valor per defecte**: `8192` + +Estableix la mida màxima del paquet que el servidor pot rebre a la vegada. + +#### `Paper.ignoreJavaVersion` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la comprovació de la versió de Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Això pot causar danys permanents als arxius del món i provocar un mal funcionament general del joc. + +L'usuari assumeix tota la responsabilitat dels problemes que puguin sorgir i Plamza no oferirà cap suport en aquest cas. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valor per defecte**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valor per defecte**: `80` + +Estableix la longitud màxima de caràcters per línia en els rètols. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valor per defecte**: `(versió del món) + 1` + +Estableix la versió de la informació de l'actualització del món que es carregarà primer. + +Útil en casos on cal actualitzar una gran quantitat de chunks, però no s'utilitza en altres situacions. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Cert` + +Activa el tractament dels comentaris YAML per defecte. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valor per defecte**: `30` + +Quan un jugador no envia cap dada durant el temps especificat (en segons), es desconnecta. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Ignora els comentaris de les propietats del servidor. + +#### `Paper.debug-sync-loads` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració de la càrrega sincronitzada de chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa el sistema de [càrrega de chunks per defecte](#user-content-fn-10)[^10] de Minecraft. + +Això provoca una gran disminució del rendiment ja que es guarda cada chunk de manera seqüencial. + +#### `Paper.explicit-flush` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa l'expulsió explícita dels canals de xarxa. + +#### `Paper.strict-thread-checks` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Registra sempre els errors que no es produeixin al fil principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Mostra una advertència si les tasques programades tenen un retard excessiu. + +#### `Paperclip.patchOnly` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Aplica només el patch sense iniciar el servidor quan s'utilitza l'executable predeterminat. + +#### `Plazma.aggressiveOptimize` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` +- **Conflicte**: `Plazma.disableConfigOptimization` + +Optimitza la configuració inicial de forma més agressiva. + +Activar això farà que el servidor sigui més ràpid i segur, però pot tenir un gran impacte en el joc. + +#### `Plazma.disableConfigOptimization` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` +- **Conflicte**: `Plazma.aggressiveOptimize` + +No optimitza la configuració inicial. + +Això fa servir la configuració bàsica de Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` + +Desactiva la marca Plazma i fa servir el favicon del servidor com a valor predeterminat de la vainilla. + +#### `Plazma.useVanillaConfiguration` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` +- **Conflicte**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Això pot tenir un gran impacte en la seguretat i el rendiment del servidor. + +Totes les qüestions que es produeixin amb aquesta propietat són responsabilitat de l'administrador del servidor. +{% endhint %} + +Fornir la configuració inicial amb els valors predeterminats de Mojang. + +Això desactiva totes les correccions de vulnerabilitats aplicades a Paper. + +Les correccions de vulnerabilitats es poden tornar a activar en la configuració de Paper o Plazma. + +#### `Plazma.vanillaize` + +- **Tipus**: `Boolean` +- **Valor predeterminat**: `true` +- **Conflicte**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Configura la configuració inicial per ser més semblant a la vainilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Propietat obsoleta + +Les propietats del sistema següents són obsoletes. + +#### `timings.bypassMax` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` +- **Obsolet**: Des de la retirada de Timings de Plazma + +Determina si es pot superar el valor màxim que es pot enviar a l'API de Timings d'Aikar. + +Si això es fa i l'API no gestiona l'excepció, s'aplicarà el límit de velocitat. + +*** + +## Argument d'inici + +L'argument d'inici es posa després de `-jar *.jar` per inicialitzar Plazma i es processa conjuntament amb aquest valor. + +### Ús + +Les propietats del sistema s'introdueixen com arguments de comandament després de `-jar *.jar`. + +Per exemple, si es vol aplicar l'argument d'inici `nogui`,\ +introduïu-ho com a continuació perquè Plazma processi l'argument `nogui` durant la inicialització. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argument d'inici complet + +#### `bukkit-settings` + +- **Àlies**: `b` +- **Valor per defecte**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Àlies**: `c` +- **Valor per defecte**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Àlies**: `c` +- **Valor per defecte**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Inicia el servidor com a món de demostració. + +#### `eraseCache` + +Elimina els fitxers de memòria cau restants després d'actualitzar el món. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Àlies**: `?` + +Mostra tots els arguments d'inici de Plazma juntament amb les seves descripcions. + +#### `initSettings` + +Crea només els fitxers de configuració i tanca el servidor. + +#### `jfrProfile` + +Activa el perfilatge JFR. + +#### `max-players` + +- **Àlies**: `s`, `size` +- **Valor per defecte**: `(proprietats del servidor)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Desactiva el panell d'interfície gràfica. + +#### `nojline` + +Desactiva JLine i utilitza la consola de vanil·la. + +#### `online-mode` + +- **Àlies**: `o` +- **Valor per defecte**: `(proprietats del servidor)` + +Selecciona si es validen els jugadors amb el servidor d'autenticació de Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Àlies**: `paper` +- **Valor per defecte**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Configura la ubicació del fitxer de configuració de PaperSpigot obsolet. + +S'utilitza per traslladar la configuració antiga a un nou fitxer de configuració i ja no es fa servir. + +#### `paper-settings-directory` + +- **Àlies**: `paper-dir` +- **Valor per defecte**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Àlies**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Àlies**: `p` +- **Valor per defecte**: `plugins` + +Configura la ubicació de la carpeta de plugins. + +#### `pufferfish-settings` + +- **Àlies**: `pufferfish` +- **Valor per defecte**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Àlies**: `purpur` +- **Valor per defecte**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Inicia el servidor en mode segur, com si fos vanil·la. + +#### `server-ip` + +- **Àlies**: `h`, `host` +- **Valor per defecte**: `(proprietats del servidor)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Àlies**: `p`, `port` +- **Valor per defecte**: `(proprietats del servidor)` + +Configura el port del servidor. + +#### `server-name` + +- **Valor per defecte**: `Un servidor de Plazma` + +Configura el nom del servidor. + +#### `spigot-settings` + +- **Àlies**: `S` +- **Valor per defecte**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Àlies**: `v` + +Mostra la versió de Plazma. + +#### `world-dir` + +- **Àlies**: `W`, `universe`, `world-container` +- **Valor per defecte**: `(carpeta del servidor)` + +Configura la ubicació on es guarden els fitxers del món. + +#### `world-name` + +- **Àlies**: `w`, `world` +- **Valor per defecte**: `(proprietats del servidor)` + +Configura el nom del fitxer del món. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Depenent de la ubicació afegida, la ubicació de processament dels arguments canvia. + +[^3]: Per exemple, si voleu establir (activar) `Plazma.iKnowWhatIAmDoing` com a `true`, en lloc de introduir `-DPlazma.iKnowWhatIAmDoing=true`, només cal introduir `-DPlazma.iKnowWhatIAmDoing` i funcionarà igualment. + +[^4]: Per exemple, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector d'esdeveniments. + +[^6]: Detector d'esdeveniments. + +[^7]: Client. + +[^8]: Senyal que indica que està connectat correctament al servidor com un batec de cor. + +[^9]: Utilitzant la funció d'expulsió AFK de Purpur, també es pot expulsar els jugadors absents. + +[^10]: Sistema de escriptura de trossos sincronitzat, Sync Chunk Write System. + +[^11]: \`ATENCIÓ! Plazma pot causar problemes inesperats, així que assegureu-vos de provar-ho a fons abans de fer servir un servidor públic. + +[^12]: Aquesta optimització de món al joc també funciona amb aquest mateix principi. + +[^13]: Els administradors de nivell 2 o superior estan exclosos. + +[^14]: Protocol d'Internet, IP. diff --git a/ca/origin/plazma/administration/reference/commands.md b/ca/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..fefe2dd1b --- /dev/null +++ b/ca/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descobreix els comandaments disponibles a Plazma. +--- + +# 🖥️ Comandaments diff --git a/ca/origin/plazma/administration/reference/configurations/README.md b/ca/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..35174b1ab --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: La configuració és la manera més bàsica de personalitzar Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atributs + +> Els atributs són els fitxers de configuració més bàsics proporcionats per Minecraft. Utilitzant els atributs, es pot canviar els mecanismes bàsics del joc. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configuració de Bukkit + +> La configuració de Bukkit és el fitxer de configuració més bàsic proporcionat per Plazma. Utilitzant la configuració de Bukkit, es poden canviar els mecanismes bàsics del servidor de Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configuració de Spigot + +> La configuració de Spigot permet modificar els detalls del joc, el tractament dels jugadors, el funcionament de les comandes, etc. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configuració de Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configuració de Pufferfish + +> La configuració de Pufferfish permet modificar el tractament dels móns i entitats de Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configuració de Purpur + +> Els atributs de Purpur permeten modificar les dades bàsiques del joc. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configuració de Plazma + +> La configuració de Plazma permet personalitzar les funcionalitats de Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ca/origin/plazma/administration/reference/configurations/bukkit.md b/ca/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f99457a49 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ca/origin/plazma/administration/reference/configurations/paper/README.md b/ca/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..7364ecb44 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Aprofundeix en quin és l'objectiu de cada fitxer a la carpeta de configuració. +--- + +# 🛩️ Paper diff --git a/ca/origin/plazma/administration/reference/configurations/paper/global.md b/ca/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..2a3e1e298 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Aprofundeix en el que significa cada node de paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ca/origin/plazma/administration/reference/configurations/paper/world.md b/ca/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..69353b69c --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Descobriu el significat de cada node a paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Món a món diff --git a/ca/origin/plazma/administration/reference/configurations/plazma/README.md b/ca/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..2f5c7b1f1 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Aprofundeix en quin és l'objectiu de cada fitxer a la carpeta de configuració. +--- + +# ✨ Plasme diff --git a/ca/origin/plazma/administration/reference/configurations/plazma/global.md b/ca/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..510983ce1 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ca/origin/plazma/administration/reference/configurations/plazma/world.md b/ca/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..58d18c810 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Descobriu què significa cada node de plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ca/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ca/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..e8e2818fa --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descobriu què significa cada node de plazma-world.yml. +--- + +# ✨ Plazma (composició per món) diff --git a/ca/origin/plazma/administration/reference/configurations/property.md b/ca/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..c3a5d4511 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de server.properties. +--- + +# 🪨 Server.properties diff --git a/ca/origin/plazma/administration/reference/configurations/pufferfish.md b/ca/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..e2798659a --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de pufferfish.yml. +--- + +# 🐡 Porc espasa diff --git a/ca/origin/plazma/administration/reference/configurations/purpur/README.md b/ca/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..98f9fabdd --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de purpur.yml. +--- + +# 🦑 Purpur diff --git a/ca/origin/plazma/administration/reference/configurations/purpur/global.md b/ca/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..64600d31c --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/ca/origin/plazma/administration/reference/configurations/purpur/world.md b/ca/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..e673120ca --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ca/origin/plazma/administration/reference/configurations/spigot.md b/ca/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..3fe865989 --- /dev/null +++ b/ca/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de spigot.yml. +--- + +# 🚰 Spigot diff --git a/ca/origin/plazma/administration/reference/permissions.md b/ca/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..fbef0eaa1 --- /dev/null +++ b/ca/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Consulta els permisos de Plazma. +--- + +# 🛡️ Permisos + +Els permisos són eines de seguretat senzilles que defineixen l'àmbit en què els jugadors del servidor poden interactuar entre ells. + +Per utilitzar i modificar els permisos de manera eficaç, cal utilitzar complements com [LuckPerms](https://luckperms.net). + +*** + +## Entenent el sistema de permisos per defecte + +A Minecraft es proporcionen grups de permisos de gestió bàsics. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Jugador**\ + És el grup de permisos que es dóna normalment a tots els jugadors. +2. **Àrbitre**\ + Pot ignorar la protecció de spawn. +3. **Administrador del món**\ + Pot utilitzar totes les ordres i blocs de comandes relacionats amb la gestió del món.\ + És el grup de permisos per defecte aplicat als datapacks i blocs de comandes. +4. **Administrador**\ + Pot utilitzar totes les ordres relacionades amb la gestió dels jugadors. +5. **Superadministrador**\ + Pot utilitzar totes les ordres relacionades amb la gestió del servidor, inclosa la consola.\ + És el grup de permisos per defecte aplicat a la consola i als operadors. + +*** + +## Configuració de permisos + +*** + +## Permisos globals + +*** + +#### `allow.ride.(Clau amb espai de noms)` + +- **Per defecte**: `Cap` + +Permet als jugadors agenollar-se i interactuar amb l'entitat per pujar-hi. + +En pujar a l'entitat, es pot controlar el seu moviment amb les tecles de **moviment** i saltar o volar amb la tecla de **salt**. + +A la **clau amb espai de noms** s'hi introdueix la [ID amb espai de noms](#user-content-fn-2)[^2] de l'entitat. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Clau amb espai de noms)` + +- **Per defecte**: `Cap` + +Permet al jugador utilitzar les habilitats especials de l'entitat en què està muntat. + +No totes les entitats tenen habilitats especials disponibles. Consulteu les habilitats especials disponibles a continuació. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Si teniu una idea, feu-la saber al [Discord de Plazma](https://plazmamc.org/discord) o a les [Discussions de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Veure les habilitats especials disponibles actualment + +- **`crepper`**\ + Al prémer la tecla de salt, explota.\ + Si el jugador té el permís `allow.powered.creeper`, pot carregar la explosió mantenint premuda la tecla de salt. +- **`dolphin`**\ + Al prémer la tecla de salt, carrega. +- **`phantom`**\ + Al prémer la tecla de salt, llança flames. +- **`wither`**\ + En interactuar, llança caps de Wither. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/credits (Jugador)`](commands.md#credits). + +Introduir `.altre` al final del permís permet que altres jugadors l'utilitzin. + +#### `bukkit.command.demo` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/demo (Jugador)`](commands.md#demo). + +Introduir `.altre` al final del permís permet que altres jugadors l'utilitzin. + +#### `bukkit.command.ping` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/ping (Jugador)`](commands.md#ping). + +Introduir `.altre` al final del permís permet que altres jugadors l'utilitzin. + +#### `bukkit.command.ram` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/rambar (Jugador)`](commands.md#rambar). + +Introduir `.altre` al final del permís permet que altres jugadors l'utilitzin. + +#### `bukkit.command.restart` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/tpsbar (Jugador)`](commands.md#tpsbar). + +Introduir `.altre` al final del permís permet que altres jugadors l'utilitzin. + +#### `bukkit.command.timings` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Per obtenir informació sobre comandes similars, consulteu [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(Mode de joc)` + +- **Per defecte**: `Administrador del món` + +Permet l'ús de la comanda `/gamemode (Mode de joc) (Jugador)`. + +Introduir `.altre` al final del permís permet que altres jugadors l'utilitzin. + +#### `paper.antixray.bypass` + +- **Per defecte**: `Cap` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Això millora el rendiment per a tots dos. + +> Per obtenir informació sobre com configurar X-Ray, consulteu la següent pàgina. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Per defecte**: `Cap` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Per defecte**: `Cap` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Per defecte**: `Cap` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Per defecte**: `Cap` + +Permet l'ús de etiquetes MiniMessage a l'enclusa. Consulteu [MiniMessage Tags](https://docs.advntr.dev/minimessage/format.html). + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Per defecte**: `Cap` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Per defecte**: `Cap` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Per defecte**: `Cap` + +Exclou els jugadors de ser expulsats per inactivitat. + +#### `purpur.debug.f3n` + +- **Per defecte**: `Administrador del món` + +Permet als jugadors canviar el mode de joc amb la tecla `F3 + N`. + +Només funciona si tenen el permís per a aquest mode de joc. + +#### `purpur.drop.spawners` + +- **Per defecte**: `Cap` + +Quan es mina un bloc de spawner amb l'objecte configurat, el bloc de spawner cau. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(Número de fila)` + +- **Per defecte**: `Cap` + +Canvia la mida de l'endrinyera. + +Es pot introduir `one`, `two`, `three`, `four`, `five`, `six` a `(Número de fila)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Per defecte**: `Cap` + +Permet que el totem d'immortalitat funcioni quan es troba a l'inventari. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Per defecte**: `Cap` + +Permet al jugador ignorar el límit de jugadors connectats. + +#### `purpur.mending_shift_click` + +- **Per defecte**: `Cap` + +Permet al jugador reparar l'objecte que té a les mans quan fa `agatxat i interactua`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Per defecte**: `Cap` + +Permet al jugador instal·lar spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Per defecte**: `Cap` + +Permet al jugador teleportar-se immediatament quan utilitza un portal al Nether. + +#### `purpur.sign.color` + +- **Per defecte**: `Cap` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Per defecte**: `Cap` + +Permet utilitzar el codi d'encriptació `(&o)` als rètols. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Per defecte**: `Cap` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Per defecte**: `Cap` + +Permet al jugador evitar l'explosió de TNT interaccionant amb ella amb les tisores. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permisos previstos + +#### `plazma.bypass.ncr-require` + +- **Per defecte**: `Cap` + +Permet al jugador connectar-se sense tenir instal·lat el mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operador. + +[^2]: Per exemple: `ender_dragon` diff --git a/ca/origin/plazma/adminstration/README.md b/ca/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..e91719658 --- /dev/null +++ b/ca/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Crea el teu propi servidor amb Plazma. +--- + +# ⚒️ Guia de gestió del servidor diff --git a/ca/origin/plazma/adminstration/expert/README.md b/ca/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..e2b57b7d2 --- /dev/null +++ b/ca/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com gestionar de manera professional el Plazma. +--- + +# 🎓 Avançat diff --git a/ca/origin/plazma/adminstration/expert/fix-exploits.md b/ca/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..e210d88e0 --- /dev/null +++ b/ca/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com solucionar les vulnerabilitats conegudes i com resoldre-les. +--- + +# ⚠️ Vulnerabilitats conegudes i com solucionar-les diff --git a/ca/origin/plazma/adminstration/expert/optimize.md b/ca/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..a386dd599 --- /dev/null +++ b/ca/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com optimitzar el Plazma. +--- + +# 🧹 Optimització diff --git a/ca/origin/plazma/adminstration/expert/vanillaize.md b/ca/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..8c452ff48 --- /dev/null +++ b/ca/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Descobreix com restaurar el patch de Paper i Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper no ofereix opcions per corregir la majoria dels errors de Vanilla amb patches. + +Actualment, Plazma està desenvolupant una configuració per desactivar aquestes correccions d'errors. + +Per tant, aquesta guia encara està en procés de redacció i la informació pot canviar en qualsevol moment. +{% endhint %} diff --git a/ca/origin/plazma/adminstration/faq.md b/ca/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..f55d1faf0 --- /dev/null +++ b/ca/origin/plazma/adminstration/faq.md @@ -0,0 +1,42 @@ +--- +description: Descobreix més sobre les preguntes freqüents. +--- + +# ⁉️ Preguntes freqüents + +{% hint style="info" %} + +### No trobeu la resposta que busqueu? + +Feu preguntes a la comunitat a través del [servidor Discord oficial](https://discord.gg/MmfC52K8A8) o [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### No s'executa amb un missatge de sortida + +Si apareix `no main manifest attribute, in plazma-(versió).jar` a la consola, el fitxer descarregat és un fitxer API de desenvolupament, heu de descarregar **Reobf Paperweight** de la pàgina de GitHub. + +Per obtenir més informació, consulteu la següent pàgina. + +{% content-ref url="getting-started/" %} +[inici](getting-started#id-2) +{% endcontent-ref %} + +### Es mostra un advertència cada vegada que el servidor s'inicia + +Plazma conté algunes correccions inestables i sempre pot funcionar incorrectament, per això mostra aquest missatge d'avís cada vegada que el servidor s'inicia. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Aquest missatge d'avís es pot desactivar utilitzant la propietat del sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Per obtenir més informació, consulteu la següent pàgina. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponible a partir de la versió 1.20.1 diff --git a/ca/origin/plazma/adminstration/getting-started/README.md b/ca/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..2ee160532 --- /dev/null +++ b/ca/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Descobreix com crear un servidor amb Plazma. +--- + +# 👟 Començar + +Per utilitzar Plazma de manera estable, el sistema ha de complir amb els següents requisits. + +| | Mínim | Recomanat | +| :--------------------: | ----: | --------: | +| Arquitectura | x64 | - | +| RAM | 8GB | 16GB | +| Espai d'emmagatzematge | 1GB | 8GB | +| JRE | 17 | 21 | + +Per a una edició de fitxers de configuració més fàcil, també és recomanable instal·lar un editor com [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instal·lar JRE + +Com el nom indica, Minecraft: **"Java"** Edition està desenvolupat en Java, per tant, requereix JRE[^1] per funcionar. + +Com que Plazma està basat en la plataforma oficial de servidors de Mojang Studios[^2], també cal instal·lar JRE per utilitzar Plazma. + +### 1.1 Comprovar si JRE està instal·lat + +Per verificar si JRE està instal·lat al sistema, introduïu [`cmd /k java --version`](#user-content-fn-4)[^4] a la finestra d'execució i executeu-la. + +Si es mostra el següent, salteu al [pas 2](setup.md#id-2). + +{% code title="Sortida correcta" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Si no es mostra així, o es mostra com a continuació, vol dir que JRE no està instal·lat o és massa antic, per tant, heu de seguir el [pas 1.2](setup.md#id-1.2). + +{% code title="JRE no està instal·lat" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE massa antic" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instal·lar JRE + +En aquesta guia, farem servir Azul Zulu com una de les opcions de JRE[^5]. + +Un cop instal·lat, torneu a fer el [pas 1.1](setup.md#id-1.1) per comprovar que la instal·lació s'ha completat correctament. + +{% tabs %} +{% tab title="Windows" %} + +1. Primer, des de [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) baixeu **JDK 21** en format `.msi`. +2. Executeu l'assistent d'instal·lació descarregat i feu clic a 'Següent'. +3. Un cop activat 'Set JAVA_HOME variable' al menú central esquerre, feu clic a 'Següent'. +4. Feu clic a 'Instal·la' per completar la instal·lació de JRE. + {% endtab %} + +{% tab title="macOS" %} +Des de [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) baixeu **JDK 21** en format `.dmg` i executeu l'assistent d'instal·lació per instal·lar JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Primer, executeu la següent comanda al terminal per afegir el repositori d'Azul Zulu a APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Després, executeu la següent comanda al terminal per instal·lar JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Podeu instal·lar JRE amb la següent comanda. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Descarregar Plazma + +Plazma ofereix diversos tipus de fitxers executables. + +{% hint style="warning" %} + +### En la majoria dels casos, s'utilitza `Reobf Paperclip`. + +El següent és per a desenvolupadors o aquells interessats en les característiques de cada tipus.\ +Si ets un usuari comú, no hi ha cap problema en saltar al [pas 3](setup.md#id-3). +{% endhint %} + +
+ +Més informació + +El nom del fitxer executable és `plazma-(gestor de versions)-1.20.4-R0.1-SNAPSHOT-(format de mapeig).jar`. + +- **Format de mapeig**\ + El mapeig és una mena de mapa que connecta el codi real de Minecraft amb el codi ofuscado. + - **Reobf**\ + Reobfuscació, també conegut com a mapeig de Spigot, és utilitzat en la majoria dels plugins NMS.\ + A partir de la versió 1.20.5, deixarà de ser utilitzat. + - **Mojmap**\ + Mapeig de Mojang, és el mapeig del Minecraft de base. +- **Gestor de versions**\ + El gestor de versions és una mena de llançador que necessita biblioteques per al funcionament del servidor i per aplicar patches als fitxers del servidor. + - **Paperclip**\ + Desenvolupat pel equip de PaperMC per a Paper i altres plataformes derivades, descarrega biblioteques i aplica patches al servidor. + - **Bundler**\ + Gestor de versions del Minecraft de base. + +
+ +*** + +## 3. Creació de l'script d'inici + +Per iniciar Plazma de manera senzilla i reiniciar el servidor automàticament, heu de crear un [script d'inici](#user-content-fn-6)[^6]. + +Podeu crear un script d'inici a través de [Flags.sh](https://flags.sh). Només cal introduir la [memòria a utilitzar per Plazma](#user-content-fn-8)[^8] i l'ordre s'optimitzarà automàticament. + +Podeu descarregar l'script d'inici fent clic al botó de descàrrega a la part inferior esquerra.\ +**Assegureu-vos que l'script d'inici descarregat és compatible amb el vostre sistema operatiu.** + +*** + +## 4. Neteja de fitxers + +Ara, mou l'script d'inici descarregat i Plazma a una nova carpeta. + +{% hint style="warning" %} + +### El nom de la carpeta ha de ser sense espais i en anglès. + +En cas contrari, Plazma o JRE podrien no funcionar correctament. +{% endhint %} + +Ara executeu l'script d'inici. En el cas de Windows, heu de seleccionar **Permetre** a la finestra de selecció de permisos del firewall. + +*** + +## 5. Acceptar l'EULA + +Després d'executar l'script d'inici, es crearà un fitxer `eula.txt` a la carpeta. + +L'EULA[^9] és un acord de llicència que has d'acceptar per utilitzar els serveis de [Mojang Studios](#user-content-fn-10)[^10]. + +Si no accepteu l'EULA, no podreu iniciar el servidor i, si incompliu l'EULA, podeu rebre sancions com la suspensió del compte, entre altres [mesures disciplinàries](#user-content-fn-11)[^11]. + +Per acceptar l'EULA, canvieu `eula=false` a `eula=true` al fitxer `eula.txt` i deseu-lo. + +*** + +## 6. Permetre connexions externes (Windows) + +Els sistemes operatius moderns bloquegen els accessos externs per seguretat mitjançant el **firewall** i el **encaminador**. + +En el cas de Windows, com ja heu permès en el [pas 3](setup.md#id-3), només cal fer el reenviament de ports. + +{% hint style="info" %} + +### Aquesta guia assumeix que feu servir el sistema operatiu Windows i [**UPnP**](#user-content-fn-12)[^12] al vostre encaminador. + +Si l'encaminador no suporta UPnP, heu de cercar informació específica per a cada encaminador, ja que cada panell és diferent. + +També podeu generar una adreça temporal amb [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} + +### Per sistemes operatius basats en UNIX com Linux o macOS, les configuracions del firewall varien segons el servei, per tant, heu de cercar informació específica. + +{% endhint %} + +### 6.1 Comprovar si cal fer reenviament de ports + +Introduïu la següent comanda a l'execució i executeu-la. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Si la sortida és `Verdader`, ja podeu acabar, però si és `Fals`, cal configurar el reenviament de ports. + +### 6.2 Connectar-se al servidor + +{% tabs %} +{% tab title="Accés des de l'extern" %} +No cal reenviament de ports o, si ja s'ha reenviat correctament els ports, ara podeu connectar-vos al servidor. + +L'adreça utilitzada per connectar-se al servidor es pot trobar [aquí](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Intent de reenviament de ports amb UPnP" %} +A l'arxiu `purpur.yml` de la carpeta del servidor, activeu `network.upnp-port-forwarding` a `true`. + +A continuació, en reiniciar el servidor, Plazma intentarà reenviar automàticament els ports. + +A continuació es mostra l'estat de l'èxit del UPnP segons el missatge que es mostra a la consola, que es visualitzarà com a `[UPnP] (missatge)`. + +| Missatge | Significat | +| ---------------------------------------- | ---------------------------------------- | +| `S'ha obert correctament el port (port)` | Reenviament de ports reeixit. | +| `El port (port) ja està obert` | Un altre servei està utilitzant el port. | +| `Error en obrir el port (port)` | Reenviament de ports fallit. | +| `El servei no està disponible` | El router no suporta UPnP. | + +Quan el servidor es tanca, Plazma tanca automàticament el port. +{% endtab %} + +{% tab title="Generació d'adreça temporal amb Ngrok" %} +L'ús de Ngrok és útil per a proves temporals, sessions de joc col·lectives o jugar amb amics. + +1. Baixeu el fitxer ZIP de `Windows (64-bit)` des de la [pàgina web de Ngrok](https://ngrok.com/download). +2. Col·loqueu l'arxiu Ngrok descarregat a la carpeta del servidor. +3. A la [pàgina web de Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) genereu un token d'autenticació. +4. Executeu la comanda que es mostra a la finestra `Command Line` de la carpeta del servidor. +5. Afegiu `start /b ngrok tcp --region jp 25565` a la part superior de l'script d'inici i `taskkill /f /t /im ngrok.exe` a la part inferior. +6. A la part superior de la consola, l'adreça `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` serà l'adreça del servidor. +7. Ara podeu connectar-vos des de l'extern utilitzant aquesta adreça. + {% endtab %} + +{% tab title="Accés des de l'ordinador local" %} +Si voleu connectar-vos al servidor des de l'ordinador local, executeu `cmd /k ipconfig` a la finestra d'execució per obtenir l'`adreça IPv4` mostrada. + +Per exemple, si després d'executar la comanda es mostra el següent: + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Podeu connectar-vos al servidor des de l'ordinador local utilitzant l'adreça IPv4 indicada com a `192.168.3.7`. + +Si el servidor i el joc s'estan executant al mateix PC, podeu connectar-vos utilitzant `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Fase de desenvolupament + +Si heu iniciat el servidor amb èxit i aquest funciona correctament, ara és moment de personalitzar-lo. + +Consulteu la guia següent per aprendre com personalitzar el servidor. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Entorn d'execució de Java, entorn d'execució de Java. + +[^2]: Paper, la base de Plazma, es basa en Spigot, que és la plataforma oficial del servidor basada en Spigot. + +[^3]: Tecla Windows + R + +[^4]: En el cas de Linux, executeu `java --version` a la terminal. + +[^5]: JRE és un dels projectes de codi obert i té diversos tipus com les plataformes de servidor de Minecraft. + +[^6]: Generalment conegut com a **llançador**. + +[^7]: En activar "Reinici automàtic", el servidor es reiniciarà automàticament. Podeu sortir introduint `Control + C`. + +[^8]: No es recomana superar la meitat de la capacitat del sistema. + + Per exemple, si la capacitat total de memòria del sistema és de 8 GB, no es recomana configurar-la per sobre dels 4 GB. + +[^9]: Acord de llicència per a l'usuari final, acord de llicència per a l'usuari final. Per obtenir més informació, consulteu el [lloc web de Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Corporació Microsoft. + +[^11]: Segons l'article 32.1.9 de la Llei de Promoció de la Indústria dels Jocs de Corea, es pot presentar una denúncia legal contra **Microsoft Korea Co., Ltd.** a Corea. + +[^12]: Universal Plug & Play. Purpur, inclosa en Plazma, utilitza aquesta tecnologia per comunicar-se automàticament amb el router només quan el servidor està en marxa, de manera que no cal reenviar els ports manualment. + +[^13]: Si no teniu un compte, registreu-vos a Ngrok amb un compte de Google o GitHub. diff --git a/ca/origin/plazma/adminstration/getting-started/customization.md b/ca/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..ce9f85a83 --- /dev/null +++ b/ca/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Descobreix com personalitzar el servidor. +--- + +# 🎨 Personalització diff --git a/ca/origin/plazma/adminstration/reference/arguments.md b/ca/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..929734434 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Aprengui sobre els arguments d'inici i les propietats del sistema. +--- + +# 🎛️ Arguments d'inici i propietats + +Els arguments d'inici i les propietats del sistema són valors afegits als [comandaments utilitzats](#user-content-fn-1)[^1] en l'execució de Plazma, permetent canviar valors que no es poden modificar després de l'execució de Plazma. + +En funció de la [posició on s'afegeixen als comandaments](#user-content-fn-2)[^2], es divideixen en **arguments d'inici** i **proprietats del sistema**. + +*** + +## Propietats del sistema + +Les propietats del sistema es col·loquen davant de `-jar` i es processen pel JVM abans que Plazma s'inicialitzi. + +{% hint style="warning" %} + +### Modificar les propietats del sistema pot alterar el funcionament de Plazma i del JVM, i pot tenir un gran impacte en el joc! + +Si no entén quina funció té cada propietat del sistema, **no les utilitzi mai!** +{% endhint %} + +### Ús + +Les propietats del sistema s'introdueixen com a arguments de comandament de Java entre `java` i `-jar`. + +Per exemple, si vol aplicar la propietat del sistema `Plazma.dummyProperty`, introduint `37` com a valor, es inicialitzarà Plazma de la següent manera. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indica que l'argument no està integrat al JVM sinó que és un argument exclusiu afegit a Plazma, + +i si no s'indica cap valor, es fixarà a [`true` de manera predeterminada.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Les plataformes de servidors de la sèrie Paperweight inclouen un punt (`.`) al nom de la propietat per distingir les propietats del sistema per a cada plataforma. + +En algunes terminals com Windows Powershell, pot ser que no s'acceptin aquests arguments, per la qual cosa cal afegir `"` als extrems dels arguments.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Totes les propietats del sistema + +#### `convertLegacySigns` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Actualitza el format dels rètols obsolets. + +#### `debug.entities` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració relacionats amb la informació de les entitats. + +#### `debug.rewriteForIDE` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la revisió de NMS per aconseguir que la informació de depuració es carregui correctament a l'IDE i remaptegi automàticament la informació de la versió interna. + +#### `disable.watchdog` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita el sistema d'advertències Watchdog de Spigot. + +#### `letMeReload` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita el missatge de confirmació del comandament `/reload`. + +{% hint style="danger" %} + +### El comandament `/reload` és molt inestable, per tant, qualsevol problema que sorgeixi al servidor després d'utilitzar `/reload` és responsabilitat de l'usuari. + +Si ets un desenvolupador de plugins i necessites actualitzar un plugin, utilitza l'hotswap en lloc de `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita els plugins que fan servir el sistema d'entrada i sortida estàndard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Adverteix quan es detecta un format obsolet en els components de xat. + +#### `Paper.bypassHostCheck` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la verificació de coincidència del patró del servidor quan un jugador es connecta. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració per a claus que falten en objectes NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració per a perfils de crani incorrectes. + +Això registra tots els blocs de crani incorrectes al món amb les seves coordenades. + +#### `Paper.disableChannelLimit` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la limitació de 128 canals de plugin per jugador[^5]. + +#### `Paper.disableClassPrioritization` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita el sistema de prioritat de classes de plugins. + +Útil en cas de problemes amb els plugins ombra. + +#### `Paper.disableFlushConsolidate` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la consolidació de Netty flush. + +#### `Paper.excessiveTELimit` + +- **Tipus**: `Enter` +- **Valor per defecte**: `750` + +Divideix l'enviament d'entitats en paquets múltiples si supera el valor establert. + +#### `Paper.filterThreshold` + +- **Tipus**: `Enter` +- **Valor per defecte**: `8192` + +Estableix la mida màxima del paquet que el servidor pot rebre a la vegada. + +#### `Paper.ignoreJavaVersion` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Deshabilita la comprovació de la versió de Java. + +{% hint style="danger" %} + +### Això pot permetre que el JVM intenti accedir a codi inexistent! + +Això pot causar danys permanents als arxius del món i provocar un mal funcionament general del joc. + +L'usuari assumeix tota la responsabilitat dels problemes que puguin sorgir i Plamza no oferirà cap suport en aquest cas. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tipus**: `Enter` +- **Valor per defecte**: `64` + +Estableix el límit de caràcters per als noms dels canals de plugins. + +#### `Paper.maxSignLength` + +- **Tipus**: `Enter` +- **Valor per defecte**: `80` + +Estableix la longitud màxima de caràcters per línia en els rètols. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tipus**: `Enter` +- **Valor per defecte**: `(versió del món) + 1` + +Estableix la versió de la informació de l'actualització del món que es carregarà primer. + +Útil en casos on cal actualitzar una gran quantitat de chunks, però no s'utilitza en altres situacions. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Cert` + +Activa el tractament dels comentaris YAML per defecte. + +#### `Paper.playerConnection.keepAlive` + +- **Tipus**: `Enter` +- **Valor per defecte**: `30` + +Quan un jugador no envia cap dada durant el temps especificat (en segons), es desconnecta. + +Normalment, el joc[^7] envia un [senyal de batut](#user-content-fn-8)[^8] al servidor de manera constant, per tant, no es desconnecta, però si el joc no respon, es considera que s'ha bloquejat i es desconnecta el jugador. + +#### `Paper.skipServerPropertiesComments` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Ignora els comentaris de les propietats del servidor. + +#### `Paper.debug-sync-loads` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa els registres de depuració de la càrrega sincronitzada de chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa el sistema de [càrrega de chunks per defecte](#user-content-fn-10)[^10] de Minecraft. + +Això provoca una gran disminució del rendiment ja que es guarda cada chunk de manera seqüencial. + +#### `Paper.explicit-flush` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Activa l'expulsió explícita dels canals de xarxa. + +#### `Paper.strict-thread-checks` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Registra sempre els errors que no es produeixin al fil principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Mostra una advertència si les tasques programades tenen un retard excessiu. + +#### `Paperclip.patchOnly` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `Fals` + +Aplica només el patch sense iniciar el servidor quan s'utilitza l'executable predeterminat. + +#### `Plazma.aggressiveOptimize` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` + +{% hint style="warning" %} + +### Aquesta propietat es traslladarà als arguments d'inici a partir de la versió 1.20.5. + +{% endhint %} + +Aplica una optimització de configuració més estricta en l'inici inicial. + +En activar-ho, el servidor es torna més ràpid i segur, però pot bloquejar algunes mecàniques o tenir un gran impacte en el joc. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` + +Suprimeix l'avís que es mostra en la inicialització de Plazma[^11]. + +### Propietat obsoleta + +Les propietats del sistema següents són obsoletes. + +#### `timings.bypassMax` + +- **Tipus**: `Boolean` +- **Valor per defecte**: `fals` +- **Obsolet**: Des de la retirada de Timings de Plazma + +Determina si es pot superar el valor màxim que es pot enviar a l'API de Timings d'Aikar. + +Si això es fa i l'API no gestiona l'excepció, s'aplicarà el límit de velocitat. + +*** + +## Argument d'inici + +L'argument d'inici es posa després de `-jar *.jar` per inicialitzar Plazma i es processa conjuntament amb aquest valor. + +### Ús + +Les propietats del sistema s'introdueixen com arguments de comandament després de `-jar *.jar`. + +Per exemple, si es vol aplicar l'argument d'inici `nogui`,\ +introduïu-ho com a continuació perquè Plazma processi l'argument `nogui` durant la inicialització. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argument d'inici complet + +#### `bukkit-settings` + +- **Àlies**: `b` +- **Valor per defecte**: `bukkit.yml` + +Configura el nom i la ubicació del [fitxer de configuració de Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Àlies**: `c` +- **Valor per defecte**: `commands.yml` + +Configura el nom i la ubicació del [fitxer de configuració de comandes de Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Àlies**: `c` +- **Valor per defecte**: `server.properties` + +Configura el nom i la ubicació del fitxer de [proprietats del servidor](../reference/configurations/property.md). + +#### `demo` + +Inicia el servidor com a món de demostració. + +#### `eraseCache` + +Elimina els fitxers de memòria cau restants després d'actualitzar el món. + +#### `forceUpgrade` + +Actualitza el món a la [versió més recent](#user-content-fn-12)[^12] ignorant la versió actual. + +#### `help` + +- **Àlies**: `?` + +Mostra tots els arguments d'inici de Plazma juntament amb les seves descripcions. + +#### `initSettings` + +Crea només els fitxers de configuració i tanca el servidor. + +#### `jfrProfile` + +Activa el perfilatge JFR. + +#### `max-players` + +- **Àlies**: `s`, `size` +- **Valor per defecte**: `(proprietats del servidor)` + +Configura el nombre màxim de [jugadors](#user-content-fn-14)[^14] permesos. + +#### `nogui` + +Desactiva el panell d'interfície gràfica. + +#### `nojline` + +Desactiva JLine i utilitza la consola de vanil·la. + +#### `online-mode` + +- **Àlies**: `o` +- **Valor per defecte**: `(proprietats del servidor)` + +Selecciona si es validen els jugadors amb el servidor d'autenticació de Mojang. + +**En cas de no utilitzar Velocity o un servidor intermediari, es poden imposar sancions per incomplir l'[EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Àlies**: `paper` +- **Valor per defecte**: `paper.yml` + +{% hint style="warning" %} + +### Aquest argument s'ha deixat d'utilitzar després de la versió 1.19.4 + +{% endhint %} + +Configura la ubicació del fitxer de configuració de PaperSpigot obsolet. + +S'utilitza per traslladar la configuració antiga a un nou fitxer de configuració i ja no es fa servir. + +#### `paper-settings-directory` + +- **Àlies**: `paper-dir` +- **Valor per defecte**: `config` + +Configura el nom i la ubicació de la carpeta on es troba el [fitxer de configuració de Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Àlies**: `plazma-dir` + +Configura el nom i la ubicació de la carpeta on es troba el [fitxer de configuració de Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Àlies**: `p` +- **Valor per defecte**: `plugins` + +Configura la ubicació de la carpeta de plugins. + +#### `pufferfish-settings` + +- **Àlies**: `pufferfish` +- **Valor per defecte**: `pufferfish.yml` + +Configura el nom i la ubicació del [fitxer de configuració de Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Àlies**: `purpur` +- **Valor per defecte**: `purpur.yml` + +Configura el nom i la ubicació del [fitxer de configuració de Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Inicia el servidor en mode segur, com si fos vanil·la. + +#### `server-ip` + +- **Àlies**: `h`, `host` +- **Valor per defecte**: `(proprietats del servidor)` + +Configura el nom de l'amfitrió del servidor o l'adreça [IP](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Àlies**: `p`, `port` +- **Valor per defecte**: `(proprietats del servidor)` + +Configura el port del servidor. + +#### `server-name` + +- **Valor per defecte**: `Un servidor de Plazma` + +Configura el nom del servidor. + +#### `spigot-settings` + +- **Àlies**: `S` +- **Valor per defecte**: `spigot.yml` + +Configura el nom i la ubicació del [fitxer de configuració de Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Àlies**: `v` + +Mostra la versió de Plazma. + +#### `world-dir` + +- **Àlies**: `W`, `universe`, `world-container` +- **Valor per defecte**: `(carpeta del servidor)` + +Configura la ubicació on es guarden els fitxers del món. + +#### `world-name` + +- **Àlies**: `w`, `world` +- **Valor per defecte**: `(proprietats del servidor)` + +Configura el nom del fitxer del món. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Depenent de la ubicació afegida, la ubicació de processament dels arguments canvia. + +[^3]: Per exemple, si voleu establir (activar) `Plazma.iKnowWhatIAmDoing` com a `true`, en lloc de introduir `-DPlazma.iKnowWhatIAmDoing=true`, només cal introduir `-DPlazma.iKnowWhatIAmDoing` i funcionarà igualment. + +[^4]: Per exemple, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector d'esdeveniments. + +[^6]: Detector d'esdeveniments. + +[^7]: Client. + +[^8]: Senyal que indica que està connectat correctament al servidor com un batec de cor. + +[^9]: Utilitzant la funció d'expulsió AFK de Purpur, també es pot expulsar els jugadors absents. + +[^10]: Sistema de escriptura de trossos sincronitzat, Sync Chunk Write System. + +[^11]: \`ATENCIÓ! Plazma pot causar problemes inesperats, així que assegureu-vos de provar-ho a fons abans de fer servir un servidor públic. + +[^12]: Aquesta optimització de món al joc també funciona amb aquest mateix principi. + +[^13]: Protocol d'Internet, IP. + +[^14]: Els administradors de nivell 2 o superior estan exclosos. diff --git a/ca/origin/plazma/adminstration/reference/commands.md b/ca/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..fefe2dd1b --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descobreix els comandaments disponibles a Plazma. +--- + +# 🖥️ Comandaments diff --git a/ca/origin/plazma/adminstration/reference/configurations/bukkit.md b/ca/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f99457a49 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ca/origin/plazma/adminstration/reference/configurations/paper/README.md b/ca/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..7364ecb44 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Aprofundeix en quin és l'objectiu de cada fitxer a la carpeta de configuració. +--- + +# 🛩️ Paper diff --git a/ca/origin/plazma/adminstration/reference/configurations/paper/global.md b/ca/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..acfa95250 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Aprofundeix en el que significa cada node de paper-global.yml. +--- + +# 🛩️ Paper (Configuració global) diff --git a/ca/origin/plazma/adminstration/reference/configurations/paper/world.md b/ca/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..7d092f4ea --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Descobriu el significat de cada node a paper-world.yml. +--- + +# 🛩️ Paper (composició de cada món) diff --git a/ca/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ca/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..2f5c7b1f1 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Aprofundeix en quin és l'objectiu de cada fitxer a la carpeta de configuració. +--- + +# ✨ Plasme diff --git a/ca/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ca/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..edf8371fd --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de plazma-global.yml. +--- + +# ✨ Plazma (configuració global) diff --git a/ca/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ca/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..a25ce1168 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Composició mundial diff --git a/ca/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ca/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..e8e2818fa --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descobriu què significa cada node de plazma-world.yml. +--- + +# ✨ Plazma (composició per món) diff --git a/ca/origin/plazma/adminstration/reference/configurations/property.md b/ca/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..c3a5d4511 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de server.properties. +--- + +# 🪨 Server.properties diff --git a/ca/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ca/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..e2798659a --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de pufferfish.yml. +--- + +# 🐡 Porc espasa diff --git a/ca/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ca/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..98f9fabdd --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de purpur.yml. +--- + +# 🦑 Purpur diff --git a/ca/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ca/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..c9379a1cd --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de purpur.yml. +--- + +# 🦑 Purpur (composició global) diff --git a/ca/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ca/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..dded8864e --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de purpur.yml. +--- + +# 🦑 Purpur (composició del món) diff --git a/ca/origin/plazma/adminstration/reference/configurations/spigot.md b/ca/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..3fe865989 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descobreix què significa cada node de spigot.yml. +--- + +# 🚰 Spigot diff --git a/ca/origin/plazma/adminstration/reference/permissions.md b/ca/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..89bd69d38 --- /dev/null +++ b/ca/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Consulta els permisos de Plazma. +--- + +# 🛡️ Permisos diff --git a/ca/origin/plazma/adminstration/referencia/README.md b/ca/origin/plazma/adminstration/referencia/README.md new file mode 100644 index 000000000..b7bb930ed --- /dev/null +++ b/ca/origin/plazma/adminstration/referencia/README.md @@ -0,0 +1,2 @@ +# 📜 Referència + diff --git a/ca/origin/plazma/adminstration/referencia/fitxers-de-configuracio/README.md b/ca/origin/plazma/adminstration/referencia/fitxers-de-configuracio/README.md new file mode 100644 index 000000000..513f28f92 --- /dev/null +++ b/ca/origin/plazma/adminstration/referencia/fitxers-de-configuracio/README.md @@ -0,0 +1,2 @@ +# 🎨 Fitxers de configuració + diff --git a/ca/origin/plazma/developers.md b/ca/origin/plazma/developers.md new file mode 100644 index 000000000..a59f628ce --- /dev/null +++ b/ca/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Desenvolupa projectes de tercers amb Plazma. +--- + +# ⚙️ Guia del desenvolupador diff --git a/ca/origin/thunderbolt/README.md b/ca/origin/thunderbolt/README.md new file mode 100644 index 000000000..44643f09e --- /dev/null +++ b/ca/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt és una plataforma de servidor basada en Plazma que permet utilitzar directament parches experimentals com a Flavor. +--- + +# 🌩️ Guia d'ús de Thunderbolt diff --git a/ca/origin/volt/README.md b/ca/origin/volt/README.md new file mode 100644 index 000000000..fb2e0bf89 --- /dev/null +++ b/ca/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt és una plantilla d'codi obert que es basa en Plazma i permet desenvolupar la seva pròpia plataforma de servidor Paperweight. +--- + +# ⚡ Guia de Desenvolupament de Volt diff --git a/cs/origin/README.md b/cs/origin/README.md new file mode 100644 index 000000000..8f55e26da --- /dev/null +++ b/cs/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Pokud máte otázky, obraťte se na nás prostřednictvím Discordu nebo diskuzí na GitHubu. +--- + +# 🏠 Vítejte na portálu dokumentace + +{% hint style="info" %} + +**Dokumentace Plazma je v současné době přeložena strojově.** + +[![Stav překladu](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) 에서 문서 번역에 참여하여 문서를 개선해 보세요. + +{% endhint %} + +### Máte problémy s používáním Plazmy? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Máte zájem o Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Chcete si vytvořit vlastní serverovou platformu pomocí Voltu? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Pokud potřebujete více informací týkajících se Minecraftu. + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/cs/origin/SUMMARY.md b/cs/origin/SUMMARY.md new file mode 100644 index 000000000..7224ae067 --- /dev/null +++ b/cs/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Obsah + +- [🏠 Vítejte v portálu dokumentů](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Návod k použití](plazma/README.md) +- [❓ Co je Plazma?](plazma/about/README.md) + - [⬇️ Stáhnout](plazma/about/downloads.md) + - [✅ Podporované verze](plazma/about/supported-versions.md) +- [⚒️ Průvodce správou serveru](plazma/administration/README.md) + - [👟 Začínáme](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Reference](plazma/administration/reference/README.md) + - [🖥️ Příkazy](plazma/administration/reference/commands.md) + - [🛡️ Oprávnění](plazma/administration/reference/permissions.md) + - [🎛️ Argumenty a vlastnosti](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Vlastnost](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globální konfigurace](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfigurace podle světa](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globální konfigurace](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfigurace podle světa](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globální konfigurace](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfigurace podle světa](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Expertní znalosti](plazma/administration/expert/README.md) + - [🧹 Optimalizace](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Převod na základní nastavení](plazma/administration/expert/vanillaize.md) + - [🩻 Blokování X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Zranitelnosti a opravy](plazma/administration/expert/fix-exploits.md) + - [⁉️ Časté dotazy](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Průvodce vývojářem](plazma/developers.md) + - [✏️ Přispět](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Průvodce použitím Thunderboltu](thunderbolt/README.md) + +## Volt + +- [⚡ Průvodce vývojem Volta](volt/README.md) + +## Různé + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Stáhnout vše](plazma/about/downloads-all.md) diff --git a/cs/origin/miscellaneous/README.md b/cs/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/cs/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/cs/origin/plazma/README.md b/cs/origin/plazma/README.md new file mode 100644 index 000000000..b6c623b93 --- /dev/null +++ b/cs/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma je open source serverová platforma pro Minecraft: Java Edition, která přidává experimentální optimalizaci založenou na papíru a možnosti personalizace různých herních mechanismů." +--- + +# ✨ Dokumentace k použití Plazmy + +## 👋 Vítejte v dokumentaci k Plazmě + +Vítejte v návodu k použití Plazma! + +{% hint style="info" %} + +**Nemůžete vyřešit problém pomocí nápovědy?** + +[Oficiální Discord server](https://discord.gg/MmfC52K8A8) nebo [GitHub Diskuze](https://github.com/PlazmaMC/PlazmaBukkit/discussions) se obraťte na komunitu se svými dotazy! + +{% endhint %} + +### O Plazma + +> Zjistěte, o jakou serverovou platformu se jedná. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Pro administrátory + +> Vytvořte si vlastní server pomocí Plazma. + +{% content-ref url="administration/" %} +[správa](administration/) +{% endcontent-ref %} + +### Pro vývojáře + +> Vyzkoušejte vývoj třetích stranových projektů pomocí Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/cs/origin/plazma/about/README.md b/cs/origin/plazma/about/README.md new file mode 100644 index 000000000..0428081f1 --- /dev/null +++ b/cs/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Zjistěte, o jakou serverovou platformu se jedná. +--- + +# ❓ Co je Plazma? + +- **Plazma** je serverová platforma založená na [Paper](https://github.com/PaperMC/Paper), která si bere výhody z [Andromeda](https://github.com/EarendelArchived/Andromeda) a [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Snažíme se poskytovat vysokou stabilitu, silný výkon, rychlé aktualizace a bohaté funkce. + +## 📋 Cíle Plazmy + +- Snažíme se stát serverovou platformou s rychlými aktualizacemi a vysokou stabilitou. +- Snažíme se poskytnout bohaté funkce a silný výkon, který není vůbec horší než u modových platforem. +- Snažíme se vytvořit svobodnou platformu, která umožňuje uživatelské úpravy i pro základní opravy. + +## ⚙️ Hlavní rysy + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Nejrychlejší aktualizace**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) udržuje zahrnuté opravy Plazmy vždy aktuální, což zajišťuje nejrychlejší aktualizace mezi serverovými platformami založenými na Paper. +6. **Optimalizace základních konfiguračních souborů**\ + Výchozí konfigurační soubory jsou optimalizovány, takže nemusíte ručně optimalizovat konfigurační soubory. +7. **Systémové vlákno fungující systematicky**\ + Asynchronizací systémových mechanismů oddělených od herních mechanismů se snižuje [dočasná prodleva](#user-content-fn-4)[^4] a optimalizuje se server. +8. **Blokování nepotřebných prostorů**\ + Spojením podobných hodnot do jedné se snižuje využití paměti. + +## ✨ Příklady využití + +- **Platforma, která správně zpracovává složité pluginy**\ + Na serveru vývojáře [IPECTER](https://github.com/IPECTER) je používán Plazma.\ + I přes komplexní vlastní pluginy fungující pomocí NMS a reflexe, a velké množství datových balíčků,\ + je schopna obsluhovat více než 100 hráčů bez výrazného poklesu výkonu. +- **Platforma udržující rychlý výkon i na RPG serverech**\ + Na jednom clusteru bylo udržováno stabilní prostředí pro 100 hráčů bez poklesu TPS a na 4 clusterech bylo možné pohodlně hrát až 250 hráčů. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Mnoho streamerů vybralo platformu**\ + Mnoho streamerů ji používá jako nádoby pro účast diváků. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Stáhnout + +Na následující stránce si můžete stáhnout Plazmu. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Chcete vědět více o podporovaných verzích? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Pluginy pro Bukkit, CraftBukkit, Spigot a Paper, Pufferfish, Purpur. + +[^2]: Patří pod společnost Microsoft Corporation. + +[^3]: Deaktivací systému hlášení chatu je možné zamezit sledování chatu ze strany Mojangu a zpracování chatu pouze na serveru. + +[^4]: Čas, kdy hra na chvíli zastaví svůj běh kvůli fungování systémových mechanismů. diff --git a/cs/origin/plazma/about/downloads-all.md b/cs/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..4bde12edd --- /dev/null +++ b/cs/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma spustitelný soubor ke stažení celý obsah +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Verze | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/cs/origin/plazma/about/downloads.md b/cs/origin/plazma/about/downloads.md new file mode 100644 index 000000000..88392ef27 --- /dev/null +++ b/cs/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Stáhněte si Plazma hned teď a vyzkoušejte ji sami. +--- + +# ⬇️ Stáhnout + +#### Chcete vědět více o podporovaných verzích? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Níže uvedené stažení je spustitelný soubor pro běžné uživatele.** + +Pokud jste vývojář a potřebujete jiný typ souboru, podívejte se na následující stránku. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VerzeStáhnout
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/cs/origin/plazma/about/patches-list.md b/cs/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..5db12f75a --- /dev/null +++ b/cs/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte všechny funkce přidané do Plazmy. +--- + +# 📑 Obsažené opravy diff --git a/cs/origin/plazma/about/supported-versions.md b/cs/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..f52654197 --- /dev/null +++ b/cs/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Zjistěte, které verze Minecraft: Java Edition podporuje Plazma." +--- + +# ✅ Stav podpory verzí + +{% hint style="info" %} + +**Plazma je vyvíjena od verze 1.19.4 a starší verze než 1.19.4 nejsou vyvíjeny.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: +[atv]: https://badge.plazmamc.org/2/podporováno +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Informace%20chybí +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/běžné +[100]: https://badge.plazmamc.org/percent/100 + +![čeká na vydání][wtr] ![ve vývoji][idv] ![podporováno][atv] ![podpora funkcí pozastavena][fse] ![podpora ukončena][eol] + +| Verze | Stabilita a podpora funkcí | Stav sestavení | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![stav sestavení](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Stav sestavení](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Stav sestavení](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/cs/origin/plazma/administration/README.md b/cs/origin/plazma/administration/README.md new file mode 100644 index 000000000..9cc5fee28 --- /dev/null +++ b/cs/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Vytvořte si vlastní server pomocí Plazma. +--- + +# ⚒️ Průvodce správou serveru diff --git a/cs/origin/plazma/administration/diagnosis/README.md b/cs/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..100d6fd60 --- /dev/null +++ b/cs/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak se vyrovnat s problémy, které vzniknou. +--- + +# 🧾 진단 diff --git a/cs/origin/plazma/administration/diagnosis/plugins.md b/cs/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..468192b98 --- /dev/null +++ b/cs/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak řešit problémy s nesprávným fungováním pluginu. +--- + +# 📜 플러그인 diff --git a/cs/origin/plazma/administration/expert/README.md b/cs/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..ee307b923 --- /dev/null +++ b/cs/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak profesionálně pracovat s Plazmou. +--- + +# 🎓 Pokročilé diff --git a/cs/origin/plazma/administration/expert/fix-exploits.md b/cs/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..71ea0587f --- /dev/null +++ b/cs/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte o známých zranitelnostech a způsobech jejich řešení. +--- + +# ⚠️ Známé zranitelnosti a způsoby řešení diff --git a/cs/origin/plazma/administration/expert/optimize.md b/cs/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..f29715409 --- /dev/null +++ b/cs/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak optimalizovat Plazmu. +--- + +# 🧹 Optimalizace diff --git a/cs/origin/plazma/administration/expert/proxy.md b/cs/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..2480184a3 --- /dev/null +++ b/cs/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak bezpečně nastavit platformu „Velocity“ pro proxy. +--- + +# 🔀 Proxy diff --git a/cs/origin/plazma/administration/expert/vanillaize.md b/cs/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..1cfc06836 --- /dev/null +++ b/cs/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Zjistěte, jak obnovit patch Paper a Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper nenabízí možnost přidání alternativy většině oprav chyb v Vanilla.** + +Plazma aktuálně vyvíjí možnost deaktivace těchto oprav chyb. + +Tento průvodce je stále ve vývoji a informace se mohou měnit. + +{% endhint %} diff --git a/cs/origin/plazma/administration/expert/xray.md b/cs/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..a4f75bfed --- /dev/null +++ b/cs/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte více o různých vestavěných metodách blokování X-Ray. +--- + +# 🩻 Blokování X-Ray diff --git a/cs/origin/plazma/administration/faq.md b/cs/origin/plazma/administration/faq.md new file mode 100644 index 000000000..9e96a1b41 --- /dev/null +++ b/cs/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Zjistěte odpovědi na často kladené otázky. +--- + +# ⁉️ Často kladené otázky + +{% hint style="info" %} + +**Nemůžete najít požadovanou odpověď?** + +[Oficiální Discord server](https://discord.gg/MmfC52K8A8) nebo [GitHub Diskuze](https://github.com/PlazmaMC/PlazmaBukkit/discussions) se obraťte na komunitu se svými dotazy! + +{% endhint %} + +### Plazma se nespustí + +Pokud se v konzoli zobrazí `no main manifest attribute, in plazma-(version).jar`,\ +stažený soubor je vývojovým API souborem, musíte stáhnout **Reobf Paperweight** z GitHub stránky. + +Pro detailní informace se podívejte na následující stránku. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Při každém spuštění serveru se zobrazuje varování + +Plazma obsahuje některé nestabilní opravy a vždy může dojít k chybám, proto server při spuštění vypisuje následující varování. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Toto varování lze deaktivovat pomocí systémové vlastnosti [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Pro detailní informace se podívejte na následující stránku. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostupné od verze 1.20.1 diff --git a/cs/origin/plazma/administration/getting-started/README.md b/cs/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..600932c18 --- /dev/null +++ b/cs/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Zjistěte, jak vytvořit server pomocí Plazma. +--- + +# 👟 Začínáme + +Pro stabilní používání Plazmy musí systém splňovat následující požadavky. + +| | Minimální | Doporučené | +| :------------: | --------- | ---------- | +| Architektura | x64 | - | +| RAM | 8GB | 16GB | +| Úložný prostor | 1GB | 8GB | +| JDK | 17 | 21 | + +Pro pohodlnou úpravu konfiguračních souborů je dobré nainstalovat editor jako [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Správný výstup" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (sestavení 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (sestavení 21.0.2+13-LTS, smíšený režim, sdílení) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' není rozpoznávaným vnitřním nebo externím příkazem, spustitelným programem nebo +souborem dávkových příkazů. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Nerozpoznaná volba: --version +Chyba: Nelze vytvořit virtuální stroj Java. +Chyba: Došlo k fatální výjimce. Program se ukončí. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Nejprve si stáhněte **JDK 21** ve formátu `.msi` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Spusťte stažené instalačního průvodce a postupujte kliknutím na `Další`. +3. V levém středu okna vyberte `Set JAVA_HOME variable`, potvrďte kliknutím na `Další`. +4. Kliknutím na `Instalovat` dokončete instalaci JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Poté spusťte následující příkaz pro instalaci JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Stažení Plazmy + +Plazma nabízí různé verze spustitelných souborů. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Více informací + +Název spustitelného souboru je stanoven jako `plazma-(správce verzí)-1.20.4-R0.1-SNAPSHOT-(mapovací forma).jar`. + +- **Mapovací forma**\ + Mapování slouží jako jakési spojení mezi skutečným kódem Minecraftu a obfuskovaným kódem. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, mapování používané v běžném Minecraftu. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Správce verzí**\ + Správce verzí je jakýsi spouštěcí program pro server, který je nezbytný pro spuštění serveru a aplikování patchů na serverové soubory. + - **Paperclip**\ + Správce od týmu PaperMC pro Paper a další odvozené platformy, který slouží ke stažení knihoven a aplikování patchů na server. + - **Bundler**\ + Správce verzí pro běžný Minecraft. + +
+ +*** + +## 3. Vytvoření startovacího skriptu + +Pro snadné spuštění Plazmy a automatické restartování serveru je nutné vytvořit [startovací skript](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Startovací skript lze stáhnout pomocí tlačítka pro stažení v levém dolním rohu.\ +**Zkontrolujte, zda stažený startovací skript odpovídá vašemu operačnímu systému.** + +*** + +## 4. Úklid souborů + +Přesuňte stažený startovací skript a Plazmu do nové složky. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Spusťte startovací skript. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Souhlas s EULA + +Po jednom spuštění startovacího skriptu se vytvoří soubor `eula.txt` ve složce. + +EULA[^9] je smlouva o licenci, kterou musíte přijmout k využívání služeb [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Pro souhlas s EULOU upravte a uložte soubor `eula.txt` z `eula=false` na `eula=true`. + +*** + +## 6. Povolení externího přístupu (Windows) + +Moderní operační systémy blokují externí přístup pomocí základních funkcí jako jsou **firewall** a **router**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Pokud váš router nepodporuje UPnP, každý router má jiné rozhraní, takže je třeba provést vlastní vyhledávání informací. + +Alternativně můžete použít [Ngrok](https://ngrok.com/) k vytvoření dočasné adresy. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Kontrola potřeby přesměrování portů + +Zadejte do spustitelného okna následující a spusťte ho. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Pokud je výstup `True`, není třeba nic dalšího, pokud je `False`, je třeba nastavit přesměrování portů. + +### 6.2 Připojení k serveru + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Při připojení k serveru použijte adresu zde k dispozici: [zde](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Poté restartujte server a Plazma automaticky zkusí přesměrovat porty. + +Níže je uvedeno, zda bylo UPnP úspěšné podle zpráv na konzoli, které se zobrazí jako `[UPnP] (zpráva)`. + +| Zpráva | Význam | +| ----------------------------------- | --------------------------------------------------- | +| `Port byl úspěšně otevřen (port)` | Přesměrování portu bylo úspěšné. | +| `Port (port) je již otevřený` | Jiná služba již využívá tento port. | +| `Nepodařilo se otevřít port (port)` | Přesměrování portu selhalo. | +| `Služba není dostupná` | Směrovač nepodporuje UPnP. | + +Když je server vypnut, Plazma automaticky uzavře porty. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Stáhněte ZIP soubor `Windows (64-bit)` z [domovské stránky Ngrok](https://ngrok.com/download). +2. Umístěte stažený Ngrok do složky se serverem. +3. Na [Nástěnce Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) vytvořte [autentizační token](#user-content-fn-13)[^13]. +4. Ve složce se serverem spusťte příkazy zobrazené v `Command Line`. +5. Přidejte `start /b ngrok tcp --region jp 25565` na začátek spouštěcího skriptu a `taskkill /f /t /im ngrok.exe` na konec. +6. Adresa serveru bude `0.tcp.jp.ngrok.io:12345` zobrazená na vrcholu konzole. +7. Nyní můžete přistupovat k serveru zvenčí pomocí této adresy. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Například, pokud se po spuštění příkazu zobrazí následující, + +```log +Windows IP konfigurace + +Ethernetový adaptér Ethernet: + + Připojené DNS přípony. . . . : + IPv4 adresa. . . . . . . . . : 192.168.3.7 + Maskování podsítě. . . . . . . : 255.255.255.0 + Výchozí brána. . . . . . . : 192.168.3.1 + +``` + +Pokus o připojení k serveru z lokální sítě můžete provést pomocí zobrazené `192.168.3.7` u IPv4 adresy. + +Pokud server a hra běží na stejném počítači, můžete se připojit pomocí `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Růst + +Pokud se server úspěšně spustil a správně funguje, je čas na jeho přizpůsobení. + +Pro zpřiznění serveru se podívejte na následující příručku. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, na kterém je založen Plazma, je založen na Spigotu, který je oficiální platformou serveru. + +[^3]: Kombinace kláves Windows + R + +[^4]: V případě Linuxu zadejte v terminálu `java --version` + +[^5]: JRE je jedním z open source projektů a existuje několik verzí podobně jako u platformy Minecraft serveru. + +[^6]: Je obecně znám jako **spouštěč**. + +[^7]: Pokud povolíte „Automatické restartování“, server se automaticky restartuje. Můžete ukončit pomocí `Control + C`. + +[^8]: Není doporučeno překročit polovinu dostupného systémového paměti. + + Například, pokud je celková kapacita paměti systému 8 GB, není doporučeno nastavit více než 4 GB. + +[^9]: Smlouva o koncovém uživatelském licenčním dohodě. Pro více informací se podívejte na [stránky Minecraftu](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Společnost Microsoft Corporation. + +[^11]: V souladu s čl. 32 odst. 1 písm. i) zákona o podpoře herního průmyslu v Koreji může být **Korejská pobočka společnosti Microsoft** podána žaloba. + +[^12]: Univerzální zásuvka a hraj. Purpur obsažený v Plazma komunikuje s routerem automaticky skrze tuto technologii a otevírá porty pouze tehdy, když je server spuštěn, takže není potřeba provádět přímé přesměrování portů. + +[^13]: Pokud nemáte účet, zaregistrujte se do Ngrok pomocí účtu Google nebo GitHub. diff --git a/cs/origin/plazma/administration/getting-started/customization.md b/cs/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..8e7357449 --- /dev/null +++ b/cs/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,122 @@ +--- +description: Zjistěte, jak přizpůsobit server uživatelským potřebám. +--- + +# 🎨 Uživatelské nastavení + +Důvodem, proč se používá upravená serverová platforma jako Plazma místo oficiální serverové platformy poskytované společností Mojang Studios, je možnost silné **uživatelské úpravy**. + +Níže jsou uvedeny různé způsoby, jak upravit a využívat Plazmu. + +## Úprava konfigurace + +Nejjednodušším způsobem, jak upravit Plazmu, je úprava konfigurace. + +Plazma poskytuje silné nastavení konfigurace od herních mechanismů po vlastnosti potvor. + +Pro popis konfigurace Plazmy se podívejte na následující stránku. + +{% content-ref url="../reference/configurations/" %} +[konfigurace](../reference/configurations/) +{% endcontent-ref %} + +## Použití pluginů + +{% hint style="success" %} + +**Plazma podporuje všechny zásuvné moduly založené na Paperu.** + +V případě zásuvných modulů Spigotu, které kvůli změně mapování Paperu od verze 1.20.5 nemusí správně fungovat, +většina zásuvných modulů založených na Paperu, jako je Paper, Pufferfish a Purpur, fungují v Plazmě +normálně a pokud nefungují správně, je to chyba v Plazmě, takže [nahlášení](../diagnosis/plugins.md) je nutné. + +{% endhint %} + +Jedním z hlavních důvodů použití Plazmy je nejsilnější způsob, jak Plazmu přizpůsobit uživatelům. +Silná ekosystém zásuvných modulů v Plazmě umožňuje snadno přizpůsobit server uživatelům. + +Existuje několik způsobů, jak najít a stáhnout zásuvné moduly. Některé zásuvné moduly jsou nahrány do veřejných úložišť a některé jsou nahrány na GitHub nebo na vlastní +webové stránky. + +{% hint style="caution" %} + +**Zásuvné moduly mohou přímo ovlivnit systém!** + +Před použitím zásuvného modulu vždy zkontrolujte jeho bezpečnost pomocí služeb jako VirusTotal nebo +stahujte zásuvné moduly ze důvěryhodných zdrojů. + +{% endhint %} + +Existuje několik služeb, které se používají k stahování zásuvných modulů. Mezi ně patří [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/), kde se zásuvné moduly podrobí posouzení před nahráním a nebezpečné zásuvné moduly jsou okamžitě odstraněny, aby se zajistilo, že se šíří pouze bezpečné zásuvné moduly. + +### Aplikace zásuvných modulů + +Pokud jste zásuvný modul stáhli, je čas ho aplikovat. + +1. Zásuvné moduly jsou ve formátu `.jar` nebo `Java Executable File`.\ + Některé zásuvné moduly mohou být také ve formě komprimovaných souborů, v takovém případě + rozbalte soubor, který obsahuje `bukkit`, `spigot` nebo `paper` v názvu a + pokud je k dispozici soubor s názvem `fat`, použijte tento soubor. +2. Stažený soubor umístěte do složky `plugins` ve složce serveru a server (znovu)spusťte. +3. Po spuštění Plazmy se na konzoli zobrazí nový obsah. + To znamená, že Plazma úspěšně načetla zásuvné moduly. +4. I když Plazma úspěšně načetla zásuvné moduly, může se stát, že zásuvný modul není spuštěn. + Pomocí příkazu `/plugins` můžete načíst aktuálně nahrávané zásuvné moduly na serveru. + Pokud jméno nainstalovaného zásuvného modulu není červené, ale zelené, znamená to, že zásuvný modul byl úspěšně načten. + +Pokud zásuvný modul není úspěšně načten, můžete najít řešení problému na následující stránce. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Použití datových balíků + +Datové balíky jsou způsobem, jak Minecraft umožňuje uživatelské úpravy, podobně jako +[resource pack](#user-content-fn-1)[^1]. + +Pomocí datových balíků můžete upravit některé části hry, jako je přidání nových entit a výzev. + +{% hint style="caution" %} + +**Datové balíky mohou poškodit svět!** + +Některé vadné datové balíky mohou poškodit svět a to nelze vrátit zpět. + +Proto je doporučeno zálohovat svět před aplikací datového balíku. + +{% endhint %} + +Datové balíky lze stáhnout z různých služeb, jako jsou [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs) a další. + +Po stažení datového balíku ho umístěte do složky `datapacks` ve složce světa serveru. +Pokud složka neexistuje, vytvořte ji a vložte do ní datový balík. + +{% hint style="warning" %} + +**Některé [datové balíky](#user-content-fn-2)[^2] se při prvním použití nemusí správně aplikovat.** + +V takovém případě se doporučuje server **2krát** restartovat. + +{% endhint %} + +Datové balíky mohou být snadno poškozeny s každou aktualizací Minecraftu. + +Zejména pokud je datový balík zcela poškozený, může dojít ke kolizi serveru, +proto je důležité provést dostatečné testování před aktualizací serveru. + +{% hint style="info" %} + +**Začněte server s příkazem `safeMode` za startovacím příkazem, abyste vypnuli všechny datové balíky a mohli server spustit.** + +[Pro více informací se podívejte na `Reference > Argumenty`.](../reference/arguments.md) + +{% endhint %} + +Nainstalované datové balíky lze zkontrolovat pomocí příkazu `/datapack list`. + +*** + +[^1]: Nebo Minecraft: Bedrock Edition doplněk. + +[^2]: Přidání nových entit atd. diff --git a/cs/origin/plazma/administration/getting-started/next-step.md b/cs/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..bc7c1532d --- /dev/null +++ b/cs/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Zjistěte, jak přizpůsobit server uživatelským potřebám. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Níže jsou uvedeny různé způsoby, jak upravit a využívat Plazmu. + +## Úprava konfigurace + +Nejjednodušším způsobem, jak upravit Plazmu, je úprava konfigurace. + +Plazma poskytuje silné nastavení konfigurace od herních mechanismů po vlastnosti potvor. + +Pro popis konfigurace Plazmy se podívejte na následující stránku. + +{% content-ref url="../reference/configurations/" %} +[konfigurace](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Použití pluginů + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Jedním z hlavních důvodů použití Plazmy je nejsilnější způsob, jak Plazmu přizpůsobit uživatelům. Silná ekosystém zásuvných modulů v Plazmě umožňuje snadno přizpůsobit server uživatelům. + +Existuje několik způsobů, jak najít a stáhnout zásuvné moduly. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Existuje několik služeb, které se používají k stahování zásuvných modulů. Mezi ně patří [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/), kde se zásuvné moduly podrobí posouzení před nahráním a nebezpečné zásuvné moduly jsou okamžitě odstraněny, aby se zajistilo, že se šíří pouze bezpečné zásuvné moduly. + +### Aplikace zásuvných modulů + +Pokud jste zásuvný modul stáhli, je čas ho aplikovat. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Stažený soubor umístěte do složky `plugins` ve složce serveru a server (znovu)spusťte. +3. Po spuštění Plazmy se na konzoli zobrazí nový obsah. To znamená, že Plazma úspěšně načetla zásuvné moduly. +4. I když Plazma úspěšně načetla zásuvné moduly, může se stát, že zásuvný modul není spuštěn. Pomocí příkazu `/plugins` můžete načíst aktuálně nahrávané zásuvné moduly na serveru. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Pokud zásuvný modul není úspěšně načten, můžete najít řešení problému na následující stránce. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Použití datových balíků + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Pomocí datových balíků můžete upravit některé části hry, jako je přidání nových entit a výzev. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Některé vadné datové balíky mohou poškodit svět a to nelze vrátit zpět. + +Proto je doporučeno zálohovat svět před aplikací datového balíku. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Po stažení datového balíku ho umístěte do složky `datapacks` ve složce světa serveru. Pokud složka neexistuje, vytvořte ji a vložte do ní datový balík. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +V takovém případě se doporučuje server **2krát** restartovat. +{% endhint %} + +Datové balíky mohou být snadno poškozeny s každou aktualizací Minecraftu. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Nainstalované datové balíky lze zkontrolovat pomocí příkazu `/datapack list`. + +*** + +## Optimalizace + +V Plazmě je mnoho optimalizačních záplat aplikováno. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Pro informace o bezpečném a správném nastavení proxy navštivte následující stránku. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Bezpečnost + +V Minecraftu je díky rozvoji módů snadné získat [nástroje pro útoky na zranitelnost](#user-content-fn-3)[^3] i online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Nastavení oprávnění + +Některé administrátorské příkazy pluginů mohou mít zranitelnosti, pokud nejsou oprávnění správně nastavena. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blokování X-Ray + +X-Ray je jednou z zranitelností, které jsou snadno dostupné i v základní optimalizačním klientovi. + +V Plazmě je k dispozici konfigurace, která umožňuje základní blokování X-Ray. + +Návod k blokování X-Ray a další informace naleznete na následující stránce. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Pro zobrazení povolených hráčů použijte `/whitelist query`. + +*** + +[^1]: Nebo Minecraft: Bedrock Edition doplněk. + +[^2]: Přidání nových entit atd. + +[^3]: Obvykle nazývané "cheaty". + +[^4]: Pokud není konfigurace optimalizována, Plazma je zastaralá nebo jsou nově objevené zranitelnosti, nemusí být blokovány. + +[^5]: Hráči se připojují na server pomocí proxy serveru Ngrok a každý restart serveru získá novou adresu Ngrok. diff --git a/cs/origin/plazma/administration/reference/README.md b/cs/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..d2d3abcb7 --- /dev/null +++ b/cs/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Zjistěte, jak používat základní metody personalizace v Plazma. +--- + +# 📜 리퍼런스 + +V Plazma je k dispozici několik metod personalizace. + +Z nichž některé jsou metody personalizace, které lze použít okamžitě bez dalších úprav. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Oficiální Discord server](https://discord.gg/MmfC52K8A8) nebo [GitHub Diskuze](https://github.com/PlazmaMC/PlazmaBukkit/discussions) se obraťte na komunitu se svými dotazy! +{% endhint %} + +*** + +## 🖥️ Příkaz + +> Příkazy umožňují sbírat informace ve hře nebo upravovat herní prostředí. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Oprávnění + +> Oprávnění určují rozsah interakce hráče. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenty a vlastnosti + +> Argumenty a vlastnosti ovlivňují fungování Plazmy. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigurace + +> Konfigurace je základním způsobem personalizace Plazmy. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/cs/origin/plazma/administration/reference/arguments.md b/cs/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..da7e31750 --- /dev/null +++ b/cs/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Zjistěte více o počátečních argumentech a vlastnostech systému. +--- + +# 🎛️ Argumenty a vlastnosti + +Začáteční argumenty a vlastnosti systému jsou hodnoty přidávané k [příkazům používaným k spuštění Plazmy](#user-content-fn-1)[^1], které mají celkový vliv na chod Plazmy. + +[Při přidání do pozice příkazu](#user-content-fn-2)[^2] se rozdělí na **vstupní argumenty** a **systémové vlastnosti**. + +*** + +## Vlastnosti systému + +Vlastnosti systému jsou hodnoty zpracované v JVM před inicializací Plazmy zadané před `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Použití + +Vlastnosti systému se zadávají jako argumenty Java mezi `java` a `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` označuje, že tento argument není vestavěný v JVM, ale je přidaný pouze pro Plazmu, + +Pokud nezadáte žádnou hodnotu do vlastnosti, bude hodnota nastavena na [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Všechny vlastnosti systému + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktualizuje zastaralý formát značek. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy související s informacemi o entitách. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje NMS revizi pro správné načítání informací v IDE a automaticky přemapuje interní verze. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje watchdog systém v Spigotu. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje potvrzovací zprávu pro příkaz `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Pokud jste vývojář pluginů a potřebujete aktualizovat plugin, použijte místo `/reload` horkou výměnu. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje pluginy používající standardní vstup a výstup. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Upozorní na zastaralý formátovací kód v chatu. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje ověřování vzoru serveru při připojení hráče. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy pro chybějící klíče v objektech NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy pro neplatné profily lebek. + +Toto zaznamenává všechny neplatné lebky v světě s jejich polohou. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje prioritizaci tříd pluginů. + +Užitečné při problémech s pluginy vytvořenými pomocí Shade. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje Netty systém konsolidace flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Výchozí hodnota**: `750` + +Pokud je entit více, než je nastaveno, rozdělí se na více paketů k odeslání. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Výchozí hodnota**: `8192` + +Nastavuje maximální velikost paketu, kterou server může přijmout najednou. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje kontrolu verze Javy. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Může dojít k trvalému poškození souborů ve světě a selhání celé herní mechaniky. + +Všechny problémy způsobené tímto jsou vaší zodpovědností a Plazma neposkytuje žádnou podporu v této věci. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Výchozí hodnota**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Výchozí hodnota**: `80` + +Nastavuje maximální délku textu na jednom řádku značky. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Výchozí hodnota**: `(verze světa) + 1` + +Nastavuje verzi informací o aktualizaci světa pro inicializaci. + +Užitečné pro hromadné aktualizace, jinak není používáno. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `True` + +Aktivuje zpracování komentářů v YAML souborech. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Výchozí hodnota**: `30` + +Pokud hráč nepošle žádná data po dobu nastavenou v sekundách, hráč je vyhozen. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Ignoruje komentáře v serverových vlastnostech. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy pro synchronizované zápisy chunků. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje [základní systém zápisu chunků](#user-content-fn-10)[^10] v Minecraftu. + +Toto ukládá každý chunk postupně, což může zpomalit výkon. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje Explicit Flushing síťového kanálu. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Vždy zaznamenává chyby, které nejsou vyvolány hlavním vláknem. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Vypíše varování, pokud plánovaná úloha má nadměrné zpoždění. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Pokud používáte výchozí spustitelný soubor, aplikuje pouze patch, ale nezahájí server. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +Zesiluje počáteční konfiguraci. + +Aktivací se server stane rychlejším a bezpečnějším, ale může mít velký vliv na hraní her. + +#### `Plazma.disableConfigOptimization` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` +- **Konflikt**: `Plazma.aggressiveOptimize` + +Neprovádí optimalizaci počáteční konfigurace. + +Tím se použije výchozí konfigurace Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` + +Deaktivuje Plazma značení a nastaví použití základního faviconu serveru. + +#### `Plazma.useVanillaConfiguration` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Může to mít velký vliv na bezpečnost a výkon serveru. + +Problémy způsobené touto vlastností jsou zodpovědností správce serveru. +{% endhint %} + +Nastaví počáteční konfiguraci na výchozí hodnoty poskytované Mojangem. + +Následkem je deaktivace všech záplatovaných zranitelností prováděných v Paperu. + +Záplatované zranitelnosti mohou být znovu aktivovány v konfiguraci Paper nebo Plazmy. + +#### `Plazma.vanillaize` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `true` +- **Konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Nastaví počáteční konfiguraci blízko k základu. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Zastaralý atribut + +Následující systémový atribut je zastaralý. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` +- **Zastaralé**: Timings byly odstraněny z Plazmy + +Rozhoduje, zda může být překročena maximální hodnota, která může být odeslána do Aikarova Timings API. + +Pokud není v API zpracováno výjimky, bude uplatněno omezení rychlosti. + +*** + +## Počáteční argument + +Počáteční argument je hodnota, která se zadá za `-jar *.jar` při inicializaci Plazmy. + +### Použití + +Systémový atribut se zadává jako programový argument za `-jar *.jar`. + +Pokud například chcete použít počáteční argument `nogui`,\ +vytvořte vstup takto a Plazma bude zpracovávat argument `nogui` během inicializace. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Celkový počáteční argument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Výchozí hodnota**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Výchozí hodnota**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Výchozí hodnota**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Spustí server v demonstračním světě. + +#### `eraseCache` + +Odstraní zbývající cache soubory po aktualizaci světa. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Vypíše všechny počáteční argumenty a jejich popis v Plazmě. + +#### `initSettings` + +Vytvoří pouze konfigurační soubory a vypne server. + +#### `jfrProfile` + +Aktivuje JFR profilování. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Vypne grafický uživatelský panel. + +#### `nojline` + +Deaktivujte JLine a použijte konzoli Vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Vyberte, zda chcete ověřovat hráče u Mojang ověřovacího serveru. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Výchozí hodnota**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Nastavuje umístění deaktivovaného konfiguračního souboru PaperSpigot. + +Používá se k přesunu stávající konfigurace do nového souboru a poté už není používán. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Výchozí hodnota**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Výchozí hodnota**: `plugins` + +Nastavuje umístění složky s pluginy. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Výchozí hodnota**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Výchozí hodnota**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Spustí server v režimu Vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Nastavuje port serveru. + +#### `server-name` + +- **Výchozí hodnota**: `A Plazma Server` + +Nastavuje název serveru. + +#### `spigot-settings` + +- **Alias**: `S` +- **Výchozí hodnota**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Vypíše verzi Plazmy. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Výchozí hodnota**: `(server folder)` + +Nastavuje umístění souborů světa. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Nastavuje název souboru světa. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Zpracování argumentů se mění podle umístění doplnění. + +[^3]: Například, pokud chcete nastavit `Plazma.iKnowWhatIAmDoing` na `true` (aktivováno), stačí zadat `-DPlazma.iKnowWhatIAmDoing` místo `-DPlazma.iKnowWhatIAmDoing=true`, a bude fungovat stejně. + +[^4]: Například, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor událostí. + +[^6]: Detektor událostí. + +[^7]: Klient. + +[^8]: Signál oznamující, že je klient úspěšně připojen k serveru, jako srdeční tep. + +[^9]: Pomocí funkce vyhoštění AFK v Purpur můžete vyhodit i hráče, kteří jsou neaktivní. + +[^10]: Synchronizační systém zápisu bloků, Sync Chunk Write System. + +[^11]: `VAROVÁNÍ! Plazma může způsobit neočekávané problémy, takže si ji pečlivě otestujte před použitím na veřejném serveru.` + +[^12]: Ve hře funguje `optimalizace světa` na stejném principu. + +[^13]: Administrátoři nad `úrovní 2` jsou vyloučeni. + +[^14]: Internetový protokol, IP. diff --git a/cs/origin/plazma/administration/reference/commands.md b/cs/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..1b8892bee --- /dev/null +++ b/cs/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, které příkazy jsou k dispozici v Plazma. +--- + +# 🖥️ Příkazy diff --git a/cs/origin/plazma/administration/reference/configurations/README.md b/cs/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..5e91c25af --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigurace je základním způsobem personalizace Plazmy. +--- + +# 🧾 구성 + +*** + +## 🪨 Vlastnost + +> Vlastnost je základní konfigurační soubor poskytovaný v Minecraftu. Pomocí vlastnosti můžete změnit základní mechanismy hry. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit konfigurace + +> Bukkit konfigurace je základní konfigurační soubor poskytovaný v Plazmě. Pomocí Bukkit konfigurace můžete změnit základní mechanismy serveru Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot konfigurace + +> Spigot konfigurace umožňuje úpravu detailních mechanismů hry, zpracování hráčů, fungování příkazů a zpráv. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper konfigurace + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish konfigurace umožňuje změnu zpracování světů a entit v Plazmě. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur konfigurace + +> Purpur vlastnosti umožňují úpravu základních dat hry. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfigurace + +> Plazma konfigurace umožňuje personalizaci funkcí Plazmy. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/cs/origin/plazma/administration/reference/configurations/bukkit.md b/cs/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0f51ed4c4 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/cs/origin/plazma/administration/reference/configurations/paper/README.md b/cs/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..57a359ea2 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, k čemu slouží každý soubor v adresáři config. +--- + +# 🛩️ Paper diff --git a/cs/origin/plazma/administration/reference/configurations/paper/global.md b/cs/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..aeb881605 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/cs/origin/plazma/administration/reference/configurations/paper/world.md b/cs/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..34418dc87 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Světový diff --git a/cs/origin/plazma/administration/reference/configurations/plazma/README.md b/cs/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..b9887dabf --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, k čemu slouží každý soubor v adresáři config. +--- + +# ✨ Plazma diff --git a/cs/origin/plazma/administration/reference/configurations/plazma/global.md b/cs/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..865b3295c --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/cs/origin/plazma/administration/reference/configurations/plazma/world.md b/cs/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..20dc82c3e --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/cs/origin/plazma/administration/reference/configurations/plazma/worlds.md b/cs/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..bd6651d0f --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru plazma-world.yml. +--- + +# ✨ Plazma (struktura světů) diff --git a/cs/origin/plazma/administration/reference/configurations/property.md b/cs/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..fb962a425 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamenají jednotlivé uzly v server.properties. +--- + +# 🪨 Server.properties diff --git a/cs/origin/plazma/administration/reference/configurations/pufferfish.md b/cs/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..3c818f6ee --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru pufferfish.yml. +--- + +# 🐡 Rypoun diff --git a/cs/origin/plazma/administration/reference/configurations/purpur/README.md b/cs/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..1dd7ae7f1 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v purpur.yml. +--- + +# 🦑 Purpur diff --git a/cs/origin/plazma/administration/reference/configurations/purpur/global.md b/cs/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..4e95fc992 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/cs/origin/plazma/administration/reference/configurations/purpur/world.md b/cs/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..d8959932f --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/cs/origin/plazma/administration/reference/configurations/spigot.md b/cs/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..40a2c01d1 --- /dev/null +++ b/cs/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru spigot.yml. +--- + +# 🚰 Spigot diff --git a/cs/origin/plazma/administration/reference/permissions.md b/cs/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..d148cb749 --- /dev/null +++ b/cs/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Zjistěte více o oprávněních aplikace Plazma. +--- + +# 🛡️ Oprávnění + +Oprávnění jsou jednoduchým bezpečnostním nástrojem, který určuje rozsah, ve kterém mohou hráči na serveru vzájemně interagovat. + +Pro správné využití oprávnění a snadnou úpravu je třeba použít pluginy jako [LuckPerms](https://luckperms.net). + +*** + +## Porozumění základnímu systému oprávnění + +V Minecraftu jsou poskytovány základní správcovské skupiny oprávnění. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Hráč**\ + Obecná skupina oprávnění, která je obvykle udělena všem hráčům. +2. **Prostředník**\ + Může ignorovat ochranu spawnu. +3. **Správce světa**\ + Může používat všechny příkazy a příkazové bloky související se správou světa.\ + Je to základní skupina oprávnění, která se vztahuje na datové balíčky a příkazové bloky. +4. **Administrátor**\ + Může používat všechny příkazy související s řízením hráčů. +5. **Hlavní správce**\ + Může používat všechny příkazy související se správou serveru.\ + Je to základní skupina oprávnění, která se vztahuje na konzoli a administrátory. + +*** + +## Nastavení oprávnění + +*** + +## Celková oprávnění + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Výchozí**: `None` + +Umožňuje hráčům se `skrčit` a interagovat s entitami, aby mohli na ně nastoupit. + +Pokud nastoupíte na entitu, můžete pomocí `kláves pro pohyb` ovládat pohyb entity a pomocí `kláves pro skok` skákat nebo létat. + +Do `(Namespaced Key)` se zadává [Namespaced ID](#user-content-fn-2)[^2] entity. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Výchozí**: `None` + +Umožňuje hráči používat speciální schopnosti entity, když na ní jezdí. + +Ne všechny entity mají dostupné speciální schopnosti. Pro seznam všech dostupných speciálních schopností se podívejte níže. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Své nápady můžete sdílet na [Plazma Discordu](https://plazmamc.org/discord) nebo [GitHub Diskuzích](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Zobrazit všechny dostupné speciální schopnosti + +- **`crepper`**\ + Při stisknutí `klávesy pro skok` exploduje.\ + Pokud hráč má oprávnění `allow.powered.creeper`, může držením `klávesy pro skok` nabít výbuch. +- **`dolphin`**\ + Při stisknutí `klávesy pro skok` se vrhne dopředu. +- **`phantom`**\ + Při stisknutí `klávesy pro skok` vystřelí plameny. +- **`wither`**\ + Při `interakci` vystřelí hlavu s Witherem. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/credits (Hráč)`](commands.md#credits). + +Pokud za oprávněním následuje `.other`, umožňuje použití jinému hráči. + +#### `bukkit.command.demo` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/demo (Hráč)`](commands.md#demo). + +Pokud za oprávněním následuje `.other`, umožňuje použití jinému hráči. + +#### `bukkit.command.ping` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/ping (Hráč)`](commands.md#ping). + +Pokud za oprávněním následuje `.other`, umožňuje použití jinému hráči. + +#### `bukkit.command.ram` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/rambar (Hráč)`](commands.md#rambar). + +Pokud za oprávněním následuje `.other`, umožňuje použití jinému hráči. + +#### `bukkit.command.restart` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/tpsbar (Hráč)`](commands.md#tpsbar). + +Pokud za oprávněním následuje `.other`, umožňuje použití jinému hráči. + +#### `bukkit.command.timings` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Pro informace o podobných příkazech se podívejte na [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje použití příkazu `/gamemode (GameMode) (Hráč)`. + +Pokud za oprávněním následuje `.other`, umožňuje použití jinému hráči. + +#### `paper.antixray.bypass` + +- **Výchozí**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Tímto způsobem mohou obě strany zažít zlepšení výkonu. + +> Pro informace o nastavení X-Ray se podívejte na následující stránku. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Výchozí**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Výchozí**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Výchozí**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Výchozí**: `None` + +Umožňuje používat [MiniMessage značky](https://docs.advntr.dev/minimessage/format.html) na kovadlech. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Výchozí**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Výchozí**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Výchozí**: `None` + +Vylučuje hráče z cíle vyhazování za nečinnost. + +#### `purpur.debug.f3n` + +- **Výchozí poskytovatel**: `Správce světa` + +Umožňuje hráči změnit herní režim pomocí klávesové zkratky `F3 + N`. + +Pokud hráč nemá oprávnění pro tento herní režim, nebude fungovat. + +#### `purpur.drop.spawners` + +- **Výchozí**: `None` + +Při těžbě spawnovacího bloku s nastaveným předmětem se spawnovací blok zahodí. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Výchozí**: `None` + +Změní velikost Ender truhly. + +Do `(NumberString)` lze zadat `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Výchozí**: `None` + +Umožňuje fungování Totemu nesmrtelnosti i když je v inventáři. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Výchozí**: `None` + +Umožňuje hráčům ignorovat omezení na maximální počet připojených hráčů. + +#### `purpur.mending_shift_click` + +- **Výchozí**: `None` + +Umožňuje hráčům opravit položku, kterou drží, když se `skloní a kliknou`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Výchozí**: `None` + +Umožňuje hráčům umístit spawnery. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Výchozí**: `None` + +Umožňuje hráčům okamžitě se přemístit, když použijí Nether portál. + +#### `purpur.sign.color` + +- **Výchozí**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Výchozí**: `None` + +Umožňuje používat kouzelné kódy `(&o)` na cedulích. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Výchozí**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Výchozí**: `None` + +Umožňuje hráčům zabránit výbuchu TNT interakcí s ním pomocí nůžek. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Plánovaná oprávnění + +#### `plazma.bypass.ncr-require` + +- **Výchozí**: `None` + +Umožňuje hráčům připojit se i bez nainstalovaného módu [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operátor. + +[^2]: Např.: `ender_dragon` diff --git a/cs/origin/plazma/adminstration/README.md b/cs/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..9cc5fee28 --- /dev/null +++ b/cs/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Vytvořte si vlastní server pomocí Plazma. +--- + +# ⚒️ Průvodce správou serveru diff --git a/cs/origin/plazma/adminstration/expert/README.md b/cs/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..ee307b923 --- /dev/null +++ b/cs/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak profesionálně pracovat s Plazmou. +--- + +# 🎓 Pokročilé diff --git a/cs/origin/plazma/adminstration/expert/fix-exploits.md b/cs/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..71ea0587f --- /dev/null +++ b/cs/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte o známých zranitelnostech a způsobech jejich řešení. +--- + +# ⚠️ Známé zranitelnosti a způsoby řešení diff --git a/cs/origin/plazma/adminstration/expert/optimize.md b/cs/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..f29715409 --- /dev/null +++ b/cs/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak optimalizovat Plazmu. +--- + +# 🧹 Optimalizace diff --git a/cs/origin/plazma/adminstration/expert/vanillaize.md b/cs/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..f5e8ac56a --- /dev/null +++ b/cs/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Zjistěte, jak obnovit patch Paper a Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper neposkytuje možnost volby většiny patchů pro opravu chyb Vanilla. + +Plazma aktuálně vyvíjí možnost deaktivace těchto oprav chyb. + +Tento průvodce je stále ve vývoji a informace se mohou měnit. +{% endhint %} diff --git a/cs/origin/plazma/adminstration/faq.md b/cs/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..20ce42f7a --- /dev/null +++ b/cs/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Zjistěte odpovědi na často kladené otázky. +--- + +# ⁉️ Často kladené otázky + +{% hint style="info" %} + +### Nemůžete najít požadovanou odpověď? + +Zeptejte se komunity na [Oficiálním Discord serveru](https://discord.gg/MmfC52K8A8) nebo na [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Problém s nezdařeným spuštěním zprávy + +Pokud se v konzoli zobrazí `no main manifest attribute, in plazma-(version).jar`,\ +stažený soubor je vývojovým API souborem, musíte stáhnout **Reobf Paperweight** z GitHub stránky. + +Pro detailní informace se podívejte na následující stránku. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Při každém spuštění serveru se zobrazuje varování + +Plazma obsahuje některé nestabilní opravy a vždy může dojít k chybám, proto server při spuštění vypisuje následující varování. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Toto varování lze deaktivovat pomocí systémové vlastnosti [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Pro detailní informace se podívejte na následující stránku. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostupné od verze 1.20.1 diff --git a/cs/origin/plazma/adminstration/getting-started/README.md b/cs/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..1e8ac8c1b --- /dev/null +++ b/cs/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Zjistěte, jak vytvořit server pomocí Plazma. +--- + +# 👟 Začínáme + +Pro stabilní používání Plazmy musí systém splňovat následující požadavky. + +| | Minimální | Doporučené | +| :------------: | --------: | ---------: | +| Architektura | x64 | - | +| RAM | 8GB | 16GB | +| Úložný prostor | 1GB | 8GB | +| JRE | 17 | 21 | + +Pro pohodlnou úpravu konfiguračních souborů je dobré nainstalovat editor jako [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalace JRE + +Jak název napovídá, Minecraft: **"Java"** Edition je vyvíjen v Javě a ke spuštění je potřeba JRE[^1]. + +Plazma je oficiální serverová platforma od Mojang Studios [založená na tomto](#user-content-fn-2)[^2], proto je pro používání Plazmy nutné nainstalovat JRE. + +### 1.1 Kontrola JRE + +Pro ověření instalace JRE na systému zadejte do [spustitelného okna](#user-content-fn-3)[^3] příkaz [`cmd /k java --version`](#user-content-fn-4)[^4] a spusťte ho. + +Pokud se zobrazí následující výstup, přeskočte na [2. krok](setup.md#id-2). + +{% code title="Správný výstup" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Pokud se nezobrazí výstup jako výše, nebo se zobrazí následující, chybí JRE nebo je příliš zastaralý, a je třeba provést [1.2 krok](setup.md#id-1.2). + +{% code title="JRE není nainstalováno" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE je příliš zastaralé" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalace JRE + +V tomto průvodci použijeme jednu z [verzí](#user-content-fn-5)[^5] JRE, konkrétně Azul Zulu. + +Po dokončení instalace zkontrolujte správnost instalace opakováním [1.1 kroku](setup.md#id-1.1). + +{% tabs %} +{% tab title="Windows" %} + +1. Nejprve si stáhněte **JDK 21** ve formátu `.msi` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Spusťte stažené instalačního průvodce a postupujte kliknutím na `Další`. +3. V levém středu okna vyberte `Set JAVA_HOME variable`, potvrďte kliknutím na `Další`. +4. Kliknutím na `Instalovat` dokončete instalaci JRE. + {% endtab %} + +{% tab title="macOS" %} +Stáhněte si instalační průvodce **JDK 21** ve formátu `.dmg` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) a postupujte podle návodů k instalaci JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Nejprve spusťte následující příkaz v terminálu pro přidání úložiště Azul Zulu do APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Poté spusťte následující příkaz pro instalaci JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Pro instalaci JRE zadejte následující příkaz. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Stažení Plazmy + +Plazma nabízí různé verze spustitelných souborů. + +{% hint style="warning" %} + +### Většinou se používá `Reobf Paperclip`. + +Následující informace jsou pro vývojáře nebo zvídavé jedince ohledně jednotlivých verzí.\ +Pro běžné uživatele je možné přeskočit na [3. krok](setup.md#id-3) bez problémů. +{% endhint %} + +
+ +Více informací + +Název spustitelného souboru je stanoven jako `plazma-(správce verzí)-1.20.4-R0.1-SNAPSHOT-(mapovací forma).jar`. + +- **Mapovací forma**\ + Mapování slouží jako jakési spojení mezi skutečným kódem Minecraftu a obfuskovaným kódem. + - **Reobf**\ + Reobfuskace, též známá jako Spigot mapování, je běžně používána v NMS zásuvných modulech.\ + Od verze 1.20.5 bude používání ukončeno. + - **Mojmap**\ + Mapování od Mojang, základní mapování Minecraftu. +- **Správce verzí**\ + Správce verzí je jakýsi spouštěcí program pro server, který je nezbytný pro spuštění serveru a aplikování patchů na serverové soubory. + - **Paperclip**\ + Správce od týmu PaperMC pro Paper a další odvozené platformy, který slouží ke stažení knihoven a aplikování patchů na server. + - **Bundler**\ + Správce verzí pro běžný Minecraft. + +
+ +*** + +## 3. Vytvoření startovacího skriptu + +Pro snadné spuštění Plazmy a automatické restartování serveru je nutné vytvořit [startovací skript](#user-content-fn-6)[^6]. + +Pomocí [Flags.sh](https://flags.sh) lze vytvořit [startovací skript.](#user-content-fn-7)[^7]\ +Pro Plazmu stačí zadat [paměť k použití](#user-content-fn-8)[^8], příkaz se automaticky optimalizuje. + +Startovací skript lze stáhnout pomocí tlačítka pro stažení v levém dolním rohu.\ +**Zkontrolujte, zda stažený startovací skript odpovídá vašemu operačnímu systému.** + +*** + +## 4. Úklid souborů + +Přesuňte stažený startovací skript a Plazmu do nové složky. + +{% hint style="warning" %} + +### Název složky nesmí obsahovat mezery a musí být v angličtině. + +V opačném případě Plazma nebo JRE nemusí správně fungovat. +{% endhint %} + +Spusťte startovací skript. V případě Windows musíte výběrem **Povolit** ve výběrovém okně povolit firewall. + +*** + +## 5. Souhlas s EULA + +Po jednom spuštění startovacího skriptu se vytvoří soubor `eula.txt` ve složce. + +EULA[^9] je smlouva o licenci, kterou musíte přijmout k využívání služeb [Mojang Studios](#user-content-fn-10)[^10]. + +Pokud nesouhlasíte s EULOU, nemůžete spustit server a porušení EULY může mít za následek sankce, jako je pozastavení účtu, atd. [může to být trestáno.](#user-content-fn-11)[^11] + +Pro souhlas s EULOU upravte a uložte soubor `eula.txt` z `eula=false` na `eula=true`. + +*** + +## 6. Povolení externího přístupu (Windows) + +Moderní operační systémy blokují externí přístup pomocí základních funkcí jako jsou **firewall** a **router**. + +V případě Windows, pokud jste povolili firewall v [3. kroku](setup.md#id-3), stačí provést pouze přesměrování portů. + +{% hint style="info" %} + +### Tento průvodce předpokládá použití operačního systému Windows a [**UPnP**](#user-content-fn-12)[^12] na routeru. + +Pokud váš router nepodporuje UPnP, každý router má jiné rozhraní, takže je třeba provést vlastní vyhledávání informací. + +Alternativně můžete použít [Ngrok](https://ngrok.com/) k vytvoření dočasné adresy. +{% endhint %} + +{% hint style="warning" %} + +### Pro (polo) UNIXové operační systémy jako Linux nebo macOS jsou nastavení firewallu specifická pro jednotlivé služby, je třeba provést vlastní vyhledávání informací. + +{% endhint %} + +### 6.1 Kontrola potřeby přesměrování portů + +Zadejte do spustitelného okna následující a spusťte ho. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Pokud je výstup `True`, není třeba nic dalšího, pokud je `False`, je třeba nastavit přesměrování portů. + +### 6.2 Připojení k serveru + +{% tabs %} +{% tab title="Připojení zvenčí" %} +Pokud není potřeba přesměrování portů nebo již bylo úspěšně provedeno, můžete se nyní připojit k serveru. + +Při připojení k serveru použijte adresu zde k dispozici: [zde](https://ip.pe.kr/) +{% endtab %} + +{% tab title="Pokus o přesměrování portu pomocí UPnP" %} +V souboru `purpur.yml` ve složce serveru aktivujte `network.upnp-port-forwarding` na hodnotu `true`. + +Poté restartujte server a Plazma automaticky zkusí přesměrovat porty. + +Níže je uvedeno, zda bylo UPnP úspěšné podle zpráv na konzoli, které se zobrazí jako `[UPnP] (zpráva)`. + +| Zpráva | Význam | +| ----------------------------------- | ----------------------------------- | +| `Port byl úspěšně otevřen (port)` | Přesměrování portu bylo úspěšné. | +| `Port (port) je již otevřený` | Jiná služba již využívá tento port. | +| `Nepodařilo se otevřít port (port)` | Přesměrování portu selhalo. | +| `Služba není dostupná` | Směrovač nepodporuje UPnP. | + +Když je server vypnut, Plazma automaticky uzavře porty. +{% endtab %} + +{% tab title="Vytvoření dočasné adresy pomocí Ngrok" %} +Použití Ngrok je užitečné pro krátkodobé testování, účastnické akce nebo hraní s přáteli. + +1. Stáhněte ZIP soubor `Windows (64-bit)` z [domovské stránky Ngrok](https://ngrok.com/download). +2. Umístěte stažený Ngrok do složky se serverem. +3. Na [Nástěnce Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) vytvořte [autentizační token](#user-content-fn-13)[^13]. +4. Ve složce se serverem spusťte příkazy zobrazené v `Command Line`. +5. Přidejte `start /b ngrok tcp --region jp 25565` na začátek spouštěcího skriptu a `taskkill /f /t /im ngrok.exe` na konec. +6. Adresa serveru bude `0.tcp.jp.ngrok.io:12345` zobrazená na vrcholu konzole. +7. Nyní můžete přistupovat k serveru zvenčí pomocí této adresy. + {% endtab %} + +{% tab title="Připojení z lokální sítě" %} +Pokud se snažíte připojit k serveru z lokální sítě, spusťte `cmd /k ipconfig` v příkazovém řádku a připojte se k `IPv4 adrese`, která je zobrazena. + +Například, pokud se po spuštění příkazu zobrazí následující, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Pokus o připojení k serveru z lokální sítě můžete provést pomocí zobrazené `192.168.3.7` u IPv4 adresy. + +Pokud server a hra běží na stejném počítači, můžete se připojit pomocí `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Fáze rozvoje + +Pokud se server úspěšně spustil a správně funguje, je čas na jeho přizpůsobení. + +Zjistěte, jak přizpůsobit server pomocí následujícího průvodce. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java běhové prostředí. + +[^2]: Paper, na kterém je založen Plazma, je založen na Spigotu, který je oficiální platformou serveru. + +[^3]: Kombinace kláves Windows + R + +[^4]: V případě Linuxu zadejte v terminálu `java --version` + +[^5]: JRE je jedním z open source projektů a existuje několik verzí podobně jako u platformy Minecraft serveru. + +[^6]: Je obecně znám jako **spouštěč**. + +[^7]: Pokud povolíte „Automatické restartování“, server se automaticky restartuje. Můžete ukončit pomocí `Control + C`. + +[^8]: Není doporučeno překročit polovinu dostupného systémového paměti. + + Například, pokud je celková kapacita paměti systému 8 GB, není doporučeno nastavit více než 4 GB. + +[^9]: Smlouva o koncovém uživatelském licenčním dohodě. Pro více informací se podívejte na [stránky Minecraftu](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Společnost Microsoft Corporation. + +[^11]: V souladu s čl. 32 odst. 1 písm. i) zákona o podpoře herního průmyslu v Koreji může být **Korejská pobočka společnosti Microsoft** podána žaloba. + +[^12]: Univerzální zásuvka a hraj. Purpur obsažený v Plazma komunikuje s routerem automaticky skrze tuto technologii a otevírá porty pouze tehdy, když je server spuštěn, takže není potřeba provádět přímé přesměrování portů. + +[^13]: Pokud nemáte účet, zaregistrujte se do Ngrok pomocí účtu Google nebo GitHub. diff --git a/cs/origin/plazma/adminstration/getting-started/customization.md b/cs/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..7987df98d --- /dev/null +++ b/cs/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, jak přizpůsobit server uživatelským potřebám. +--- + +# 🎨 Uživatelské nastavení diff --git a/cs/origin/plazma/adminstration/reference/README.md b/cs/origin/plazma/adminstration/reference/README.md new file mode 100644 index 000000000..8a9d38718 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/README.md @@ -0,0 +1,2 @@ +# 📜 Reference + diff --git a/cs/origin/plazma/adminstration/reference/arguments.md b/cs/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..4fe5c8f34 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Zjistěte více o počátečních argumentech a vlastnostech systému. +--- + +# 🎛️ Argumenty a vlastnosti + +Počáteční proměnné a vlastnosti systému jsou hodnoty připojené k [příkazům používaným k spuštění Plazmy](#user-content-fn-1)[^1],\ +co umožňuje změnit hodnotu, která nemůže být změněna po spuštění Plazmy. + +V závislosti na [místě, kde jsou připojeny k příkazu](#user-content-fn-2)[^2], se rozdělují na **počáteční argumenty** a **vlastnosti systému**. + +*** + +## Vlastnosti systému + +Vlastnosti systému jsou hodnoty zpracované v JVM před inicializací Plazmy zadané před `-jar`. + +{% hint style="warning" %} + +### Změna vlastností systému může ovlivnit chování Plazmy a JVM a může mít velký dopad na hru! + +Pokud nejste jisti, jakou roli jednotlivé vlastnosti systému hrají, **nepoužívejte je!** +{% endhint %} + +### Použití + +Vlastnosti systému se zadávají jako argumenty Java mezi `java` a `-jar`. + +Například pokud chcete použít vlastnost systému `Plazma.dummyProperty`,\ +po zadání následujícího textu se hodnota `37` přidá jako další vlastnost při inicializaci Plazmy. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` označuje, že tento argument není vestavěný v JVM, ale je přidaný pouze pro Plazmu, + +Pokud nezadáte žádnou hodnotu, hodnota se [nastaví na `true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platformy řady Paperweight mají v názvech vlastností systému `.` k oddělení vlastností pro jednotlivé platformy. + +V některých terminálech, jako je Windows Powershell, může být nutné přidat `"` na oba konce argumentu. [Takto se to dělá.](#user-content-fn-4)[^4] +{% endhint %} + +### Všechny vlastnosti systému + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktualizuje zastaralý formát značek. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy související s informacemi o entitách. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje NMS revizi pro správné načítání informací v IDE a automaticky přemapuje interní verze. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje watchdog systém v Spigotu. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje potvrzovací zprávu pro příkaz `/reload`. + +{% hint style="danger" %} + +### Příkaz `/reload` je velmi nestabilní, takže všechny problémy na serveru po jeho použití jsou na vaší vlastní zodpovědnosti. + +Pokud jste vývojář pluginů a potřebujete aktualizovat plugin, použijte místo `/reload` horkou výměnu. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje pluginy používající standardní vstup a výstup. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Upozorní na zastaralý formátovací kód v chatu. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje ověřování vzoru serveru při připojení hráče. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy pro chybějící klíče v objektech NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy pro neplatné profily lebek. + +Toto zaznamenává všechny neplatné lebky v světě s jejich polohou. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje omezení počtu 128 kanálů pluginů na hráče.[^5] + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje prioritizaci tříd pluginů. + +Užitečné při problémech s pluginy vytvořenými pomocí Shade. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje Netty systém konsolidace flush. + +#### `Paper.excessiveTELimit` + +- **Typ**: `Integer` +- **Výchozí hodnota**: `750` + +Pokud je entit více, než je nastaveno, rozdělí se na více paketů k odeslání. + +#### `Paper.filterThreshold` + +- **Typ**: `Integer` +- **Výchozí hodnota**: `8192` + +Nastavuje maximální velikost paketu, kterou server může přijmout najednou. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Deaktivuje kontrolu verze Javy. + +{% hint style="danger" %} + +### To umožňuje JVM přistupovat k neexistujícímu kódu! + +Může dojít k trvalému poškození souborů ve světě a selhání celé herní mechaniky. + +Všechny problémy způsobené tímto jsou vaší zodpovědností a Plazma neposkytuje žádnou podporu v této věci. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Typ**: `Integer` +- **Výchozí hodnota**: `64` + +Nastavuje omezení názvu kanálu pluginu.[^6] + +#### `Paper.maxSignLength` + +- **Typ**: `Integer` +- **Výchozí hodnota**: `80` + +Nastavuje maximální délku textu na jednom řádku značky. + +#### `Paper.minPrecachedDatafixVersion` + +- **Typ**: `Integer` +- **Výchozí hodnota**: `(verze světa) + 1` + +Nastavuje verzi informací o aktualizaci světa pro inicializaci. + +Užitečné pro hromadné aktualizace, jinak není používáno. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `True` + +Aktivuje zpracování komentářů v YAML souborech. + +#### `Paper.playerConnection.keepAlive` + +- **Typ**: `Integer` +- **Výchozí hodnota**: `30` + +Pokud hráč nepošle žádná data po dobu nastavenou v sekundách, hráč je vyhozen. + +Obvykle hra[^7] pravidelně posílá [heartbeat signály](#user-content-fn-8)[^8] na server, takže [není vyhozen,](#user-content-fn-9)[^9] ale pokud hra neodpoví, je považována za havarovanou a hráč je vyhozen. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Ignoruje komentáře v serverových vlastnostech. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje debug logy pro synchronizované zápisy chunků. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje [základní systém zápisu chunků](#user-content-fn-10)[^10] v Minecraftu. + +Toto ukládá každý chunk postupně, což může zpomalit výkon. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Aktivuje Explicit Flushing síťového kanálu. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Vždy zaznamenává chyby, které nejsou vyvolány hlavním vláknem. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Vypíše varování, pokud plánovaná úloha má nadměrné zpoždění. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `False` + +Pokud používáte výchozí spustitelný soubor, aplikuje pouze patch, ale nezahájí server. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` + +{% hint style="warning" %} + +### Tato vlastnost bude přesunuta do počátečních argumentů po verzi 1.20.5. + +{% endhint %} + +Při prvním spuštění se přísněji uplatní optimalizace konfigurace. + +Aktivací se server stane rychlejším a bezpečnějším, ale může blokovat některé funkce nebo výrazně ovlivnit hraní hry. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` + +Potlačuje varování[^11], které se objeví při inicializaci Plazmy. + +### Zastaralý atribut + +Následující systémový atribut je zastaralý. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Výchozí hodnota**: `false` +- **Zastaralé**: Timings byly odstraněny z Plazmy + +Rozhoduje, zda může být překročena maximální hodnota, která může být odeslána do Aikarova Timings API. + +Pokud není v API zpracováno výjimky, bude uplatněno omezení rychlosti. + +*** + +## Počáteční argument + +Počáteční argument je hodnota, která se zadá za `-jar *.jar` při inicializaci Plazmy. + +### Použití + +Systémový atribut se zadává jako programový argument za `-jar *.jar`. + +Pokud například chcete použít počáteční argument `nogui`,\ +vytvořte vstup takto a Plazma bude zpracovávat argument `nogui` během inicializace. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Celkový počáteční argument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Výchozí hodnota**: `bukkit.yml` + +Nastavuje název a umístění [konfiguračního souboru Bukkitu](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Výchozí hodnota**: `commands.yml` + +Nastavuje název a umístění [konfiguračního souboru příkazů Bukkitu](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Výchozí hodnota**: `server.properties` + +Nastavuje název a umístění [souboru vlastností serveru](../reference/configurations/property.md). + +#### `demo` + +Spustí server v demonstračním světě. + +#### `eraseCache` + +Odstraní zbývající cache soubory po aktualizaci světa. + +#### `forceUpgrade` + +Vynutí [aktualizaci](#user-content-fn-12)[^12] světa bez ohledu na verzi. + +#### `help` + +- **Alias**: `?` + +Vypíše všechny počáteční argumenty a jejich popis v Plazmě. + +#### `initSettings` + +Vytvoří pouze konfigurační soubory a vypne server. + +#### `jfrProfile` + +Aktivuje JFR profilování. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Nastavuje maximální počet [hráčů](#user-content-fn-14)[^14] povolených na serveru. + +#### `nogui` + +Vypne grafický uživatelský panel. + +#### `nojline` + +Deaktivujte JLine a použijte konzoli Vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Vyberte, zda chcete ověřovat hráče u Mojang ověřovacího serveru. + +**Pokud nepoužíváte Velocity nebo jiný proxy, může to být porušení [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Výchozí hodnota**: `paper.yml` + +{% hint style="warning" %} + +### Toto pole bylo zrušeno po verzi 1.19.4. + +{% endhint %} + +Nastavuje umístění deaktivovaného konfiguračního souboru PaperSpigot. + +Používá se k přesunu stávající konfigurace do nového souboru a poté už není používán. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Výchozí hodnota**: `config` + +Nastavuje název a umístění složky, kde jsou uloženy [konfigurační soubory Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Nastavuje název a umístění složky, kde jsou uloženy [konfigurační soubory Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Výchozí hodnota**: `plugins` + +Nastavuje umístění složky s pluginy. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Výchozí hodnota**: `pufferfish.yml` + +Nastavuje název a umístění [konfiguračního souboru Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Výchozí hodnota**: `purpur.yml` + +Nastavuje název a umístění [konfiguračního souboru Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Spustí server v režimu Vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Nastavuje název hostitele serveru nebo [IP adresu](#user-content-fn-13). + +#### `server-port` + +- **Alias**: `p`, `port` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Nastavuje port serveru. + +#### `server-name` + +- **Výchozí hodnota**: `A Plazma Server` + +Nastavuje název serveru. + +#### `spigot-settings` + +- **Alias**: `S` +- **Výchozí hodnota**: `spigot.yml` + +Nastavuje název a umístění [konfiguračního souboru Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Vypíše verzi Plazmy. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Výchozí hodnota**: `(server folder)` + +Nastavuje umístění souborů světa. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Výchozí hodnota**: `(serverové vlastnosti)` + +Nastavuje název souboru světa. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Zpracování argumentů se mění podle umístění doplnění. + +[^3]: Například, pokud chcete nastavit `Plazma.iKnowWhatIAmDoing` na `true` (aktivováno), stačí zadat `-DPlazma.iKnowWhatIAmDoing` místo `-DPlazma.iKnowWhatIAmDoing=true`, a bude fungovat stejně. + +[^4]: Například, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor událostí. + +[^6]: Detektor událostí. + +[^7]: Klient. + +[^8]: Signál oznamující, že je klient úspěšně připojen k serveru, jako srdeční tep. + +[^9]: Pomocí funkce vyhoštění AFK v Purpur můžete vyhodit i hráče, kteří jsou neaktivní. + +[^10]: Synchronizační systém zápisu bloků, Sync Chunk Write System. + +[^11]: `VAROVÁNÍ! Plazma může způsobit neočekávané problémy, takže si ji pečlivě otestujte před použitím na veřejném serveru.` + +[^12]: Ve hře funguje `optimalizace světa` na stejném principu. + +[^13]: Internetový protokol, IP. + +[^14]: Administrátoři nad `úrovní 2` jsou vyloučeni. diff --git a/cs/origin/plazma/adminstration/reference/commands.md b/cs/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..1b8892bee --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, které příkazy jsou k dispozici v Plazma. +--- + +# 🖥️ Příkazy diff --git a/cs/origin/plazma/adminstration/reference/configurations/bukkit.md b/cs/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0f51ed4c4 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/cs/origin/plazma/adminstration/reference/configurations/paper/README.md b/cs/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..57a359ea2 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, k čemu slouží každý soubor v adresáři config. +--- + +# 🛩️ Paper diff --git a/cs/origin/plazma/adminstration/reference/configurations/paper/global.md b/cs/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..6e2de1a43 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v paper-global.yml. +--- + +# 🛩️ Paper (globální konfigurace) diff --git a/cs/origin/plazma/adminstration/reference/configurations/paper/world.md b/cs/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f95621c98 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru paper-world.yml. +--- + +# 🛩️ Papír (složení světa) diff --git a/cs/origin/plazma/adminstration/reference/configurations/plazma/README.md b/cs/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..b9887dabf --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, k čemu slouží každý soubor v adresáři config. +--- + +# ✨ Plazma diff --git a/cs/origin/plazma/adminstration/reference/configurations/plazma/global.md b/cs/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..6bcc20929 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru plazma-global.yml. +--- + +# ✨ Plazma (globální konfigurace) diff --git a/cs/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/cs/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..de7adc0c4 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Světové složení diff --git a/cs/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/cs/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..bd6651d0f --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru plazma-world.yml. +--- + +# ✨ Plazma (struktura světů) diff --git a/cs/origin/plazma/adminstration/reference/configurations/property.md b/cs/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..fb962a425 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamenají jednotlivé uzly v server.properties. +--- + +# 🪨 Server.properties diff --git a/cs/origin/plazma/adminstration/reference/configurations/pufferfish.md b/cs/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..3c818f6ee --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru pufferfish.yml. +--- + +# 🐡 Rypoun diff --git a/cs/origin/plazma/adminstration/reference/configurations/purpur/README.md b/cs/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..1dd7ae7f1 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v purpur.yml. +--- + +# 🦑 Purpur diff --git a/cs/origin/plazma/adminstration/reference/configurations/purpur/global.md b/cs/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..3f2576e96 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v purpur.yml. +--- + +# 🦑 Purpur (globální kompozice) diff --git a/cs/origin/plazma/adminstration/reference/configurations/purpur/world.md b/cs/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..ed715117c --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v purpur.yml. +--- + +# 🦑 Purpurová (složení světa) diff --git a/cs/origin/plazma/adminstration/reference/configurations/spigot.md b/cs/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..40a2c01d1 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte, co znamená každý uzel v souboru spigot.yml. +--- + +# 🚰 Spigot diff --git a/cs/origin/plazma/adminstration/reference/konfiguracni-soubory/README.md b/cs/origin/plazma/adminstration/reference/konfiguracni-soubory/README.md new file mode 100644 index 000000000..28f0f3881 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/konfiguracni-soubory/README.md @@ -0,0 +1,2 @@ +# 🎨 Konfigurační soubory + diff --git a/cs/origin/plazma/adminstration/reference/permissions.md b/cs/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..db0650ca6 --- /dev/null +++ b/cs/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Zjistěte více o oprávněních aplikace Plazma. +--- + +# 🛡️ Oprávnění diff --git a/cs/origin/plazma/developers.md b/cs/origin/plazma/developers.md new file mode 100644 index 000000000..c9ef73bf5 --- /dev/null +++ b/cs/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Vyzkoušejte vývoj třetích stranových projektů pomocí Plazma. +--- + +# ⚙️ Průvodce vývojářem diff --git a/cs/origin/thunderbolt/README.md b/cs/origin/thunderbolt/README.md new file mode 100644 index 000000000..92a85c73c --- /dev/null +++ b/cs/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt je platforma založená na Plazma, která umožňuje experimentální záplaty rozdělit do chutí a přímo je používat. +--- + +# 🌩️ Průvodce použitím Thunderbolt diff --git a/cs/origin/volt/README.md b/cs/origin/volt/README.md new file mode 100644 index 000000000..ce7a359ba --- /dev/null +++ b/cs/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt je open source šablona, která vám umožňuje vyvíjet svou vlastní serverovou platformu Paperweight založenou na Plazma. +--- + +# ⚡ Průvodce vývojem Volt diff --git a/da/origin/README.md b/da/origin/README.md new file mode 100644 index 000000000..cd3d5a1ad --- /dev/null +++ b/da/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Hvis du har spørgsmål, bedes du spørge via Discord eller GitHub-diskussioner. +--- + +# 🏠 Velkommen til Docs Portal + +{% hint style="info" %} + +**Plazma's dokument er i øjeblikket maskinoversat.** + +[![Oversættelsesstatus](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) Forbedre dokumentationen ved at deltage i dokumentoversættelse på [https://translate.plazmamc.org/](https://translate.plazmamc.org/). + +{% endhint %} + +### Hvis der opstår problemer under brug af Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Hvis du er interesseret i Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Hvis du vil oprette din egen serverplatform med Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Hvis du har brug for mere information om Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/da/origin/SUMMARY.md b/da/origin/SUMMARY.md new file mode 100644 index 000000000..8db83dc65 --- /dev/null +++ b/da/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Indholdsfortegnelse + +- [🏠 Velkommen til Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Brugsanvisning](plazma/README.md) +- [❓ Hvad er Plazma?](plazma/about/README.md) + - [⬇️ Download](plazma/about/downloads.md) + - [✅ Understøttede versioner](plazma/about/supported-versions.md) +- [⚒️ Serveradministration Guide](plazma/administration/README.md) + - [👟 Kom godt i gang](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Reference](plazma/administration/reference/README.md) + - [🖥️ Kommandoer](plazma/administration/reference/commands.md) + - [🛡️ Tilladelser](plazma/administration/reference/permissions.md) + - [🎛️ Argumenter og Egenskaber](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Egenskab](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global Konfiguration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Verdenskonfiguration](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global Konfiguration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Verdenskonfiguration](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global Konfiguration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Verdenskonfiguration](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Ekspert](plazma/administration/expert/README.md) + - [🧹 Optimering](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Gør Vanilje](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blokering](plazma/administration/expert/xray.md) + - [⚠️ Sårbarheder og Løsninger](plazma/administration/expert/fix-exploits.md) + - [⁉️ Ofte Stillede Spørgsmål](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Udviklerguide](plazma/developers.md) + - [✏️ Bidrag](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadoc](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Brugsvejledning](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Udviklingsvejledning](volt/README.md) + +## Diverse + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Download Alle](plazma/about/downloads-all.md) diff --git a/da/origin/miscellaneous/README.md b/da/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/da/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/da/origin/plazma/README.md b/da/origin/plazma/README.md new file mode 100644 index 000000000..083862335 --- /dev/null +++ b/da/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma er en åben kildekode serverplatform til Minecraft: Java Edition, der tilføjer eksperimentel optimering baseret på papir og tilpasningsmuligheder af flere spilfunktioner." +--- + +# ✨ Plazma Brugsdokumentation + +## 👋 Velkommen til Plazma Dokumenter + +Velkommen til Plazma-brugervejledningen! + +{% hint style="info" %} + +Kan du ikke løse problemet gennem manualen? + +Spørg fællesskabet ved at bruge [Officiel Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub-diskussioner](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Om Plazma + +> Lær mere om, hvad Plazma serverplatformen er. + +{% content-ref url="about/" %} +[om](about/) +{% endcontent-ref %} + +### For administratorer + +> Brug Plazma til at oprette din egen server. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### For udviklere + +> Brug Plazma til at udvikle tredjepartsprojekter. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/da/origin/plazma/about/README.md b/da/origin/plazma/about/README.md new file mode 100644 index 000000000..44ac6f3d7 --- /dev/null +++ b/da/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Lær mere om, hvad Plazma serverplatformen er. +--- + +# ❓ Hvad er Plazma? + +- **Plazma** er en serverplatform baseret på [Paper](https://github.com/PaperMC/Paper), der kun bringer fordelene fra [Andromeda](https://github.com/EarendelArchived/Andromeda) og [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Vi stræber altid efter at levere høj stabilitet, kraftfuld ydeevne, hurtige opdateringer og omfattende funktioner. + +## 📋 Mål for Plazma + +- Vi arbejder hårdt for at blive en serverplatform med hurtige opdateringer og høj stabilitet. +- Vi stræber efter at tilbyde omfattende funktioner og kraftfuld ydeevne, ikke mindre end en modplatform. +- Vi arbejder på at skabe en fri platform, hvor selv Vanilla-patches kan tilpasses. + +## ⚙️ Vigtigste funktioner + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Hurtigste opdateringer**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) sikrer, at Plazmas inkluderede patches altid er opdaterede, hvilket giver de hurtigste opdateringer blandt Paper-baserede serverplatforme. +6. **Optimerede standardkonfigurationsfiler**\ + De medfølgende konfigurationsfiler er optimerede, så du ikke behøver at optimere dem manuelt. +7. **Effektivt multi-threaded drift**\ + Ved at asynkronisere systemmekanismer, der ikke er relateret til spillets mekanik, reduceres [latency](#user-content-fn-4)[^4] for at optimere serveren. +8. **Blokerer for unødvendig hukommelsesbrug**\ + Værdier med lignende data kombineres for at reducere hukommelsesforbruget. + +## ✨ Anvendelseseksempler + +- **En platform der korrekt håndterer komplekse plugins**\ + På udvikleren [IPECTER](https://github.com/IPECTER)'s server bruges Plazma.\ + Selv med egne plugins der fungerer med NMS og refleksion, samt store komplekse datapakker,\ + kan den modtage over 100 spillere uden ydeevneproblemer. +- **En platform der opretholder hurtig ydeevne selv på RPG-servere**\ + Det lykkedes at holde 100 spillere stabilt uden TPS-fald på en enkelt klynge,\ + og 250 spillere på 4 klynger kunne spille behageligt. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Mange streamere har valgt platformen**\ + Det er blevet valgt som en spand til seerengagement af mange streamere. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +Du kan downloade Plazma fra nedenstående side. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Vil du have detaljer om understøttede versioner? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot-plugins og Paper, Pufferfish, Purpur-plugins. + +[^2]: Ejet af Microsoft Corporation. + +[^3]: Ved at deaktivere chat rapporteringssystemet kan chatten kun behandles på serveren og forhindre Mojangs chat sporing. + +[^4]: Den tid, hvor spillet midlertidigt stopper for at lade systemmekanismer fungere. diff --git a/da/origin/plazma/about/downloads-all.md b/da/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..e7a2f32b4 --- /dev/null +++ b/da/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma udføre fil download fuld visning +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/da/origin/plazma/about/downloads.md b/da/origin/plazma/about/downloads.md new file mode 100644 index 000000000..a6b5a397b --- /dev/null +++ b/da/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Download Plazma nu og prøv det selv. +--- + +# ⬇️ Download + +#### Vil du have detaljer om understøttede versioner? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Nedenstående download er en eksekverbar fil til almindelige brugere.** + +Hvis du er udvikler og har brug for en anden type fil, skal du se nedenstående side. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionHent
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Downloads +
1.20.1 + Hent +
1.19.4 + Hent +
+ +*** diff --git a/da/origin/plazma/about/patches-list.md b/da/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..a8a86376a --- /dev/null +++ b/da/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Lær alt om alle funktioner, der er tilføjet til Plazma. +--- + +# 📑 Indeholdt patch diff --git a/da/origin/plazma/about/supported-versions.md b/da/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..297281086 --- /dev/null +++ b/da/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Find ud af hvilke versioner af Minecraft: Java Edition der understøttes af Plazma." +--- + +# ✅ Versionsunderstøttelsesstatus + +{% hint style="info" %} + +**Plazma er blevet udviklet siden 1.19.4, versioner under 1.19.4 er ikke længere under udvikling.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: https://badge.plazmamc.org/1/under%20udvikling +[atv]: https://badge.plazmamc.org/2/i%20support +[fse]: https://badge.plazmamc.org/6/funktion%20support%20suspenderet +[eol]: https://badge.plazmamc.org/4/support%20slut +[ukn]: https://badge.plazmamc.org/0/Ingen%20information +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: https://badge.plazmamc.org/percent/100 + +![venter på udgivelse][wtr] ![under udvikling][idv] ![i support][atv] ![funktion support suspenderet][fse] ![support slut][eol] + +| Version | Stabilitet og funktionalitetsstøtte | Byggestatus | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![bygge status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Bygningsstatus](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Bygningsstatus](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/da/origin/plazma/administration/README.md b/da/origin/plazma/administration/README.md new file mode 100644 index 000000000..1ea5a7c82 --- /dev/null +++ b/da/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Brug Plazma til at oprette din egen server. +--- + +# ⚒️ Serveradministration vejledning diff --git a/da/origin/plazma/administration/diagnosis/README.md b/da/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..6b4239ab4 --- /dev/null +++ b/da/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvordan du håndterer problemer, når de opstår. +--- + +# 🧾 진단 diff --git a/da/origin/plazma/administration/diagnosis/plugins.md b/da/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..2b7b2ad69 --- /dev/null +++ b/da/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvordan du løser problemer, når plugin'en ikke fungerer korrekt. +--- + +# 📜 플러그인 diff --git a/da/origin/plazma/administration/expert/README.md b/da/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..1686b3f6a --- /dev/null +++ b/da/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan man professionelt håndterer Plazma. +--- + +# 🎓 Avanceret diff --git a/da/origin/plazma/administration/expert/fix-exploits.md b/da/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..fa06c9f68 --- /dev/null +++ b/da/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Find ud af om kendte sårbarheder og hvordan man løser dem. +--- + +# ⚠️ Kendte sårbarheder og løsningsmetoder diff --git a/da/origin/plazma/administration/expert/optimize.md b/da/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..a1ba09be1 --- /dev/null +++ b/da/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du optimerer Plazma. +--- + +# 🧹 Optimering diff --git a/da/origin/plazma/administration/expert/proxy.md b/da/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..62b3eaacb --- /dev/null +++ b/da/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du sikkert konfigurerer proxy-platformen "Velocity". +--- + +# 🔀 Proxy diff --git a/da/origin/plazma/administration/expert/vanillaize.md b/da/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..d118da7a1 --- /dev/null +++ b/da/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Lær hvordan du genopretter Paper og vanilje patch. +--- + +# ↩️ Vaniljeisering + +{% hint style="warning" %} + +**Paper tilføjer ikke valgmuligheder til de fleste patches, der retter fejl i vanille.** + +Plazma udvikler i øjeblikket muligheden for at deaktivere sådanne fejlrettelser som en konfiguration. + +Derfor er denne vejledning stadig under udarbejdelse, og informationen kan altid ændres. + +{% endhint %} diff --git a/da/origin/plazma/administration/expert/xray.md b/da/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..d318fe98b --- /dev/null +++ b/da/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Lær om forskellige indbyggede metoder til at blokere X-Ray. +--- + +# 🩻 Blokering af X-Ray diff --git a/da/origin/plazma/administration/faq.md b/da/origin/plazma/administration/faq.md new file mode 100644 index 000000000..d04a799b8 --- /dev/null +++ b/da/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Find svar på ofte stillede spørgsmål. +--- + +# ⁉️ Ofte stillede spørgsmål + +{% hint style="info" %} + +**Kan du ikke finde det svar, du leder efter?** + +Spørg fællesskabet ved at bruge [Officiel Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub-diskussioner](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma starter ikke + +Hvis der vises 'ingen hovedmanifestattribut i plazma-(version).jar' i konsollen,\ +filen, du har downloadet, er en udviklings-API-fil, og du skal downloade **Reobf Paperweight** fra GitHub-siden. + +Se nærmere på følgende side for mere information. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Advarsler vises hver gang serveren starter + +Plazma indeholder nogle ustabile patches og kan potentielt mislykkes, derfor vises følgende advarsler, når serveren starter. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Disse advarsler kan deaktiveres ved hjælp af systemegenskaben [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Se nærmere på følgende side for mere information. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tilgængelig fra version 1.20.1 diff --git a/da/origin/plazma/administration/getting-started/README.md b/da/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..25a9b03cf --- /dev/null +++ b/da/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Lær hvordan du opretter en server med Plazma. +--- + +# 👟 Kom i gang + +For at bruge Plazma på en stabil måde, skal dit system opfylde følgende krav: + +| | Minimum | Anbefalet | +| :--------: | ------- | --------- | +| Arkitektur | x64 | - | +| RAM | 8GB | 16GB | +| Lagerplads | 1GB | 8GB | +| JDK | 17 | 21 | + +For nem redigering af konfigurationsfiler, er det også en god ide at installere en editor som [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Korrekt output" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' er ikke et internt eller eksternt kommando, et kørbart program eller en +batchfil. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Ukendt mulighed: --version +Fejl: Kunne ikke oprette Java Virtual Machine. +Fejl: Der opstod en fatal undtagelse. Programmet afsluttes. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Først skal du downloade **JDK 21** i `.msi`-format fra [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Kør den downloadede installationsguide og klik på `Næste`. +3. Aktivér `Set JAVA_HOME variable` fra menuen i midten af vinduet og klik derefter på `Næste`. +4. Afslut installationen ved at klikke på `Installer` for at installere JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Derefter skal du køre følgende kommando i terminalen for at installere JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma tilbyder forskellige former for eksekverbare filer. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Læs mere + +Navnet på eksekverbar fil er `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping form).jar`. + +- **Mapping Form**\ + Mapping er en slags kortlægning mellem Minecrafts faktiske kode og obfuskeringen af koden. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, er vanilla Minecraft-mapping. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + Version Manager er en slags launcher, der er nødvendig for at køre serveren og patche serverfilerne. + - **Paperclip**\ + Udviklet af PaperMC-teamet til Paper og andre afledte platforme, downloader biblioteker og anvender patches på serveren. + - **Bundler**\ + Vanilla Minecraft version manager. + +
+ +*** + +## 3. Oprettelse af Start Script + +For at starte Plazma nemt og få serveren til automatisk at genstarte, skal du oprette et [start script](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Du kan downloade startscriptet ved at klikke på download-knappen nederst til venstre.\ +**Sørg for at startscriptet er kompatibelt med dit operativsystem.** + +*** + +## 4. Fil Oprydning + +Flyt det downloadede startscript og Plazma til en ny mappe. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Kør startscriptet nu. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Accept + +Når du har kørt startscriptet en gang, vil der blive oprettet en `eula.txt`-fil i mappen. + +EULA[^9] er en licensaftale, som du skal acceptere for at bruge tjenester fra [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +For at acceptere EULA, skal du ændre `eula=false` til `eula=true` i `eula.txt`-filen og gemme ændringerne. + +*** + +## 6. Tillad Ekstern Adgang (Windows) + +Moderne operativsystemer blokerer som standard ekstern adgang fra firewall og router for at forhindre farlige tilgange udefra. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Hvis din router ikke understøtter UPnP, skal du søge information om hvordan du gør det, da panelet varierer fra router til router. + +Alternativt kan du bruge [Ngrok](https://ngrok.com/) til at oprette en midlertidig adresse. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Kontrol af Nødvendighed for Portvideresendelse + +Indtast følgende i Kør-dialogen og udfør kommandoen. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Hvis outputtet viser `True`, behøver du ikke gøre mere, men hvis det viser `False`, skal du konfigurere portvideresendelse. + +### 6.2 Forbindelse til Serveren + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Du kan finde den adresse, der bruges til at oprette forbindelse til serveren, [her](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Derefter, når serveren genstartes, vil Plazma automatisk forsøge at videresende porten. + +Nedenfor er resultatet af UPnP ifølge meddelelsen, som vises i konsollen som '[UPnP] (besked)'. + +| Besked | Betydning | +| -------------------------------------------------------- | ---------------------------------------------------------------------- | +| 'Porten (port) blev åbnet med succes' | Portvideresendelse lykkedes. | +| 'Porten (port) er allerede åben' | En anden tjeneste bruger allerede den pågældende port. | +| 'Kunne ikke åbne porten (port)' | Portvideresendelse mislykkedes. | +| 'Tjenesten er utilgængelig' | Routeren understøtter ikke UPnP. | + +Når serveren lukkes ned, lukker Plazma automatisk porten. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Download ZIP-filen til 'Windows (64-bit)' fra [Ngrok's hjemmeside](https://ngrok.com/download). +2. Placer den downloadede Ngrok i servermappen. +3. Generer en godkendelsestoken fra [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Kør kommandoen, der vises i 'Command Line' i servermappen. +5. Tilføj 'start /b ngrok tcp --region jp 25565' øverst i kørselsskriptet og 'taskkill /f /t /im ngrok.exe' nederst. +6. Fra 'Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565' i konsollen vil '0.tcp.jp.ngrok.io:12345' være serverens adresse. +7. Nu kan du oprette forbindelse eksternt via denne adresse. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +For eksempel, hvis følgende vises efter at kommandoen er kørt, + +```log +Windows IP konfiguration + +Ethernet-adapter Ethernet: + + Forbundet DNS-suffiks. . . . : + IPv4-adresse. . . . . . . . : 192.168.3.7 + Subnetmaske. . . . . . . . : 255.255.255.0 + Standardgateway. . . . . . : 192.168.3.1 + +``` + +Kan du forsøge at oprette forbindelse til serveren lokalt ved at bruge '192.168.3.7', der vises som IPv4-adressen her. + +Hvis serveren og spillet kører på samme PC, kan du oprette forbindelse ved at bruge 'localhost'. +{% endtab %} +{% endtabs %} + +## 7. Udvikle sig + +Når serveren er startet succesfuldt og kører korrekt, er det nu tid til at tilpasse serveren. + +Lær, hvordan du tilpasser serveren ved at følge nedenstående vejledning. + +{% content-ref url="næste-trin.md" %} +[næste-trin.md](næste-trin.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma's baseret på Paper, som er baseret på Spigot, der igen er baseret på den officielle serverplatform. + +[^3]: Windows-tast + R + +[^4]: For Linux, brug 'java --version' i terminalen. + +[^5]: JRE er et open source-projekt med flere varianter, ligesom Minecraft-serverplatformen. + +[^6]: Det er generelt kendt som en **launcher**. + +[^7]: Når 'Auto-genstart' er aktiveret, genstarter serveren automatisk. Du kan afslutte ved at indtaste 'Control + C'. + +[^8]: Det anbefales ikke at overskride halvdelen af systemets hukommelse. + + For eksempel, hvis den samlede hukommelseskapacitet er 8 GB, anbefales det ikke at indstille den til over 4 GB. + +[^9]: End-User License Agreement, Slutbrugerlicensaftale. Se [Minecraft's hjemmeside](https://www.minecraft.net/ko-kr/usage-guidelines) for flere oplysninger. + +[^10]: Microsoft Corporation. + +[^11]: I henhold til artikel 32, stk. 1, nr. 9 i loven om fremme af spilindustrien i Sydkorea, kan **Koreanske Microsoft Corporation** retsforfølges. + +[^12]: Universal Plug & Play. Purpur inkluderet i Plazma kommunikerer automatisk med routeren via denne teknologi for at åbne porten, når serveren kører, så der er ikke behov for manuel portvideresendelse. + +[^13]: Hvis du ikke har en konto, kan du tilmelde dig Ngrok ved hjælp af en Google- eller GitHub-konto. diff --git a/da/origin/plazma/administration/getting-started/customization.md b/da/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..0e2d35755 --- /dev/null +++ b/da/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,114 @@ +--- +description: Lær hvordan du tilpasser serveren. +--- + +# 🎨 Brugerdefinering + +Grunden til at bruge en ændret serverplatform som Plazma i stedet for den officielle serverplatform fra Mojang Studios er, at det giver mulighed for kraftig **brugerdefinering**. + +Her er forskellige måder at tilpasse og bruge Plazma på. + +## Konfigurationsændringer + +Den mest grundlæggende måde at tilpasse Plazma på er ved at ændre konfigurationen. + +Plazma tilbyder kraftfulde konfigurationsindstillinger, lige fra spillets mekanik til mobegenskaber. + +Se nedenstående side for en beskrivelse af Plazmas konfigurationer. + +{% content-ref url="../reference/configurations/" %} +[konfigurationer](../reference/configurations/) +{% endcontent-ref %} + +## Brug af plugins + +{% hint style="success" %} + +**Plazma understøtter alle plugins baseret på Paper korrekt.** + +For Spigot plugins kan der være nogle problemer med Paper's mappingændringer fra 1.20.5, men de fleste plugins baseret på Paper som f.eks. Paper, Pufferfish og Purpur fungerer korrekt i Plazma. Hvis de ikke fungerer korrekt, skyldes det en fejl i Plazma, så [venligst rapporter det med det samme.](../diagnosis/plugins.md) + +{% endhint %} + +At bruge Plazma er den primære årsag og den mest kraftfulde måde at tilpasse Plazma på. +Plazmas stærke plugin-økosystem gør det nemt at tilpasse serveren. + +Der er flere måder at finde og downloade plugins på. Nogle plugins uploades til offentlige opbevaringstjenester, mens andre uploades til GitHub eller deres egne sider. + +{% hint style="caution" %} + +**Plugins kan få direkte adgang til systemet!** + +Brug tjenester som VirusTotal til altid at kontrollere, om et plugin er sikkert, før du anvender det, eller download plugins fra pålidelige tjenester. + +{% endhint %} + +Der er flere tjenester til at downloade plugins. Tjenester som [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) gennemgår en godkendelsesproces, før plugins uploades, for at sikre at kun sikre plugins distribueres. + +### Anvendelse af plugins + +Når du har downloadet et plugin, er det nu tid til at anvende det. + +1. Plugins er i form af `.jar` eller `Java Executable File`.\ + Nogle plugins kan være i en komprimeret fil, hvor du skal udpakke den og bruge filen, der indeholder 'bukkit', 'spigot' eller 'paper' i navnet, og hvis der er en fil med 'fat', skal du bruge den. +2. Placer den downloadede fil i servermappen 'plugins' og genstart (eller start) serveren. +3. Når Plazma starter, vises der nye oplysninger på konsollen. + Dette betyder, at Plazma har indlæst pluginnet korrekt. +4. Selvom Plazma har indlæst pluginnet korrekt, kan det være, at pluginnet ikke starter. + Ved at bruge kommandoen `/plugins` kan du se en liste over de aktuelt indlæste plugins på serveren. + Hvis navnet på det installerede plugin ikke er rødt, men i stedet er grønt, er pluginnet indlæst korrekt. + +Hvis et plugin ikke er indlæst korrekt, kan du finde løsninger på problemerne på følgende side. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Brug af datapakker + +Datapakker er en måde at tilpasse Minecraft på, ligesom ressourcepakker. + +Ved at bruge datapakker kan du tilføje nye grupper af væsener og udfordringer i spillet. + +{% hint style="caution" %} + +**Datapakker kan beskadige verdener!** + +Nogle defekte datapakker kan beskadige verdener, og dette kan ikke fortrydes. + +Det anbefales derfor at tage en sikkerhedskopi af verdenen, før du anvender datapakker. + +{% endhint %} + +Datapakker kan downloades fra flere tjenester som [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) og andre. + +Når du har downloadet en datapakke, kan du anvende den ved at placere den i mappen 'datapacks' i serverens verden. +Opret mappen, hvis den ikke allerede findes. + +{% hint style="warning" %} + +**Nogle [datapakker](#user-content-fn-2) fungerer muligvis ikke korrekt ved første anvendelse.** + +I så fald anbefales det at genstarte serveren **2 gange**. + +{% endhint %} + +Datapakker kan nemt blive beskadiget, når Minecraft opdateres. + +Især hvis en datapakke er alvorligt beskadiget, kan det få serveren til at krashe, så det er vigtigt at teste serveren tilstrækkeligt, før du opdaterer. + +{% hint style="info" %} + +**Efter serverstartkommandoen kan du indtaste 'safeMode' for at deaktivere alle datapakker og derefter starte serveren.** + +[Se 'Reference > Arguments' for flere detaljer.](../reference/arguments.md) + +{% endhint %} + +Du kan bekræfte, hvilke datapakker der er anvendt, ved at bruge kommandoen `/datapack list`. + +*** + +[^1]: Eller Minecraft: Bedrock Editions add-ons. + +[^2]: Tilføjelse af væsener og mere. diff --git a/da/origin/plazma/administration/getting-started/next-step.md b/da/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..069221d63 --- /dev/null +++ b/da/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Lær hvordan du tilpasser serveren. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Her er forskellige måder at tilpasse og bruge Plazma på. + +## Konfigurationsændringer + +Den mest grundlæggende måde at tilpasse Plazma på er ved at ændre konfigurationen. + +Plazma tilbyder kraftfulde konfigurationsindstillinger, lige fra spillets mekanik til mobegenskaber. + +Se nedenstående side for en beskrivelse af Plazmas konfigurationer. + +{% content-ref url="../reference/configurations/" %} +[konfigurationer](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Brug af plugins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +At bruge Plazma er den primære årsag og den mest kraftfulde måde at tilpasse Plazma på. Plazmas stærke plugin-økosystem gør det nemt at tilpasse serveren. + +Der er flere måder at finde og downloade plugins på. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Der er flere tjenester til at downloade plugins. Tjenester som [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) gennemgår en godkendelsesproces, før plugins uploades, for at sikre at kun sikre plugins distribueres. + +### Anvendelse af plugins + +Når du har downloadet et plugin, er det nu tid til at anvende det. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Placer den downloadede fil i servermappen 'plugins' og genstart (eller start) serveren. +3. Når Plazma starter, vises der nye oplysninger på konsollen. Dette betyder, at Plazma har indlæst pluginnet korrekt. +4. Selvom Plazma har indlæst pluginnet korrekt, kan det være, at pluginnet ikke starter. Ved at bruge kommandoen `/plugins` kan du se en liste over de aktuelt indlæste plugins på serveren. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Hvis et plugin ikke er indlæst korrekt, kan du finde løsninger på problemerne på følgende side. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Brug af datapakker + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Ved at bruge datapakker kan du tilføje nye grupper af væsener og udfordringer i spillet. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Nogle defekte datapakker kan beskadige verdener, og dette kan ikke fortrydes. + +Det anbefales derfor at tage en sikkerhedskopi af verdenen, før du anvender datapakker. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Når du har downloadet en datapakke, kan du anvende den ved at placere den i mappen 'datapacks' i serverens verden. Opret mappen, hvis den ikke allerede findes. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +I så fald anbefales det at genstarte serveren **2 gange**. +{% endhint %} + +Datapakker kan nemt blive beskadiget, når Minecraft opdateres. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Du kan bekræfte, hvilke datapakker der er anvendt, ved at bruge kommandoen `/datapack list`. + +*** + +## Optimering + +Der er blevet anvendt mange optimeringspatches på Plazma. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Se nedenstående side for information om sikker og korrekt proxykonfiguration. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Sikkerhed + +Da Minecraft-mods er blevet mere avancerede, er det nemt at finde [sårbarhedsangrebsmotorer](#user-content-fn-3) online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Tilladelsesindstillinger + +Nogle plugins' administratorkommandoer kan have sårbarheder, hvis tilladelserne ikke er korrekt konfigureret. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokering + +X-Ray er en af de sårbarheder, der nemt kan udnyttes selv på grundlæggende optimerede klienter. + +Plazma tilbyder en konfiguration, der som standard kan blokere X-Ray. + +Se nedenstående side for metoden til X-Ray blokering og yderligere forklaring. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Brug '/whitelist query' for at se, hvilke spillere der har tilladelse til at tilslutte sig. + +*** + +[^1]: Eller Minecraft: Bedrock Editions add-ons. + +[^2]: Tilføjelse af væsener og mere. + +[^3]: Generelt kaldes det 'cheating'. + +[^4]: Hvis konfigurationen ikke er optimeret, hvis Plazma er forældet, eller hvis der er nye sårbarheder, kan de muligvis ikke være blokeret. + +[^5]: Når en spiller tilslutter sig serveren, sker det via en Ngrok proxyserver, og den tildelte Ngrok-adresse ændres ved hver genstart. diff --git a/da/origin/plazma/administration/reference/README.md b/da/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..920bdf3c1 --- /dev/null +++ b/da/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Lær hvordan du tilpasser Plazma's standardtilpasningsmetoder. +--- + +# 📜 리퍼런스 + +Plazma tilbyder forskellige tilpasningsmetoder. + +Blandt dem er de følgende 4 metoder tilpasningsmetoder, som kan bruges uden yderligere arbejde. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +Spørg fællesskabet ved at bruge [Officiel Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub-diskussioner](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Kommando + +> Kommandoer giver mulighed for at indsamle oplysninger i spillet eller tilpasse spiloplevelsen for brugeren. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Tilladelser + +> Tilladelser angiver omfanget af interaktion, som spilleren kan have. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenter og egenskaber + +> Argumenter og egenskaber påvirker Plazmas funktion på en overordnet måde. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguration + +> Konfiguration er den mest grundlæggende måde at tilpasse Plazma på. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/da/origin/plazma/administration/reference/arguments.md b/da/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..90159ac98 --- /dev/null +++ b/da/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Få kendskab til startargumenter og systemegenskaber. +--- + +# 🎛️ Argumenter og egenskaber + +Startargumenter og systemegenskaber er værdier, der tilføjes kommandoer, der bruges til at køre Plazma, og de har en overordnet indvirkning på Plazmas funktion. + +I henhold til **startargumenter** og **systemegenskaber** opdelt efter placeringen, der tilføjes til kommandoen (se [fn-2](#user-content-fn-2)). + +*** + +## Systemegenskaber + +Systemegenskaber, der indtastes foran `-jar`, behandles af JVM før Plazma initialiseres. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Brugsanvisning + +Systemegenskaber indtastes som Java-kommandoargumenter mellem `java` og `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` angiver, at argumentet ikke er indbygget i JVM, men er et dedikeret argument til Plazma og + +Hvis der ikke angives nogen værdi for egenskaben, vil værdien være fastsat til `true` (se [fn-3](#user-content-fn-3)). + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Alle systemegenskaber + +#### `convertLegacySigns` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Opdaterer deaktiverede skiltformater. + +#### `debug.entities` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for entitetsinformation. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer NMS-revisionen for at kunne indlæse debugoplysninger korrekt i IDE'en og remapper automatisk interne versionsoplysninger. + +#### `disable.watchdog` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer Spigots watchdog-advarselssystem. + +#### `letMeReload` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer bekræftelsesbeskeden for `/reload`-kommandoen. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Hvis du er pluginudvikler og skal opdatere et plugin, skal du bruge hotswap i stedet for `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer brugen af standard input/output-systemet for plugins. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Advarer, når forældet formatering opdages i chatkomponenter. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer validering af serverens mønster, når en spiller opretter forbindelse til serveren. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for manglende nøgler i NBT-objekter. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for ugyldige kranieprofiler. + +Dette logger placeringen af alle ugyldige kranieblokke i verden. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer prioritering af pluginklasser. + +Nyttig, hvis der er problemer med plugin-shading. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer Netty's flush-consolidation-system. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Standardværdi**: `750` + +Opdeler entiteter i flere pakker, hvis de overstiger den angivne værdi. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Standardværdi**: `8192` + +Indstiller størrelsen på den maksimale pakke, serveren kan modtage ad gangen. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer Java-versionkontrol. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Dette kan permanent beskadige filer som verdener og ødelægge spillets mekanik. + +Enhver skade forårsaget af dette er dit eget ansvar, og Plamza yder ingen support i den henseende. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Standardværdi**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Standardværdi**: `80` + +Indstiller den maksimale længde af tekst på et skiltlinje. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Standardværdi**: `(verdensversion) + 1` + +Indstiller versionen for de første datafixes, der skal initialiseres. + +Nyttig, hvis der er behov for at opdatere store mængder chunks, men ellers ikke bruges. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolesk` +- **Standardværdi**: `Sandt` + +Aktiverer behandlingen af YAML-filkommentarer som standard. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Standardværdi**: `30` + +Spilleren bliver kicket, hvis der ikke modtages nogen data i det angivne antal sekunder. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Ignorerer kommentarer i serveregenskaberne. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for synkroniseret chunkgenerering. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer Minecrafts [standard chunkgenereringssystem](#user-content-fn-10)[^10]. + +Dette gemmer hver chunk sekventielt, hvilket kan forårsage betydelig ydeevnenedgang. + +#### `Paper.explicit-flush` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer eksplisit flushing af netværkskanaler. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Logger altid fejl, der ikke opstår på hovedtråden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Advarer, hvis planlagte opgaver har overdreven ventetid. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Anvend kun patch uden at starte serveren, når du bruger den medfølgende eksekverbare fil. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +Øger den oprindelige konfiguration mere effektivt. + +Aktivering vil få serveren til at køre hurtigere og mere sikkert, men det kan have en stor indvirkning på spiloplevelsen. + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` +- **Konflikt**: `Plazma.aggressiveOptimize` + +Optimerer ikke den oprindelige konfiguration så aggressivt. + +Dette bruger standardkonfigurationen fra Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` + +Deaktiverer Plazma branding og bruger en simpel vaniljeserver favicon. + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Dette kan have stor indvirkning på serverens sikkerhed og ydeevne. + +Enhver problem opstået ved brug af denne egenskab er serveradministratorens ansvar. +{% endhint %} + +Giver den oprindelige konfiguration med standardværdier fra Mojang. + +Dette deaktiverer alle sårbarhedspatches, som Paper har implementeret. + +Sårbarhedspatches kan genaktiveres i Paper eller Plazma konfiguration. + +#### `Plazma.vanillaize` + +- **Type**: `Boolesk` +- **Standardværdi**: `true` +- **Konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Gør den oprindelige konfiguration mere vanilla-nær. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Afbrydende egenskab + +Følgende systemegenskaber er afbrudte egenskaber. + +#### `timings.bypassMax` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` +- **Afbrydet brug**: Timings blev fjernet fra Plazma + +Bestemmer, om værdier, der sendes til Aikars Timings API, kan overstige det maksimale. + +Selvom dette er tilfældet, vil ratebegrænsning blive anvendt, hvis der ikke håndteres undtagelser i API'en. + +*** + +## Startargument + +Startargumenter indtastes efter `-jar *.jar` for at initialisere Plazma og behandles sammen med det. + +### Brugsanvisning + +Systemegenskaber indtastes som programkommandoargumenter efter `-jar *.jar`. + +Hvis du f.eks. vil anvende startargumentet `nogui`,\ +skal du indtaste det som vist nedenfor, så Plazma kan behandle `nogui`-argumentet under initialiseringen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Samlede startargumenter + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standard**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Standard**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Standard**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Starter serveren i demotilstand. + +#### `eraseCache` + +Fjerner eventuelle cache-filer efter en verdensopgradering. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Udskriver alle Plazmas startargumenter og beskrivelser. + +#### `initSettings` + +Opretter kun konfigurationsfiler og afslutter serveren. + +#### `jfrProfile` + +Aktiverer JFR-profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standard**: `(serveregenskab)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Deaktiverer det grafiske brugergrænsefladepanel. + +#### `nojline` + +Deaktiver JLine og brug standard konsollen. + +#### `online-mode` + +- **Alias**: `o` +- **Standard**: `(serveregenskab)` + +Vælg om spillerne skal valideres mod Mojangs godkendelsesserver. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardværdi**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Angiver placeringen af den deaktiverede PaperSpigot konfigurationsfil. + +Denne bruges til at flytte eksisterende konfiguration til en ny fil og er ikke længere i brug. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardværdi**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Standardværdi**: `plugins` + +Angiver placeringen af plugins-mappen. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardværdi**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardværdi**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Starter serveren i fuld standardtilstand som om det var ren vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standard**: `(serveregenskab)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standard**: `(serveregenskab)` + +Angiver serverens portnummer. + +#### `server-name` + +- **Standardværdi**: `A Plazma Server` + +Angiver serverens navn. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardværdi**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Viser Plazma versionen. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardværdi**: `(servermappe)` + +Angiver placeringen hvor verdensfilerne gemmes. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standard**: `(serveregenskab)` + +Angiver navnet på verdensfilen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Afhængigt af positionen behandles argumenterne anderledes. + +[^3]: For eksempel, hvis du vil aktivere `Plazma.iKnowWhatIAmDoing` til `true`, fungerer det på samme måde, hvis du kun indtaster `-DPlazma.iKnowWhatIAmDoing`, i stedet for `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: For eksempel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: Et signal der indikerer, at forbindelsen til serveren fungerer korrekt, ligesom et hjerteslag. + +[^9]: Med Purpurs AFK kick-funktion kan også spillere, der er inaktive, blive sparket. + +[^10]: Sync Chunk Write System, synkroniseret chunk-skrivesystem. + +[^11]: `ADVARSEL! Plazma kan forårsage uventede problemer, så sørg for at teste det grundigt, før du bruger det på en offentlig server.` + +[^12]: I spillet fungerer 'verdensoptimering' på samme måde. + +[^13]: Administratorer på niveau 2 eller højere er undtaget. + +[^14]: Internet Protocol, IP. diff --git a/da/origin/plazma/administration/reference/commands.md b/da/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..c2f912570 --- /dev/null +++ b/da/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Lær om de kommandoer, der er tilgængelige på Plazma. +--- + +# 🖥️ Kommandoer diff --git a/da/origin/plazma/administration/reference/configurations/README.md b/da/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..ebffc9ba3 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfiguration er den mest grundlæggende måde at tilpasse Plazma på. +--- + +# 🧾 구성 + +*** + +## 🪨 Egenskaber + +> Egenskaber er den mest grundlæggende konfigurationsfil, som Minecraft tilbyder. Ved at bruge egenskaber kan du ændre spillets grundlæggende mekanismer. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit konfiguration + +> Bukkit konfiguration er den mest grundlæggende konfigurationsfil, som Plazma tilbyder. Ved at bruge Bukkit konfiguration kan du ændre grundlæggende mekanismer på en Minecraft-server. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot konfiguration + +> Spigot konfiguration giver dig mulighed for at ændre spillets detaljerede mekanismer, spillerbehandling, kommandoer osv. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper konfiguration + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish konfiguration giver dig mulighed for at ændre Plazmas verdens- og enhåndteringsprocesser. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur konfiguration + +> Purpur egenskaber giver dig mulighed for at ændre spillets overordnede grunddata. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfiguration + +> Plazma konfiguration giver dig mulighed for at tilpasse Plazmas funktioner. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/da/origin/plazma/administration/reference/configurations/bukkit.md b/da/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..4f8328c1a --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver knude i bukkit.yml betyder. +--- + +# 🪣 Bukkit diff --git a/da/origin/plazma/administration/reference/configurations/paper/README.md b/da/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..e63a0193b --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af formålet med hver fil i config-mappen. +--- + +# 🛩️ Papir diff --git a/da/origin/plazma/administration/reference/configurations/paper/global.md b/da/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a0f0eee84 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🌏 전역 구성 diff --git a/da/origin/plazma/administration/reference/configurations/paper/world.md b/da/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..2a66fc442 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Find out what each node in paper-world.yml means. +--- + +# 🏳️ 세계별 구성 + +Verdensomspændende diff --git a/da/origin/plazma/administration/reference/configurations/plazma/README.md b/da/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..c6f205520 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af formålet med hver fil i config-mappen. +--- + +# ✨ Plazma diff --git a/da/origin/plazma/administration/reference/configurations/plazma/global.md b/da/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f542cdab7 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i plazma-global.yml betyder. +--- + +# 🌏 전역 구성 diff --git a/da/origin/plazma/administration/reference/configurations/plazma/world.md b/da/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..7634be35e --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# 🏳️ 세계별 구성 diff --git a/da/origin/plazma/administration/reference/configurations/plazma/worlds.md b/da/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..ffa66294b --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# ✨ Plazma (sammensætning af verdener) diff --git a/da/origin/plazma/administration/reference/configurations/property.md b/da/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..d9d6aa84b --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i server.properties betyder. +--- + +# 🪨 Server.properties diff --git a/da/origin/plazma/administration/reference/configurations/pufferfish.md b/da/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..a1c359cb1 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver knude i pufferfish.yml betyder. +--- + +# 🐡 Kuglefisk diff --git a/da/origin/plazma/administration/reference/configurations/purpur/README.md b/da/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..773653a3c --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i purpur.yml betyder. +--- + +# 🦑 Purpur diff --git a/da/origin/plazma/administration/reference/configurations/purpur/global.md b/da/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..30567e386 --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i purpur.yml betyder. +--- + +# 🌏 전역 구성 diff --git a/da/origin/plazma/administration/reference/configurations/purpur/world.md b/da/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..e3728266e --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i purpur.yml betyder. +--- + +# 🏳️ 세계별 구성 diff --git a/da/origin/plazma/administration/reference/configurations/spigot.md b/da/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..d7ab7d8dd --- /dev/null +++ b/da/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver knude i spigot.yml betyder. +--- + +# 🚰 Spigot diff --git a/da/origin/plazma/administration/reference/permissions.md b/da/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..4b53a2b1a --- /dev/null +++ b/da/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Få mere at vide om tilladelserne til Plazma. +--- + +# 🛡️ Tilladelser + +Rettigheder er et simpelt sikkerhedsværktøj på serveren, der definerer omfanget af interaktion mellem spillere. + +For at udnytte rettigheder korrekt og let kunne redigere dem, skal du bruge plugins som [LuckPerms](https://luckperms.net). + +*** + +## Forståelse af grundlæggende rettighedssystem + +Minecraft tilbyder grundlæggende administrative rettighedsgrupper. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Spillere**\ + Er en standard rettighedsgruppe tildelt alle spillere. +2. **Mæglere**\ + Kan ignorere spawnbeskyttelse. +3. **Verdensadministratorer**\ + Kan bruge alle kommandoer og kommandoblokke relateret til verdensstyring.\ + Er en standard rettighedsgruppe for datapakker og kommandoblokke. +4. **Administratorer**\ + Kan bruge alle kommandoer relateret til spillerstyring. +5. **Superadministratorer**\ + Kan bruge alle kommandoer, inklusive serveradministration.\ + Er en standard rettighedsgruppe for konsollen og administratorer. + +*** + +## Opsætning af rettigheder + +*** + +## Fulde rettigheder + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Standard**: `Ingen` + +Tillader spillere at 'sne' og interagere med enheder for at ride dem. + +Når du rider enheden, kan du bruge 'bevægelsesknapperne' til at styre enhedens bevægelse og 'hoppeknappen' til at hoppe eller flyve. + +I '(Namespaced Key)' indsættes enhedens [Namespaced ID](#user-content-fn-2)[^2]. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Standard**: `Ingen` + +Tillader spilleren at bruge en entitets specielle evner, mens de rider på entiteten. + +Ikke alle entiteters specielle evner er tilgængelige. Se nedenfor for en liste over alle tilgængelige specielle evner. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Post dine ideer på [Plazma Discord](https://plazmamc.org/discord) eller [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Se alle tilgængelige specielle evner + +- **`crepper`**\ + Når du trykker på `hoppeknappen`, eksploderer den.\ + Hvis spilleren har tilladelsen `allow.powered.creeper`, kan du holde `hoppeknappen` nede for at oplade den. +- **`dolphin`**\ + Når du trykker på `hoppeknappen`, sprinter den. +- **`phantom`**\ + Når du trykker på `hoppeknappen`, skyder den ild. +- **`wither`**\ + Ved `interaktion` affyrer den wither-hovedet. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/compass` kommandoen](commands.md#compass). + +#### `bukkit.command.credits` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/credits (Spiller)` kommandoen](commands.md#credits). + +Hvis du indtaster `.other` efter tilladelsesnavnet, tillader det brugen til andre spillere. + +#### `bukkit.command.demo` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/demo (Spiller)` kommandoen](commands.md#demo). + +Hvis du indtaster `.other` efter tilladelsesnavnet, tillader det brugen til andre spillere. + +#### `bukkit.command.ping` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/ping (Spiller)` kommandoen](commands.md#ping). + +Hvis du indtaster `.other` efter tilladelsesnavnet, tillader det brugen til andre spillere. + +#### `bukkit.command.ram` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/ram` kommandoen](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/rambar (Spiller)` kommandoen](commands.md#rambar). + +Hvis du indtaster `.other` efter tilladelsesnavnet, tillader det brugen til andre spillere. + +#### `bukkit.command.restart` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/restart` kommandoen](commands.md#restart). + +#### `bukkit.command.tps` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/tps` kommandoen](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/tpsbar (Spiller)` kommandoen](commands.md#tpsbar). + +Hvis du indtaster `.other` efter tilladelsesnavnet, tillader det brugen til andre spillere. + +#### `bukkit.command.timings` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/timings` kommandoen](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Tjek [Spark](https://spark.lucko.me/docs/Command-Usage) for lignende funktioner. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af [`/uptime` kommandoen](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Standard givet**: `Verdensadministrator` + +Tillader brug af `/gamemode (GameMode) (Spiller)` kommandoen. + +Hvis du indtaster `.other` efter tilladelsesnavnet, tillader det brugen til andre spillere. + +#### `paper.antixray.bypass` + +- **Standard**: `Ingen` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Dette giver forbedret ydeevne for begge parter. + +> Se nedenstående side for at lære om X-Ray-indstillinger. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Standard**: `Ingen` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Standard**: `Ingen` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Standard**: `Ingen` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Standard**: `Ingen` + +Tillader brug af MiniMessage-tags på ambolten med [MiniMessage-tags](https://docs.advntr.dev/minimessage/format.html). + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Standard**: `Ingen` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Standard**: `Ingen` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Standard**: `Ingen` + +Ekskluderer spilleren fra at blive sparket for inaktivitet. + +#### `purpur.debug.f3n` + +- **Standard givet**: `Verdensadministrator` + +Tillader spilleren at skifte spiltilstand ved at trykke på `F3 + N`-tasterne. + +Det virker ikke, hvis spilleren ikke har tilladelse til den pågældende spiltilstand. + +#### `purpur.drop.spawners` + +- **Standard**: `Ingen` + +Hvis du bryder en spawnerblok med den konfigurerede genstand, vil spawnerblokken falde ned. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Standard**: `Ingen` + +Ændrer størrelsen på en enderbryst. + +Du kan indtaste `one`, `two`, `three`, `four`, `five`, `six` i `(NumberString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Standard**: `Ingen` + +Tillader, at totem af udødelighed fungerer, selvom det er i inventaret. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Standard**: `Ingen` + +Tillad spilleren at ignorere serverens fulde kapacitet. + +#### `purpur.mending_shift_click` + +- **Standard**: `Ingen` + +Tillad spilleren at reparere genstande ved at `trykke skifte og højreklikke` mens de er bøjet. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Standard**: `Ingen` + +Tillad spilleren at placere spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Standard**: `Ingen` + +Lad spilleren øjeblikkeligt teleportere, når de bruger Nether portalen. + +#### `purpur.sign.color` + +- **Standard**: `Ingen` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Standard**: `Ingen` + +Tillad brug af forvrængningskode `(&o)` på skilte. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Standard**: `Ingen` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Standard**: `Ingen` + +Tillad spilleren at forhindre TNT-eksplosion ved at `interagere` med saks. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Planlagte tilladelser + +#### `plazma.bypass.ncr-require` + +- **Standard**: `Ingen` + +Tillad spilleren at deltage uden at have [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) mod installeret. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operatør. + +[^2]: F.eks.: `ender_dragon` diff --git a/da/origin/plazma/adminstration/README.md b/da/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..1ea5a7c82 --- /dev/null +++ b/da/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Brug Plazma til at oprette din egen server. +--- + +# ⚒️ Serveradministration vejledning diff --git a/da/origin/plazma/adminstration/expert/README.md b/da/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..1686b3f6a --- /dev/null +++ b/da/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan man professionelt håndterer Plazma. +--- + +# 🎓 Avanceret diff --git a/da/origin/plazma/adminstration/expert/fix-exploits.md b/da/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..fa06c9f68 --- /dev/null +++ b/da/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Find ud af om kendte sårbarheder og hvordan man løser dem. +--- + +# ⚠️ Kendte sårbarheder og løsningsmetoder diff --git a/da/origin/plazma/adminstration/expert/optimize.md b/da/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..a1ba09be1 --- /dev/null +++ b/da/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du optimerer Plazma. +--- + +# 🧹 Optimering diff --git a/da/origin/plazma/adminstration/expert/vanillaize.md b/da/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..01665893f --- /dev/null +++ b/da/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Lær hvordan du genopretter Paper og vanilje patch. +--- + +# ↩️ Vaniljeisering + +{% hint style="warning" %} + +### Paper tilføjer ikke valgmuligheder til de fleste patches, der løser fejl i vanilje. + +Plazma udvikler i øjeblikket muligheden for at deaktivere sådanne fejlrettelser som en konfiguration. + +Derfor er denne vejledning stadig under udarbejdelse, og informationen kan altid ændres. +{% endhint %} diff --git a/da/origin/plazma/adminstration/faq.md b/da/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..fd0c79cb7 --- /dev/null +++ b/da/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Find svar på ofte stillede spørgsmål. +--- + +# ⁉️ Ofte stillede spørgsmål + +{% hint style="info" %} + +### Kan du ikke finde det svar, du leder efter? + +Spørg fællesskabet via [Officiel Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Handlingen udføres ikke med en besked, der vises + +Hvis der vises 'ingen hovedmanifestattribut i plazma-(version).jar' i konsollen,\ +filen, du har downloadet, er en udviklings-API-fil, og du skal downloade **Reobf Paperweight** fra GitHub-siden. + +Se nærmere på følgende side for mere information. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Advarsler vises hver gang serveren starter + +Plazma indeholder nogle ustabile patches og kan potentielt mislykkes, derfor vises følgende advarsler, når serveren starter. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Disse advarsler kan deaktiveres ved hjælp af systemegenskaben [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Se nærmere på følgende side for mere information. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tilgængelig fra version 1.20.1 diff --git a/da/origin/plazma/adminstration/getting-started/README.md b/da/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..a604f11f5 --- /dev/null +++ b/da/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Lær hvordan du opretter en server med Plazma. +--- + +# 👟 Kom i gang + +For at bruge Plazma på en stabil måde, skal dit system opfylde følgende krav: + +| | Minimum | Anbefalet | +| :--------: | ------: | --------: | +| Arkitektur | x64 | - | +| RAM | 8GB | 16GB | +| Lagerplads | 1GB | 8GB | +| JRE | 17 | 21 | + +For nem redigering af konfigurationsfiler, er det også en god ide at installere en editor som [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE Installation + +Som navnet antyder, kræver Minecraft: **"Java"** Edition JRE[^1] for at køre, da det er udviklet i Java. + +Da Plazma er baseret på Mojang Studios' officielle serverplatform[^2], skal du også installere JRE for at bruge Plazma. + +### 1.1 Kontrollering af JRE + +For at kontrollere om JRE er installeret på dit system, skal du indtaste [`cmd /k java --version`](#user-content-fn-4)[^4] i en **Kør**-dialog og udføre kommandoen. + +Hvis du får følgende output, skal du fortsætte til [trin 2](setup.md#id-2). + +{% code title="Korrekt output" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Hvis du ikke får det rigtige output, eller hvis du får følgende output, betyder det at JRE enten ikke er installeret eller er for gammel, og du skal udføre [trin 1.2](setup.md#id-1.2). + +{% code title="JRE ikke installeret" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE for gammel" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE Installation + +I denne guide bruger vi Azul Zulu som en af JRE-typerne[^5]. + +Når installationen er færdig, skal du køre [trin 1.1](setup.md#id-1.1) igen for at kontrollere om installationen er korrekt. + +{% tabs %} +{% tab title="Windows" %} + +1. Først skal du downloade **JDK 21** i `.msi`-format fra [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Kør den downloadede installationsguide og klik på `Næste`. +3. Aktivér `Set JAVA_HOME variable` fra menuen i midten af vinduet og klik derefter på `Næste`. +4. Afslut installationen ved at klikke på `Installer` for at installere JRE. + {% endtab %} + +{% tab title="macOS" %} +Download og kør den `.dmg`-format af **JDK 21** fra [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) for at installere JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Først skal du køre følgende kommando i terminalen for at tilføje Azul Zulu-repositoriet til APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Derefter skal du køre følgende kommando i terminalen for at installere JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Du kan installere JRE ved at indtaste følgende kommando. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma tilbyder forskellige former for eksekverbare filer. + +{% hint style="warning" %} + +### I de fleste tilfælde skal du bruge `Reobf Paperclip`. + +Følgende information er for udviklere eller dem der er interesseret i de forskellige formater.\ +Hvis du er en almindelig bruger, kan du springe til [trin 3](setup.md#id-3) uden problemer. +{% endhint %} + +
+ +Læs mere + +Navnet på eksekverbar fil er `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping form).jar`. + +- **Mapping Form**\ + Mapping er en slags kortlægning mellem Minecrafts faktiske kode og obfuskeringen af koden. + - **Reobf**\ + Reobfuscation, også kendt som Spigot-mapping, bruges hovedsageligt i de fleste NMS-plugins.\ + Det vil blive udfaset fra version 1.20.5. + - **Mojmap**\ + Mojang-mapping, Vanilla Minecraft-mapping. +- **Version Manager**\ + Version Manager er en slags launcher, der er nødvendig for at køre serveren og patche serverfilerne. + - **Paperclip**\ + Udviklet af PaperMC-teamet til Paper og andre afledte platforme, downloader biblioteker og anvender patches på serveren. + - **Bundler**\ + Vanilla Minecraft version manager. + +
+ +*** + +## 3. Oprettelse af Start Script + +For at starte Plazma nemt og få serveren til automatisk at genstarte, skal du oprette et [start script](#user-content-fn-6)[^6]. + +Du kan oprette startscriptet ved hjælp af [Flags.sh](https://flags.sh).\ +Indtast blot det ønskede hukommelsesforbrug til Plazma[^8], og kommandoen vil automatisk blive optimeret. + +Du kan downloade startscriptet ved at klikke på download-knappen nederst til venstre.\ +**Sørg for at startscriptet er kompatibelt med dit operativsystem.** + +*** + +## 4. Fil Oprydning + +Flyt det downloadede startscript og Plazma til en ny mappe. + +{% hint style="warning" %} + +### Mappen skal navngives uden mellemrum og skal være på engelsk. + +Ellers kan Plazma eller JRE muligvis ikke fungere korrekt. +{% endhint %} + +Kør startscriptet nu. For Windows-brugere, skal du vælge **Tillad** i firewall tilladelsesvinduet. + +*** + +## 5. EULA Accept + +Når du har kørt startscriptet en gang, vil der blive oprettet en `eula.txt`-fil i mappen. + +EULA[^9] er en licensaftale, som du skal acceptere for at bruge tjenester fra [Mojang Studios](#user-content-fn-10)[^10]. + +Hvis du ikke accepterer EULA, kan du ikke starte serveren, og hvis du overtræder EULA'en, kan du blive straffet med suspension af kontoen eller lignende [sanktioner](#user-content-fn-11)[^11]. + +For at acceptere EULA, skal du ændre `eula=false` til `eula=true` i `eula.txt`-filen og gemme ændringerne. + +*** + +## 6. Tillad Ekstern Adgang (Windows) + +Moderne operativsystemer blokerer som standard ekstern adgang fra firewall og router for at forhindre farlige tilgange udefra. + +Da du allerede har tilladt det i [trin 3](setup.md#id-3) for Windows, behøver du kun at viderestille portene. + +{% hint style="info" %} + +### Denne guide er skrevet under antagelse af, at du bruger Windows-operativsystemet og en router, der understøtter [**UPnP**](#user-content-fn-12)[^12]. + +Hvis din router ikke understøtter UPnP, skal du søge information om hvordan du gør det, da panelet varierer fra router til router. + +Alternativt kan du bruge [Ngrok](https://ngrok.com/) til at oprette en midlertidig adresse. +{% endhint %} + +{% hint style="warning" %} + +### For Linux eller macOS (næsten) UNIX-baserede operativsystemer, varierer opsætningen af firewall-tjenester, så du skal søge information om det. + +{% endhint %} + +### 6.1 Kontrol af Nødvendighed for Portvideresendelse + +Indtast følgende i Kør-dialogen og udfør kommandoen. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Hvis outputtet viser `True`, behøver du ikke gøre mere, men hvis det viser `False`, skal du konfigurere portvideresendelse. + +### 6.2 Forbindelse til Serveren + +{% tabs %} +{% tab title="Ekstern adgang" %} +Hvis portvideresendelse ikke er nødvendig, eller hvis portvideresendelse allerede er lykkedes, kan du nu oprette forbindelse til serveren. + +Du kan finde den adresse, der bruges til at oprette forbindelse til serveren, [her](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Prøv at bruge UPnP til portvideresendelse" %} +Aktiver 'network.upnp-port-forwarding' til 'true' i 'purpur.yml' i servermappen. + +Derefter, når serveren genstartes, vil Plazma automatisk forsøge at videresende porten. + +Nedenfor er resultatet af UPnP ifølge meddelelsen, som vises i konsollen som '[UPnP] (besked)'. + +| Besked | Betydning | +| -------------------------------------------------------- | ------------------------------------------------------ | +| 'Porten (port) blev åbnet med succes' | Portvideresendelse lykkedes. | +| 'Porten (port) er allerede åben' | En anden tjeneste bruger allerede den pågældende port. | +| 'Kunne ikke åbne porten (port)' | Portvideresendelse mislykkedes. | +| 'Tjenesten er utilgængelig' | Routeren understøtter ikke UPnP. | + +Når serveren lukkes ned, lukker Plazma automatisk porten. +{% endtab %} + +{% tab title="Opret midlertidig adresse med Ngrok" %} +Metoden med Ngrok er nyttig til kortsigtede tests, samarbejde eller spille med venner. + +1. Download ZIP-filen til 'Windows (64-bit)' fra [Ngrok's hjemmeside](https://ngrok.com/download). +2. Placer den downloadede Ngrok i servermappen. +3. Generer en godkendelsestoken fra [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Kør kommandoen, der vises i 'Command Line' i servermappen. +5. Tilføj 'start /b ngrok tcp --region jp 25565' øverst i kørselsskriptet og 'taskkill /f /t /im ngrok.exe' nederst. +6. Fra 'Forwarding tcp\://0.tcp.jp.ngrok.io:12345 -> localhost:25565' i konsollen vil '0.tcp.jp.ngrok.io:12345' være serverens adresse. +7. Nu kan du oprette forbindelse eksternt via denne adresse. + {% endtab %} + +{% tab title="Lokal adgang" %} +Hvis du forsøger at oprette forbindelse til serveren lokalt, kan du bruge 'cmd /k ipconfig' i køre-vinduet for at oprette forbindelse til 'IPv4-adressen', der vises. + +For eksempel, hvis følgende vises efter at kommandoen er kørt, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Kan du forsøge at oprette forbindelse til serveren lokalt ved at bruge '192.168.3.7', der vises som IPv4-adressen her. + +Hvis serveren og spillet kører på samme PC, kan du oprette forbindelse ved at bruge 'localhost'. +{% endtab %} +{% endtabs %} + +## 7. Udviklingsfase + +Når serveren er startet succesfuldt og kører korrekt, er det nu tid til at tilpasse serveren. + +Lær hvordan du tilpasser serveren ved at følge denne vejledning. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java Runtime Environment. + +[^2]: Plazma's baseret på Paper, som er baseret på Spigot, der igen er baseret på den officielle serverplatform. + +[^3]: Windows-tast + R + +[^4]: For Linux, brug 'java --version' i terminalen. + +[^5]: JRE er et open source-projekt med flere varianter, ligesom Minecraft-serverplatformen. + +[^6]: Det er generelt kendt som en **launcher**. + +[^7]: Når 'Auto-genstart' er aktiveret, genstarter serveren automatisk. Du kan afslutte ved at indtaste 'Control + C'. + +[^8]: Det anbefales ikke at overskride halvdelen af systemets hukommelse. + + For eksempel, hvis den samlede hukommelseskapacitet er 8 GB, anbefales det ikke at indstille den til over 4 GB. + +[^9]: End-User License Agreement, Slutbrugerlicensaftale. Se [Minecraft's hjemmeside](https://www.minecraft.net/ko-kr/usage-guidelines) for flere oplysninger. + +[^10]: Microsoft Corporation. + +[^11]: I henhold til artikel 32, stk. 1, nr. 9 i loven om fremme af spilindustrien i Sydkorea, kan **Koreanske Microsoft Corporation** retsforfølges. + +[^12]: Universal Plug & Play. Purpur inkluderet i Plazma kommunikerer automatisk med routeren via denne teknologi for at åbne porten, når serveren kører, så der er ikke behov for manuel portvideresendelse. + +[^13]: Hvis du ikke har en konto, kan du tilmelde dig Ngrok ved hjælp af en Google- eller GitHub-konto. diff --git a/da/origin/plazma/adminstration/getting-started/customization.md b/da/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..a08cbe945 --- /dev/null +++ b/da/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du tilpasser serveren. +--- + +# 🎨 Brugerdefinering diff --git a/da/origin/plazma/adminstration/reference/arguments.md b/da/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..1d55a47d1 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Få kendskab til startargumenter og systemegenskaber. +--- + +# 🎛️ Argumenter og egenskaber + +Startvariabler og systemegenskaber er værdier, der tilføjes til [kommandoer](#user-content-fn-1)[^1] brugt til at køre Plazma, hvilket gør det muligt at ændre uændringsbare værdier efter Plazma er kørt. + +Afhængigt af hvor de tilføjes til kommandoen, opdeles de i **startargumenter** og **systemegenskaber**. + +*** + +## Systemegenskaber + +Systemegenskaber, der indtastes foran `-jar`, behandles af JVM før Plazma initialiseres. + +{% hint style="warning" %} + +### Ændringer i systemegenskaber kan ændre Plazmas og JVM's funktion og have stor indvirkning på spillet! + +Hvis du ikke er sikker på, hvad hver systemegenskab gør, **brug det ikke under nogen omstændigheder!** +{% endhint %} + +### Brugsanvisning + +Systemegenskaber indtastes som Java-kommandoargumenter mellem `java` og `-jar`. + +Hvis du f.eks. vil anvende systemegenskaben `Plazma.dummyProperty`, vil følgende indtastning initialisere Plazma med værdien `37`. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` angiver, at argumentet ikke er indbygget i JVM, men er et dedikeret argument til Plazma og + +hvis der ikke angives nogen værdi, vil værdien være [`true` som standard.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight-relaterede serverplatforme inkluderer `.` i egenskabsnavnet for at adskille systemegenskaberne for hver platform. + +I visse terminaler som Windows Powershell kan disse argumenter muligvis ikke accepteres, så du skal tilføje `"` i begge ender af argumenterne.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Alle systemegenskaber + +#### `convertLegacySigns` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Opdaterer deaktiverede skiltformater. + +#### `debug.entities` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for entitetsinformation. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer NMS-revisionen for at kunne indlæse debugoplysninger korrekt i IDE'en og remapper automatisk interne versionsoplysninger. + +#### `disable.watchdog` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer Spigots watchdog-advarselssystem. + +#### `letMeReload` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer bekræftelsesbeskeden for `/reload`-kommandoen. + +{% hint style="danger" %} + +### `/reload`-kommandoen er meget ustabil, så alle problemer, der opstår efter brugen af `/reload`, er brugerens eget ansvar. + +Hvis du er pluginudvikler og skal opdatere et plugin, skal du bruge hotswap i stedet for `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer brugen af standard input/output-systemet for plugins. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Advarer, når forældet formatering opdages i chatkomponenter. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer validering af serverens mønster, når en spiller opretter forbindelse til serveren. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for manglende nøgler i NBT-objekter. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for ugyldige kranieprofiler. + +Dette logger placeringen af alle ugyldige kranieblokke i verden. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer begrænsningen på 128 pluginkanaler pr. spiller.[^5] + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer prioritering af pluginklasser. + +Nyttig, hvis der er problemer med plugin-shading. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer Netty's flush-consolidation-system. + +#### `Paper.excessiveTELimit` + +- **Type**: `Heltal` +- **Standardværdi**: `750` + +Opdeler entiteter i flere pakker, hvis de overstiger den angivne værdi. + +#### `Paper.filterThreshold` + +- **Type**: `Heltal` +- **Standardværdi**: `8192` + +Indstiller størrelsen på den maksimale pakke, serveren kan modtage ad gangen. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Deaktiverer Java-versionkontrol. + +{% hint style="danger" %} + +### Dette kan føre til, at JVM forsøger at få adgang til ikke-eksisterende kode! + +Dette kan permanent beskadige filer som verdener og ødelægge spillets mekanik. + +Enhver skade forårsaget af dette er dit eget ansvar, og Plamza yder ingen support i den henseende. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Heltal` +- **Standardværdi**: `64` + +Indstiller begrænsningen for kanalnavne til plugins.[^6] + +#### `Paper.maxSignLength` + +- **Type**: `Heltal` +- **Standardværdi**: `80` + +Indstiller den maksimale længde af tekst på et skiltlinje. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Heltal` +- **Standardværdi**: `(verdensversion) + 1` + +Indstiller versionen for de første datafixes, der skal initialiseres. + +Nyttig, hvis der er behov for at opdatere store mængder chunks, men ellers ikke bruges. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolesk` +- **Standardværdi**: `Sandt` + +Aktiverer behandlingen af YAML-filkommentarer som standard. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Heltal` +- **Standardværdi**: `30` + +Spilleren bliver kicket, hvis der ikke modtages nogen data i det angivne antal sekunder. + +Normalt sender spillet[^7] konstant [hjerteslagssignaler](#user-content-fn-8)[^8] til serveren, så spilleren ikke bliver kicket, men hvis spillet ikke svarer, betragtes det som en kollision og spilleren bliver kicket. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Ignorerer kommentarer i serveregenskaberne. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer debuglogs for synkroniseret chunkgenerering. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer Minecrafts [standard chunkgenereringssystem](#user-content-fn-10)[^10]. + +Dette gemmer hver chunk sekventielt, hvilket kan forårsage betydelig ydeevnenedgang. + +#### `Paper.explicit-flush` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Aktiverer eksplisit flushing af netværkskanaler. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Logger altid fejl, der ikke opstår på hovedtråden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Advarer, hvis planlagte opgaver har overdreven ventetid. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolesk` +- **Standardværdi**: `Falsk` + +Anvend kun patch uden at starte serveren, når du bruger den medfølgende eksekverbare fil. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` + +{% hint style="warning" %} + +### Denne egenskab vil blive flyttet til startargumenter efter 1.20.5. + +{% endhint %} + +Øger konfigurationsoptimeringen, der anvendes ved første start, mere strengt. + +Når aktiveret, vil serveren blive hurtigere og mere sikker, men det kan blokere visse mekanismer eller have stor indflydelse på spiloplevelsen. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` + +Undertrykker advarslen[^11], der vises under initialisering af Plazma. + +### Afbrydende egenskab + +Følgende systemegenskaber er afbrudte egenskaber. + +#### `timings.bypassMax` + +- **Type**: `Boolesk` +- **Standardværdi**: `false` +- **Afbrydet brug**: Timings blev fjernet fra Plazma + +Bestemmer, om værdier, der sendes til Aikars Timings API, kan overstige det maksimale. + +Selvom dette er tilfældet, vil ratebegrænsning blive anvendt, hvis der ikke håndteres undtagelser i API'en. + +*** + +## Startargument + +Startargumenter indtastes efter `-jar *.jar` for at initialisere Plazma og behandles sammen med det. + +### Brugsanvisning + +Systemegenskaber indtastes som programkommandoargumenter efter `-jar *.jar`. + +Hvis du f.eks. vil anvende startargumentet `nogui`,\ +skal du indtaste det som vist nedenfor, så Plazma kan behandle `nogui`-argumentet under initialiseringen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Samlede startargumenter + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standard**: `bukkit.yml` + +Indstiller navn og placering af [Bukkit-konfigurationsfilen](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Standard**: `commands.yml` + +Indstiller navn og placering af [Bukkit-kommandokonfigurationsfilen](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Standard**: `server.properties` + +Indstiller navn og placering af [serveregenskabsfilen](../reference/configurations/property.md). + +#### `demo` + +Starter serveren i demotilstand. + +#### `eraseCache` + +Fjerner eventuelle cache-filer efter en verdensopgradering. + +#### `forceUpgrade` + +Opgraderer verdenen tvunget, uanset versionen, [se opgradering](#user-content-fn-12)[^12]. + +#### `help` + +- **Alias**: `?` + +Udskriver alle Plazmas startargumenter og beskrivelser. + +#### `initSettings` + +Opretter kun konfigurationsfiler og afslutter serveren. + +#### `jfrProfile` + +Aktiverer JFR-profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standard**: `(serveregenskab)` + +Indstiller det maksimale antal tilladte [spillere](#user-content-fn-14)[^14]. + +#### `nogui` + +Deaktiverer det grafiske brugergrænsefladepanel. + +#### `nojline` + +Deaktiver JLine og brug standard konsollen. + +#### `online-mode` + +- **Alias**: `o` +- **Standard**: `(serveregenskab)` + +Vælg om spillerne skal valideres mod Mojangs godkendelsesserver. + +**Hvis du ikke bruger Velocity eller andre proxier, kan du blive sanktioneret for at overtræde [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardværdi**: `paper.yml` + +{% hint style="warning" %} + +### Denne parameter er blevet deaktiveret efter 1.19.4 + +{% endhint %} + +Angiver placeringen af den deaktiverede PaperSpigot konfigurationsfil. + +Denne bruges til at flytte eksisterende konfiguration til en ny fil og er ikke længere i brug. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardværdi**: `config` + +Angiver navn og placering af mappen, hvor [Paper konfigurationsfiler](../reference/configurations/paper/README.md) er placeret. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Angiver navn og placering af mappen, hvor [Plazma konfigurationsfiler](../reference/configurations/plazma/README.md) er placeret. + +#### `plugins` + +- **Alias**: `p` +- **Standardværdi**: `plugins` + +Angiver placeringen af plugins-mappen. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardværdi**: `pufferfish.yml` + +Angiver navn og placering af [Pufferfish konfigurationsfilen](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardværdi**: `purpur.yml` + +Angiver navn og placering af [Purpur konfigurationsfilen](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Starter serveren i fuld standardtilstand som om det var ren vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standard**: `(serveregenskab)` + +Angiver serverens værtsnavn eller [Internet Protocol](#user-content-fn-13) adresse. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standard**: `(serveregenskab)` + +Angiver serverens portnummer. + +#### `server-name` + +- **Standardværdi**: `A Plazma Server` + +Angiver serverens navn. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardværdi**: `spigot.yml` + +Angiver navn og placering af [Spigot konfigurationsfilen](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Viser Plazma versionen. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardværdi**: `(servermappe)` + +Angiver placeringen hvor verdensfilerne gemmes. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standard**: `(serveregenskab)` + +Angiver navnet på verdensfilen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Afhængigt af positionen behandles argumenterne anderledes. + +[^3]: For eksempel, hvis du vil aktivere `Plazma.iKnowWhatIAmDoing` til `true`, fungerer det på samme måde, hvis du kun indtaster `-DPlazma.iKnowWhatIAmDoing`, i stedet for `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: For eksempel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: Et signal der indikerer, at forbindelsen til serveren fungerer korrekt, ligesom et hjerteslag. + +[^9]: Med Purpurs AFK kick-funktion kan også spillere, der er inaktive, blive sparket. + +[^10]: Sync Chunk Write System, synkroniseret chunk-skrivesystem. + +[^11]: `ADVARSEL! Plazma kan forårsage uventede problemer, så sørg for at teste det grundigt, før du bruger det på en offentlig server.` + +[^12]: I spillet fungerer 'verdensoptimering' på samme måde. + +[^13]: Internet Protocol, IP. + +[^14]: Administratorer på niveau 2 eller højere er undtaget. diff --git a/da/origin/plazma/adminstration/reference/commands.md b/da/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..c2f912570 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Lær om de kommandoer, der er tilgængelige på Plazma. +--- + +# 🖥️ Kommandoer diff --git a/da/origin/plazma/adminstration/reference/configurations/bukkit.md b/da/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..4f8328c1a --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver knude i bukkit.yml betyder. +--- + +# 🪣 Bukkit diff --git a/da/origin/plazma/adminstration/reference/configurations/paper/README.md b/da/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..e63a0193b --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af formålet med hver fil i config-mappen. +--- + +# 🛩️ Papir diff --git a/da/origin/plazma/adminstration/reference/configurations/paper/global.md b/da/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..fa05fc682 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🛩️ Paper (global configuration) diff --git a/da/origin/plazma/adminstration/reference/configurations/paper/world.md b/da/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f18b91381 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-world.yml means. +--- + +# 🛩️ Papir (opbygning af verdener) diff --git a/da/origin/plazma/adminstration/reference/configurations/plazma/README.md b/da/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..c6f205520 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af formålet med hver fil i config-mappen. +--- + +# ✨ Plazma diff --git a/da/origin/plazma/adminstration/reference/configurations/plazma/global.md b/da/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..790dd133c --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i plazma-global.yml betyder. +--- + +# ✨ Plazma (global konfiguration) diff --git a/da/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/da/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..aef994374 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Verdensomspændende sammensætning diff --git a/da/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/da/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..ffa66294b --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# ✨ Plazma (sammensætning af verdener) diff --git a/da/origin/plazma/adminstration/reference/configurations/property.md b/da/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..d9d6aa84b --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i server.properties betyder. +--- + +# 🪨 Server.properties diff --git a/da/origin/plazma/adminstration/reference/configurations/pufferfish.md b/da/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..a1c359cb1 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver knude i pufferfish.yml betyder. +--- + +# 🐡 Kuglefisk diff --git a/da/origin/plazma/adminstration/reference/configurations/purpur/README.md b/da/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..773653a3c --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i purpur.yml betyder. +--- + +# 🦑 Purpur diff --git a/da/origin/plazma/adminstration/reference/configurations/purpur/global.md b/da/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..b1bbc59d3 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i purpur.yml betyder. +--- + +# 🦑 Purpur (global sammensætning) diff --git a/da/origin/plazma/adminstration/reference/configurations/purpur/world.md b/da/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..86f931e39 --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver node i purpur.yml betyder. +--- + +# 🦑 Purpur (verdensomspændende sammensætning) diff --git a/da/origin/plazma/adminstration/reference/configurations/spigot.md b/da/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..d7ab7d8dd --- /dev/null +++ b/da/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find ud af, hvad hver knude i spigot.yml betyder. +--- + +# 🚰 Spigot diff --git a/da/origin/plazma/adminstration/reference/permissions.md b/da/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..398db096f --- /dev/null +++ b/da/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Få mere at vide om tilladelserne til Plazma. +--- + +# 🛡️ Tilladelser diff --git a/da/origin/plazma/developers.md b/da/origin/plazma/developers.md new file mode 100644 index 000000000..78f3dd67e --- /dev/null +++ b/da/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Brug Plazma til at udvikle tredjepartsprojekter. +--- + +# ⚙️ Udviklerguide diff --git a/da/origin/thunderbolt/README.md b/da/origin/thunderbolt/README.md new file mode 100644 index 000000000..3bce8d7fc --- /dev/null +++ b/da/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt er en Plazma-baseret serverplatform, der giver dig mulighed for at bruge eksperimentelle patches direkte som en Flavor. +--- + +# 🌩️ Thunderbolt Brugervejledning diff --git a/da/origin/volt/README.md b/da/origin/volt/README.md new file mode 100644 index 000000000..c4bdf9454 --- /dev/null +++ b/da/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt er en open source-skabelon, der giver mulighed for at udvikle sin egen Paperweight-serverplatform baseret på Plazma. +--- + +# ⚡ Volt Udviklingsguide diff --git a/de/origin/README.md b/de/origin/README.md new file mode 100644 index 000000000..da355724a --- /dev/null +++ b/de/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Bei Fragen wenden Sie sich bitte über Discord oder GitHub-Diskussionen an uns. +--- + +# 🏠 Willkommen beim Docs-Portal + +{% Hinweis-Stil="info" %} + +**Die Dokumente von Plazma befinden sich derzeit in einem maschinellen Übersetzungszustand.** + +[![Übersetzungsstatus](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) Die Dokumentenübersetzung auf [https://translate.plazmamc.org/](https://translate.plazmamc.org/) verbessern Sie durch die Teilnahme an der Übersetzung der Dokumente. + +{% endhint %} + +### Wenn es Probleme bei der Verwendung von Plazma gibt, was dann? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Wenn Sie an Thunderbolt interessiert sind, kontaktieren Sie uns. + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Wenn Sie Ihre eigene Serverplattform mit Volt erstellen möchten, kontaktieren Sie uns. + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Wenn Sie mehr Informationen zu Minecraft benötigen, kontaktieren Sie uns. + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/de/origin/SUMMARY.md b/de/origin/SUMMARY.md new file mode 100644 index 000000000..8e9abef1e --- /dev/null +++ b/de/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Inhaltsverzeichnis + +- [🏠 Willkommen im Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma-Nutzungsdokumentation](plazma/README.md) +- [❓ Was ist Plazma?](plazma/about/README.md) + - [⬇️ Herunterladen](plazma/about/downloads.md) + - [✅ Unterstützte Versionen](plazma/about/supported-versions.md) +- [⚒️ Server-Verwaltungsleitfaden](plazma/administration/README.md) + - [👟 Einstieg](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referenz](plazma/administration/reference/README.md) + - [🖥️ Befehle](plazma/administration/reference/commands.md) + - [🛡️ Berechtigungen](plazma/administration/reference/permissions.md) + - [🎛️ Argumente und Eigenschaften](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Eigenschaft](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globale Konfiguration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Weltweite Konfiguration](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Kugelfisch](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globale Konfiguration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Weltweite Konfiguration](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globale Konfiguration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Weltweite Konfiguration](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Fortgeschritten](plazma/administration/expert/README.md) + - [🧹 Optimierung](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Entvanillisierung](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blockierung](plazma/administration/expert/xray.md) + - [⚠️ Sicherheitslücken und Lösungen](plazma/administration/expert/fix-exploits.md) + - [⁉️ Häufig gestellte Fragen](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Entwicklerhandbuch](plazma/developers.md) + - [✏️ Mitwirken](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadoc](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt-Nutzungsanleitung](thunderbolt/README.md) + +## Volt + +- [⚡ Volt-Entwicklungsanleitung](volt/README.md) + +## Verschiedenes + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Alle Downloads anzeigen](plazma/about/downloads-all.md) diff --git a/de/origin/miscellaneous/README.md b/de/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/de/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/de/origin/plazma/README.md b/de/origin/plazma/README.md new file mode 100644 index 000000000..0d1033eab --- /dev/null +++ b/de/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma ist eine Open-Source-Serverplattform für Minecraft: Java Edition, die auf papierbasierter experimenteller Optimierung und der Anpassung verschiedener Spielmechaniken basiert." +--- + +# ✨ Plazma Verwendungsdokumente + +## 👋 Willkommen bei Plazma-Dokumenten + +Willkommen im Plazma-Benutzerhandbuch! + +{% Hinweis-Stil="info" %} + +**Können Sie das Problem nicht über die Anleitung lösen?** + +[Offizieller Discord-Server](https://discord.gg/MmfC52K8A8) oder [GitHub-Diskussionen](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - stellen Sie Ihre Fragen an die Community! + +{% endhint %} + +### Über Plazma + +> Erfahren Sie mehr über Plazma als Serverplattform. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Für Administratoren + +> Erstellen Sie Ihren eigenen Server mit Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Für Entwickler + +> Entwickeln Sie Drittanbieterprojekte mit Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/de/origin/plazma/about/README.md b/de/origin/plazma/about/README.md new file mode 100644 index 000000000..e94d0e63d --- /dev/null +++ b/de/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Erfahren Sie mehr über Plazma als Serverplattform. +--- + +# ❓ Was ist Plazma? + +- **Plazma** ist eine auf [Paper](https://github.com/PaperMC/Paper) basierende Serverplattform, die nur die Vorteile von [Andromeda](https://github.com/EarendelArchived/Andromeda) und [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) vereint. +- Wir bemühen uns stets um hohe Stabilität, starke Leistung, schnelle Updates und ein umfangreiches Funktionsangebot. + +## 📋 Ziele von Plazma + +- Wir streben danach, eine Serverplattform mit schnellen Updates und hoher Stabilität zu sein. +- Wir bemühen uns, Funktionen und Leistung zu bieten, die denen von Mod-Plattformen in nichts nachstehen. +- Wir streben danach, eine frei anpassbare Plattform zu schaffen, die auch Patches von Vanilla anpassen kann. + +## ⚙️ Hauptmerkmale + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Schnellste Updates**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) sorgt dafür, dass die enthaltenen Patches von Plazma immer auf dem neuesten Stand gehalten werden und somit die schnellsten Updates unter den auf Paper basierenden Serverplattformen bietet. +6. **Optimierte Standardkonfigurationsdateien**\ + Die standardmäßig angewendeten Konfigurationsdateien sind optimiert, sodass Sie keine eigenen Konfigurationsdateien optimieren müssen. +7. **Systematisches Multithreading**\ + Durch die Asynchronisierung von Systemmechanismen, die nichts mit dem Spielmechanismus zu tun haben, wird die Latenz reduziert und der Server optimiert. +8. **Blockieren der Verwendung unnötiger Speicherbereiche**\ + Durch Zusammenführen von Daten mit ähnlichen Werten wird der Speicherverbrauch reduziert. + +## ✨ Anwendungsfälle + +- **Plattform, die auch komplexe Plugins richtig verarbeitet**\ + Wird auf dem Server des Entwicklers [IPECTER](https://github.com/IPECTER) verwendet.\ + Eigenes Plugin, das mit NMS und Reflexion funktioniert, mit umfangreichen und komplexen Datapacks,\ + um mehr als 100 Spieler ohne Leistungsabfall zu bewältigen. +- **Plattform, die auch auf RPG-Servern eine schnelle Leistung beibehält**\ + Es konnte die Stabilität von 100 Spielern in einem einzelnen Cluster ohne TPS-Abfall aufrechterhalten werden,\ + und insgesamt 250 Spieler konnten auf 4 Clustern angenehm spielen. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **많은 스트리머가 선택한 플랫폼**\ + 많은 스트리머 분들의 시청자 참여용 버킷으로 선택받아 사용되고 있습니다. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +Auf der folgenden Seite können Sie Plazma herunterladen. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Möchten Sie detaillierte Informationen zur Unterstützung von Versionen erhalten? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot-Plugins und Paper, Pufferfish, Purpur-Plugins. + +[^2]: Von Microsoft Corporation. + +[^3]: Durch Deaktivieren des Chat-Meldesystems wird der Chat ausschließlich auf dem Server verarbeitet und das Chat-Tracking von Mojang verhindert. + +[^4]: Zeit, die das Spiel angehalten wird, um die Systemmechanismen zu aktivieren. diff --git a/de/origin/plazma/about/downloads-all.md b/de/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..55ca9b9f7 --- /dev/null +++ b/de/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma Ausführbare Datei herunterladen Vollständige Ansicht +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/de/origin/plazma/about/downloads.md b/de/origin/plazma/about/downloads.md new file mode 100644 index 000000000..ff552289b --- /dev/null +++ b/de/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Laden Sie Plazma jetzt herunter und probieren Sie es selbst aus. +--- + +# ⬇️ Download + +#### Möchten Sie detaillierte Informationen zur Unterstützung von Versionen erhalten? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% Hinweis-Stil="info" %} + +**Die folgenden Downloads sind ausführbare Dateien für normale Benutzer.** + +Wenn Sie ein Entwickler sind und eine andere Art von Datei benötigen, sehen Sie sich bitte die folgende Seite an. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionHerunterladen
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Herunterladen +
1.20.1 + Herunterladen +
1.19.4 + Herunterladen +
+ +*** diff --git a/de/origin/plazma/about/patches-list.md b/de/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..03d9f5b36 --- /dev/null +++ b/de/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über alle Funktionen, die zu Plazma hinzugefügt wurden. +--- + +# 📑 Enthaltene Patches diff --git a/de/origin/plazma/about/supported-versions.md b/de/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..9f04233fe --- /dev/null +++ b/de/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Erfahren Sie, welche Versionen von Minecraft: Java Edition von Plazma unterstützt werden." +--- + +# ✅ Unterstützte Versionen + +{% Hinweis-Stil="info" %} + +**Plazma wird ab Version 1.19.4 entwickelt, Versionen unter 1.19.4 werden nicht mehr unterstützt.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/In%20Bearbeitung +[atv]: https://badge.plazmamc.org/2/Unterstützt +[fse]: https://badge.plazmamc.org/6/Funktion%20Unterstützung%20eingestellt +[eol]: https://badge.plazmamc.org/4/Unterstützung%20beendet +[ukn]: https://badge.plazmamc.org/0/Keine%20Informationen +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Warten auf Veröffentlichung][wtr] ![In Bearbeitung][idv] ![Unterstützt][atv] ![Funktion Unterstützung eingestellt][fse] ![Unterstützung beendet][eol] + +| Version | Stabilität und Funktionsunterstützung | Build-Status | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Build Status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1,20,4](https://badge.plazmamc.org/6/1,20,4)](https://git.plazmamc.org/1,20,4) | ![지원 종료][eol]![100%][100] | [![Build-Status](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Build-Status](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/de/origin/plazma/administration/README.md b/de/origin/plazma/administration/README.md new file mode 100644 index 000000000..d99e7a8d1 --- /dev/null +++ b/de/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Erstellen Sie Ihren eigenen Server mit Plazma. +--- + +# ⚒️ Server-Verwaltungsleitfaden diff --git a/de/origin/plazma/administration/diagnosis/README.md b/de/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..b121a7855 --- /dev/null +++ b/de/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, wie Sie mit Problemen umgehen, wenn sie auftreten. +--- + +# 🧾 진단 diff --git a/de/origin/plazma/administration/diagnosis/plugins.md b/de/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..d8d123b65 --- /dev/null +++ b/de/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, wie Sie Probleme beheben, wenn das Plugin nicht ordnungsgemäß funktioniert. +--- + +# 📜 플러그인 diff --git a/de/origin/plazma/administration/expert/README.md b/de/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b38b88e8b --- /dev/null +++ b/de/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über die professionelle Handhabung von Plazma. +--- + +# 🎓 Vertiefung diff --git a/de/origin/plazma/administration/expert/fix-exploits.md b/de/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..993055823 --- /dev/null +++ b/de/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über bekannte Sicherheitslücken und wie man sie behebt. +--- + +# ⚠️ Bekannte Sicherheitslücken und Lösungsmethoden diff --git a/de/origin/plazma/administration/expert/optimize.md b/de/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..0400ab04a --- /dev/null +++ b/de/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, wie Sie Plazma optimieren können. +--- + +# 🧹 Optimierung diff --git a/de/origin/plazma/administration/expert/proxy.md b/de/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..af97df7d0 --- /dev/null +++ b/de/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, wie Sie die Proxy-Plattform "Velocity" sicher konfigurieren können. +--- + +# 🔀 Proxy diff --git a/de/origin/plazma/administration/expert/vanillaize.md b/de/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..5cc189b17 --- /dev/null +++ b/de/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Erfahren Sie, wie Sie das Paper- und Vanille-Patch wiederherstellen können. +--- + +# ↩️ Vanilleisierung + +{% Hinweis Stil="Warnung" %} + +**Paper enthält keine Optionen für die meisten Patches zur Behebung von Vanilla-Fehlern.** + +Plazma entwickelt derzeit eine Konfiguration, um solche Fehlerbehebungen zu deaktivieren. + +Daher ist dieser Leitfaden noch in Bearbeitung und die Informationen können sich jederzeit ändern. + +{% endhint %} diff --git a/de/origin/plazma/administration/expert/xray.md b/de/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..435474456 --- /dev/null +++ b/de/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über verschiedene eingebaute Methoden, um Röntgenstrahlen zu blockieren. +--- + +# 🩻 X-Ray Blockierung diff --git a/de/origin/plazma/administration/faq.md b/de/origin/plazma/administration/faq.md new file mode 100644 index 000000000..8bc00956a --- /dev/null +++ b/de/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Erfahren Sie mehr über häufig gestellte Fragen. +--- + +# ⁉️ Häufig gestellte Fragen + +{% Hinweis-Stil="info" %} + +**Konnten Sie die gewünschte Antwort nicht finden?** + +[Offizieller Discord-Server](https://discord.gg/MmfC52K8A8) oder [GitHub-Diskussionen](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - stellen Sie Ihre Fragen an die Community! + +{% endhint %} + +### Plazma startet nicht + +Wenn in der Konsole `no main manifest attribute, in plazma-(version).jar` angezeigt wird,\ +dann haben Sie die Entwicklungs-API-Datei heruntergeladen und müssen **Reobf Paperweight** von der GitHub-Seite herunterladen. + +Für weitere Informationen siehe die folgende Seite. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Eine Warnung wird jedes Mal angezeigt, wenn der Server gestartet wird. + +Plazma enthält einige instabile Patches und kann daher möglicherweise fehlerhaft funktionieren. Daher werden beim Start des Servers folgende Warnungen angezeigt. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Diese Warnungen können mit dem Systemattribut [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] deaktiviert werden. + +Für weitere Informationen siehe die folgende Seite. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Ab Version 1.20.1 verfügbar diff --git a/de/origin/plazma/administration/getting-started/README.md b/de/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..61ec53ae1 --- /dev/null +++ b/de/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Erfahren Sie, wie Sie einen Server mit Plazma erstellen. +--- + +# 👟 Los geht's + +Um Plazma stabil zu nutzen, muss das System die folgenden Anforderungen erfüllen. + +| | Minimum | Empfohlen | +| :-----------: | ------- | --------- | +| Architektur | x64 | - | +| RAM | 8GB | 16GB | +| Speicherplatz | 1GB | 8GB | +| JDK | 17 | 21 | + +Für eine reibungslose Konfigurationsdateibearbeitung ist es auch ratsam, einen Editor wie [Visual Studio Code](https://code.visualstudio.com/download) zu installieren. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Richtige Ausgabe" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Laufzeitumgebung Zulu21.32+17-CA (Build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (Build 21.0.2+13-LTS, gemischter Modus, gemeinsame Nutzung) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' ist keine interne oder externe Befehl, ein ausführbares Programm oder +eine Stapeldatei. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unbekannte Option: --version +Fehler: Java Virtual Machine konnte nicht erstellt werden. +Fehler: Es ist ein schwerwiegender Ausnahmefehler aufgetreten. Das Programm wird beendet. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Laden Sie zuerst [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) herunter und installieren Sie **JDK 21** im `.msi`-Format. +2. Führen Sie den heruntergeladenen Installationsassistenten aus und klicken Sie auf `Next`. +3. Aktivieren Sie im mittleren linken Bereich des Fensters `Set JAVA_HOME variable` und klicken Sie dann auf `Next`. +4. Klicken Sie auf `Install`, um die JRE-Installation abzuschließen. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Führen Sie dann den folgenden Befehl im Terminal aus, um JRE zu installieren. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma herunterladen + +Plazma bietet verschiedene Arten von ausführbaren Dateien an. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Weitere Informationen + +Der Name der ausführbaren Datei ist `plazma-(Version Manager)-1.20.4-R0.1-SNAPSHOT-(Mapping Typ).jar`. + +- **Mapping Typ**\ + Mapping ist eine Art Karte, die den echten Code von Minecraft mit dem obfuszierten Code verbindet. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, ist das Mapping für das Vanilla Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + Der Version Manager ist eine Art Launcher, der die für den Serverbetrieb erforderlichen Bibliotheken bereitstellt und Serverdateien patcht. + - **Paperclip**\ + Ein Administrator, den das PaperMC-Team für Paper und andere abgeleitete Plattformen entwickelt hat. Es lädt Bibliotheken herunter und wendet Patches auf den Server an. + - **Bundler**\ + Der Version Manager für Vanilla Minecraft. + +
+ +*** + +## 3. Startskript erstellen + +Um Plazma einfach zu starten und den Server automatisch neu zu starten, müssen Sie ein [Startskript](#user-content-fn-6)[^6] erstellen. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Sie können das Startskript über den Download-Button unten links herunterladen.\ +**Stellen Sie sicher, dass das heruntergeladene Startskript mit Ihrem Betriebssystem übereinstimmt.** + +*** + +## 4. Dateien ordnen + +Verschieben Sie das heruntergeladene Startskript und Plazma in einen neuen Ordner. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Führen Sie nun das Startskript aus. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA-Zustimmung + +Nach dem Ausführen des Startskripts wird eine `eula.txt`-Datei im Ordner erstellt. + +Die EULA[^9] ist ein Endbenutzer-Lizenzvertrag, dem Sie zustimmen müssen, um die Dienste von [Mojang Studios](#user-content-fn-10)[^10] zu nutzen. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Um der EULA zuzustimmen, ändern Sie `eula=false` in der `eula.txt`-Datei in `eula=true` und speichern Sie die Änderungen. + +*** + +## 6. Externe Verbindungen zulassen (Windows) + +Moderne Betriebssysteme blockieren standardmäßig externe Zugriffe, um vor Gefahren zu schützen, indem sie die Firewall und den Router verwenden. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Wenn Ihr Router UPnP nicht unterstützt, müssen Sie je nach Routermodell Informationen suchen. + +Alternativ können Sie auch [Ngrok](https://ngrok.com/) verwenden, um eine temporäre Adresse zu generieren. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Überprüfung der Notwendigkeit von Port-Weiterleitungen + +Geben Sie Folgendes in das Ausführungsfenster ein und führen Sie es aus. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Wenn die Ausgabe `True` ist, sind keine weiteren Maßnahmen erforderlich. Wenn die Ausgabe `False` ist, müssen Port-Weiterleitungen festgelegt werden. + +### 6.2 Serververbindung + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Die Adresse, die zum Verbinden mit dem Server verwendet wird, finden Sie [hier](https://ip.pe.kr/) heraus. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Danach, wenn Sie den Server neu starten, versucht Plazma automatisch Portweiterleitung. + +Die folgende Meldung auf der Konsole zeigt den Erfolg oder Misserfolg von UPnP an, und in der Konsole wird `[UPnP] (Nachricht)` angezeigt. + +| Nachricht | Bedeutung | +| ---------------------------------------- | -------------------------------------------------------------- | +| `Port (포트)` erfolgreich geöffnet | Portweiterleitung erfolgreich. | +| `Port (포트) ist bereits geöffnet` | Ein anderer Dienst verwendet den Port bereits. | +| `Port (포트) konnte nicht geöffnet werden` | Portweiterleitung fehlgeschlagen. | +| `Dienst ist nicht verfügbar` | Der Router unterstützt kein UPnP. | + +Wenn der Server heruntergefahren wird, schließt Plazma die Ports automatisch. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Laden Sie die `Windows (64-bit)` ZIP-Datei von der [Ngrok-Website](https://ngrok.com/download) herunter. +2. Legen Sie das heruntergeladene Ngrok in den Serverordner. +3. Erstellen Sie auf dem [Ngrok-Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) einen [Authentifizierungstoken](#user-content-fn-13). +4. Führen Sie den im Serverordner angezeigten Befehl in der `Command Line` aus. +5. Fügen Sie dem Ausführungsskript `start /b ngrok tcp --region jp 25565` am Anfang und `taskkill /f /t /im ngrok.exe` am Ende hinzu. +6. In der Konsole wird `Weiterleitung tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` angezeigt, wobei `0.tcp.jp.ngrok.io:12345` die Adresse des Servers ist. +7. Jetzt können Sie über diese Adresse von extern auf den Server zugreifen. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Beispielsweise, wenn nach Ausführung des Befehls Folgendes angezeigt wird: + +```log +Windows IP-Konfiguration + +Ethernet-Adapter Ethernet: + + Verbundenes DNS-Suffix. . . . : + IPv4-Adresse. . . . . . . . . : 192.168.3.7 + Subnetzmaske . . . . . . . : 255.255.255.0 + Standardgateway . . . . . . : 192.168.3.1 + +``` + +Versuchen Sie, sich mit der im IPv4-Adressfeld angezeigten `192.168.3.7` zu verbinden, um lokal auf den Server zuzugreifen. + +Wenn Server und Spiel auf demselben PC ausgeführt werden, können Sie sich mit `localhost` verbinden. +{% endtab %} +{% endtabs %} + +## 7. Fortschritt + +Wenn der Server erfolgreich gestartet wurde und ordnungsgemäß funktioniert, ist es jetzt an der Zeit, den Server anzupassen. + +Erfahren Sie, wie Sie den Server anpassen können, indem Sie das folgende Handbuch lesen. + +{% content-ref url="naechster-schritt.md" %} +[naechster-schritt.md](naechster-schritt.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Die auf Paper basierende Plazma basiert auf Spigot, das wiederum auf der offiziellen Serverplattform von Spigot basiert. + +[^3]: Windows-Taste + R + +[^4]: Für Linux verwenden Sie `java --version` im Terminal. + +[^5]: JRE ist ein Open-Source-Projekt mit verschiedenen Versionen, ähnlich wie die Minecraft-Serverplattform. + +[^6]: Es wird im Allgemeinen als **Launcher** bezeichnet. + +[^7]: Durch Aktivieren von "Auto-Neustart" wird der Server automatisch neu gestartet. Sie können `Strg + C` eingeben, um es zu beenden. + +[^8]: Es wird nicht empfohlen, mehr als die Hälfte des Systems zu verwenden. + + Beispielsweise wird bei einem Gesamtspeicher von 8 GB die Einstellung auf mehr als 4 GB nicht empfohlen. + +[^9]: Endbenutzer-Lizenzvereinbarung, Endbenutzer-Lizenzvereinbarung. Weitere Informationen finden Sie auf der [Minecraft-Website](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Gemäß Artikel 32 Absatz 1 Nummer 9 des Gesetzes über die Förderung der Spieleindustrie in Korea kann **Korea Microsoft Corporation** rechtlich belangt werden. + +[^12]: Universal Plug & Play. Durch das in Plazma enthaltene Purpur kommuniziert automatisch mit dem Router über diese Technologie, um die Ports nur zu öffnen, wenn der Server läuft, daher ist kein manuelles Portforwarding erforderlich. + +[^13]: Wenn Sie kein Konto haben, können Sie sich über ein Google- oder GitHub-Konto bei Ngrok anmelden. diff --git a/de/origin/plazma/administration/getting-started/customization.md b/de/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..0455636eb --- /dev/null +++ b/de/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,114 @@ +--- +description: Erfahren Sie, wie Sie den Server anpassen können. +--- + +# 🎨 Anpassung für Benutzer + +Der Grund, warum Plazma und nicht die offizielle Serverplattform von Mojang Studios verwendet wird, ist die Möglichkeit einer starken **Benutzeranpassung**. + +Hier sind verschiedene Möglichkeiten, wie Plazma angepasst und genutzt werden kann. + +## Konfigurationsänderung + +Die grundlegendste Methode zur Anpassung von Plazma besteht darin, die Konfiguration zu ändern. + +Plazma bietet leistungsstarke Konfigurationseinstellungen von Spielmechaniken bis hin zu Eigenschaften von Mobs. + +Weitere Informationen zur Konfiguration von Plazma finden Sie auf der folgenden Seite. + +{% content-ref url="../reference/configurations/" %} +[Konfigurationen](../reference/configurations/) +{% endcontent-ref %} + +## Verwendung von Plugins + +{% Hinweis-Stil="Erfolg" %} + +**Plazma unterstützt alle auf Papier basierenden Plugins ordnungsgemäß.** + +Für Spigot-Plugins kann es aufgrund der Mapping-Änderungen von Paper ab Version 1.20.5 zu einigen Fehlfunktionen kommen, jedoch funktionieren die meisten Plugins, die auf Paper basieren, wie Paper, Pufferfish und Purpur, auch in Plazma einwandfrei. Sollte ein Plugin nicht ordnungsgemäß funktionieren, handelt es sich um einen Fehler in Plazma, daher melden Sie dies bitte sofort [hier](../diagnosis/plugins.md). + +{% endhint %} + +Dies ist der Hauptgrund für die Verwendung von Plazma und gleichzeitig die leistungsstärkste Methode zur Anpassung von Plazma. +Das starke Plugin-Ökosystem von Plazma ermöglicht es Ihnen, den Server einfach anzupassen. + +Es gibt verschiedene Möglichkeiten, Plugins zu finden und herunterzuladen. Einige Plugins werden in öffentlichen Repository-Diensten hochgeladen, während andere auf GitHub oder eigenen Websites hochgeladen werden. + +{% Hinweis-Stil="Vorsicht" %} + +**Plugins können direkt auf das System zugreifen!** + +Verwenden Sie Dienste wie VirusTotal, um die Sicherheit von Plugins vor der Anwendung zu überprüfen, oder laden Sie Plugins von vertrauenswürdigen Diensten herunter. + +{% endhint %} + +Es gibt verschiedene Dienste zum Herunterladen von Plugins. Davon durchlaufen Services wie [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hangar](https://hangar.papermc.io/) eine Prüfung, bevor Plugins hochgeladen werden, um sicherzustellen, dass nur sichere Plugins verbreitet werden. + +### Plugin-Anwendung + +Wenn Sie ein Plugin heruntergeladen haben, ist es nun an der Zeit, das Plugin anzuwenden. + +1. Plugins sind als `.jar` oder `Java-Ausführbare Datei` verfügbar.\ + Einige Plugins sind möglicherweise als komprimierte Dateien verpackt. In diesem Fall entpacken Sie die Datei und verwenden Sie die Datei, die `bukkit`, `spigot` oder `paper` im Namen enthält, sowie die Datei mit `fat`. +2. Legen Sie die heruntergeladene Datei in den Ordner `plugins` im Serververzeichnis und starten Sie den Server (neu). +3. Wenn Plazma gestartet wird, werden neue Inhalte in der Konsole ausgegeben. + Dies bedeutet, dass Plazma das Plugin ordnungsgemäß geladen hat. +4. Auch wenn Plazma das Plugin ordnungsgemäß geladen hat, könnte es sein, dass das Plugin nicht gestartet wurde. + Mit dem Befehl `/plugins` können Sie die aktuell geladenen Plugins auf dem Server abrufen. + Wenn der Name des installierten Plugins nicht rot, sondern grün ist, wurde das Plugin ordnungsgemäß geladen. + +Wenn ein Plugin nicht ordnungsgemäß geladen wurde, finden Sie auf der folgenden Seite Lösungen für das Problem. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Datapack verwenden + +Datapacks sind eine Möglichkeit der Anpassung, die Minecraft standardmäßig bietet und ähnlich wie [Resource Packs](#user-content-fn-1)[^1] funktionieren. + +Mit Datapacks können Sie neue Kreaturen und Herausforderungen im Spiel hinzufügen. + +{% Hinweis-Stil="Vorsicht" %} + +**Datapacks können die Welt beschädigen!** + +Einige defekte Datapacks können die Welt beschädigen, was nicht rückgängig gemacht werden kann. + +Daher wird empfohlen, die Welt vor dem Anwenden von Datapacks zu sichern. + +{% endhint %} + +Datapacks können auch von verschiedenen Diensten wie [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) heruntergeladen werden. + +Nachdem Sie Datapacks heruntergeladen haben, können Sie sie im Ordner `datapacks` im Weltverzeichnis des Servers platzieren, um sie anzuwenden. +Erstellen Sie den Ordner, falls er nicht vorhanden ist, und fügen Sie die Datapacks hinzu. + +{% Hinweis Stil="Warnung" %} + +**Einige [Datapacks](#user-content-fn-2)[^2] funktionieren möglicherweise nicht ordnungsgemäß, wenn sie zum ersten Mal angewendet werden.** + +In diesem Fall wird empfohlen, den Server **zweimal** neu zu starten. + +{% endhint %} + +Datapacks können bei jeder Aktualisierung von Minecraft leicht beschädigt werden. + +Insbesondere wenn Datapacks vollständig beschädigt sind, kann der Server abstürzen. Daher ist es wichtig, vor dem Aktualisieren des Servers ausreichende Tests durchzuführen. + +{% Hinweis-Stil="info" %} + +**Geben Sie nach dem Startbefehl des Servers `safeMode` ein, um alle Datapacks zu deaktivieren, bevor Sie den Server starten.** + +Weitere Informationen finden Sie unter `Referenz > Argumente und Eigenschaften`.](../reference/arguments.md) + +{% endhint %} + +Die angewendeten Datapacks können mit dem Befehl `/datapack list` überprüft werden. + +*** + +[^1]: Oder Minecraft: Bedrock Edition Add-ons. + +[^2]: Hinzufügen von Kreaturen usw. diff --git a/de/origin/plazma/administration/getting-started/next-step.md b/de/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..7c6140e9c --- /dev/null +++ b/de/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Erfahren Sie, wie Sie den Server anpassen können. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Hier sind verschiedene Möglichkeiten, wie Plazma angepasst und genutzt werden kann. + +## Konfigurationsänderung + +Die grundlegendste Methode zur Anpassung von Plazma besteht darin, die Konfiguration zu ändern. + +Plazma bietet leistungsstarke Konfigurationseinstellungen von Spielmechaniken bis hin zu Eigenschaften von Mobs. + +Weitere Informationen zur Konfiguration von Plazma finden Sie auf der folgenden Seite. + +{% content-ref url="../reference/configurations/" %} +[Konfigurationen](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Verwendung von Plugins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Dies ist der Hauptgrund für die Verwendung von Plazma und gleichzeitig die leistungsstärkste Methode zur Anpassung von Plazma. Das starke Plugin-Ökosystem von Plazma ermöglicht es Ihnen, den Server einfach anzupassen. + +Es gibt verschiedene Möglichkeiten, Plugins zu finden und herunterzuladen. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Es gibt verschiedene Dienste zum Herunterladen von Plugins. Davon durchlaufen Services wie [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hangar](https://hangar.papermc.io/) eine Prüfung, bevor Plugins hochgeladen werden, um sicherzustellen, dass nur sichere Plugins verbreitet werden. + +### Plugin-Anwendung + +Wenn Sie ein Plugin heruntergeladen haben, ist es nun an der Zeit, das Plugin anzuwenden. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Legen Sie die heruntergeladene Datei in den Ordner `plugins` im Serververzeichnis und starten Sie den Server (neu). +3. Wenn Plazma gestartet wird, werden neue Inhalte in der Konsole ausgegeben. Dies bedeutet, dass Plazma das Plugin ordnungsgemäß geladen hat. +4. Auch wenn Plazma das Plugin ordnungsgemäß geladen hat, könnte es sein, dass das Plugin nicht gestartet wurde. Mit dem Befehl `/plugins` können Sie die aktuell geladenen Plugins auf dem Server abrufen. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Wenn ein Plugin nicht ordnungsgemäß geladen wurde, finden Sie auf der folgenden Seite Lösungen für das Problem. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Datapack verwenden + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Mit Datapacks können Sie neue Kreaturen und Herausforderungen im Spiel hinzufügen. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Einige defekte Datapacks können die Welt beschädigen, was nicht rückgängig gemacht werden kann. + +Daher wird empfohlen, die Welt vor dem Anwenden von Datapacks zu sichern. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Nachdem Sie Datapacks heruntergeladen haben, können Sie sie im Ordner `datapacks` im Weltverzeichnis des Servers platzieren, um sie anzuwenden. Erstellen Sie den Ordner, falls er nicht vorhanden ist, und fügen Sie die Datapacks hinzu. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +In diesem Fall wird empfohlen, den Server **zweimal** neu zu starten. +{% endhint %} + +Datapacks können bei jeder Aktualisierung von Minecraft leicht beschädigt werden. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Die angewendeten Datapacks können mit dem Befehl `/datapack list` überprüft werden. + +*** + +## Optimierung + +Es wurden viele Optimierungspatches auf Plazma angewendet. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Weitere Informationen zur sicheren und korrekten Proxy-Konfiguration finden Sie auf der folgenden Seite. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Sicherheit + +Minecraft hat sich zu einem Mod entwickelt, der es einfach macht, [Schwachstellenangriffsmaschinen](#user-content-fn-3)[^3] auch online zu bekommen. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Berechtigungseinstellung + +Einige Admin-Befehle von Plugins können Schwachstellen aufweisen, wenn die Berechtigungen nicht ordnungsgemäß festgelegt sind. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray-Blockierung + +X-Ray ist eine der Schwachstellen, die selbst von grundlegenden Optimierungsclients leicht genutzt werden können. + +Plazma bietet eine Konfiguration, um X-Ray standardmäßig zu blockieren. + +Weitere Informationen zur X-Ray-Blockierungsmethode finden Sie auf der folgenden Seite. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Verwenden Sie `/whitelist query`, um die autorisierten Spieler anzuzeigen. + +*** + +[^1]: Oder Minecraft: Bedrock Edition Add-ons. + +[^2]: Hinzufügen von Kreaturen usw. + +[^3]: Im Allgemeinen als "Hacks" bezeichnet. + +[^4]: In Fällen von nicht optimierten Konfigurationen, veralteten Plazma-Versionen oder neu entdeckten Schwachstellen kann es sein, dass sie nicht blockiert sind. + +[^5]: Spieler stellen über den Ngrok-Proxyserver eine Verbindung zum Server her, und die bei jedem Neustart ausgegebene Ngrok-Adresse ändert sich. diff --git a/de/origin/plazma/administration/reference/README.md b/de/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..e6b6e56a8 --- /dev/null +++ b/de/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Erfahren Sie, wie Sie die benutzerdefinierten Funktionen von Plazma nutzen können. +--- + +# 📜 리퍼런스 + +Plazma bietet verschiedene Möglichkeiten zur Benutzeranpassung. + +Unter diesen sind 4 Methoden sofort einsatzbereit, ohne zusätzliche Maßnahmen. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Offizieller Discord-Server](https://discord.gg/MmfC52K8A8) oder [GitHub-Diskussionen](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - stellen Sie Ihre Fragen an die Community! +{% endhint %} + +*** + +## 🖥️ Befehle + +> Befehle ermöglichen es, Informationen im Spiel zu sammeln oder die Spielerfahrung anzupassen. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Berechtigungen + +> Berechtigungen legen den Bereich fest, in dem Spieler interagieren können. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumente und Eigenschaften + +> Argumente und Eigenschaften beeinflussen die Funktionsweise von Plazma umfassend. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguration + +> Die Konfiguration ist der grundlegendste Weg, Plazma anzupassen. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/de/origin/plazma/administration/reference/arguments.md b/de/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..cc7f1c134 --- /dev/null +++ b/de/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Erfahren Sie mehr über Startargumente und Systemeigenschaften. +--- + +# 🎛️ Argumente und Eigenschaften + +Die Startargumente und Systemeigenschaften sind Werte, die an den Befehl angehängt werden, der zur Ausführung von Plazma verwendet wird[^1], und beeinflussen insgesamt die Funktionsweise von Plazma. + +[Anweisungsposition](#user-content-fn-2)[^2] wird in **Startargumente** und **Systemeigenschaften** unterteilt. + +*** + +## Systemeigenschaft + +Systemeigenschaften werden vor dem Start von Plazma vor der Initialisierung in der JVM eingegeben. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Verwendung + +Systemeigenschaften werden als Java-Befehlsargumente zwischen `java` und `-jar` eingegeben. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` zeigt an, dass das Argument nicht in die JVM integriert ist, sondern ein eigenes Argument für Plazma ist und + +Wenn keine Werte für Eigenschaften eingegeben werden, wird der Wert auf [`true` festgelegt](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Alle Systemeigenschaften + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktualisiert das verwendete veraltete Schildformat. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für Entitätsinformationen. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die NMS-Revision, um Debug-Informationen in der IDE korrekt zu laden und aktualisiert automatisch die interne Versionsinformation. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert das Watchdog-Warnsystem von Spigot. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Bestätigungsnachricht des `/reload`-Befehls. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Wenn Sie ein Plugin-Entwickler sind und Ihr Plugin aktualisieren müssen, verwenden Sie anstelle von `/reload` das Hotswap. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert Plugins, die das Standard-Ein-/Ausgabesystem verwenden. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Warnt, wenn veraltete Formatierungen in Chat-Komponenten erkannt werden. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Überprüfung der Musterübereinstimmung des Servers, wenn ein Spieler eine Verbindung herstellt. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für fehlende Schlüssel in NBT-Objekten. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für ungültige Schädelprofile. + +Dies protokolliert alle fehlerhaften Schädelblöcke in der Welt mit ihren Positionen. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert das Klassenpriorisierungssystem für Plugins. + +Nützlich, wenn Probleme mit Plugin-Schatten auftreten. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert das Netty Flush-Konsolidierungssystem. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Standardwert**: `750` + +Teilt Entitäten in mehrere Pakete auf, wenn sie den angegebenen Wert überschreiten. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Standardwert**: `8192` + +Legt die maximale Paketgröße fest, die der Server auf einmal empfangen kann. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Java-Versionüberprüfung. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Dies kann zu dauerhaften Schäden an Dateien wie der Welt und zu einem Zusammenbruch des gesamten Spielmechanismus führen. + +Alle Probleme, die durch diese Maßnahme entstehen, liegen in Ihrer Verantwortung, und Plamza leistet keine Unterstützung dafür. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Standardwert**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Standardwert**: `80` + +Legt die maximale Länge eines Textes auf einem Schild fest. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Standardwert**: `(Weltversion) + 1` + +Legt die Version der zuerst zu initialisierenden Welt-Update-Informationen fest. + +Nützlich, wenn eine große Anzahl von Chunks aktualisiert werden muss, aber in anderen Fällen nicht verwendet wird. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Standardwert**: `True` + +Aktiviert die Verarbeitung von Kommentaren in YAML-Dateien standardmäßig. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Standardwert**: `30` + +Wenn ein Spieler für die angegebene Zeit (in Sekunden) keine Daten sendet, wird der Spieler gekickt. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Ignoriert Kommentare in den Servereigenschaften. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für synchronisierte Chunk-Loads. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert das Standard-Chunk-Schreibsystem von Minecraft. + +Dies führt dazu, dass jeder Chunk nacheinander gespeichert wird, was zu erheblicher Leistungseinbuße führt. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert das explizite Flushen des Netzwerkkanals. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Protokolliert immer Fehler, die nicht im Hauptthread auftreten. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Gibt eine Warnung aus, wenn geplante Aufgaben eine übermäßige Verzögerung aufweisen. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Wendet nur Patches an, ohne den Server zu starten, wenn das Standardausführungsprogramm verwendet wird. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Standardwert**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +Stärkere Optimierung der anfänglichen Konfiguration. + +Wenn aktiviert, wird der Server schneller und sicherer, kann jedoch das Gameplay stark beeinflussen. + +#### `Plazma.disableConfigOptimization` + +- **Typ**: `Boolean` +- **Standardwert**: `false` +- **Konflikt**: `Plazma.aggressiveOptimize` + +Keine Optimierung der anfänglichen Konfiguration. + +Führt zur Verwendung der Standardkonfiguration von Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Standardwert**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Typ**: `Boolean` +- **Standardwert**: `false` + +Deaktiviert das Plazma-Branding und verwendet das standardmäßige Server-Favicon von Vanille. + +#### `Plazma.useVanillaConfiguration` + +- **Typ**: `Boolean` +- **Standardwert**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Dies kann die Server-Sicherheit und Leistung erheblich beeinträchtigen. + +Alle Probleme, die durch diese Eigenschaft entstehen, liegen in der Verantwortung des Serveradministrators. +{% endhint %} + +Bietet die anfängliche Konfiguration mit den Standardwerten von Mojang an. + +Hebt alle von Paper durchgeführten Sicherheitslückenpatches auf. + +Sicherheitslückenpatches können in der Paper- oder Plazma-Konfiguration wieder aktiviert werden. + +#### `Plazma.vanillaize` + +- **Typ**: `Boolean` +- **Standardwert**: `true` +- **Konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Stellt die anfängliche Konfiguration näher an Vanille an. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Das Eigenschaft wurde eingestellt + +Die folgenden Systemeigenschaften sind eingestellt + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Standardwert**: `false` +- **Eingestellt**: Timings wurden seit der Entfernung aus Plazma + +Entscheidet, ob der Wert, der an Aikars Timings API gesendet werden kann, überschritten werden kann. + +Wenn dies trotzdem nicht von der API behandelt wird, wird eine Ratenbegrenzung angewendet. + +*** + +## Startargument + +Das Startargument wird nach `-jar *.jar` eingegeben und wird von Plazma initialisiert und gemeinsam verarbeitet. + +### Verwendung + +Systemeigenschaften werden als Programmargumente nach `-jar *.jar` eingegeben. + +Wenn beispielsweise das Startargument `nogui` angewendet werden soll,\ +geben Sie wie folgt ein, damit Plazma das Argument `nogui` während der Initialisierung verarbeitet. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Gesamtes Startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standardwert**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Standardwert**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Standardwert**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Startet den Server mit der Demo-Welt. + +#### `eraseCache` + +Entfernt übrig gebliebene Cache-Dateien nach dem Welt-Upgrade. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Gibt alle Startargumente und Erklärungen von Plazma aus. + +#### `initSettings` + +Erstellt nur die Konfigurationsdatei und beendet den Server. + +#### `jfrProfile` + +Aktiviert die JFR-Profilerstellung. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standardwert**: `(Servereigenschaft)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Deaktiviert das grafische Benutzeroberflächenpanel. + +#### `nojline` + +Deaktivieren Sie JLine und verwenden Sie die Vanille-Konsole. + +#### `online-mode` + +- **Alias**: `o` +- **Standardwert**: `(Servereigenschaft)` + +Wählen Sie aus, ob Spieler über den Mojang-Authentifizierungsserver überprüft werden sollen. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardwert**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Legt den Speicherort der deaktivierten PaperSpigot-Konfigurationsdatei fest. + +Dies wird verwendet, um vorhandene Konfigurationen in eine neue Konfigurationsdatei zu migrieren und wird danach nicht mehr verwendet. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardwert**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Standardwert**: `plugins` + +Legt den Speicherort des Plugin-Ordners fest. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardwert**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardwert**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Startet den Server im sicheren Modus, um einen vollständig Vanille-Status zu gewährleisten. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standardwert**: `(Servereigenschaft)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standardwert**: `(Servereigenschaft)` + +Legt den Port des Servers fest. + +#### `server-name` + +- **Standardwert**: `Ein Plazma-Server` + +Legt den Namen des Servers fest. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardwert**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Gibt die Plazma-Version aus. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardwert**: `(Serverordner)` + +Legt den Speicherort der Weltdateien fest. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standardwert**: `(Servereigenschaft)` + +Legt den Namen der Weltdateien fest. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Die Verarbeitung von Argumenten ändert sich je nach angehängtem Ort. + +[^3]: Wenn Sie beispielsweise `Plazma.iKnowWhatIAmDoing` auf `true` setzen möchten, funktioniert dies genauso, wenn Sie nur `-DPlazma.iKnowWhatIAmDoing` anstelle von `-DPlazma.iKnowWhatIAmDoing=true` eingeben. + +[^4]: Zum Beispiel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event-Detektor. + +[^6]: Event-Detektor. + +[^7]: Client. + +[^8]: Ein Signal, das anzeigt, dass der Server ordnungsgemäß mit dem Herzschlag verbunden ist. + +[^9]: Mit der AFK-Kick-Funktion von Purpur können auch abwesende Spieler gekickt werden. + +[^10]: Synchrones Chunk-Schreibsystem, Sync Chunk Write System. + +[^11]: `WARNUNG! Plazma kann unerwartete Probleme verursachen, daher sollten Sie es vor der Verwendung auf einem öffentlichen Server gründlich testen.` + +[^12]: Das `Welt-Optimieren` im Spiel funktioniert nach dem gleichen Prinzip. + +[^13]: `Level 2` und höher sind ausgenommen. + +[^14]: Internetprotokoll, IP. diff --git a/de/origin/plazma/administration/reference/commands.md b/de/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..3ebc1bee3 --- /dev/null +++ b/de/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über die Befehle, die in Plazma verfügbar sind. +--- + +# 🖥️ Befehle diff --git a/de/origin/plazma/administration/reference/configurations/README.md b/de/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..3f75e113f --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Die Konfiguration ist der grundlegendste Weg, Plazma anzupassen. +--- + +# 🧾 구성 + +*** + +## 🪨 Eigenschaften + +> Eigenschaften sind die grundlegendste Konfigurationsdatei, die von Minecraft bereitgestellt wird. Durch die Verwendung von Eigenschaften können grundlegende Mechanismen des Spiels geändert werden. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit-Konfiguration + +> Die Bukkit-Konfiguration ist die grundlegendste Konfigurationsdatei, die von Plazma bereitgestellt wird. Durch die Verwendung der Bukkit-Konfiguration können grundlegende Mechanismen des Minecraft-Servers geändert werden. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot-Konfiguration + +> Die Spigot-Konfiguration ermöglicht es, die detaillierten Mechanismen des Spiels, die Spielerinteraktionen, Befehle usw. zu ändern und Nachrichten anzupassen. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper-Konfiguration + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfisch + +> Die Pufferfisch-Konfiguration ermöglicht es, die Verarbeitung von Welten und Entitäten in Plazma zu ändern. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur-Konfiguration + +> Die Purpur-Eigenschaften ermöglichen es, die grundlegenden Spielsdaten zu ändern. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma-Konfiguration + +> Die Plazma-Konfiguration ermöglicht es, die Funktionen von Plazma anzupassen. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/de/origin/plazma/administration/reference/configurations/bukkit.md b/de/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..467c78617 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in der bukkit.yml bedeutet. +--- + +# 🪣 Bukkit diff --git a/de/origin/plazma/administration/reference/configurations/paper/README.md b/de/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..47c4c3c62 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each file in the config folder is for. +--- + +# 🛩️ Papier diff --git a/de/origin/plazma/administration/reference/configurations/paper/global.md b/de/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..ce63676ee --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ermitteln Sie, was jeder Knoten in paper-global.yml bedeutet. +--- + +# 🌏 전역 구성 diff --git a/de/origin/plazma/administration/reference/configurations/paper/world.md b/de/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..885ca2ab9 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Erfahren Sie, was jeder Knoten in paper-world.yml bedeutet. +--- + +# 🏳️ 세계별 구성 + +Weltweit diff --git a/de/origin/plazma/administration/reference/configurations/plazma/README.md b/de/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..3be99c78d --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each file in the config folder is for. +--- + +# ✨ Plazma diff --git a/de/origin/plazma/administration/reference/configurations/plazma/global.md b/de/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..ba6908d86 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in plazma-global.yml bedeutet. +--- + +# 🌏 전역 구성 diff --git a/de/origin/plazma/administration/reference/configurations/plazma/world.md b/de/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..039052bca --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in plazma-world.yml bedeutet. +--- + +# 🏳️ 세계별 구성 diff --git a/de/origin/plazma/administration/reference/configurations/plazma/worlds.md b/de/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..616f59ff1 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in plazma-world.yml bedeutet. +--- + +# ✨ Plazma (Zusammensetzung nach Welt) diff --git a/de/origin/plazma/administration/reference/configurations/property.md b/de/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..c9b13690c --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in server.properties bedeutet. +--- + +# 🪨 Server.properties diff --git a/de/origin/plazma/administration/reference/configurations/pufferfish.md b/de/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..1ae93b12e --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in pufferfish.yml bedeutet. +--- + +# 🐡 Kugelfisch diff --git a/de/origin/plazma/administration/reference/configurations/purpur/README.md b/de/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..97cf1a6e5 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in purpur.yml bedeutet. +--- + +# 🦑 Purpur diff --git a/de/origin/plazma/administration/reference/configurations/purpur/global.md b/de/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..227458fd2 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in purpur.yml bedeutet. +--- + +# 🌏 전역 구성 diff --git a/de/origin/plazma/administration/reference/configurations/purpur/world.md b/de/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..59e33737c --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in purpur.yml bedeutet. +--- + +# 🏳️ 세계별 구성 diff --git a/de/origin/plazma/administration/reference/configurations/spigot.md b/de/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..c539a5759 --- /dev/null +++ b/de/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in der spigot.yml bedeutet. +--- + +# 🚰 Spigot diff --git a/de/origin/plazma/administration/reference/permissions.md b/de/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..a74054810 --- /dev/null +++ b/de/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Erfahren Sie mehr über die Berechtigungen von Plazma. +--- + +# 🛡️ Berechtigungen + +Berechtigungen sind ein einfaches Sicherheitstool, das den Bereich festlegt, in dem sich Server-Player interagieren können. + +Um Berechtigungen ordnungsgemäß zu nutzen und einfach zu bearbeiten, müssen Sie Plugins wie [LuckPerms](https://luckperms.net) verwenden. + +*** + +## Verständnis des Standardberechtigungssystems + +In Minecraft gibt es grundlegende Verwaltungsrechtegruppen. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Spieler**\ + Normalerweise die Standardberechtigungsgruppe für alle Spieler. +2. **Vermittler**\ + Kann den Spawnschutz ignorieren. +3. **Welt-Administrator**\ + Kann alle Befehle und Befehlsblöcke im Zusammenhang mit der Weltverwaltung verwenden.\ + Standardberechtigungsgruppe für Datapacks und Befehlsblöcke. +4. **Administrator**\ + Kann alle Befehle im Zusammenhang mit der Spielerverwaltung verwenden. +5. **Hauptadministrator**\ + Kann alle Befehle einschließlich Serververwaltung verwenden.\ + Standardberechtigungsgruppe für Konsole und Operatoren. + +*** + +## Berechtigungen einstellen + +*** + +## Alle Berechtigungen + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, sich zu ducken und mit Entitäten zu interagieren, um auf sie zu steigen. + +Wenn Sie auf eine Entität steigen, können Sie ihre Bewegung mit den `Bewegungstasten` steuern und mit der `Sprungtaste` springen oder fliegen. + +Der `(Namespaced Key)` ist die [Namespaced ID](#user-content-fn-2)[^2] der Entität. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, die auf einem Entity reiten, die Spezialfähigkeiten des Entity zu nutzen. + +Nicht alle Spezialfähigkeiten aller Entities sind verfügbar. Für eine Liste aller verfügbaren Spezialfähigkeiten siehe unten. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Veröffentlichen Sie Ihre Ideen auf [Plazma Discord](https://plazmamc.org/discord) oder [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Verfügbare Spezialfähigkeiten anzeigen + +- **`crepper`**\ + Drücken Sie die `Sprungtaste`, um zu explodieren.\ + Wenn ein Spieler die Berechtigung `allow.powered.creeper` hat, kann er die `Sprungtaste` gedrückt halten, um aufzuladen. +- **`dolphin`**\ + Drücken Sie die `Sprungtaste`, um zu sprinten. +- **`phantom`**\ + Drücken Sie die `Sprungtaste`, um Feuerbälle zu schießen. +- **`wither`**\ + Durch `Interaktion` wird der Wither-Schädel abgefeuert. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/credits (Spieler)`](commands.md#credits). + +Durch Eingabe von `.other` hinter dem Berechtigungsnamen wird die Verwendung für andere Spieler ermöglicht. + +#### `bukkit.command.demo` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/demo (Spieler)`](commands.md#demo). + +Durch Eingabe von `.other` hinter dem Berechtigungsnamen wird die Verwendung für andere Spieler ermöglicht. + +#### `bukkit.command.ping` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/ping (Spieler)`](commands.md#ping). + +Durch Eingabe von `.other` hinter dem Berechtigungsnamen wird die Verwendung für andere Spieler ermöglicht. + +#### `bukkit.command.ram` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/rambar (Spieler)`](commands.md#rambar). + +Durch Eingabe von `.other` hinter dem Berechtigungsnamen wird die Verwendung für andere Spieler ermöglicht. + +#### `bukkit.command.restart` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/tpsbar (Spieler)`](commands.md#tpsbar). + +Durch Eingabe von `.other` hinter dem Berechtigungsnamen wird die Verwendung für andere Spieler ermöglicht. + +#### `bukkit.command.timings` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Für ähnliche Funktionen siehe [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- Standardmäßig: `Welt-Manager` + +Erlaubt die Verwendung des Befehls `/gamemode (GameMode) (Spieler)`. + +Durch Eingabe von `.other` hinter dem Berechtigungsnamen wird die Verwendung für andere Spieler ermöglicht. + +#### `paper.antixray.bypass` + +- **Standardmäßig**: `Nichts` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Dadurch können beide Seiten Leistungsverbesserungen erfahren. + +> Für Informationen zur X-Ray-Einstellung siehe die folgende Seite. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Standardmäßig**: `Nichts` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Standardmäßig**: `Nichts` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Standardmäßig**: `Nichts` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Standardmäßig**: `Nichts` + +Ermöglicht die Verwendung von [MiniMessage-Tags](https://docs.advntr.dev/minimessage/format.html) auf dem Amboss. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Standardmäßig**: `Nichts` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Standardmäßig**: `Nichts` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Standardmäßig**: `Nichts` + +Schließt den Spieler von der Ausweisung im Leerlauf aus. + +#### `purpur.debug.f3n` + +- Standardmäßig: `Welt-Manager` + +Erlaubt es Spielern, den Spielmodus mit `F3 + N` zu ändern. + +Funktioniert nicht, wenn die Berechtigung für diesen Spielmodus fehlt. + +#### `purpur.drop.spawners` + +- **Standardmäßig**: `Nichts` + +Wenn Sie mit dem im Setup festgelegten Gegenstand einen Spawner abbauen, fällt der Spawner heraus. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Standardmäßig**: `Nichts` + +Ändert die Größe der Endertruhe. + +Für `(NumberString)` können `one`, `two`, `three`, `four`, `five`, `six` eingegeben werden. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Standardmäßig**: `Nichts` + +Erlaubt es, dass der Totem der Unsterblichkeit auch funktioniert, wenn er sich im Inventar befindet. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, die Verbindung zu einem vollen Server herzustellen, ohne die Spielerbeschränkung zu beachten. + +#### `purpur.mending_shift_click` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, ein gehaltenes Element zu reparieren, wenn sie `sneak + right-click` ausführen. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, Spawner zu platzieren. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Standardmäßig**: `Nichts` + +Bewirkt, dass Spieler sofort teleportiert werden, wenn sie das Nether-Portal benutzen. + +#### `purpur.sign.color` + +- **Standardmäßig**: `Nichts` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Standardmäßig**: `Nichts` + +Ermöglicht die Verwendung des Verwirrungscode `(&o)` auf Schildern. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Standardmäßig**: `Nichts` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, durch `Interaktion mit einer Schere` eine TNT-Explosion zu verhindern. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Geplante Berechtigung + +#### `plazma.bypass.ncr-require` + +- **Standardmäßig**: `Nichts` + +Ermöglicht es Spielern, sich auch ohne installierten [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) Modus zu verbinden. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Zum Beispiel: `ender_dragon` diff --git a/de/origin/plazma/adminstration/README.md b/de/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..d99e7a8d1 --- /dev/null +++ b/de/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Erstellen Sie Ihren eigenen Server mit Plazma. +--- + +# ⚒️ Server-Verwaltungsleitfaden diff --git a/de/origin/plazma/adminstration/expert/README.md b/de/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b38b88e8b --- /dev/null +++ b/de/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über die professionelle Handhabung von Plazma. +--- + +# 🎓 Vertiefung diff --git a/de/origin/plazma/adminstration/expert/fix-exploits.md b/de/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..993055823 --- /dev/null +++ b/de/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über bekannte Sicherheitslücken und wie man sie behebt. +--- + +# ⚠️ Bekannte Sicherheitslücken und Lösungsmethoden diff --git a/de/origin/plazma/adminstration/expert/optimize.md b/de/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..0400ab04a --- /dev/null +++ b/de/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, wie Sie Plazma optimieren können. +--- + +# 🧹 Optimierung diff --git a/de/origin/plazma/adminstration/expert/vanillaize.md b/de/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..5e1746524 --- /dev/null +++ b/de/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Erfahren Sie, wie Sie das Paper- und Vanille-Patch wiederherstellen können. +--- + +# ↩️ Vanilleisierung + +{% Hinweis Stil="Warnung" %} + +### Paper bietet keine Optionen für die meisten Patches zur Behebung von Fehlern in Vanille. + +Plazma entwickelt derzeit eine Konfiguration, um solche Fehlerbehebungen zu deaktivieren. + +Daher ist dieser Leitfaden noch in Bearbeitung und die Informationen können sich jederzeit ändern. +{% endhint %} diff --git a/de/origin/plazma/adminstration/faq.md b/de/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..9831f2d24 --- /dev/null +++ b/de/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Erfahren Sie mehr über häufig gestellte Fragen. +--- + +# ⁉️ Häufig gestellte Fragen + +{% Hinweis-Stil="info" %} + +### Konnten Sie die gewünschte Antwort nicht finden? + +Fragen Sie die Community über den [offiziellen Discord-Server](https://discord.gg/MmfC52K8A8) oder [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Es wird eine Meldung angezeigt, aber das Programm wird nicht ausgeführt. + +Wenn in der Konsole `no main manifest attribute, in plazma-(version).jar` angezeigt wird,\ +dann haben Sie die Entwicklungs-API-Datei heruntergeladen und müssen **Reobf Paperweight** von der GitHub-Seite herunterladen. + +Für weitere Informationen siehe die folgende Seite. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Eine Warnung wird jedes Mal angezeigt, wenn der Server gestartet wird. + +Plazma enthält einige instabile Patches und kann daher möglicherweise fehlerhaft funktionieren. Daher werden beim Start des Servers folgende Warnungen angezeigt. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Diese Warnungen können mit dem Systemattribut [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] deaktiviert werden. + +Für weitere Informationen siehe die folgende Seite. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Ab Version 1.20.1 verfügbar diff --git a/de/origin/plazma/adminstration/getting-started/README.md b/de/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..41f4290c5 --- /dev/null +++ b/de/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Erfahren Sie, wie Sie einen Server mit Plazma erstellen. +--- + +# 👟 Los geht's + +Um Plazma stabil zu nutzen, muss das System die folgenden Anforderungen erfüllen. + +| | Minimum | Empfohlen | +| :-----------: | ------: | --------: | +| Architektur | x64 | - | +| RAM | 8GB | 16GB | +| Speicherplatz | 1GB | 8GB | +| JRE | 17 | 21 | + +Für eine reibungslose Konfigurationsdateibearbeitung ist es auch ratsam, einen Editor wie [Visual Studio Code](https://code.visualstudio.com/download) zu installieren. + +*** + +## 1. JRE Installation + +Wie der Name schon sagt, wird Minecraft: **"Java"** Edition in Java entwickelt und erfordert daher JRE[^1] zur Ausführung. + +Da Plazma auf der offiziellen Serverplattform von Mojang Studios basiert[^2], muss auch JRE installiert werden, um Plazma zu verwenden. + +### 1.1 Überprüfung der JRE-Installation + +Um zu überprüfen, ob JRE auf dem System installiert ist, geben Sie [`cmd /k java --version`](#user-content-fn-4)[^4] in das Ausführungsfenster ein und führen Sie es aus. + +Wenn die Ausgabe wie folgt aussieht, überspringen Sie [Schritt 2](setup.md#id-2). + +{% code title="Korrekte Ausgabe" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Wenn dies nicht der Fall ist oder wenn die Ausgabe wie folgt aussieht, ist JRE nicht vorhanden oder zu alt, und Sie müssen [Schritt 1.2](setup.md#id-1.2) ausführen. + +{% code title="JRE nicht installiert" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE zu alt" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE-Installation + +In diesem Handbuch verwenden wir Azul Zulu als eine der [JRE-Varianten](#user-content-fn-5)[^5]. + +Überprüfen Sie nach Abschluss der Installation erneut [Schritt 1.1](setup.md#id-1.1), um sicherzustellen, dass die Installation korrekt abgeschlossen wurde. + +{% tabs %} +{% tab title="Windows" %} + +1. Laden Sie zuerst [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) herunter und installieren Sie **JDK 21** im `.msi`-Format. +2. Führen Sie den heruntergeladenen Installationsassistenten aus und klicken Sie auf `Next`. +3. Aktivieren Sie im mittleren linken Bereich des Fensters `Set JAVA_HOME variable` und klicken Sie dann auf `Next`. +4. Klicken Sie auf `Install`, um die JRE-Installation abzuschließen. + {% endtab %} + +{% tab title="macOS" %} +Laden Sie von [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) den **JDK 21** im `.dmg`-Format herunter und installieren Sie JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Fügen Sie zuerst das Azul Zulu-Repository zu APT hinzu, indem Sie den folgenden Befehl im Terminal ausführen. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Führen Sie dann den folgenden Befehl im Terminal aus, um JRE zu installieren. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Sie können JRE mit dem folgenden Befehl installieren. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma herunterladen + +Plazma bietet verschiedene Arten von ausführbaren Dateien an. + +{% Hinweis Stil="Warnung" %} + +### In den meisten Fällen wird `Reobf Paperclip` verwendet. + +Die folgenden Informationen sind für Entwickler oder diejenigen gedacht, die sich für die Eigenschaften der verschiedenen Arten interessieren.\ +Für normale Benutzer ist es nicht erforderlich, [Schritt 3](setup.md#id-3) zu lesen. +{% endhint %} + +
+ +Weitere Informationen + +Der Name der ausführbaren Datei ist `plazma-(Version Manager)-1.20.4-R0.1-SNAPSHOT-(Mapping Typ).jar`. + +- **Mapping Typ**\ + Mapping ist eine Art Karte, die den echten Code von Minecraft mit dem obfuszierten Code verbindet. + - **Reobf**\ + Reobfuscation, auch bekannt als Spigot Mapping, wird hauptsächlich von den meisten NMS-Plugins verwendet.\ + Es wird ab Version 1.20.5 nicht mehr unterstützt. + - **Mojmap**\ + Mojang Mapping, das Mapping für das Vanilla Minecraft. +- **Version Manager**\ + Der Version Manager ist eine Art Launcher, der die für den Serverbetrieb erforderlichen Bibliotheken bereitstellt und Serverdateien patcht. + - **Paperclip**\ + Ein Administrator, den das PaperMC-Team für Paper und andere abgeleitete Plattformen entwickelt hat. Es lädt Bibliotheken herunter und wendet Patches auf den Server an. + - **Bundler**\ + Der Version Manager für Vanilla Minecraft. + +
+ +*** + +## 3. Startskript erstellen + +Um Plazma einfach zu starten und den Server automatisch neu zu starten, müssen Sie ein [Startskript](#user-content-fn-6)[^6] erstellen. + +Sie können das Startskript über [Flags.sh](https://flags.sh) erstellen. Geben Sie einfach die [zu verwendende Speichermenge](#user-content-fn-8)[^8] für Plazma ein, und der Befehl wird automatisch optimiert. + +Sie können das Startskript über den Download-Button unten links herunterladen.\ +**Stellen Sie sicher, dass das heruntergeladene Startskript mit Ihrem Betriebssystem übereinstimmt.** + +*** + +## 4. Dateien ordnen + +Verschieben Sie das heruntergeladene Startskript und Plazma in einen neuen Ordner. + +{% Hinweis Stil="Warnung" %} + +### Der Ordnername darf keine Leerzeichen enthalten und muss auf Englisch festgelegt sein. + +Andernfalls funktionieren Plazma oder JRE möglicherweise nicht ordnungsgemäß. +{% endhint %} + +Führen Sie nun das Startskript aus. Für Windows müssen Sie im Firewall-Zugriffsauswahlfenster unbedingt **Zulassen** auswählen. + +*** + +## 5. EULA-Zustimmung + +Nach dem Ausführen des Startskripts wird eine `eula.txt`-Datei im Ordner erstellt. + +Die EULA[^9] ist ein Endbenutzer-Lizenzvertrag, dem Sie zustimmen müssen, um die Dienste von [Mojang Studios](#user-content-fn-10)[^10] zu nutzen. + +Ohne Zustimmung zur EULA können Sie den Server nicht starten, und bei Verstoß gegen die EULA können Maßnahmen wie Kontosperrung ergriffen werden. [^11] + +Um der EULA zuzustimmen, ändern Sie `eula=false` in der `eula.txt`-Datei in `eula=true` und speichern Sie die Änderungen. + +*** + +## 6. Externe Verbindungen zulassen (Windows) + +Moderne Betriebssysteme blockieren standardmäßig externe Zugriffe, um vor Gefahren zu schützen, indem sie die Firewall und den Router verwenden. + +Da Sie in Schritt 3 die Windows-Firewall bereits zugelassen haben, müssen Sie nur noch Port-Weiterleitungen einrichten. + +{% Hinweis-Stil="info" %} + +### Dieser Leitfaden geht davon aus, dass Sie ein Windows-Betriebssystem und einen Router mit [**UPnP**](#user-content-fn-12)[^12]-Unterstützung verwenden. + +Wenn Ihr Router UPnP nicht unterstützt, müssen Sie je nach Routermodell Informationen suchen. + +Alternativ können Sie auch [Ngrok](https://ngrok.com/) verwenden, um eine temporäre Adresse zu generieren. +{% endhint %} + +{% Hinweis Stil="Warnung" %} + +### Für Betriebssysteme der (halb-)UNIX-Familie wie Linux oder macOS müssen Sie die Einstellungen für die Firewall-Dienste je nach Service separat überprüfen. + +{% endhint %} + +### 6.1 Überprüfung der Notwendigkeit von Port-Weiterleitungen + +Geben Sie Folgendes in das Ausführungsfenster ein und führen Sie es aus. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Wenn die Ausgabe `True` ist, sind keine weiteren Maßnahmen erforderlich. Wenn die Ausgabe `False` ist, müssen Port-Weiterleitungen festgelegt werden. + +### 6.2 Serververbindung + +{% tabs %} +{% tab title="Externe Verbindung" %} +Wenn keine Port-Weiterleitungen erforderlich sind oder diese bereits erfolgreich eingerichtet wurden, können Sie jetzt eine Verbindung zum Server herstellen. + +Die Adresse, die zum Verbinden mit dem Server verwendet wird, finden Sie [hier](https://ip.pe.kr/) heraus. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +In der `purpur.yml`-Datei des Serverordners aktivieren Sie `network.upnp-port-forwarding` auf `true`. + +Danach, wenn Sie den Server neu starten, versucht Plazma automatisch Portweiterleitung. + +Die folgende Meldung auf der Konsole zeigt den Erfolg oder Misserfolg von UPnP an, und in der Konsole wird `[UPnP] (Nachricht)` angezeigt. + +| Nachricht | Bedeutung | +| ---------------------------------------- | ---------------------------------------------- | +| `Port (포트)` erfolgreich geöffnet | Portweiterleitung erfolgreich. | +| `Port (포트) ist bereits geöffnet` | Ein anderer Dienst verwendet den Port bereits. | +| `Port (포트) konnte nicht geöffnet werden` | Portweiterleitung fehlgeschlagen. | +| `Dienst ist nicht verfügbar` | Der Router unterstützt kein UPnP. | + +Wenn der Server heruntergefahren wird, schließt Plazma die Ports automatisch. +{% endtab %} + +{% tab title="Vorübergehende Adresse mit Ngrok erstellen" %} +Die Verwendung von Ngrok ist nützlich für kurzfristige Tests, gemeinsames Spielen oder Spielen mit Freunden. + +1. Laden Sie die `Windows (64-bit)` ZIP-Datei von der [Ngrok-Website](https://ngrok.com/download) herunter. +2. Legen Sie das heruntergeladene Ngrok in den Serverordner. +3. Erstellen Sie auf dem [Ngrok-Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) einen [Authentifizierungstoken](#user-content-fn-13). +4. Führen Sie den im Serverordner angezeigten Befehl in der `Command Line` aus. +5. Fügen Sie dem Ausführungsskript `start /b ngrok tcp --region jp 25565` am Anfang und `taskkill /f /t /im ngrok.exe` am Ende hinzu. +6. In der Konsole wird `Weiterleitung tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` angezeigt, wobei `0.tcp.jp.ngrok.io:12345` die Adresse des Servers ist. +7. Jetzt können Sie über diese Adresse von extern auf den Server zugreifen. + {% endtab %} + +{% tab title="Lokaler Zugriff" %} +Wenn Sie auf den Server lokal zugreifen möchten, können Sie nach Ausführen von `cmd /k ipconfig` im Ausgabefenster die `IPv4-Adresse` verwenden. + +Beispielsweise, wenn nach Ausführung des Befehls Folgendes angezeigt wird: + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Versuchen Sie, sich mit der im IPv4-Adressfeld angezeigten `192.168.3.7` zu verbinden, um lokal auf den Server zuzugreifen. + +Wenn Server und Spiel auf demselben PC ausgeführt werden, können Sie sich mit `localhost` verbinden. +{% endtab %} +{% endtabs %} + +## 7. Entwicklungsphase + +Wenn der Server erfolgreich gestartet wurde und ordnungsgemäß funktioniert, ist es jetzt an der Zeit, den Server anzupassen. + +Erfahren Sie, wie Sie den Server anpassen können, indem Sie den folgenden Leitfaden lesen. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java-Laufzeitumgebung, Java-Laufzeitumgebung. + +[^2]: Die auf Paper basierende Plazma basiert auf Spigot, das wiederum auf der offiziellen Serverplattform von Spigot basiert. + +[^3]: Windows-Taste + R + +[^4]: Für Linux verwenden Sie `java --version` im Terminal. + +[^5]: JRE ist ein Open-Source-Projekt mit verschiedenen Versionen, ähnlich wie die Minecraft-Serverplattform. + +[^6]: Es wird im Allgemeinen als **Launcher** bezeichnet. + +[^7]: Durch Aktivieren von "Auto-Neustart" wird der Server automatisch neu gestartet. Sie können `Strg + C` eingeben, um es zu beenden. + +[^8]: Es wird nicht empfohlen, mehr als die Hälfte des Systems zu verwenden. + + Beispielsweise wird bei einem Gesamtspeicher von 8 GB die Einstellung auf mehr als 4 GB nicht empfohlen. + +[^9]: Endbenutzer-Lizenzvereinbarung, Endbenutzer-Lizenzvereinbarung. Weitere Informationen finden Sie auf der [Minecraft-Website](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Gemäß Artikel 32 Absatz 1 Nummer 9 des Gesetzes über die Förderung der Spieleindustrie in Korea kann **Korea Microsoft Corporation** rechtlich belangt werden. + +[^12]: Universal Plug & Play. Durch das in Plazma enthaltene Purpur kommuniziert automatisch mit dem Router über diese Technologie, um die Ports nur zu öffnen, wenn der Server läuft, daher ist kein manuelles Portforwarding erforderlich. + +[^13]: Wenn Sie kein Konto haben, können Sie sich über ein Google- oder GitHub-Konto bei Ngrok anmelden. diff --git a/de/origin/plazma/adminstration/getting-started/customization.md b/de/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..fc69f30df --- /dev/null +++ b/de/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, wie Sie den Server anpassen können. +--- + +# 🎨 Anpassung für Benutzer diff --git a/de/origin/plazma/adminstration/reference/arguments.md b/de/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..e3da9c2bb --- /dev/null +++ b/de/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Erfahren Sie mehr über Startargumente und Systemeigenschaften. +--- + +# 🎛️ Argumente und Eigenschaften + +Startvariablen und Systemeigenschaften sind Werte, die an [Plazma-Befehle](#user-content-fn-1)[^1] angehängt werden, um Werte hinzuzufügen, die nach dem Start von Plazma nicht mehr geändert werden können. + +Je nach [Anhängestelle des Befehls](#user-content-fn-2)[^2] werden sie in **Startargumente** und **Systemeigenschaften** unterteilt. + +*** + +## Systemeigenschaft + +Systemeigenschaften werden vor dem Start von Plazma vor der Initialisierung in der JVM eingegeben. + +{% Hinweis Stil="Warnung" %} + +### Das Ändern von Systemeigenschaften kann das Verhalten von Plazma und der JVM ändern und sich erheblich auf das Spiel auswirken! + +Wenn Sie nicht sicher sind, welche Rolle jede Systemeigenschaft spielt, **verwenden Sie sie auf keinen Fall!** +{% endhint %} + +### Verwendung + +Systemeigenschaften werden als Java-Befehlsargumente zwischen `java` und `-jar` eingegeben. + +Wenn Sie beispielsweise die Systemeigenschaft `Plazma.dummyProperty` anwenden möchten, wird der Wert `37` wie folgt eingegeben, um die nachfolgende Eigenschaft zu initialisieren. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` zeigt an, dass das Argument nicht in die JVM integriert ist, sondern ein eigenes Argument für Plazma ist und + +wenn kein Wert angegeben wird, wird der Wert auf [`true` festgelegt.](#user-content-fn-3)[^3] + +{% Hinweis-Stil="info" %} + +### Die Paperweight-Serverplattformen enthalten einen Punkt im Eigenschaftsnamen, um die Systemeigenschaften für jede Plattform zu unterscheiden. + +In einigen Terminals wie Windows Powershell können diese Argumente möglicherweise nicht akzeptiert werden, daher müssen Sie `"` am Anfang und Ende des Arguments [hinzufügen.](#user-content-fn-4)[^4] +{% endhint %} + +### Alle Systemeigenschaften + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktualisiert das verwendete veraltete Schildformat. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für Entitätsinformationen. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die NMS-Revision, um Debug-Informationen in der IDE korrekt zu laden und aktualisiert automatisch die interne Versionsinformation. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert das Watchdog-Warnsystem von Spigot. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Bestätigungsnachricht des `/reload`-Befehls. + +{% hint style="danger" %} + +### Der `/reload`-Befehl ist äußerst instabil, daher liegt die volle Verantwortung für alle Probleme, die nach der Verwendung von `/reload` im Server auftreten, beim Benutzer. + +Wenn Sie ein Plugin-Entwickler sind und Ihr Plugin aktualisieren müssen, verwenden Sie anstelle von `/reload` das Hotswap. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert Plugins, die das Standard-Ein-/Ausgabesystem verwenden. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Warnt, wenn veraltete Formatierungen in Chat-Komponenten erkannt werden. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Überprüfung der Musterübereinstimmung des Servers, wenn ein Spieler eine Verbindung herstellt. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für fehlende Schlüssel in NBT-Objekten. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für ungültige Schädelprofile. + +Dies protokolliert alle fehlerhaften Schädelblöcke in der Welt mit ihren Positionen. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Begrenzung der Anzahl von Plugin-Kanälen pro Spieler auf 128. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert das Klassenpriorisierungssystem für Plugins. + +Nützlich, wenn Probleme mit Plugin-Schatten auftreten. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert das Netty Flush-Konsolidierungssystem. + +#### `Paper.excessiveTELimit` + +- **Typ**: `Integer` +- **Standardwert**: `750` + +Teilt Entitäten in mehrere Pakete auf, wenn sie den angegebenen Wert überschreiten. + +#### `Paper.filterThreshold` + +- **Typ**: `Integer` +- **Standardwert**: `8192` + +Legt die maximale Paketgröße fest, die der Server auf einmal empfangen kann. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Deaktiviert die Java-Versionüberprüfung. + +{% hint style="danger" %} + +### Dadurch kann die JVM auf nicht vorhandenen Code zugreifen! + +Dies kann zu dauerhaften Schäden an Dateien wie der Welt und zu einem Zusammenbruch des gesamten Spielmechanismus führen. + +Alle Probleme, die durch diese Maßnahme entstehen, liegen in Ihrer Verantwortung, und Plamza leistet keine Unterstützung dafür. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Typ**: `Integer` +- **Standardwert**: `64` + +Legt die Beschränkung für den Namen des Plugin-Kanals fest. + +#### `Paper.maxSignLength` + +- **Typ**: `Integer` +- **Standardwert**: `80` + +Legt die maximale Länge eines Textes auf einem Schild fest. + +#### `Paper.minPrecachedDatafixVersion` + +- **Typ**: `Integer` +- **Standardwert**: `(Weltversion) + 1` + +Legt die Version der zuerst zu initialisierenden Welt-Update-Informationen fest. + +Nützlich, wenn eine große Anzahl von Chunks aktualisiert werden muss, aber in anderen Fällen nicht verwendet wird. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Standardwert**: `True` + +Aktiviert die Verarbeitung von Kommentaren in YAML-Dateien standardmäßig. + +#### `Paper.playerConnection.keepAlive` + +- **Typ**: `Integer` +- **Standardwert**: `30` + +Wenn ein Spieler für die angegebene Zeit (in Sekunden) keine Daten sendet, wird der Spieler gekickt. + +Normalerweise sendet das Spiel[^7] weiterhin Herzschläge an den Server, sodass kein Kick erfolgt, wenn das Spiel nicht antwortet, wird angenommen, dass es abgestürzt ist und der Spieler wird gekickt. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Ignoriert Kommentare in den Servereigenschaften. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert Debug-Logs für synchronisierte Chunk-Loads. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert das Standard-Chunk-Schreibsystem von Minecraft. + +Dies führt dazu, dass jeder Chunk nacheinander gespeichert wird, was zu erheblicher Leistungseinbuße führt. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Aktiviert das explizite Flushen des Netzwerkkanals. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Protokolliert immer Fehler, die nicht im Hauptthread auftreten. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Gibt eine Warnung aus, wenn geplante Aufgaben eine übermäßige Verzögerung aufweisen. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Standardwert**: `False` + +Wendet nur Patches an, ohne den Server zu starten, wenn das Standardausführungsprogramm verwendet wird. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Standardwert**: `false` + +{% Hinweis Stil="Warnung" %} + +### Diese Eigenschaft wird in Zukunft als Startargument ab Version 1.20.5 verschoben werden. + +{% endhint %} + +Es werden strengere Konfigurationsoptimierungen angewendet, die beim ersten Start gelten. + +Wenn aktiviert, wird der Server schneller und sicherer, aber es kann einige Gimmicks blockieren oder sich stark auf das Spielerlebnis auswirken. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Standardwert**: `false` + +Unterdrückt die Warnmeldung[^11], die beim Initialisieren von Plazma angezeigt wird. + +### Das Eigenschaft wurde eingestellt + +Die folgenden Systemeigenschaften sind eingestellt + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Standardwert**: `false` +- **Eingestellt**: Timings wurden seit der Entfernung aus Plazma + +Entscheidet, ob der Wert, der an Aikars Timings API gesendet werden kann, überschritten werden kann. + +Wenn dies trotzdem nicht von der API behandelt wird, wird eine Ratenbegrenzung angewendet. + +*** + +## Startargument + +Das Startargument wird nach `-jar *.jar` eingegeben und wird von Plazma initialisiert und gemeinsam verarbeitet. + +### Verwendung + +Systemeigenschaften werden als Programmargumente nach `-jar *.jar` eingegeben. + +Wenn beispielsweise das Startargument `nogui` angewendet werden soll,\ +geben Sie wie folgt ein, damit Plazma das Argument `nogui` während der Initialisierung verarbeitet. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Gesamtes Startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standardwert**: `bukkit.yml` + +Legt Namen und Position der [Bukkit-Konfigurationsdatei](../reference/configurations/bukkit.md) fest. + +#### `command-settings` + +- **Alias**: `c` +- **Standardwert**: `commands.yml` + +Legt Namen und Position der [Bukkit-Befehlskonfigurationsdatei](../reference/configurations/bukkit.md) fest. + +#### `config` + +- **Alias**: `c` +- **Standardwert**: `server.properties` + +Legt Namen und Position der [Servereigenschaften](../reference/configurations/property.md) fest. + +#### `demo` + +Startet den Server mit der Demo-Welt. + +#### `eraseCache` + +Entfernt übrig gebliebene Cache-Dateien nach dem Welt-Upgrade. + +#### `forceUpgrade` + +Ignoriert die Version und führt ein [erzwungenes Upgrade](#user-content-fn-12)[^12] der Welt durch. + +#### `help` + +- **Alias**: `?` + +Gibt alle Startargumente und Erklärungen von Plazma aus. + +#### `initSettings` + +Erstellt nur die Konfigurationsdatei und beendet den Server. + +#### `jfrProfile` + +Aktiviert die JFR-Profilerstellung. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standardwert**: `(Servereigenschaft)` + +Legt die maximale Anzahl von [Spielern](#user-content-fn-14)[^14] fest, die erlaubt sind. + +#### `nogui` + +Deaktiviert das grafische Benutzeroberflächenpanel. + +#### `nojline` + +Deaktivieren Sie JLine und verwenden Sie die Vanille-Konsole. + +#### `online-mode` + +- **Alias**: `o` +- **Standardwert**: `(Servereigenschaft)` + +Wählen Sie aus, ob Spieler über den Mojang-Authentifizierungsserver überprüft werden sollen. + +**Bei Verwendung von Velocity oder anderen Proxys können Sanktionen gegen die [EULA](../getting-started/README.md#id-5) verhängt werden.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardwert**: `paper.yml` + +{% Hinweis Stil="Warnung" %} + +### Dieser Parameter wurde nach 1.19.4 eingestellt + +{% endhint %} + +Legt den Speicherort der deaktivierten PaperSpigot-Konfigurationsdatei fest. + +Dies wird verwendet, um vorhandene Konfigurationen in eine neue Konfigurationsdatei zu migrieren und wird danach nicht mehr verwendet. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardwert**: `config` + +Legt den Namen und Speicherort des Ordners fest, in dem die [Paper-Konfigurationsdatei](../reference/configurations/paper/README.md) gespeichert ist. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Legt den Namen und Speicherort des Ordners fest, in dem die [Plazma-Konfigurationsdatei](../reference/configurations/plazma/README.md) gespeichert ist. + +#### `plugins` + +- **Alias**: `p` +- **Standardwert**: `plugins` + +Legt den Speicherort des Plugin-Ordners fest. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardwert**: `pufferfish.yml` + +Legt Namen und Speicherort der [Pufferfish-Konfigurationsdatei](../reference/configurations/pufferfish.md) fest. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardwert**: `purpur.yml` + +Legt Namen und Speicherort der [Purpur-Konfigurationsdatei](../reference/configurations/purpur/README.md) fest. + +#### `safeMode` + +Startet den Server im sicheren Modus, um einen vollständig Vanille-Status zu gewährleisten. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standardwert**: `(Servereigenschaft)` + +Legt den Hostnamen des Servers oder die [Internetprotokoll](#user-content-fn-13)[^13]-Adresse fest. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standardwert**: `(Servereigenschaft)` + +Legt den Port des Servers fest. + +#### `server-name` + +- **Standardwert**: `Ein Plazma-Server` + +Legt den Namen des Servers fest. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardwert**: `spigot.yml` + +Legt Namen und Speicherort der [Spigot-Konfigurationsdatei](../reference/configurations/spigot.md) fest. + +#### `version` + +- **Alias**: `v` + +Gibt die Plazma-Version aus. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardwert**: `(Serverordner)` + +Legt den Speicherort der Weltdateien fest. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standardwert**: `(Servereigenschaft)` + +Legt den Namen der Weltdateien fest. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Die Verarbeitung von Argumenten ändert sich je nach angehängtem Ort. + +[^3]: Wenn Sie beispielsweise `Plazma.iKnowWhatIAmDoing` auf `true` setzen möchten, funktioniert dies genauso, wenn Sie nur `-DPlazma.iKnowWhatIAmDoing` anstelle von `-DPlazma.iKnowWhatIAmDoing=true` eingeben. + +[^4]: Zum Beispiel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event-Detektor. + +[^6]: Event-Detektor. + +[^7]: Client. + +[^8]: Ein Signal, das anzeigt, dass der Server ordnungsgemäß mit dem Herzschlag verbunden ist. + +[^9]: Mit der AFK-Kick-Funktion von Purpur können auch abwesende Spieler gekickt werden. + +[^10]: Synchrones Chunk-Schreibsystem, Sync Chunk Write System. + +[^11]: `WARNUNG! Plazma kann unerwartete Probleme verursachen, daher sollten Sie es vor der Verwendung auf einem öffentlichen Server gründlich testen.` + +[^12]: Das `Welt-Optimieren` im Spiel funktioniert nach dem gleichen Prinzip. + +[^13]: Internetprotokoll, IP. + +[^14]: `Level 2` und höher sind ausgenommen. diff --git a/de/origin/plazma/adminstration/reference/commands.md b/de/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..3ebc1bee3 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über die Befehle, die in Plazma verfügbar sind. +--- + +# 🖥️ Befehle diff --git a/de/origin/plazma/adminstration/reference/configurations/bukkit.md b/de/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..467c78617 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in der bukkit.yml bedeutet. +--- + +# 🪣 Bukkit diff --git a/de/origin/plazma/adminstration/reference/configurations/paper/README.md b/de/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..47c4c3c62 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each file in the config folder is for. +--- + +# 🛩️ Papier diff --git a/de/origin/plazma/adminstration/reference/configurations/paper/global.md b/de/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..331cdc1d7 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ermitteln Sie, was jeder Knoten in paper-global.yml bedeutet. +--- + +# 🛩️ Paper (globale Konfiguration) diff --git a/de/origin/plazma/adminstration/reference/configurations/paper/world.md b/de/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..5715c1a49 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in paper-world.yml bedeutet. +--- + +# 🛩️ Papier (Zusammensetzung nach Welt) diff --git a/de/origin/plazma/adminstration/reference/configurations/plazma/README.md b/de/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..3be99c78d --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each file in the config folder is for. +--- + +# ✨ Plazma diff --git a/de/origin/plazma/adminstration/reference/configurations/plazma/global.md b/de/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..7025db3b6 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in plazma-global.yml bedeutet. +--- + +# ✨ Plazma (Global Configuration) diff --git a/de/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/de/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..9aedaac89 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Weltweite Konfiguration diff --git a/de/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/de/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..616f59ff1 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in plazma-world.yml bedeutet. +--- + +# ✨ Plazma (Zusammensetzung nach Welt) diff --git a/de/origin/plazma/adminstration/reference/configurations/property.md b/de/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..c9b13690c --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in server.properties bedeutet. +--- + +# 🪨 Server.properties diff --git a/de/origin/plazma/adminstration/reference/configurations/pufferfish.md b/de/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..1ae93b12e --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in pufferfish.yml bedeutet. +--- + +# 🐡 Kugelfisch diff --git a/de/origin/plazma/adminstration/reference/configurations/purpur/README.md b/de/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..97cf1a6e5 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in purpur.yml bedeutet. +--- + +# 🦑 Purpur diff --git a/de/origin/plazma/adminstration/reference/configurations/purpur/global.md b/de/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..b605dc676 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in purpur.yml bedeutet. +--- + +# 🦑 Purpur (전역 구성) diff --git a/de/origin/plazma/adminstration/reference/configurations/purpur/world.md b/de/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..d75178dba --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in purpur.yml bedeutet. +--- + +# 🦑 Purpur (Weltzusammensetzung) diff --git a/de/origin/plazma/adminstration/reference/configurations/spigot.md b/de/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..c539a5759 --- /dev/null +++ b/de/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie, was jeder Knoten in der spigot.yml bedeutet. +--- + +# 🚰 Spigot diff --git a/de/origin/plazma/adminstration/reference/permissions.md b/de/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..15edf524d --- /dev/null +++ b/de/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Erfahren Sie mehr über die Berechtigungen von Plazma. +--- + +# 🛡️ Berechtigungen diff --git a/de/origin/plazma/developers.md b/de/origin/plazma/developers.md new file mode 100644 index 000000000..6b98f96c0 --- /dev/null +++ b/de/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Entwickeln Sie Drittanbieterprojekte mit Plazma. +--- + +# ⚙️ Entwicklerhandbuch diff --git a/de/origin/thunderbolt/README.md b/de/origin/thunderbolt/README.md new file mode 100644 index 000000000..b7a4acd93 --- /dev/null +++ b/de/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt ist eine auf der Plazma-Plattform basierende Serverplattform, die experimentelle Patches als Flavor unterscheidet und es ermöglicht, sie direkt zu nutzen. +--- + +# 🌩️ Thunderbolt - Benutzerhandbuch diff --git a/de/origin/volt/README.md b/de/origin/volt/README.md new file mode 100644 index 000000000..f1541de10 --- /dev/null +++ b/de/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt ist ein Open-Source-Template, mit dem Sie auf Basis von Plazma Ihre eigene Paperweight-Serverplattform entwickeln können. +--- + +# ⚡ Volt Entwicklungsleitfaden diff --git a/el/origin/README.md b/el/origin/README.md new file mode 100644 index 000000000..b84323215 --- /dev/null +++ b/el/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Αν έχετε ερωτήσεις, παρακαλούμε να τις κάνετε μέσω Discord ή συζητήσεων στο GitHub. +--- + +# 🏠 Καλώς ήλθατε στο Κέντρο Εγγράφων + +{% hint style="info" %} + +**Το έγγραφο του Plazma είναι προς το παρόν μεταφρασμένο από μηχανική μετάφραση.** + +[![Κατάσταση Μετάφρασης](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Συμμετέχετε στη μετάφραση τεκμηρίωσης στο [https://translate.plazmamc.org/](https://translate.plazmamc.org/) για να βελτιώσετε τα έγγραφα. + +{% endhint %} + +### Αν αντιμετωπίζετε προβλήματα κατά τη χρήση του Plazma, τι πρέπει να κάνετε; + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Αν ενδιαφέρεστε για το Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Αν θέλετε να δημιουργήσετε τη δική σας πλατφόρμα εξυπηρέτησης με το Volt, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Αν χρειάζεστε περισσότερες πληροφορίες σχετικά με το Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/el/origin/SUMMARY.md b/el/origin/SUMMARY.md new file mode 100644 index 000000000..c921fe0aa --- /dev/null +++ b/el/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Πίνακας περιεχομένων + +- [🏠 Καλώς ήρθατε στο Κέντρο Εγγράφων](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Εγγραφές Χρήσης Plazma](plazma/README.md) +- [❓ Τι είναι το Plazma;](plazma/about/README.md) + - [⬇️ Λήψη](plazma/about/downloads.md) + - [✅ Κατάσταση Υποστήριξης Έκδοσης](plazma/about/supported-versions.md) +- [⚒️ Οδηγός Διαχείρισης Διακομιστή](plazma/administration/README.md) + - [👟 Ξεκινώντας](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Αναφορά](plazma/administration/reference/README.md) + - [🖥️ Εντολές](plazma/administration/reference/commands.md) + - [🛡️ Δικαιώματα](plazma/administration/reference/permissions.md) + - [🎛️ Ορίσματα και Ιδιότητες](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Ιδιότητα](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Παγκόσμια Διαμόρφωση](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Παγκόσμιες Διαμορφώσεις](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Παγκόσμια Διαμόρφωση](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Παγκόσμιες Διαμορφώσεις](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Παγκόσμια Διαμόρφωση](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Παγκόσμιες Διαμορφώσεις](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Ειδίκευση](plazma/administration/expert/README.md) + - [🧹 Βελτιστοποίηση](plazma/administration/expert/optimize.md) + - [🔀 Προξενία](plazma/administration/expert/proxy.md) + - [↩️ Καταστολή](plazma/administration/expert/vanillaize.md) + - [🩻 Φραγή Ακτίνας X](plazma/administration/expert/xray.md) + - [⚠️ Ευπάθειες και Επιδιορθώσεις](plazma/administration/expert/fix-exploits.md) + - [⁉️ Συχνές Ερωτήσεις](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Οδηγός Προγραμματιστή](plazma/developers.md) + - [✏️ Συνεισφορά](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Οδηγός Χρήσης Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Οδηγός Ανάπτυξης Volt](volt/README.md) + +## Διάφορα + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Κατέβασμα Όλων](plazma/about/downloads-all.md) diff --git a/el/origin/miscellaneous/README.md b/el/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/el/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/el/origin/plazma/README.md b/el/origin/plazma/README.md new file mode 100644 index 000000000..b774581a5 --- /dev/null +++ b/el/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Το Plazma είναι μια πλατφόρμα εξυπηρέτησης ανοικτού κώδικα για το Minecraft: Java Edition που προσθέτει πειραματική βελτιστοποίηση βασισμένη σε χαρτί και προσαρμοσμένες λειτουργίες παιχνιδιού." +--- + +# ✨ Εγγραφή Χρήσης Πλάζμα + +## 👋 Καλώς ήρθατε στα Έγγραφα του Πλάζμα + +Καλώς ήρθατε στον οδηγό χρήσης του Plazma! + +{% hint style="info" %} + +**Δεν μπορείτε να λύσετε το πρόβλημα μέσω του εγχειριδίου;** + +[Επίσημος Διακομιστής Discord](https://discord.gg/MmfC52K8A8) ή συζητήσεις στο [GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) για να ρωτήσετε την κοινότητα! + +{% endhint %} + +### Σχετικά με το Plazma + +> Μάθετε τι είναι το Plazma ως πλατφόρμα εξυπηρέτησης. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Για Διαχειριστές + +> Δημιουργήστε το δικό σας διακομιστή χρησιμοποιώντας το Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Για Προγραμματιστές + +> Αναπτύξτε ένα πρότζεκτ τρίτων με τη χρήση του Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/el/origin/plazma/about/README.md b/el/origin/plazma/about/README.md new file mode 100644 index 000000000..08433cf08 --- /dev/null +++ b/el/origin/plazma/about/README.md @@ -0,0 +1,72 @@ +--- +description: Μάθετε τι είναι το Plazma ως πλατφόρμα εξυπηρέτησης. +--- + +# ❓ Τι είναι το Plazma; + +- **Το Plazma** είναι μια βασισμένη στο [Paper](https://github.com/PaperMC/Paper) πλατφόρμα εξυπηρέτησης που φέρνει μόνο τα πλεονεκτήματα από τα [Andromeda](https://github.com/EarendelArchived/Andromeda) και [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Προσπαθούμε πάντα να παρέχουμε υψηλή σταθερότητα και ισχυρή απόδοση, γρήγορες ενημερώσεις και εκτεταμένες λειτουργίες. + +## 📋 Στόχοι του Plazma + +- Προσπαθούμε να γίνουμε μια πλατφόρμα εξυπηρέτησης με γρήγορες ενημερώσεις και υψηλή σταθερότητα. +- Προσπαθούμε να παρέχουμε εκτενείς λειτουργίες και ισχυρή απόδοση όπως η πλατφόρμα μοντς. +- Προσπαθούμε να δημιουργήσουμε μια ελεύθερη πλατφόρμα που μπορεί να προσαρμοστεί ακόμη και για τις επιδιορθώσεις του Vanilla. + +## ⚙️ Κύρια χαρακτηριστικά + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Γρηγορότερες ενημερώσεις**\ + Το [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) διατηρεί τις περιλαμβανόμενες ενημερώσεις του Plazma πάντα ενημερωμένες, παρέχοντας τις γρηγορότερες ενημερώσεις στη βάση του Paper πλατφόρμα εξυπηρέτησης. +6. **Βελτιστοποίηση των βασικών αρχείων διαμόρφωσης**\ + Τα προεπιλεγμένα αρχεία διαμόρφωσης είναι βελτιστοποιημένα, οπότε δεν χρειάζεται να βελτιστοποιήσετε χειροκίνητα τα αρχεία διαμόρφωσης. +7. **Λειτουργία πολλαπλών νημάτων με σύστημα λειτουργίας**\ + Ασύγχρονη λειτουργία των συστημάτων μηχανικής που δεν σχετίζονται με το μηχανισμό του παιχνιδιού, μειώνοντας τον [χρόνο καθυστέρησης](#user-content-fn-4)[^4] για τη βελτιστοποίηση του εξυπηρετητή. +8. **Αποτροπή χρήσης περιττού χώρου**\ + Συγχώνευση δεδομένων με παρόμοιες τιμές για μείωση της μνήμης που χρησιμοποιείται. + +## ✨ Παραδείγματα χρήσης + +- **Πλατφόρμα που χειρίζεται σωστά ακόμα και πολύπλοκα πρόσθετα**\ + Χρησιμοποιείται το Plazma στον διακομιστή του προγραμματιστή [IPECTER](https://github.com/IPECTER).\ + Παρόλο που χρησιμοποιούνται προσθέτα δεδομένων μεγάλου μεγέθους και πολύπλοκα που λειτουργούν με NMS και αντανάκλαση, ο διακομιστής μπορεί να υποδεχτεί πάνω από 100 παίκτες χωρίς μείωση της απόδοσης. +- **Πλατφόρμα που διατηρεί υψηλή απόδοση ακόμα και σε RPG διακομιστή**\ + Κατάφερε να διατηρήσει σταθερά 100 παίκτες σε ένα μοναδικό cluster χωρίς μείωση του TPS και να επιτρέψει σε σύνολο 250 παικτών να παίξουν άνετα σε 4 clusters. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Πλατφόρμα που επιλέγουν πολλοί streamers**\ + Έχει επιλεγεί ως το βαρέλι συμμετοχής των θεατών πολλών streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Λήψη + +Μπορείτε να κατεβάσετε το Plazma από τη σελίδα παρακάτω. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Θέλετε να μάθετε περισσότερα για την υποστήριξη των εκδόσεων; + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Πρόσθετα Bukkit, CraftBukkit, Spigot και πρόσθετα Paper, Pufferfish, Purpur. + +[^2]: Υπό την Microsoft Corporation. + +[^3]: Αν απενεργοποιήσετε το σύστημα αναφορών συνομιλίας, η συνομιλία θα επεξεργάζεται μόνο στον εξυπηρετητή, αποτρέποντας την παρακολούθηση της Mojang στη συνομιλία. + +[^4]: Χρόνος που απαιτείται για τη λειτουργία του μηχανισμού συστήματος. diff --git a/el/origin/plazma/about/downloads-all.md b/el/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..31f7631b5 --- /dev/null +++ b/el/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Πλήρης προβολή λήψης αρχείου Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Έκδοση | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/el/origin/plazma/about/downloads.md b/el/origin/plazma/about/downloads.md new file mode 100644 index 000000000..52f1d9d73 --- /dev/null +++ b/el/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Κατεβάστε τώρα το Plazma και δοκιμάστε το απευθείας. +--- + +# ⬇️ Λήψη + +#### Θέλετε να μάθετε περισσότερα για την υποστήριξη των εκδόσεων; + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Το παρακάτω λήψη είναι το αρχείο εκτέλεσης για τους κανονικούς χρήστες.** + +Αν είστε προγραμματιστής και χρειάζεστε διαφορετικό τύπο αρχείου, ανατρέξτε στην παρακάτω σελίδα. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ΈκδοσηΛήψη
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Λήψη +
1.20.1 + Λήψη +
1.19.4 + Λήψη +
+ +*** diff --git a/el/origin/plazma/about/patches-list.md b/el/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..167c64812 --- /dev/null +++ b/el/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε για όλες τις λειτουργίες που προστέθηκαν στο Plazma. +--- + +# 📑 Περιλαμβάνεται ο πατσιάς diff --git a/el/origin/plazma/about/supported-versions.md b/el/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..fad46ad9a --- /dev/null +++ b/el/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Βρείτε τις εκδόσεις που υποστηρίζονται από το Plazma στην Minecraft: Java Edition." +--- + +# ✅ Κατάσταση υποστήριξης εκδόσεων + +{% hint style="info" %} + +**Το Plazma αναπτύσσεται από την έκδοση 1.19.4 και μετά, ενώ οι εκδόσεις πριν την 1.19.4 δεν υποστηρίζονται πλέον.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Σε%20αναμονή%20κυκλοφορίας +[idv]: https://badge.plazmamc.org/1/Σε_Ανάπτυξη +[atv]: https://badge.plazmamc.org/2/Υποστηρίζεται +[fse]: https://badge.plazmamc.org/6/Διακοπή_Υποστήριξης_Λειτουργιών +[eol]: https://badge.plazmamc.org/4/Τέλος_Υποστήριξης +[ukn]: +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Κανονικό +[100]: https://badge.plazmamc.org/percent/100 + +![Αναμονή για Κυκλοφορία][wtr] ![Σε Ανάπτυξη][idv] ![Υποστηρίζεται][atv] ![Διακοπή Υποστήριξης Λειτουργιών][fse] ![Τέλος Υποστήριξης][eol] + +| Έκδοση | Υποστήριξη Σταθερότητας και Λειτουργικότητας | Κατάσταση κατασκευής | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Κατάσταση Κατασκευής](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Κατάσταση Κατασκευής](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Κατάσταση Κατασκευής](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/el/origin/plazma/administration/README.md b/el/origin/plazma/administration/README.md new file mode 100644 index 000000000..8c737104f --- /dev/null +++ b/el/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Δημιουργήστε το δικό σας διακομιστή χρησιμοποιώντας το Plazma. +--- + +# ⚒️ Οδηγός Διαχείρισης Διακομιστή diff --git a/el/origin/plazma/administration/diagnosis/README.md b/el/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..2379e7d17 --- /dev/null +++ b/el/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να αντιμετωπίζετε τα προβλήματα όταν προκύψουν. +--- + +# 🧾 진단 diff --git a/el/origin/plazma/administration/diagnosis/plugins.md b/el/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..8b5b7c3e1 --- /dev/null +++ b/el/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να αντιμετωπίσετε το πρόβλημα όταν το πρόσθετο δεν λειτουργεί σωστά. +--- + +# 📜 플러그인 diff --git a/el/origin/plazma/administration/expert/README.md b/el/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..01389b834 --- /dev/null +++ b/el/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να αντιμετωπίζετε επαγγελματικά το Plazma. +--- + +# 🎓 Εμβάθυνση diff --git a/el/origin/plazma/administration/expert/fix-exploits.md b/el/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..913faf8b6 --- /dev/null +++ b/el/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε για γνωστά ευπαθή σημεία και πώς να τα αντιμετωπίσετε. +--- + +# ⚠️ Γνωστά ευπαθή σημεία και τρόποι αντιμετώπισής τους diff --git a/el/origin/plazma/administration/expert/optimize.md b/el/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..0afb062ca --- /dev/null +++ b/el/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να βελτιστοποιήσετε το Plazma. +--- + +# 🧹 Βελτιστοποίηση diff --git a/el/origin/plazma/administration/expert/proxy.md b/el/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..c874fc913 --- /dev/null +++ b/el/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να διαμορφώσετε με ασφάλεια την πλατφόρμα προξενικών υπηρεσιών "Velocity". +--- + +# 🔀 Προξενική diff --git a/el/origin/plazma/administration/expert/vanillaize.md b/el/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..28996acef --- /dev/null +++ b/el/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Μάθετε πώς να επαναφέρετε το πατσάρισμα του Paper και της βανίλιας. +--- + +# ↩️ Βανιλιοποίηση + +{% hint style="warning" %} + +**Το Paper δεν προσθέτει επιλογές στις περισσότερες επιδιορθώσεις του Vanilla για τα σφάλματα.** + +Το Plazma αναπτύσσει τη δυνατότητα απενεργοποίησης αυτών των διορθώσεων σφαλμάτων ως μέρος των ρυθμίσεών του αυτή τη στιγμή. + +Επομένως, αυτός ο οδηγός είναι ακόμα υπό κατασκευή και οι πληροφορίες μπορεί να αλλάξουν ανά πάσα στιγμή. + +{% endhint %} diff --git a/el/origin/plazma/administration/expert/xray.md b/el/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..67bde8f1f --- /dev/null +++ b/el/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε για τους διάφορους ενσωματωμένους τρόπους που αποτρέπουν την ακτινοβολία X-Ray. +--- + +# 🩻 Αποκλεισμός X-Ray diff --git a/el/origin/plazma/administration/faq.md b/el/origin/plazma/administration/faq.md new file mode 100644 index 000000000..784f56ca6 --- /dev/null +++ b/el/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Μάθετε σχετικά με συχνές ερωτήσεις. +--- + +# ⁉️ Συχνές Ερωτήσεις + +{% hint style="info" %} + +**Δεν μπορείτε να βρείτε την απάντηση που ψάχνετε;** + +[Επίσημος Διακομιστής Discord](https://discord.gg/MmfC52K8A8) ή συζητήσεις στο [GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) για να ρωτήσετε την κοινότητα! + +{% endhint %} + +### Το Plazma δεν ξεκινά + +Εάν εμφανίζεται το μήνυμα `no main manifest attribute, in plazma-(version).jar`,\ +το αρχείο που κατεβάσατε είναι αρχείο API ανάπτυξης, πρέπει να κατεβάσετε το **Reobf Paperweight** από τη σελίδα GitHub. + +Για περισσότερες πληροφορίες, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Εμφανίζεται προειδοποίηση κάθε φορά που ξεκινά ο διακομιστής + +Το Plazma περιλαμβάνει ορισμένα ασταθή patches και μπορεί πάντα να προκαλέσει δυσλειτουργίες, γι' αυτό εμφανίζει το ακόλουθο μήνυμα προειδοποίησης κάθε φορά που ο διακομιστής ξεκινά. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Μπορείτε να απενεργοποιήσετε το συγκεκριμένο μήνυμα προειδοποίησης χρησιμοποιώντας την ιδιότητα συστήματος [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Για περισσότερες πληροφορίες, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Διαθέσιμο από την έκδοση 1.20.1 diff --git a/el/origin/plazma/administration/getting-started/README.md b/el/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..97342699b --- /dev/null +++ b/el/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Μάθετε πώς να δημιουργήσετε έναν διακομιστή με το Plazma. +--- + +# 👟 Ξεκινήστε + +Για να χρησιμοποιήσετε το Plazma με σταθερότητα, το σύστημά σας πρέπει να πληροί τις ακόλουθες απαιτήσεις. + +| | Ελάχιστο | Συνιστώμενο | +| :---------------: | -------- | ----------- | +| Αρχιτεκτονική | x64 | - | +| RAM | 8GB | 16GB | +| Χώρος αποθήκευσης | 1GB | 8GB | +| JDK | 17 | 21 | + +Για ομαλή επεξεργασία αρχείων ρυθμίσεων, είναι καλό να εγκαταστήσετε έναν επεξεργαστή κώδικα όπως το [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Σωστή Έξοδος" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +Περιβάλλον Εκτέλεσης OpenJDK Zulu21.32+17-CA (έκδοση 21.0.2+13-LTS) +Εικοσιτετράμπιτος Διακομιστής VM Zulu21.32+17-CA του OpenJDK (έκδοση 21.0.2+13-LTS, ανάμεικτη λειτουργία, κοινή χρήση) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' δεν είναι εσωτερική ή εξωτερική εντολή, εκτελέσιμο πρόγραμμα, ή +αρχείο δέσμης. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Μη αναγνωρισμένη επιλογή: --version +Σφάλμα: Αδυναμία δημιουργίας της Εικονικής Μηχανής Java. +Σφάλμα: Παρουσιάστηκε μια μοιραία εξαίρεση. Το πρόγραμμα θα τερματιστεί. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Κατεβάστε το **JDK 21** από το [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) σε μορφή `.msi`. +2. Εκτελέστε τον κατεβασμένο οδηγό εγκατάστασης και κάντε κλικ στο `Επόμενο`. +3. Από το μενού που εμφανίζεται στο κέντρο-αριστερά της οθόνης, ενεργοποιήστε την επιλογή `Set JAVA_HOME variable` και κάντε κλικ στο `Επόμενο`. +4. Κάντε κλικ στο `Εγκατάσταση` για να ολοκληρώσετε την εγκατάσταση του JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Χαρτογραφημένο από την Mojang, είναι το mapping του κανονικού Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP διαμόρφωση + +Κάρτα Ethernet Ethernet: + + Συνδεδεμένο DNS κατάληξη. . . . : + Διεύθυνση IPv4. . . . . . . . . : 192.168.3.7 + Μάσκα υποδικτύου . . . . . . . : 255.255.255.0 + Προεπιλεγμένη πύλη. . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. Εξέλιξη + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +Δείτε το παρακάτω εγχειρίδιο για να μάθετε πώς να εξατομικεύσετε τον διακομιστή. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Εταιρεία Microsoft. + +[^11]: Στην περίπτωση της Νότιας Κορέας, μπορείτε να υποβάλετε νομική ενστάσει στην **Κορεάτικη Εταιρεία Microsoft** σύμφωνα με το άρθρο 32 παράγραφος 1 υποπαράγραφος 9 του νόμου περί προώθησης της βιομηχανίας των βιντεοπαιχνιδιών. + +[^12]: Universal Plug & Play. Το Purpur που περιλαμβάνεται στο Plazma επικοινωνεί αυτόματα με τον router μέσω αυτής της τεχνολογίας και ανοίγει τη θύρα μόνο όταν ο διακομιστής είναι ενεργός, εξαλείφοντας την ανάγκη για άμεση προώθηση θυρών. + +[^13]: Σε περίπτωση που δεν έχετε λογαριασμό, εγγραφείτε στο Ngrok μέσω λογαριασμού Google ή GitHub. diff --git a/el/origin/plazma/administration/getting-started/customization.md b/el/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..137d4bb31 --- /dev/null +++ b/el/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,117 @@ +--- +description: Μάθετε πώς να εξατομικεύετε τον διακομιστή σας. +--- + +# 🎨 Εξατομίκευση χρήστη + +Ο λόγος που χρησιμοποιούμε την τροποποιημένη πλατφόρμα εξυπηρέτησης όπως το Plazma αντί να χρησιμοποιούμε την επίσημη πλατφόρμα εξυπηρέτησης που παρέχεται από τη Mojang Studios είναι επειδή επιτρέπει ισχυρή **προσαρμογή**. + +Παρακάτω είναι μερικοί τρόποι προσαρμογής και χρήσης του Plazma. + +## Τροποποίηση διαμόρφωσης + +Ο πιο βασικός τρόπος προσαρμογής του Plazma είναι να τροποποιήσετε τη διαμόρφωση. + +Το Plazma παρέχει ισχυρές ρυθμίσεις διαμόρφωσης από το μηχανισμό του παιχνιδιού μέχρι τα χαρακτηριστικά των τεράτων. + +Για περισσότερες πληροφορίες σχετικά με τη διαμόρφωση του Plazma, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="../reference/configurations/" %} +[διαμορφώσεις](../reference/configurations/) +{% endcontent-ref %} + +## Χρήση προσθέτων + +{% hint style="success" %} + +**Το Plazma υποστηρίζει κανονικά όλα τα πρόσθετα βασισμένα σε χαρτί.** + +Για τα πρόσθετα του Spigot, μετά την έκδοση 1.20.5, λόγω των αλλαγών στην αντιστοίχιση του Paper, μπορεί να μη λειτουργούν ορισμένα, αλλά τα περισσότερα πρόσθετα που βασίζονται στο Paper, όπως το Paper, το Pufferfish και το Purpur, λειτουργούν κανονικά στο Plazma. Αν δεν λειτουργούν σωστά, αυτό οφείλεται σε σφάλμα του Plazma, οπότε παρακαλούμε [να το αναφέρετε αμέσως.](../diagnosis/plugins.md) + +{% endhint %} + +Αυτό είναι το κύριο λόγο που χρησιμοποιείτε το Plazma και η ισχυρότερη μέθοδος εξατομίκευσης του Plazma. +Το ισχυρό οικοσύστημα προσθέτων του Plazma επιτρέπει την εύκολη εξατομίκευση του διακομιστή. + +Υπάρχουν διάφοροι τρόποι για να βρείτε και να κατεβάσετε πρόσθετα. Ορισμένα πρόσθετα ανεβάζονται σε υπηρεσίες δημόσιου αποθετηρίου, ενώ άλλα ανεβάζονται στο GitHub ή σε ιστότοπο που ανήκει σε αυτούς. + +{% hint style="caution" %} + +**Τα πρόσθετα μπορούν να έχουν άμεση πρόσβαση στο σύστημα!** + +Χρησιμοποιήστε υπηρεσίες όπως το VirusTotal για να ελέγξετε πάντα την ασφάλεια των προσθέτων πριν τα εφαρμόσετε, ή κατεβάστε προσθέτα από αξιόπιστες υπηρεσίες. + +{% endhint %} + +Υπάρχουν πολλές υπηρεσίες για τη λήψη προσθέτων. Ανάμεσά τους, οι υπηρεσίες όπως το [SpigotMC Forum](https://www.spigotmc.org/resources/), το [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), το [Modrinth](https://modrinth.com/plugins), το [Hanger](https://hangar.papermc.io/) αξιολογούν τα πρόσθετα πριν τη δημοσίευσή τους, ώστε να διασφαλίζεται ότι κυκλοφορούν μόνο ασφαλή πρόσθετα. + +### Εφαρμογή προσθέτων + +Αφού κατεβάσετε τα πρόσθετα, είναι ώρα να τα εφαρμόσετε. + +1. Τα πρόσθετα είναι σε μορφή `.jar` ή `Java Executable File`.\ + Σε ορισμένες περιπτώσεις, τα πρόσθετα είναι συμπιεσμένα σε αρχεία, οπότε + πρέπει να αποσυμπιεστούν, με τα ονόματα να περιλαμβάνουν τις λέξεις `bukkit`, `spigot` ή `paper`, + και αν υπάρχει αρχείο με `fat`, τότε πρέπει να χρησιμοποιηθεί το αρχείο `fat`. +2. Τοποθετήστε το κατεβασμένο αρχείο στον φάκελο `plugins` του διακομιστή και επανεκκινήστε τον (ή επανεκκινήστε τον). +3. Όταν ξεκινήσει το Plazma, θα εμφανιστούν νέες πληροφορίες στην κονσόλα. + Αυτό σημαίνει ότι το Plazma φόρτωσε τα πρόσθετα κανονικά. +4. Ακόμα κι αν το Plazma φόρτωσε τα πρόσθετα κανονικά, μπορεί να μην έχουν ξεκινήσει. + Με τη χρήση της εντολής `/plugins` μπορείτε να δείτε τα πρόσθετα που έχουν φορτωθεί στον τρέχοντα διακομιστή. + Αν το όνομα του πρόσθετου δεν είναι κόκκινο + αλλά πράσινο, τότε το πρόσθετο έχει φορτωθεί κανονικά. + +Αν το πρόσθετο δεν έχει φορτωθεί κανονικά, μπορείτε να βρείτε λύσεις στον παρακάτω σύνδεσμο. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Χρήση δεδομένων + +Τα δεδομένα είναι ένας τρόπος προσαρμογής του Minecraft, παρόμοιος με τα [resource packs](#user-content-fn-1)[^1]. + +Με τα δεδομένα, μπορείτε να προσθέσετε νέες κατηγορίες πλασμάτων και προκλήσεις στο παιχνίδι. + +{% hint style="caution" %} + +**Τα δεδομένα μπορεί να καταστρέψουν τον κόσμο!** + +Κάποια δεδομένα που δεν λειτουργούν σωστά μπορεί να καταστρέψουν τον κόσμο και αυτό δεν μπορεί να αναιρεθεί. + +Γι' αυτό, είναι συνιστώμενο να δημιουργήσετε αντίγραφο ασφαλείας του κόσμου πριν εφαρμόσετε δεδομένα. + +{% endhint %} + +Τα δεδομένα μπορούν να κατεβαστούν από πολλές υπηρεσίες, όπως το [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), το [Modrinth](https://modrinth.com/datapacks), το [Planet Minecraft](https://www.planetminecraft.com/data-packs/) κ.α. + +Αφού κατεβάσετε τα δεδομένα, μπορείτε να τα εφαρμόσετε στον φάκελο `datapacks` του κόσμου του διακομιστή. +Αν ο φάκελος δεν υπάρχει, μπορείτε να τον δημιουργήσετε και να τον προσθέσετε. + +{% hint style="warning" %} + +**Σε ορισμένες περιπτώσεις [τα δεδομένα](#user-content-fn-2)[^2] ενδέχεται να μην εφαρμοστούν σωστά από την πρώτη φορά.** + +Γι' αυτό το λόγο, συνιστάται να επανεκκινήσετε τον διακομιστή **2 φορές**. + +{% endhint %} + +Τα δεδομένα μπορεί να καταστραφούν εύκολα με κάθε ενημέρωση του Minecraft. + +Ιδιαίτερα, αν τα δεδομένα καταστραφούν εντελώς, ο διακομιστής μπορεί να καταρρεύσει, οπότε είναι σημαντικό να δοκιμάσετε επαρκώς πριν ενημερώσετε τον διακομιστή. + +{% hint style="info" %} + +**Μετά την εντολή εκκίνησης του διακομιστή, μπορείτε να εισάγετε το `safeMode` για να απενεργοποιήσετε όλα τα δεδομένα και να εκκινήσετε τον διακομιστή.** + +[Για περισσότερες πληροφορίες, ανατρέξτε στο `Αναφορές > Ορίσματα και Ιδιότητες`.](../reference/arguments.md) + +{% endhint %} + +Τα δεδομένα μπορούν να επιβεβαιωθούν με την εντολή `/datapack list`. + +*** + +[^1]: Ή με το Minecraft: Bedrock Edition's add-on. + +[^2]: Προσθήκη νέων κατηγοριών πλασμάτων κ.λπ. diff --git a/el/origin/plazma/administration/getting-started/next-step.md b/el/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..56d9fc793 --- /dev/null +++ b/el/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Μάθετε πώς να εξατομικεύετε τον διακομιστή σας. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Παρακάτω είναι μερικοί τρόποι προσαρμογής και χρήσης του Plazma. + +## Τροποποίηση διαμόρφωσης + +Ο πιο βασικός τρόπος προσαρμογής του Plazma είναι να τροποποιήσετε τη διαμόρφωση. + +Το Plazma παρέχει ισχυρές ρυθμίσεις διαμόρφωσης από το μηχανισμό του παιχνιδιού μέχρι τα χαρακτηριστικά των τεράτων. + +Για περισσότερες πληροφορίες σχετικά με τη διαμόρφωση του Plazma, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="../reference/configurations/" %} +[διαμορφώσεις](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Χρήση προσθέτων + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Αυτό είναι το κύριο λόγο που χρησιμοποιείτε το Plazma και η ισχυρότερη μέθοδος εξατομίκευσης του Plazma. Το ισχυρό οικοσύστημα προσθέτων του Plazma επιτρέπει την εύκολη εξατομίκευση του διακομιστή. + +Υπάρχουν διάφοροι τρόποι για να βρείτε και να κατεβάσετε πρόσθετα. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Υπάρχουν πολλές υπηρεσίες για τη λήψη προσθέτων. Ανάμεσά τους, οι υπηρεσίες όπως το [SpigotMC Forum](https://www.spigotmc.org/resources/), το [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), το [Modrinth](https://modrinth.com/plugins), το [Hanger](https://hangar.papermc.io/) αξιολογούν τα πρόσθετα πριν τη δημοσίευσή τους, ώστε να διασφαλίζεται ότι κυκλοφορούν μόνο ασφαλή πρόσθετα. + +### Εφαρμογή προσθέτων + +Αφού κατεβάσετε τα πρόσθετα, είναι ώρα να τα εφαρμόσετε. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Τοποθετήστε το κατεβασμένο αρχείο στον φάκελο `plugins` του διακομιστή και επανεκκινήστε τον (ή επανεκκινήστε τον). +3. Όταν ξεκινήσει το Plazma, θα εμφανιστούν νέες πληροφορίες στην κονσόλα. Αυτό σημαίνει ότι το Plazma φόρτωσε τα πρόσθετα κανονικά. +4. Ακόμα κι αν το Plazma φόρτωσε τα πρόσθετα κανονικά, μπορεί να μην έχουν ξεκινήσει. Με τη χρήση της εντολής `/plugins` μπορείτε να δείτε τα πρόσθετα που έχουν φορτωθεί στον τρέχοντα διακομιστή. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Αν το πρόσθετο δεν έχει φορτωθεί κανονικά, μπορείτε να βρείτε λύσεις στον παρακάτω σύνδεσμο. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Χρήση δεδομένων + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Με τα δεδομένα, μπορείτε να προσθέσετε νέες κατηγορίες πλασμάτων και προκλήσεις στο παιχνίδι. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Κάποια δεδομένα που δεν λειτουργούν σωστά μπορεί να καταστρέψουν τον κόσμο και αυτό δεν μπορεί να αναιρεθεί. + +Γι' αυτό, είναι συνιστώμενο να δημιουργήσετε αντίγραφο ασφαλείας του κόσμου πριν εφαρμόσετε δεδομένα. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Αφού κατεβάσετε τα δεδομένα, μπορείτε να τα εφαρμόσετε στον φάκελο `datapacks` του κόσμου του διακομιστή. Αν ο φάκελος δεν υπάρχει, μπορείτε να τον δημιουργήσετε και να τον προσθέσετε. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Γι' αυτό το λόγο, συνιστάται να επανεκκινήσετε τον διακομιστή **2 φορές**. +{% endhint %} + +Τα δεδομένα μπορεί να καταστραφούν εύκολα με κάθε ενημέρωση του Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Τα δεδομένα μπορούν να επιβεβαιωθούν με την εντολή `/datapack list`. + +*** + +## Βελτιστοποίηση + +Το Plazma έχει εφαρμοστεί πολλά πακέτα βελτιστοποίησης. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Προξενητής + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Για πληροφορίες σχετικά με ασφαλείς και σωστές ρυθμίσεις προξενητή, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Ασφάλεια + +Το Minecraft έχει εξελιχθεί σε σημείο όπου είναι εύκολο να βρεθεί ένας [κινητήρας επίθεσης ευπάθειας](#user-content-fn-3)[^3] ακόμα και online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Ρύθμιση δικαιωμάτων + +Ορισμένες διαχειριστικές εντολές προσθέτων μπορεί να παρουσιάζουν ευπάθειες λόγω μη σωστής ρύθμισης δικαιωμάτων. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Αποκλεισμός X-Ray + +Το X-Ray είναι μία από τις ευπάθειες που μπορούν να χρησιμοποιηθούν εύκολα ακόμα και από ένα βασικό πρόγραμμα πελάτη βελτιστοποίησης. + +Το Plazma παρέχει διαμόρφωση για τον αποκλεισμό του X-Ray από προεπιλογή. + +Για οδηγίες και εξηγήσεις σχετικά με τον αποκλεισμό του X-Ray, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Λευκή λίστα + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Για να δείτε τους παίκτες που έχουν επιτραπεί να συνδεθούν, χρησιμοποιήστε την εντολή `/whitelist query`. + +*** + +[^1]: Ή με το Minecraft: Bedrock Edition's add-on. + +[^2]: Προσθήκη νέων κατηγοριών πλασμάτων κ.λπ. + +[^3]: Συνήθως αναφέρεται ως "hack". + +[^4]: Σε περιπτώσεις όπου η διαμόρφωση δεν είναι βελτιστοποιημένη, ή το Plazma είναι παλιό ή υπάρχουν νέες ευπάθειες, ενδέχεται να μην έχουν αποκλειστεί. + +[^5]: Ο παίκτης συνδέεται στον διακομιστή μέσω του διακομιστή προξενητή Ngrok, και η διεύθυνση Ngrok που εκδίδεται κάθε φορά που γίνεται επανεκκίνηση είναι διαφορετική. diff --git a/el/origin/plazma/administration/reference/README.md b/el/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..541a646f6 --- /dev/null +++ b/el/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Ανακαλύψτε τους τρόπους προσαρμογής που παρέχονται από το Plazma. +--- + +# 📜 리퍼런스 + +Το Plazma παρέχει διάφορους τρόπους προσαρμογής. + +Από αυτούς, τέσσερις τρόποι μπορούν να χρησιμοποιηθούν αμέσως χωρίς περαιτέρω εργασία. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Επίσημος Διακομιστής Discord](https://discord.gg/MmfC52K8A8) ή συζητήσεις στο [GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) για να ρωτήσετε την κοινότητα! +{% endhint %} + +*** + +## 🖥️ Εντολές + +> Οι εντολές επιτρέπουν τη συλλογή πληροφοριών εντός του παιχνιδιού ή την προσαρμογή του περιβάλλοντος παιχνιδιού. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Δικαιώματα + +> Τα δικαιώματα καθορίζουν το πεδίο όπου ο παίκτης μπορεί να αλληλεπιδράσει. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Παράμετροι και ιδιότητες + +> Οι παράμετροι και οι ιδιότητες επηρεάζουν συνολικά τη λειτουργία του Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Ρυθμίσεις + +> Οι ρυθμίσεις είναι ο βασικότερος τρόπος προσαρμογής του Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/el/origin/plazma/administration/reference/arguments.md b/el/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..40dd1be95 --- /dev/null +++ b/el/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +Οι αρχικές εντολές και τα χαρακτηριστικά του συστήματος είναι τιμές που προστίθενται στην εκτέλεση του Plazma με [εντολές που χρησιμοποιούνται](#user-content-fn-1)[^1], επηρεάζοντας γενικά τη λειτουργία του Plazma. + +[위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **Τύπος**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `false` + +Απενεργοποιεί το Plazma branding και χρησιμοποιεί το βανίλια εικονίδιο διακομιστή. + +#### `Plazma.useVanillaConfiguration` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `false` +- **Σύγκρουση**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Αυτό μπορεί να έχει σημαντικές επιπτώσεις στην ασφάλεια και την απόδοση του διακομιστή. + +Οποιοδήποτε πρόβλημα που προκύπτει από αυτήν την ιδιότητα ανήκει στον διαχειριστή του διακομιστή. +{% endhint %} + +Παρέχει την προεπιλεγμένη τιμή που παρέχει η Mojang για την αρχική διαμόρφωση. + +Απενεργοποιεί όλες τις επιδιορθωμένες ευπάθειες που έχει εφαρμόσει το Paper. + +Οι επιδιορθωμένες ευπάθειες μπορούν να ενεργοποιηθούν ξανά στη ρύθμιση του Paper ή του Plazma. + +#### `Plazma.vanillaize` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `true` +- **Σύγκρουση**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Ρυθμίζει την αρχική διαμόρφωση για να είναι πιο κοντά στο βανίλια. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Ανασταλμένη ιδιότητα + +Οι παρακάτω ιδιότητες συστήματος είναι ανασταλμένες. + +#### `timings.bypassMax` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `false` +- **ΔΙΑΚΟΠΗ ΧΡΗΣΗΣ**: Η Timings έχει αφαιρεθεί από το Plazma μετά την πρόσφατη αναβάθμιση + +Καθορίζει εάν μπορεί να υπερβεί το μέγιστο των τιμών που μπορούν να σταλούν στο Timings API του Aikar. + +Αν γίνει έτσι χωρίς να χειρίζεται εξαιρέσεις στο API, εφαρμόζεται περιορισμός ρυθμού. + +*** + +## Παράμετρος εκκίνησης + +Η παράμετρος εκκίνησης εισάγεται μετά το `-jar *.jar` για την εκκίνηση του Plazma και είναι μια τιμή που χειρίζεται μαζί. + +### Οδηγίες χρήσης + +Οι ιδιότητες του συστήματος εισάγονται ως παράμετροι εντολής προγράμματος μετά το `-jar *.jar`. + +Για παράδειγμα, εάν θέλετε να εφαρμόσετε την παράμετρο εκκίνησης `nogui`,\ +εισάγετε το παρακάτω για να χειριστεί η παράμετρος `nogui` κατά την αρχικοποίηση του Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Συνολική παράμετρος εκκίνησης + +#### `bukkit-settings` + +- **Ψευδώνυμο**: `b` +- **Προεπιλεγμένη τιμή**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Ψευδώνυμο**: `c` +- **Προεπιλεγμένη τιμή**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Ψευδώνυμο**: `c` +- **Προεπιλεγμένη τιμή**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Εκκινεί τον διακομιστή σε λειτουργία επίδειξης. + +#### `eraseCache` + +Αφαιρεί τα απομείναντα αρχεία cache μετά την αναβάθμιση του κόσμου. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Ψευδώνυμο**: `?` + +Εμφανίζει τις συνολικές παραμέτρους εκκίνησης του Plazma και τις εξηγήσεις τους. + +#### `initSettings` + +Δημιουργεί μόνο το αρχείο διαμόρφωσης και κλείνει τον διακομιστή. + +#### `jfrProfile` + +Ενεργοποιεί το προφίλ JFR. + +#### `max-players` + +- **Ψευδώνυμο**: `s`, `size` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Απενεργοποιεί το γραφικό πάνελ διεπαφής. + +#### `nojline` + +Απενεργοποιήστε το JLine και χρησιμοποιήστε τη βανίλια κονσόλα. + +#### `online-mode` + +- **Ψευδώνυμο**: `o` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Επιλέξτε εάν θέλετε να επικυρώνετε τους παίκτες με τους Mojang εξυπηρετητές επικύρωσης. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Ψευδώνυμο**: `paper` +- **Προεπιλεγμένο**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Ορίζει τη θέση του αρχείου ρυθμίσεων του PaperSpigot που έχει σταματήσει να χρησιμοποιείται. + +Χρησιμοποιείται για τη μεταφορά των υφιστάμενων ρυθμίσεων σε νέο αρχείο ρυθμίσεων, και στη συνέχεια δεν χρησιμοποιείται. + +#### `paper-settings-directory` + +- **Ψευδώνυμο**: `paper-dir` +- **Προεπιλεγμένο**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Ψευδώνυμο**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Ψευδώνυμο**: `p` +- **Προεπιλεγμένο**: `plugins` + +Ορίζει τη θέση του φακέλου προσθέτων. + +#### `pufferfish-settings` + +- **Ψευδώνυμο**: `pufferfish` +- **Προεπιλεγμένο**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Ψευδώνυμο**: `purpur` +- **Προεπιλεγμένο**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Ξεκινά τον διακομιστή σε πλήρη κατάσταση βανίλια. + +#### `server-ip` + +- **Ψευδώνυμο**: `h`, `host` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Ψευδώνυμο**: `p`, `port` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Ορίζει τη θύρα του διακομιστή. + +#### `server-name` + +- **Προεπιλεγμένο**: `Ένας Διακομιστής Plazma` + +Ορίζει το όνομα του διακομιστή. + +#### `spigot-settings` + +- **Ψευδώνυμο**: `S` +- **Προεπιλεγμένο**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Ψευδώνυμο**: `v` + +Εμφανίζει την έκδοση του Plazma. + +#### `world-dir` + +- **Ψευδώνυμο**: `W`, `universe`, `world-container` +- **Προεπιλεγμένο**: `(φάκελος διακομιστή)` + +Ορίζει τη θέση όπου αποθηκεύονται τα αρχεία κόσμου. + +#### `world-name` + +- **Ψευδώνυμο**: `w`, `world` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Ορίζει το όνομα του αρχείου κόσμου. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Η τοποθεσία επεξεργασίας παραμέτρων αλλάζει ανάλογα με την προσαρμογή. + +[^3]: Για παράδειγμα, αν θέλετε να ενεργοποιήσετε το `Plazma.iKnowWhatIAmDoing` σε `true`, αρκεί να εισάγετε `-DPlazma.iKnowWhatIAmDoing` αντί για `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Για παράδειγμα, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Ανιχνευτής συμβάντων. + +[^6]: Ανιχνευτής συμβάντων. + +[^7]: Πελάτης. + +[^8]: Σήμα που υποδεικνύει ότι ο διακομιστής είναι συνδεδεμένος κανονικά, όπως η καρδιακή παλμικότητα. + +[^9]: Με τη χρήση της λειτουργίας απομάκρυνσης AFK του Purpur, μπορείτε να απομακρύνετε από τον διακομιστή ακόμη και παίκτες που έχουν αφήσει τη θέση τους. + +[^10]: Σύστημα συγχρονισμού εγγραφής τμημάτων, Sync Chunk Write System. + +[^11]: `ΠΡΟΕΙΔΟΠΟΙΗΣΗ! Το Plazma μπορεί να προκαλέσει απροσδόκητα προβλήματα, επομένως βεβαιωθείτε ότι το δοκιμάσετε εκτενώς πριν το χρησιμοποιήσετε σε δημόσιο διακομιστή.` + +[^12]: Η `βελτιστοποίηση κόσμου` στο παιχνίδι λειτουργεί με την ίδια αρχή. + +[^13]: Οι διαχειριστές άνω του `επιπέδου 2` εξαιρούνται. + +[^14]: Πρωτόκολλο Διαδικτύου, IP. diff --git a/el/origin/plazma/administration/reference/commands.md b/el/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..f26c0a9ac --- /dev/null +++ b/el/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε για τις εντολές που είναι διαθέσιμες στο Plazma. +--- + +# 🖥️ Εντολές diff --git a/el/origin/plazma/administration/reference/configurations/README.md b/el/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..2c5fd4cfb --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Οι ρυθμίσεις είναι ο βασικότερος τρόπος προσαρμογής του Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Ιδιότητα + +> Η ιδιότητα είναι το πιο βασικό αρχείο διαμόρφωσης που παρέχει το Minecraft. Χρησιμοποιώντας την ιδιότητα, μπορείτε να αλλάξετε το βασικό μηχανισμό του παιχνιδιού. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Διαμόρφωση Bukkit + +> Η διαμόρφωση Bukkit είναι το πιο βασικό αρχείο διαμόρφωσης που παρέχει το Plazma. Χρησιμοποιώντας τη διαμόρφωση Bukkit, μπορείτε να αλλάξετε τον βασικό μηχανισμό του διακομιστή Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Διαμόρφωση Spigot + +> Η διαμόρφωση Spigot επιτρέπει την τροποποίηση λεπτομερειών του παιχνιδιού, την επεξεργασία των παικτών, τη λειτουργία των εντολών και των μηνυμάτων. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Διαμόρφωση Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Διαμόρφωση Pufferfish + +> Η διαμόρφωση Pufferfish επιτρέπει την τροποποίηση των κόσμων και οντοτήτων του Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Διαμόρφωση Purpur + +> Η ιδιότητα Purpur επιτρέπει την τροποποίηση των βασικών δεδομένων του παιχνιδιού. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Διαμόρφωση Plazma + +> Η διαμόρφωση Plazma επιτρέπει την εξατομίκευση των λειτουργιών του Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/el/origin/plazma/administration/reference/configurations/bukkit.md b/el/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..7de5ce822 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/el/origin/plazma/administration/reference/configurations/paper/README.md b/el/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..c2b3b129a --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε ποια είναι η χρήση κάθε αρχείου στο φάκελο config. +--- + +# 🛩️ Χαρτί diff --git a/el/origin/plazma/administration/reference/configurations/paper/global.md b/el/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f3fcdf538 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/el/origin/plazma/administration/reference/configurations/paper/world.md b/el/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..87078fdd7 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Αναζητήστε τι σημαίνει κάθε κόμβος του paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Κόσμος diff --git a/el/origin/plazma/administration/reference/configurations/plazma/README.md b/el/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..6038f79c0 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε ποια είναι η χρήση κάθε αρχείου στο φάκελο config. +--- + +# ✨ Πλάζμα diff --git a/el/origin/plazma/administration/reference/configurations/plazma/global.md b/el/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..ffff77773 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/el/origin/plazma/administration/reference/configurations/plazma/world.md b/el/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..073e935cd --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/el/origin/plazma/administration/reference/configurations/plazma/worlds.md b/el/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..98a1f2e7e --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του plazma-world.yml. +--- + +# ✨ Πλάσμα (Διαμόρφωση κόσμου) diff --git a/el/origin/plazma/administration/reference/configurations/property.md b/el/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..d1907a544 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του server.properties. +--- + +# 🪨 Server.properties diff --git a/el/origin/plazma/administration/reference/configurations/pufferfish.md b/el/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..674a63882 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Αναζητήστε τι σημαίνει κάθε κόμβος του pufferfish.yml. +--- + +# 🐡 Φουσκωτό ψάρι diff --git a/el/origin/plazma/administration/reference/configurations/purpur/README.md b/el/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..7b6d6ccf8 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο purpur.yml. +--- + +# 🦑 Πορφύρα diff --git a/el/origin/plazma/administration/reference/configurations/purpur/global.md b/el/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..8e1851602 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/el/origin/plazma/administration/reference/configurations/purpur/world.md b/el/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..1300ec900 --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/el/origin/plazma/administration/reference/configurations/spigot.md b/el/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..ff785bc0c --- /dev/null +++ b/el/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο spigot.yml. +--- + +# 🚰 Spigot diff --git a/el/origin/plazma/administration/reference/permissions.md b/el/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..0aab30609 --- /dev/null +++ b/el/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Μάθετε σχετικά με τα δικαιώματα του Plazma. +--- + +# 🛡️ Δικαιώματα + +Τα δικαιώματα είναι ένα απλό εργαλείο ασφαλείας που ορίζει το εύρος στο οποίο μπορούν να αλληλεπιδρούν οι παίκτες στον εξυπηρετητή. + +Για να χρησιμοποιήσετε σωστά και να τροποποιήσετε εύκολα τα δικαιώματα, πρέπει να χρησιμοποιήσετε πρόσθετα όπως το [LuckPerms](https://luckperms.net). + +*** + +## Κατανόηση του βασικού συστήματος δικαιωμάτων + +Στο Minecraft, υπάρχουν προεπιλεγμένες ομάδες διαχείρισης δικαιωμάτων. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Παίκτης**\ + Είναι η ομάδα δικαιωμάτων που δίνεται συνήθως σε όλους τους παίκτες. +2. **Διαιτητής**\ + Μπορεί να αγνοήσει την προστασία της εκκίνησης. +3. **Διαχειριστής κόσμου**\ + Μπορεί να χρησιμοποιήσει όλες τις εντολές και τα μπλοκ εντολών που σχετίζονται με τη διαχείριση του κόσμου.\ + Είναι η προεπιλεγμένη ομάδα δικαιωμάτων που εφαρμόζονται στα δεδομένα πακέτα και στα μπλοκ εντολών. +4. **Διαχειριστής**\ + Μπορεί να χρησιμοποιήσει όλες τις εντολές που σχετίζονται με τη διαχείριση των παικτών. +5. **Γενικός Διαχειριστής**\ + Μπορεί να χρησιμοποιήσει όλες τις εντολές που σχετίζονται με τη διαχείριση του εξυπηρετητή.\ + Είναι η προεπιλεγμένη ομάδα δικαιωμάτων που εφαρμόζεται στην κονσόλα και στους διαχειριστές. + +*** + +## Ορισμός δικαιωμάτων + +*** + +## Όλα τα δικαιώματα + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να `καθίσει και να αλληλεπιδράσει` με τον οντότητα για να τον καβαλήσει. + +Όταν καβαλάει την οντότητα, μπορεί να χειρίζεται τη μετακίνηση της οντότητας με το `πλήκτρο κίνησης` και να πηδάει ή να πετάει με το `πλήκτρο άλματος`. + +Στο `(Namespaced Key)` εισάγεται το [Namespaced ID](#user-content-fn-2)[^2] της οντότητας. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να χρησιμοποιήσει τις ειδικές λειτουργίες του entity όταν τον καβαλάει. + +Δεν είναι διαθέσιμες όλες οι ειδικές λειτουργίες για όλα τα entities. Δείτε παρακάτω τις διαθέσιμες ειδικές λειτουργίες. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Δημοσιεύστε την ιδέα σας στο [Plazma Discord](https://plazmamc.org/discord) ή [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Δείτε τις διαθέσιμες ειδικές λειτουργίες + +- **`crepper`**\ + Θα εκραγεί με το πάτημα του `πλήκτρου άλματος`.\ + Αν ο παίκτης έχει την άδεια `allow.powered.creeper`, μπορεί να κρατήσει πατημένο το `πλήκτρο άλματος` για να φορτώσει. +- **`dolphin`**\ + Θα τρέξει με το πάτημα του `πλήκτρου άλματος`. +- **`phantom`**\ + Θα εκτοξεύσει φλόγες με το πάτημα του `πλήκτρου άλματος`. +- **`wither`**\ + Θα εκτοξεύσει το κεφάλι του wither με το `διπλό κλικ`. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/credits (Παίκτης)`](commands.md#credits). + +Επιτρέπει τη χρήση σε άλλους παίκτες πληκτρολογώντας `.other` μετά το όνομα της άδειας. + +#### `bukkit.command.demo` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/demo (Παίκτης)`](commands.md#demo). + +Επιτρέπει τη χρήση σε άλλους παίκτες πληκτρολογώντας `.other` μετά το όνομα της άδειας. + +#### `bukkit.command.ping` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/ping (Παίκτης)`](commands.md#ping). + +Επιτρέπει τη χρήση σε άλλους παίκτες πληκτρολογώντας `.other` μετά το όνομα της άδειας. + +#### `bukkit.command.ram` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/rambar (Παίκτης)`](commands.md#rambar). + +Επιτρέπει τη χρήση σε άλλους παίκτες πληκτρολογώντας `.other` μετά το όνομα της άδειας. + +#### `bukkit.command.restart` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/tpsbar (Παίκτης)`](commands.md#tpsbar). + +Επιτρέπει τη χρήση σε άλλους παίκτες πληκτρολογώντας `.other` μετά το όνομα της άδειας. + +#### `bukkit.command.timings` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Για παρόμοιες λειτουργίες, ελέγξτε το [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει τη χρήση της εντολής `/gamemode (GameMode) (Παίκτης)`. + +Επιτρέπει τη χρήση σε άλλους παίκτες πληκτρολογώντας `.other` μετά το όνομα της άδειας. + +#### `paper.antixray.bypass` + +- **Προεπιλογή**: `Κανένα` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Με αυτόν τον τρόπο και οι δύο πλευρές μπορούν να βελτιώσουν την απόδοσή τους. + +> Για περισσότερες πληροφορίες σχετικά με τη ρύθμιση του X-Ray, δείτε τη σελίδα παρακάτω. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Προεπιλογή**: `Κανένα` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Προεπιλογή**: `Κανένα` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Προεπιλογή**: `Κανένα` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει τη χρήση των [ετικετών MiniMessage](https://docs.advntr.dev/minimessage/format.html) στον μοχλό. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Προεπιλογή**: `Κανένα` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Προεπιλογή**: `Κανένα` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Προεπιλογή**: `Κανένα` + +Αποκλείει τον παίκτη από τη λίστα αποβολής λόγω αδράνειας. + +#### `purpur.debug.f3n` + +- **Προεπιλογή**: `Διαχειριστής Κόσμου` + +Επιτρέπει στον παίκτη να αλλάξει το game mode με το πλήκτρο `F3 + N`. + +Δεν λειτουργεί χωρίς την κατάλληλη άδεια για το game mode. + +#### `purpur.drop.spawners` + +- **Προεπιλογή**: `Κανένα` + +Όταν σπάσετε ένα spawner block με το συγκεκριμένο αντικείμενο, θα πέσει το spawner block. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Προεπιλογή**: `Κανένα` + +Αλλάζει το μέγεθος του ender chest. + +Μπορείτε να εισάγετε `one`, `two`, `three`, `four`, `five`, `six` στο `(NumberString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει τη λειτουργία του τότεμ της αθανασίας ακόμα και αν βρίσκεται στο inventory. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να αγνοήσει το όριο συνδέσεων. + +#### `purpur.mending_shift_click` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να επισκευάσει το αντικείμενο που κρατάει όταν `κάνει κλικ δεξιά και ταυτόχρονα κάνει κρυφή κίνηση`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να τοποθετήσει spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να μετακινηθεί αμέσως όταν χρησιμοποιεί την πύλη του Nether. + +#### `purpur.sign.color` + +- **Προεπιλογή**: `Κανένα` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει τη χρήση του κωδικού μαγείας `(&o)` στις πινακίδες. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Προεπιλογή**: `Κανένα` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να αποτρέψει την έκρηξη TNT κάνοντας `κλικ αριστερά και κρυφή κίνηση`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Δικαιώματα που πρόκειται να δοθούν + +#### `plazma.bypass.ncr-require` + +- **Προεπιλογή**: `Κανένα` + +Επιτρέπει στον παίκτη να συνδεθεί ακόμα κι αν δεν έχει εγκαταστήσει το [NoChatReports](https://modrinth.com/mod/no-chat-reports) mod. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Διαχειριστής. + +[^2]: Παράδειγμα: `ender_dragon` diff --git a/el/origin/plazma/adminstration/README.md b/el/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..8c737104f --- /dev/null +++ b/el/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Δημιουργήστε το δικό σας διακομιστή χρησιμοποιώντας το Plazma. +--- + +# ⚒️ Οδηγός Διαχείρισης Διακομιστή diff --git a/el/origin/plazma/adminstration/expert/README.md b/el/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..01389b834 --- /dev/null +++ b/el/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να αντιμετωπίζετε επαγγελματικά το Plazma. +--- + +# 🎓 Εμβάθυνση diff --git a/el/origin/plazma/adminstration/expert/fix-exploits.md b/el/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..913faf8b6 --- /dev/null +++ b/el/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε για γνωστά ευπαθή σημεία και πώς να τα αντιμετωπίσετε. +--- + +# ⚠️ Γνωστά ευπαθή σημεία και τρόποι αντιμετώπισής τους diff --git a/el/origin/plazma/adminstration/expert/optimize.md b/el/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..0afb062ca --- /dev/null +++ b/el/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να βελτιστοποιήσετε το Plazma. +--- + +# 🧹 Βελτιστοποίηση diff --git a/el/origin/plazma/adminstration/expert/vanillaize.md b/el/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..2ec9a9739 --- /dev/null +++ b/el/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Μάθετε πώς να επαναφέρετε το πατσάρισμα του Paper και της βανίλιας. +--- + +# ↩️ Βανιλιοποίηση + +{% hint style="warning" %} + +### Το Paper δεν προσθέτει επιλογές στις περισσότερες επιδιορθώσεις σφαλμάτων της βανίλιας. + +Το Plazma αναπτύσσει τη δυνατότητα απενεργοποίησης αυτών των διορθώσεων σφαλμάτων ως μέρος των ρυθμίσεών του αυτή τη στιγμή. + +Επομένως, αυτός ο οδηγός είναι ακόμα υπό κατασκευή και οι πληροφορίες μπορεί να αλλάξουν ανά πάσα στιγμή. +{% endhint %} diff --git a/el/origin/plazma/adminstration/faq.md b/el/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..cbd2ed42e --- /dev/null +++ b/el/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Μάθετε σχετικά με συχνές ερωτήσεις. +--- + +# ⁉️ Συχνές Ερωτήσεις + +{% hint style="info" %} + +### Δεν μπορείτε να βρείτε την απάντηση που ψάχνετε; + +Ρωτήστε την κοινότητα μέσω του [επίσημου διακομιστή Discord](https://discord.gg/MmfC52K8A8) ή των [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Η εκτέλεση δεν πραγματοποιείται με μήνυμα εξόδου + +Εάν εμφανίζεται το μήνυμα `no main manifest attribute, in plazma-(version).jar`,\ +το αρχείο που κατεβάσατε είναι αρχείο API ανάπτυξης, πρέπει να κατεβάσετε το **Reobf Paperweight** από τη σελίδα GitHub. + +Για περισσότερες πληροφορίες, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Εμφανίζεται προειδοποίηση κάθε φορά που ξεκινά ο διακομιστής + +Το Plazma περιλαμβάνει ορισμένα ασταθή patches και μπορεί πάντα να προκαλέσει δυσλειτουργίες, γι' αυτό εμφανίζει το ακόλουθο μήνυμα προειδοποίησης κάθε φορά που ο διακομιστής ξεκινά. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Μπορείτε να απενεργοποιήσετε το συγκεκριμένο μήνυμα προειδοποίησης χρησιμοποιώντας την ιδιότητα συστήματος [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Για περισσότερες πληροφορίες, ανατρέξτε στην παρακάτω σελίδα. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Διαθέσιμο από την έκδοση 1.20.1 diff --git a/el/origin/plazma/adminstration/getting-started/README.md b/el/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..941d63efd --- /dev/null +++ b/el/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Μάθετε πώς να δημιουργήσετε έναν διακομιστή με το Plazma. +--- + +# 👟 Ξεκινήστε + +Για να χρησιμοποιήσετε το Plazma με σταθερότητα, το σύστημά σας πρέπει να πληροί τις ακόλουθες απαιτήσεις. + +| | Ελάχιστο | Συνιστώμενο | +| :---------------: | -------: | ----------: | +| Αρχιτεκτονική | x64 | - | +| RAM | 8GB | 16GB | +| Χώρος αποθήκευσης | 1GB | 8GB | +| JRE | 17 | 21 | + +Για ομαλή επεξεργασία αρχείων ρυθμίσεων, είναι καλό να εγκαταστήσετε έναν επεξεργαστή κώδικα όπως το [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Εγκατάσταση JRE + +Όπως υποδηλώνει το όνομά του, το Minecraft: **"Java"** Edition έχει αναπτυχθεί με Java και για να εκτελεστεί απαιτεί το JRE[^1]. + +Δεδομένου ότι το Plazma βασίζεται στην επίσημη πλατφόρμα εξυπηρέτησης της Mojang Studios, πρέπει επίσης να εγκαταστήσετε το JRE για να χρησιμοποιήσετε το Plazma. + +### 1.1 Έλεγχος ύπαρξης JRE + +Για να ελέγξετε αν το JRE είναι εγκατεστημένο στο σύστημά σας, πληκτρολογήστε [`cmd /k java --version`](#user-content-fn-4)[^4] στην `Γραμμή Εντολών` και πατήστε `Enter`. + +Εάν εμφανιστεί το ακόλουθο, πηγαίνετε στο [2ο βήμα](setup.md#id-2). + +{% code title="Σωστή έξοδος" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Εάν δεν εμφανιστεί ή εμφανιστεί όπως παρακάτω, σημαίνει ότι το JRE δεν υπάρχει ή είναι πολύ παλιό και πρέπει να εκτελέσετε το [1.2 βήμα](setup.md#id-1.2). + +{% code title="Το JRE δεν είναι εγκατεστημένο" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="Το JRE είναι πολύ παλιό" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Εγκατάσταση JRE + +Σε αυτό τον οδηγό, θα χρησιμοποιήσουμε το Azul Zulu ως [ένα από τα είδη](#user-content-fn-5)[^5] του JRE. + +Αφού ολοκληρώσετε την εγκατάσταση, εκτελέστε ξανά το [1.1 βήμα](setup.md#id-1.1) για να ελέγξετε αν η εγκατάσταση ολοκληρώθηκε σωστά. + +{% tabs %} +{% tab title="Windows" %} + +1. Κατεβάστε το **JDK 21** από το [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) σε μορφή `.msi`. +2. Εκτελέστε τον κατεβασμένο οδηγό εγκατάστασης και κάντε κλικ στο `Επόμενο`. +3. Από το μενού που εμφανίζεται στο κέντρο-αριστερά της οθόνης, ενεργοποιήστε την επιλογή `Set JAVA_HOME variable` και κάντε κλικ στο `Επόμενο`. +4. Κάντε κλικ στο `Εγκατάσταση` για να ολοκληρώσετε την εγκατάσταση του JRE. + {% endtab %} + +{% tab title="macOS" %} +Κατεβάστε το **JDK 21** από το [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) σε μορφή `.dmg` και εκτελέστε τον οδηγό εγκατάστασης για να εγκαταστήσετε το JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Εταιρεία Microsoft. + +[^11]: Στην περίπτωση της Νότιας Κορέας, μπορείτε να υποβάλετε νομική ενστάσει στην **Κορεάτικη Εταιρεία Microsoft** σύμφωνα με το άρθρο 32 παράγραφος 1 υποπαράγραφος 9 του νόμου περί προώθησης της βιομηχανίας των βιντεοπαιχνιδιών. + +[^12]: Universal Plug & Play. Το Purpur που περιλαμβάνεται στο Plazma επικοινωνεί αυτόματα με τον router μέσω αυτής της τεχνολογίας και ανοίγει τη θύρα μόνο όταν ο διακομιστής είναι ενεργός, εξαλείφοντας την ανάγκη για άμεση προώθηση θυρών. + +[^13]: Σε περίπτωση που δεν έχετε λογαριασμό, εγγραφείτε στο Ngrok μέσω λογαριασμού Google ή GitHub. diff --git a/el/origin/plazma/adminstration/getting-started/customization.md b/el/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..802437056 --- /dev/null +++ b/el/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε πώς να εξατομικεύετε τον διακομιστή σας. +--- + +# 🎨 Εξατομίκευση χρήστη diff --git a/el/origin/plazma/adminstration/reference/arguments.md b/el/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..132594fff --- /dev/null +++ b/el/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **Τύπος**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **Τύπος**: `Ακέραιος` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `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` + +{% hint style="warning" %} + +### Αυτή η ιδιότητα θα μεταφερθεί ως παράμετρος εκκίνησης από την έκδοση 1.20.5 και μετά. + +{% endhint %} + +Εφαρμόζει πιο αυστηρή βελτιστοποίηση ρυθμίσεων κατά την αρχική εκκίνηση. + +Ενεργοποιώντας το, ο εξυπηρετητής γίνεται ακόμα πιο γρήγορος και ασφαλής, αλλά μπορεί να αποκλείσει κάποιες λειτουργίες ή να επηρεάσει σημαντικά το παιχνίδι. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `false` + +Αναστέλλει την εμφάνιση του μηνύματος προειδοποίησης[^11] κατά την αρχικοποίηση του Plazma. + +### Ανασταλμένη ιδιότητα + +Οι παρακάτω ιδιότητες συστήματος είναι ανασταλμένες. + +#### `timings.bypassMax` + +- **Τύπος**: `Boolean` +- **Προεπιλεγμένη τιμή**: `false` +- **ΔΙΑΚΟΠΗ ΧΡΗΣΗΣ**: Η Timings έχει αφαιρεθεί από το Plazma μετά την πρόσφατη αναβάθμιση + +Καθορίζει εάν μπορεί να υπερβεί το μέγιστο των τιμών που μπορούν να σταλούν στο Timings API του Aikar. + +Αν γίνει έτσι χωρίς να χειρίζεται εξαιρέσεις στο API, εφαρμόζεται περιορισμός ρυθμού. + +*** + +## Παράμετρος εκκίνησης + +Η παράμετρος εκκίνησης εισάγεται μετά το `-jar *.jar` για την εκκίνηση του Plazma και είναι μια τιμή που χειρίζεται μαζί. + +### Οδηγίες χρήσης + +Οι ιδιότητες του συστήματος εισάγονται ως παράμετροι εντολής προγράμματος μετά το `-jar *.jar`. + +Για παράδειγμα, εάν θέλετε να εφαρμόσετε την παράμετρο εκκίνησης `nogui`,\ +εισάγετε το παρακάτω για να χειριστεί η παράμετρος `nogui` κατά την αρχικοποίηση του Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Συνολική παράμετρος εκκίνησης + +#### `bukkit-settings` + +- **Ψευδώνυμο**: `b` +- **Προεπιλεγμένη τιμή**: `bukkit.yml` + +Ορίζει το όνομα και τη θέση του [αρχείου διαμόρφωσης Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Ψευδώνυμο**: `c` +- **Προεπιλεγμένη τιμή**: `commands.yml` + +Ορίζει το όνομα και τη θέση του [αρχείου διαμόρφωσης εντολών Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Ψευδώνυμο**: `c` +- **Προεπιλεγμένη τιμή**: `server.properties` + +Ορίζει το όνομα και τη θέση του [αρχείου ιδιοτήτων του διακομιστή](../reference/configurations/property.md). + +#### `demo` + +Εκκινεί τον διακομιστή σε λειτουργία επίδειξης. + +#### `eraseCache` + +Αφαιρεί τα απομείναντα αρχεία cache μετά την αναβάθμιση του κόσμου. + +#### `forceUpgrade` + +Αναβαθμίζει τον κόσμο ανεξάρτητα από την έκδοση με την επιλογή αυτή. + +#### `help` + +- **Ψευδώνυμο**: `?` + +Εμφανίζει τις συνολικές παραμέτρους εκκίνησης του Plazma και τις εξηγήσεις τους. + +#### `initSettings` + +Δημιουργεί μόνο το αρχείο διαμόρφωσης και κλείνει τον διακομιστή. + +#### `jfrProfile` + +Ενεργοποιεί το προφίλ JFR. + +#### `max-players` + +- **Ψευδώνυμο**: `s`, `size` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Ορίζει το μέγιστο αριθμό επιτρεπόμενων [παικτών](#user-content-fn-14). + +#### `nogui` + +Απενεργοποιεί το γραφικό πάνελ διεπαφής. + +#### `nojline` + +Απενεργοποιήστε το JLine και χρησιμοποιήστε τη βανίλια κονσόλα. + +#### `online-mode` + +- **Ψευδώνυμο**: `o` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Επιλέξτε εάν θέλετε να επικυρώνετε τους παίκτες με τους Mojang εξυπηρετητές επικύρωσης. + +**Αν δεν χρησιμοποιείτε το Velocity ή άλλο proxy, μπορεί να τιμωρηθείτε για παραβίαση του [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Ψευδώνυμο**: `paper` +- **Προεπιλεγμένο**: `paper.yml` + +{% hint style="warning" %} + +### Αυτό το όρισμα έχει σταματήσει να χρησιμοποιείται μετά την έκδοση 1.19.4 + +{% endhint %} + +Ορίζει τη θέση του αρχείου ρυθμίσεων του PaperSpigot που έχει σταματήσει να χρησιμοποιείται. + +Χρησιμοποιείται για τη μεταφορά των υφιστάμενων ρυθμίσεων σε νέο αρχείο ρυθμίσεων, και στη συνέχεια δεν χρησιμοποιείται. + +#### `paper-settings-directory` + +- **Ψευδώνυμο**: `paper-dir` +- **Προεπιλεγμένο**: `config` + +Ορίζει το όνομα και τη θέση του φακέλου όπου βρίσκονται τα αρχεία ρυθμίσεων του [Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Ψευδώνυμο**: `plazma-dir` + +Ορίζει το όνομα και τη θέση του φακέλου όπου βρίσκονται τα αρχεία ρυθμίσεων του [Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Ψευδώνυμο**: `p` +- **Προεπιλεγμένο**: `plugins` + +Ορίζει τη θέση του φακέλου προσθέτων. + +#### `pufferfish-settings` + +- **Ψευδώνυμο**: `pufferfish` +- **Προεπιλεγμένο**: `pufferfish.yml` + +Ορίζει το όνομα και τη θέση του αρχείου ρυθμίσεων του [Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Ψευδώνυμο**: `purpur` +- **Προεπιλεγμένο**: `purpur.yml` + +Ορίζει το όνομα και τη θέση του αρχείου ρυθμίσεων του [Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Ξεκινά τον διακομιστή σε πλήρη κατάσταση βανίλια. + +#### `server-ip` + +- **Ψευδώνυμο**: `h`, `host` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Ορίζει το όνομα του φιλοξενητή του διακομιστή ή τη διεύθυνση [Internet Protocol](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Ψευδώνυμο**: `p`, `port` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Ορίζει τη θύρα του διακομιστή. + +#### `server-name` + +- **Προεπιλεγμένο**: `Ένας Διακομιστής Plazma` + +Ορίζει το όνομα του διακομιστή. + +#### `spigot-settings` + +- **Ψευδώνυμο**: `S` +- **Προεπιλεγμένο**: `spigot.yml` + +Ορίζει το όνομα και τη θέση του αρχείου ρυθμίσεων του [Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Ψευδώνυμο**: `v` + +Εμφανίζει την έκδοση του Plazma. + +#### `world-dir` + +- **Ψευδώνυμο**: `W`, `universe`, `world-container` +- **Προεπιλεγμένο**: `(φάκελος διακομιστή)` + +Ορίζει τη θέση όπου αποθηκεύονται τα αρχεία κόσμου. + +#### `world-name` + +- **Ψευδώνυμο**: `w`, `world` +- **Προεπιλεγμένη τιμή**: `(Ιδιότητα διακομιστή)` + +Ορίζει το όνομα του αρχείου κόσμου. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Η τοποθεσία επεξεργασίας παραμέτρων αλλάζει ανάλογα με την προσαρμογή. + +[^3]: Για παράδειγμα, αν θέλετε να ενεργοποιήσετε το `Plazma.iKnowWhatIAmDoing` σε `true`, αρκεί να εισάγετε `-DPlazma.iKnowWhatIAmDoing` αντί για `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Για παράδειγμα, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Ανιχνευτής συμβάντων. + +[^6]: Ανιχνευτής συμβάντων. + +[^7]: Πελάτης. + +[^8]: Σήμα που υποδεικνύει ότι ο διακομιστής είναι συνδεδεμένος κανονικά, όπως η καρδιακή παλμικότητα. + +[^9]: Με τη χρήση της λειτουργίας απομάκρυνσης AFK του Purpur, μπορείτε να απομακρύνετε από τον διακομιστή ακόμη και παίκτες που έχουν αφήσει τη θέση τους. + +[^10]: Σύστημα συγχρονισμού εγγραφής τμημάτων, Sync Chunk Write System. + +[^11]: `ΠΡΟΕΙΔΟΠΟΙΗΣΗ! Το Plazma μπορεί να προκαλέσει απροσδόκητα προβλήματα, επομένως βεβαιωθείτε ότι το δοκιμάσετε εκτενώς πριν το χρησιμοποιήσετε σε δημόσιο διακομιστή.` + +[^12]: Η `βελτιστοποίηση κόσμου` στο παιχνίδι λειτουργεί με την ίδια αρχή. + +[^13]: Πρωτόκολλο Διαδικτύου, IP. + +[^14]: Οι διαχειριστές άνω του `επιπέδου 2` εξαιρούνται. diff --git a/el/origin/plazma/adminstration/reference/commands.md b/el/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..f26c0a9ac --- /dev/null +++ b/el/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε για τις εντολές που είναι διαθέσιμες στο Plazma. +--- + +# 🖥️ Εντολές diff --git a/el/origin/plazma/adminstration/reference/configurations/bukkit.md b/el/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..7de5ce822 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/el/origin/plazma/adminstration/reference/configurations/paper/README.md b/el/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..c2b3b129a --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε ποια είναι η χρήση κάθε αρχείου στο φάκελο config. +--- + +# 🛩️ Χαρτί diff --git a/el/origin/plazma/adminstration/reference/configurations/paper/global.md b/el/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..3d67a75ac --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του paper-global.yml. +--- + +# 🛩️ Χαρτί (Παγκόσμια διάταξη) diff --git a/el/origin/plazma/adminstration/reference/configurations/paper/world.md b/el/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..dc8612bae --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Αναζητήστε τι σημαίνει κάθε κόμβος του paper-world.yml. +--- + +# 🛩️ Χαρτί (Διάρθρωση κόσμου) diff --git a/el/origin/plazma/adminstration/reference/configurations/plazma/README.md b/el/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..6038f79c0 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε ποια είναι η χρήση κάθε αρχείου στο φάκελο config. +--- + +# ✨ Πλάζμα diff --git a/el/origin/plazma/adminstration/reference/configurations/plazma/global.md b/el/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..9699f91da --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του plazma-global.yml. +--- + +# ✨ Plazma (Παγκόσμια Διαμόρφωση) diff --git a/el/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/el/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..a7f492af7 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Παγκόσμια σύνθεση diff --git a/el/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/el/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..98a1f2e7e --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του plazma-world.yml. +--- + +# ✨ Πλάσμα (Διαμόρφωση κόσμου) diff --git a/el/origin/plazma/adminstration/reference/configurations/property.md b/el/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..d1907a544 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος του server.properties. +--- + +# 🪨 Server.properties diff --git a/el/origin/plazma/adminstration/reference/configurations/pufferfish.md b/el/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..674a63882 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Αναζητήστε τι σημαίνει κάθε κόμβος του pufferfish.yml. +--- + +# 🐡 Φουσκωτό ψάρι diff --git a/el/origin/plazma/adminstration/reference/configurations/purpur/README.md b/el/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..7b6d6ccf8 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο purpur.yml. +--- + +# 🦑 Πορφύρα diff --git a/el/origin/plazma/adminstration/reference/configurations/purpur/global.md b/el/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..73c7ac5ea --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο purpur.yml. +--- + +# 🦑 Πορφύρα (Παγκόσμια Διάταξη) diff --git a/el/origin/plazma/adminstration/reference/configurations/purpur/world.md b/el/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..b9e217de8 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο purpur.yml. +--- + +# 🦑 Πορφύρα (Διαμόρφωση κόσμου) diff --git a/el/origin/plazma/adminstration/reference/configurations/spigot.md b/el/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..ff785bc0c --- /dev/null +++ b/el/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ανακαλύψτε τι σημαίνει κάθε κόμβος στο spigot.yml. +--- + +# 🚰 Spigot diff --git a/el/origin/plazma/adminstration/reference/permissions.md b/el/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..98b51b294 --- /dev/null +++ b/el/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Μάθετε σχετικά με τα δικαιώματα του Plazma. +--- + +# 🛡️ Δικαιώματα diff --git a/el/origin/plazma/developers.md b/el/origin/plazma/developers.md new file mode 100644 index 000000000..f5c66f3b3 --- /dev/null +++ b/el/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Αναπτύξτε ένα πρότζεκτ τρίτων με τη χρήση του Plazma. +--- + +# ⚙️ Οδηγός Προγραμματιστή diff --git a/el/origin/thunderbolt/README.md b/el/origin/thunderbolt/README.md new file mode 100644 index 000000000..26c5b69ab --- /dev/null +++ b/el/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Το Thunderbolt είναι μια πλατφόρμα εξυπηρέτησης βασισμένη σε Plazma που διαχωρίζει πειραματικά τα περάσματα σε Flavor για να μπορείτε να τα χρησιμοποιήσετε απευθείας. +--- + +# 🌩️ Οδηγός Χρήσης Thunderbolt diff --git a/el/origin/volt/README.md b/el/origin/volt/README.md new file mode 100644 index 000000000..fffbeb999 --- /dev/null +++ b/el/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Το Volt είναι ένα ανοικτού κώδικα πρότυπο που μπορεί να αναπτύξει τη δική του πλατφόρμα εξυπηρέτησης βάρους χάρτινου βάρους με βάση την Plazma. +--- + +# ⚡ Οδηγός Ανάπτυξης Volt diff --git a/en-PT/origin/README.md b/en-PT/origin/README.md new file mode 100644 index 000000000..fab6fe562 --- /dev/null +++ b/en-PT/origin/README.md @@ -0,0 +1,41 @@ +--- +description: If ye have any questions, please ask on Discord or GitHub Discussions. +--- + +# 🏠 Welcome to Docs Portal + +{% hint style="info" %} + +**Plazma's document be currently in a state o' machine translation.** + +[![Translation Status](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) at the plank participate in document translation to improve the document. + +{% endhint %} + +### If thar be a problem while using Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### If yer interested in Thunderbolt, arrr! + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### If ye be wantin' to create yer own server platform with Volt, arrr! + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` If ye be needin' more Minecraft-related information, arrr! + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/en-PT/origin/SUMMARY.md b/en-PT/origin/SUMMARY.md new file mode 100644 index 000000000..db6ec851d --- /dev/null +++ b/en-PT/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Table o' contents + +- [🏠 Welcome t' Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Usage Docs](plazma/README.md) +- [❓ What be Plazma?](plazma/about/README.md) + - [⬇️ Download](plazma/about/downloads.md) + - [✅ Version Support Status](plazma/about/supported-versions.md) +- [⚒️ Shipmate Management Guide](plazma/administration/README.md) + - [👟 Setting Sail](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Reference](plazma/administration/reference/README.md) + - [🖥️ Commands](plazma/administration/reference/commands.md) + - [🛡️ Permissions](plazma/administration/reference/permissions.md) + - [🎛️ Assumptions and Attributes](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Attribute](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Advanced](plazma/administration/expert/README.md) + - [🧹 Optimization](plazma/administration/expert/optimize.md) + - [🔀 Matey](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 Spyglass Blockade](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilities and Solutions](plazma/administration/expert/fix-exploits.md) + - [⁉️ Frequently Asked Questions](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Developer Guide](plazma/developers.md) + - [✏️ Contribute](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Usage Guide](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Development Guide](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ View All Downloads](plazma/about/downloads-all.md) diff --git a/en-PT/origin/miscellaneous/README.md b/en-PT/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/en-PT/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/en-PT/origin/plazma/README.md b/en-PT/origin/plazma/README.md new file mode 100644 index 000000000..6c1ecc852 --- /dev/null +++ b/en-PT/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma be a Paper based experimental optimization with various game mechanism customization feature added Minecraft: Java Edition fer open source server platform." +--- + +# ✨ Plazma Usage Docs + +## 👋 Welcome to Plazma Docs + +Plazma usage docs ye be welcome! + +{% hint style="info" %} + +**Can ye not solve th' problem through th' manual?** + +[Official Discord ship](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions) be askin' questions to the crew through the community! + +{% endhint %} + +### About Plazma + +> Find out what kind o' server platform Plazma be. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### For Administrators + +> Use Plazma to create yer own server. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### For Developers + +> Use Plazma to develop third-party projects. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/en-PT/origin/plazma/about/README.md b/en-PT/origin/plazma/about/README.md new file mode 100644 index 000000000..5aa909d4c --- /dev/null +++ b/en-PT/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Find out what kind o' server platform Plazma be. +--- + +# ❓ What be Plazma? + +- **Plazma** be [Andromeda](https://github.com/EarendelArchived/Andromeda) and [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) advantages only be taken from [Paper](https://github.com/PaperMC/Paper) base o' server platform. +- Always high stability and powerful performance, quick updates, be strive t' provide vast features. + +## 📋 Plazma's goal + +- Strive t' be a server platform with quick updates and high stability. +- Strive t' provide vast features and powerful performance not inferior t' mod platforms. +- Strive t' create a free platform that can be customized even vanilla patches. + +## ⚙️ Main features + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Fastest updates**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ensures that Plazma's included patches be always kept up t' date, providin' the fastest updates among Paper-based server platforms. +6. **Optimized default configuration files**\ + The default configuration files be optimized, so ye don't need t' optimize the configuration files yerself. +7. **Systematically operate multi-threaded**\ + Asynchronize system mechanisms unrelated t' the game's mechanisms t' reduce [latency](#user-content-fn-4)[^4] and optimize the server. +8. **Block unnecessary space usage**\ + Combine all data with similar values into one t' reduce memory usage. + +## ✨ Use cases + +- **Platform handlin' complex plugins correctly**\ + Plazma be used on developer [IPECTER](https://github.com/IPECTER)'s server.\ + With self-plugins operatin' with NMS an' reflection, extensive an' complex data packs be heavily applied,\ + acceptin' over 100 players without performance degradation. +- **Platform maintainin' fast performance on RPG servers**\ + Stably maintainin' 100 players on a single cluster without TPS drops, an' allowin' a pleasant play experience fer 250 players on 4 clusters. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Many streamers be choosin' th' platform**\ + Many streamers' viewers be choosin' it as a bucket fer participation. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +Ye can download Plazma from the page below. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### If ye be wantin' detailed information about version support? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugins and Paper, Pufferfish, Purpur plugins. + +[^2]: Below be Microsoft Corporation. + +[^3]: Disablin' the chat report system allows chat t' be processed only on the server, preventin' Mojang's chat tracking. + +[^4]: Time when the game pauses momentarily for the system mechanism t' operate. diff --git a/en-PT/origin/plazma/about/downloads-all.md b/en-PT/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..0621e59a2 --- /dev/null +++ b/en-PT/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma runnin' document download all +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/en-PT/origin/plazma/about/downloads.md b/en-PT/origin/plazma/about/downloads.md new file mode 100644 index 000000000..79015b4df --- /dev/null +++ b/en-PT/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Right now download Plazma and try it out fer yerself. +--- + +# ⬇️ Download + +#### If ye be wantin' detailed information about version support? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Below be a runnin' file fer regular users.** + +If ye be a developer and be needin' a different type o' file, consult the page below. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionDownload
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/en-PT/origin/plazma/about/patches-list.md b/en-PT/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..3c590d216 --- /dev/null +++ b/en-PT/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Learn about all the features added to Plazma. +--- + +# 📑 Included Patches diff --git a/en-PT/origin/plazma/about/supported-versions.md b/en-PT/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..5c9bfa1be --- /dev/null +++ b/en-PT/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Discover the Minecraft: Java Edition version supported by Plazma." +--- + +# ✅ Version support status + +{% hint style="info" %} + +**Plazma bein' developed since 1.19.4, versions below 1.19.4 be not bein' developed.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Waitin%20for%20Release +[idv]: https://badge.plazmamc.org/1/development +[atv]: https://badge.plazmamc.org/2/support +[fse]: https://badge.plazmamc.org/6/function%20support%20discontinued +[eol]: https://badge.plazmamc.org/4/support%20ended +[ukn]: https://badge.plazmamc.org/0/No%20info +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/ordinary +[100]: https://badge.plazmamc.org/percent/100 + +![Waiting for release][wtr] ![Development][idv] ![Support][atv] ![Function support discontinued][fse] ![Support ended][eol] + +| Version | Stability and function support | Build status | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/en-PT/origin/plazma/administration/README.md b/en-PT/origin/plazma/administration/README.md new file mode 100644 index 000000000..10533d0f1 --- /dev/null +++ b/en-PT/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Use Plazma to create yer own server. +--- + +# ⚒️ Shipmate management guide diff --git a/en-PT/origin/plazma/administration/diagnosis/README.md b/en-PT/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..490eb2c46 --- /dev/null +++ b/en-PT/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: When a problem arises, find out how to deal with it. +--- + +# 🧾 진단 diff --git a/en-PT/origin/plazma/administration/diagnosis/plugins.md b/en-PT/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..5958e2cef --- /dev/null +++ b/en-PT/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: When ye be havin' trouble with a plugin not workin' properly, find out how to fix it. +--- + +# 📜 플러그인 diff --git a/en-PT/origin/plazma/administration/expert/README.md b/en-PT/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b4ccf734e --- /dev/null +++ b/en-PT/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Learn about how to handle Plazma professionally. +--- + +# 🎓 Advanced diff --git a/en-PT/origin/plazma/administration/expert/fix-exploits.md b/en-PT/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..581525697 --- /dev/null +++ b/en-PT/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Learn about known vulnerabilities and how to fix 'em. +--- + +# ⚠️ Known vulnerabilities and fixin' ways diff --git a/en-PT/origin/plazma/administration/expert/optimize.md b/en-PT/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..e8d1c6bad --- /dev/null +++ b/en-PT/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Discover how to optimize Plazma. +--- + +# 🧹 Optimize diff --git a/en-PT/origin/plazma/administration/expert/proxy.md b/en-PT/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..17bf10998 --- /dev/null +++ b/en-PT/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: How t' safely configure th' proxy platform "Velocity"? +--- + +# 🔀 Proxy diff --git a/en-PT/origin/plazma/administration/expert/vanillaize.md b/en-PT/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..d4e3f1dfb --- /dev/null +++ b/en-PT/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Learn how to restore Paper and vanilla patches, me hearties. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper be not addin' options t' most patches fixin' vanilla errors.** + +Currently, Plazma be workin' on makin' it possible to disable such error fixin' through configuration. + +Hence, this guide be still in the makin', with information subject to change at any time. + +{% endhint %} diff --git a/en-PT/origin/plazma/administration/expert/xray.md b/en-PT/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..95d87d9d8 --- /dev/null +++ b/en-PT/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Learn about various built-in ways to block X-Ray. +--- + +# 🩻 X-Ray Blockage diff --git a/en-PT/origin/plazma/administration/faq.md b/en-PT/origin/plazma/administration/faq.md new file mode 100644 index 000000000..6ccd6d17b --- /dev/null +++ b/en-PT/origin/plazma/administration/faq.md @@ -0,0 +1,43 @@ +--- +description: Learn about the frequently asked questions, ye scallywag. +--- + +# ⁉️ Frequently Asked Questions + +{% hint style="info" %} + +**Arrr ye not be findin' th' answer ye be lookin' fer?** + +[Official Discord ship](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions) be askin' questions to the crew through the community! + +{% endhint %} + +### Plazma be not startin' + +If `no main manifest attribute, in plazma-(version).jar` be showin' in the console, the downloaded file be a development API file, and ye need to download **Reobf Paperweight** from the GitHub page. + +To learn more in detail, be referrin' to the followin' page. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Warnings be displayed every time the server be startin' + +Plazma be containin' some unstable patches and may always have a chance of malfunction, hence the server be displayin' the followin' warning message each time it starts. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ye can disable the said warning message usin' the [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +To learn more in detail, be referrin' to the followin' page. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available from 1.20.1 diff --git a/en-PT/origin/plazma/administration/getting-started/README.md b/en-PT/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..4db51596e --- /dev/null +++ b/en-PT/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Discover how to make a server with Plazma. +--- + +# 👟 Gettin' Started + +To use Plazma reliably, yer system must meet the followin' requirements. + +| | Minimum | Recommended | +| :-----------: | ------- | ----------- | +| Architecture | x64 | - | +| RAM | 8GB | 16GB | +| Storage Space | 1GB | 8GB | +| JDK | 17 | 21 | + +For smooth configuration file edits, it be good to install an editor like [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Proper Output" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' be not an internal or external command, nor be it a program or +batch file. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. First off, download **JDK 21** from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) in `.msi` format. +2. Run the downloaded install wizard and click `Next`. +3. After activatin' `Set JAVA_HOME variable` in the menu displayed in the center-left o' the window, click `Next`. +4. Press `Install` t' complete the JRE install. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, run the followin' command in the terminal t' install JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma offers various types o' executable files. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Learn More + +The name o' the executable file be `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mappin' type).jar`. + +- **Mappin' Type**\ + Mappin' be a kind o' map that connects Minecraft's actual code with the obfuscated code. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + The version manager be a launcher necessary fer server operation, patchin' server files, and libraries. + - **Paperclip**\ + Developed by the PaperMC team fer Paper and other derivative platforms, it downloads libraries and applies patches t' the server. + - **Bundler**\ + The vanilla Minecraft version manager. + +
+ +*** + +## 3. Start Script Creation + +T' easily start Plazma and automatically restart the server, ye need t' create a [start script](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Ye can download the start script by clickin' the download button at the bottom left.\ +**Make sure the downloaded start script matches yer operatin' system.** + +*** + +## 4. File Organization + +Now, move the downloaded start script and Plazma t' a new folder. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Now, run the start script. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Agreement + +Once ye run the start script, a `eula.txt` file will be created in the folder. + +The EULA[^9] be a license agreement ye must agree t' by usin' the services o' [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +T' agree t' the EULA, change `eula=false` in the `eula.txt` file t' `eula=true` and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operatin' systems block external access by default t' prevent risky access from outside via the **firewall** and **router**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +If yer router does not support UPnP, ye must search fer the specific panel fer each router, as they vary. + +Alternatively, ye can use [Ngrok](https://ngrok.com/) t' generate a temporary address. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Checkin' the Need fer Port Forwardin' + +Enter the followin' in the run window and execute it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output be `True`, ye be good t' go, but if it be `False`, ye need t' set up port forwardin'. + +### 6.2 Connectin' t' the Server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +The address t' connect t' the server can be found [here](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Then, after restartin' the server, Plazma will automatically attempt port forwardin'. + +The success o' UPnP will be determined by the message output t' the console, which will be displayed as `[UPnP] (message)`. + +| Message | Meanin' | +| --------------------------------- | --------------------------------------------------- | +| `Successfully opened port (port)` | Port forwardin' successful. | +| `Port (port) is already open` | Another service be usin' that port. | +| `Failed t' open port (port)` | Port forwardin' failed. | +| `Service be unavailable` | The router does not support UPnP. | + +When the server shuts down, Plazma will automatically close the port. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Download the `Windows (64-bit)` ZIP file from the [Ngrok website](https://ngrok.com/download). +2. Place the downloaded Ngrok in the server folder. +3. Generate an authentication token from the [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Run the command displayed in the `Command Line` section in the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top o' the run script, and `taskkill /f /t /im ngrok.exe` at the bottom. +6. At the tippity top o' th' console be showin' `Forwardin' tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, 'n `0.tcp.jp.ngrok.io:12345` becometh th' server's address. +7. Ye can now connect through that address from th' outside. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +For example, if 'tis shown as follows after runnin' th' command, + +```log +Windows IP Configuration + +Ethernet adapter Ethernet: + + Connection-specific DNS Suffix . . . . . : + IPv4 Address. . . . . . . . . . . : 192.168.3.7 + Subnet Mask . . . . . . . . . . . : 255.255.255.0 + Default Gateway . . . . . . . . . : 192.168.3.1 + +``` + +Ye can connect t' th' server from yer local machine by attemptin' t' connect t' th' `192.168.3.7` shown in th' IPv4 address. + +If th' server 'n th' game be runnin' on th' same PC, ye can connect usin' `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Thrivin' + +Once ye have successfully started th' server 'n 'tis runnin' properly, 'tis time t' customize th' server. + +Learn how t' customize yer server through th' followin' guide. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma's foundation Paper be based on Spigot, 'n Spigot be based on th' official server platform. + +[^3]: Pressin' Windows key + R + +[^4]: For Linux, in th' terminal type `java --version` + +[^5]: JRE be one o' th' open-source projects, like Minecraft server platforms, there be various types. + +[^6]: Usually known as a **launcher**. + +[^7]: If ye enable "Auto-restart", th' server will restart automatically. Ye can end by pressin' `Control + C`. + +[^8]: It be not advisable t' exceed more than half o' th' system's capacity. + + For instance, if ye be havin' a total system memory capacity o' 8GB, settin' it above 4GB be not bein' recommended. + +[^9]: End-User License Agreement, Final User Use Covenant. For more details, check out [Minecraft website](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: In the case o' South Korea, under the Game Industry Promotion Act Article 32, Paragraph 1, Item 9, **Korea Microsoft Corporation** bein' able to pursue legal action. + +[^12]: Universal Plug & Play. Plazma in Purpur be communicatin' automatically with the router through this technology, so there be no need to be doin' port forwardin' directly when the server be runnin', the port be openin' only when the server be runnin'. + +[^13]: If ye don't have an account, sign up for Ngrok with yer Google or GitHub account. diff --git a/en-PT/origin/plazma/administration/getting-started/customization.md b/en-PT/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..253b85760 --- /dev/null +++ b/en-PT/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,124 @@ +--- +description: Learn how to userize the server. +--- + +# 🎨 Userization + +Using a modified server platform like Plazma instead of the official server platform provided by Mojang Studios +is because the most significant reason is the ability for **customization**. + +Below are various ways to customize and utilize Plazma. + +## Configuration Modification + +The most basic way to customize Plazma is to modify the configuration. + +Plazma provides powerful configuration settings from game mechanics to mob attributes. + +Refer to the following page for explanations about Plazma's configurations. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Plugin Usage + +{% hint style="success" %} + +**Plazma be supportin' all plugins based on Paper.** + +For Spigot plugins, there may be some issues due to mappin' changes from Paper 1.20.5 onwards, +but most plugins based on Paper like Paper, Pufferfish, and Purpur be workin' on Plazma as well, +and if they don't be workin' properly, it be an error of Plazma, so please [report it immediately.](../diagnosis/plugins.md) + +{% endhint %} + +Bein' a major reason for usin' Plazma and the most powerful way to customize Plazma. +Plazma's powerful plugin ecosystem makes it easy to customize servers. + +There be various ways to find and download plugins. Some plugins be uploaded to public repository services, while others be uploaded to GitHub or their own +sites. + +{% hint style="caution" %} + +**Plugins can directly access the system!** + +Always make sure to check if a plugin be safe by usin' services like VirusTotal before applyin' it, +or download plugins from trusted services. + +{% endhint %} + +There be several services used to download plugins. Among them, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) be services that go through a review process before plugins be uploaded, makin' sure only safe plugins be distributed. + +### Applyin' Plugins + +Once ye have downloaded a plugin, it be time to apply it. + +1. Plugins be in `.jar` or `Java Executable File` format.\ + Some plugins may be compressed, in which case + ye should unzip them and if there be files with `bukkit`, `spigot`, or `paper` in their names, + use the `fat` file if there be one. +2. Put the downloaded file in the `plugins` folder of the server directory and restart the server. +3. When Plazma starts, new content will be output to the console. + This means that Plazma has properly loaded the plugins. +4. Even if Plazma has loaded the plugins properly, they may not have started. + Ye can use the `/plugins` command to load the currently installed plugins on the server. + If the plugin names be not in red + but in green, then the plugins have been loaded properly. + +If the plugins haven't loaded properly, ye can find solutions on the followin' page. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Usin' Data Packs + +Data Packs be a way to customize Minecraft similar to +[Resource Packs](#user-content-fn-1)[^1]. + +With Data Packs, ye can modify parts of the game like addin' new creatures and challenges. + +{% hint style="caution" %} + +**Data Packs can damage worlds!** + +Some faulty Data Packs can damage worlds irreversibly. + +Therefore, it be recommended to backup the world before applyin' Data Packs. + +{% endhint %} + +Data Packs can be downloaded from various services like [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) and others. + +Once ye have downloaded a Data Pack, ye can apply it by puttin' it in the `datapacks` folder of the server's world directory. +If the folder doesn't exist, ye can create it and add the Data Pack. + +{% hint style="warning" %} + +**Some [Data Packs](#user-content-fn-2)[^2] may not apply properly on the first try.** + +In such cases, it be recommended to restart the server **2 times**. + +{% endhint %} + +Data Packs can easily get damaged with each Minecraft update. + +Especially when Data Packs be completely damaged, the server may crash, +so it be important to thoroughly test before updatin' the server. + +{% hint style="info" %} + +**After the server startin' command, ye can enter `safeMode` to disable all Data Packs before startin' the server.** + +[Refer to 'Arguments' in the `Reference` for more details.](../reference/arguments.md) + +{% endhint %} + +Ye can check the applied Data Packs with the `/datapack list` command. + +*** + +[^1]: Or in Minecraft: Bedrock Edition's add-ons. + +[^2]: Such as addin' new creatures. diff --git a/en-PT/origin/plazma/administration/getting-started/next-step.md b/en-PT/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..f2b1b79a7 --- /dev/null +++ b/en-PT/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Learn how to userize the server. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Below are various ways to customize and utilize Plazma. + +## Configuration Modification + +The most basic way to customize Plazma is to modify the configuration. + +Plazma provides powerful configuration settings from game mechanics to mob attributes. + +Refer to the following page for explanations about Plazma's configurations. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Plugin Usage + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Bein' a major reason for usin' Plazma and the most powerful way to customize Plazma. Plazma's powerful plugin ecosystem makes it easy to customize servers. + +There be various ways to find and download plugins. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +There be several services used to download plugins. Among them, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) be services that go through a review process before plugins be uploaded, makin' sure only safe plugins be distributed. + +### Applyin' Plugins + +Once ye have downloaded a plugin, it be time to apply it. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Put the downloaded file in the `plugins` folder of the server directory and restart the server. +3. When Plazma starts, new content will be output to the console. This means that Plazma has properly loaded the plugins. +4. Even if Plazma has loaded the plugins properly, they may not have started. Ye can use the `/plugins` command to load the currently installed plugins on the server. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +If the plugins haven't loaded properly, ye can find solutions on the followin' page. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Usin' Data Packs + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +With Data Packs, ye can modify parts of the game like addin' new creatures and challenges. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Some faulty Data Packs can damage worlds irreversibly. + +Therefore, it be recommended to backup the world before applyin' Data Packs. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Once ye have downloaded a Data Pack, ye can apply it by puttin' it in the `datapacks` folder of the server's world directory. If the folder doesn't exist, ye can create it and add the Data Pack. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +In such cases, it be recommended to restart the server **2 times**. +{% endhint %} + +Data Packs can easily get damaged with each Minecraft update. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Ye can check the applied Data Packs with the `/datapack list` command. + +*** + +## Optimization + +Plazma has many optimization patches applied. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Refer to the following page for information on safe and proper proxy settings. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Safety + +As Minecraft mods advance, it is easy to find [vulnerability attack engines](#user-content-fn-3)[^3] online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Permission Settings + +Some plugin admin commands may have vulnerabilities if permissions are not properly set. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray Blocking + +X-Ray is one of the vulnerabilities easily accessible even in basic optimization clients. + +Plazma provides configurations to block X-Ray by default. + +Please refer to the following page for X-Ray blocking methods and explanations. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Use `/whitelist query` to see players allowed to access. + +*** + +[^1]: Or in Minecraft: Bedrock Edition's add-ons. + +[^2]: Such as addin' new creatures. + +[^3]: Generally referred to as "hacks." + +[^4]: If the configuration is not optimized, Plazma is outdated, or new vulnerabilities are discovered, they may not be blocked. + +[^5]: When players connect to the server, they connect through the Ngrok proxy server, and the Ngrok address issued changes with each restart. diff --git a/en-PT/origin/plazma/administration/reference/README.md b/en-PT/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..1cc67e429 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Discover the ways to customize provided by Plazma, ye scallywag! +--- + +# 📜 리퍼런스 + +Plazma be offerin' various ways to customize, me hearties. + +Among them, these 4 ways be ready to use without any additional work needed, arrr! + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Official Discord ship](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions) be askin' questions to the crew through the community! +{% endhint %} + +*** + +## 🖥️ Commands + +> Commands allow ye to gather information in the game or customize the play environment, savvy? + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permissions + +> Permissions be settin' the range in which players can interact, matey. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Arguments and Attributes + +> Arguments and Attributes be havin' a broad impact on the operation of Plazma, arrr! + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurations + +> Configurations be the most basic way to customize Plazma, ye scurvy dogs. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/en-PT/origin/plazma/administration/reference/arguments.md b/en-PT/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..27cacbcd1 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Learn about the start arguments and system properties, me hearties. +--- + +# 🎛️ Arguments and Properties + +Start acquisition and system attributes be values added to Plazma execution [commands](#user-content-fn-1)[^1], impacting Plazma's operation overall. + +[Location to add to the command](#user-content-fn-2)[^2] will be divided into **start arguments** and **system properties** according to the instructions. + +*** + +## System properties + +System properties be values processed by the JVM before Plazma be initialized and entered before `-jar`, matey. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### How to use + +System properties be entered as Java command arguments between `java` and `-jar`, me hearties. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` signifies that the argument be not embedded in the JVM but be an additional argument exclusive to Plazma, arrr, + +If no value is entered for the property, the value will be fixed as [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### All system properties + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Updates discontinued sign formats, arrr. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging related to entity information, matey. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables NMS revision to enable proper loading of debug information in the IDE, arrr, and automatically remaps internal version information, arrr. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the Spigot Watchdog warning system, me hearties. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the confirmation message for the `/reload` command, arrr. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +If ye be a plugin developer and need to update a plugin, use hotswapping instead of `/reload`, arrr. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables plugins using the standard input/output system, arrr. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Issues a warning when legacy formatting be detected in chat components, arrr. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables server pattern matching verification when players connect to the server, arrr. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging for missing keys in NBT objects, me hearties. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging for head blocks with invalid profile information, arrr. + +Logs all invalid head blocks within the world with their locations, arrr. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Default Value**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the plugin class prioritization system, arrr. + +Useful if issues arise from plugin shading, arrr. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the Netty flush consolidation system, arrr. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Default Value**: `750` + +Splits entities into multiple packets for transmission if they exceed the set value, arrr. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Default Value**: `8192` + +Sets the maximum packet size the server can receive at once, arrr. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables Java version checking, me hearties. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +This could permanently damage world files and overall game mechanics, arrr. + +Any issues caused by this be the responsibility of the user, and Plamza provides no support for it, arrr. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Default Value**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Default Value**: `80` + +Sets the maximum length of characters that can be entered on one line of a sign, arrr. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Default Value**: `(world version) + 1` + +Sets the version of world update information to initialize first, arrr. + +Useful when needing to update large amounts of chunks but otherwise not used, arrr. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Default Value**: `True` + +Enables processing of comments in YAML files, arrr. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Default Value**: `30` + +If a player does not receive any data for the set amount of time in seconds, they be kicked from the server, arrr. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Ignores comments in server properties, arrr. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging for synchronous chunk loading, arrr. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables Minecraft's [default chunk writing system](#user-content-fn-10)[^10], matey. + +This saves each chunk in order, causing significant performance degradation, arrr. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables Explicit Flushing for network channels, arrr. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Always logs errors that occur outside the main thread, arrr. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Outputs a warning if scheduled tasks have excessive wait times, arrr. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Default Value**: `False` + +When using the default provided executable, only applies patches without starting the server, arrr. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Default Value**: `false` +- **Clash**: `Plazma.disableConfigOptimization` + +Fortify the initial setup more. + +Activating this will make the server faster and safer, but it can have a significant impact on gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolean` +- **Default Value**: `false` +- **Clash**: `Plazma.aggressiveOptimize` + +Do not optimize the initial setup. + +This uses the default configuration of Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default Value**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolean` +- **Default Value**: `false` + +Disable Plazma branding and use the vanilla default server favicon. + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolean` +- **Default Value**: `false` +- **Clash**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +This can significantly impact server safety and performance. + +All issues arising from this property are the responsibility of the server administrator. +{% endhint %} + +Provides the initial setup with the default values provided by Mojang. + +Disables all vulnerability patches applied by Paper. + +Vulnerability patches can be re-enabled in the Paper configuration or Plazma configuration. + +#### `Plazma.vanillaize` + +- **Type**: `Boolean` +- **Default**: `true` +- **Clash**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Set up the initial configuration closer to vanilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Discontinued booty + +Below system booty be a discontinued booty. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Default Value**: `false` +- **Abandoned**: Timings bein' removed from Plazma front-end since + +Determines if it be acceptable t' exceed th' maximum value that can be sent t' Aikar's Timings API. + +Even if done so, if not handled by th' API, rate limitin' be applied. + +*** + +## Startin' Arguments + +Startin' Arguments be input after `-jar *.jar` fer Plazma initialization an' be processed together with it. + +### Usin' Method + +System properties be input as program command arguments after `-jar *.jar`. + +For example, if ye be tryin' t' apply th' `nogui` startin' argument,\ +enterin' as follows will make Plazma process th' `nogui` argument durin' initialization. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Total Startin' Arguments + +#### `bukkit-settings` + +- **Alias**: `b` +- **Default**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Default**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Default**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Starts th' server with a demo world. + +#### `eraseCache` + +Removes any leftover cache files after world upgrade. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Displays Plazma's total startin' arguments an' descriptions. + +#### `initSettings` + +Only generates configuration files an' shuts down th' server. + +#### `jfrProfile` + +Enables JFR profiling. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Default**: `(Server Properties)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Disables th' graphical interface panel. + +#### `nojline` + +Disables JLine an' uses vanilla console. + +#### `online-mode` + +- **Alias**: `o` +- **Default**: `(Server Properties)` + +Chooses whether t' authenticate players with Mojang authentication servers. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Default**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Sets th' location o' th' deprecated PaperSpigot configuration file. + +This be used t' migrate existin' configurations t' a new configuration file an' be not used thereafter. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Default**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Default**: `plugins` + +Sets th' location o' th' plugin folder. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Default**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Default**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Starts th' server in a complete vanilla state (safe mode). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Default**: `(Server Properties)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Default**: `(Server Properties)` + +Sets th' port o' th' server. + +#### `server-name` + +- **Default**: `A Plazma Server` + +Sets th' name o' th' server. + +#### `spigot-settings` + +- **Alias**: `S` +- **Default**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Outputs th' Plazma version. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Default**: `(Server Folder)` + +Sets th' location where world files be stored. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Default**: `(Server Properties)` + +Sets th' name o' th' world file. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Position where arguments be processed changes dependin' on where they be appended. + +[^3]: For example, if ye be wantin' t' set (enable) `Plazma.iKnowWhatIAmDoing` t' `true`, enterin' `-DPlazma.iKnowWhatIAmDoing=true` be th' same as enterin' `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: For example, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Matey. + +[^8]: Signal notifying that ye be properly connected to the server like a heartbeat. + +[^9]: Using Purpur's AFK bootin' feature, ye can boot players who be away from their seats. + +[^10]: Sync Chunk Write System, Matey. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: In the game, `world optimization` also operates on the same principle. + +[^13]: `Level 2` or higher administrators are excluded. + +[^14]: Internet Protocol, IP. diff --git a/en-PT/origin/plazma/administration/reference/commands.md b/en-PT/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..3afd0db71 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Discover the commands available in Plazma. +--- + +# 🖥️ Commands diff --git a/en-PT/origin/plazma/administration/reference/configurations/README.md b/en-PT/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..8aac00b59 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Configurations be the most basic way to customize Plazma, ye scurvy dogs. +--- + +# 🧾 구성 + +*** + +## 🪨 Attribute + +> Attributes are the most basic composition files provided in Minecraft. Using attributes allows you to change the basic mechanisms of the game. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Configuration + +> Bukkit configuration is the most basic configuration file provided in Plazma. Using Bukkit configuration allows you to change the basic mechanisms of a Minecraft server. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Configuration + +> Spigot configuration allows you to modify the detailed mechanisms of the game, player processing, operation of commands, and messages. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Configuration + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish configuration allows you to change the processing of worlds and entities in Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Configuration + +> Purpur attributes allow you to modify the overall basic data of the game. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Configuration + +> Plazma configuration allows you to customize Plazma's features. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/en-PT/origin/plazma/administration/reference/configurations/bukkit.md b/en-PT/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e84eaa8aa --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in bukkit.yml means. +--- + +# 🪣 Bukkit diff --git a/en-PT/origin/plazma/administration/reference/configurations/paper/README.md b/en-PT/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..43473cc41 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Learn the purpose of each file in the config folder. +--- + +# 🛩️ Paper diff --git a/en-PT/origin/plazma/administration/reference/configurations/paper/global.md b/en-PT/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a0f0eee84 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🌏 전역 구성 diff --git a/en-PT/origin/plazma/administration/reference/configurations/paper/world.md b/en-PT/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..3095c8425 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Find out what each node in the paper-world.yml means. +--- + +# 🏳️ 세계별 구성 + +Worldly diff --git a/en-PT/origin/plazma/administration/reference/configurations/plazma/README.md b/en-PT/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..2e08a7ab2 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Learn the purpose of each file in the config folder. +--- + +# ✨ Port o' Plazma diff --git a/en-PT/origin/plazma/administration/reference/configurations/plazma/global.md b/en-PT/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..d2edaeca4 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/en-PT/origin/plazma/administration/reference/configurations/plazma/world.md b/en-PT/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..833845b94 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/en-PT/origin/plazma/administration/reference/configurations/plazma/worlds.md b/en-PT/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/en-PT/origin/plazma/administration/reference/configurations/property.md b/en-PT/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..cce4704d6 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: find out what each node in the server.properties means. +--- + +# 🪨 Server.properties diff --git a/en-PT/origin/plazma/administration/reference/configurations/pufferfish.md b/en-PT/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04ffee13e --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 Pufferfish diff --git a/en-PT/origin/plazma/administration/reference/configurations/purpur/README.md b/en-PT/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fe215c95b --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur diff --git a/en-PT/origin/plazma/administration/reference/configurations/purpur/global.md b/en-PT/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..379d3d5a8 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🌏 전역 구성 diff --git a/en-PT/origin/plazma/administration/reference/configurations/purpur/world.md b/en-PT/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..c41642913 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🏳️ 세계별 구성 diff --git a/en-PT/origin/plazma/administration/reference/configurations/spigot.md b/en-PT/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..b967c25b1 --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in the spigot.yml means. +--- + +# 🚰 Spigot diff --git a/en-PT/origin/plazma/administration/reference/permissions.md b/en-PT/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..142c1940d --- /dev/null +++ b/en-PT/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Learn about the authority of Plazma. +--- + +# 🛡️ Authority + +Authority be a simple security tool on the server that sets the scope where players can interact with each other. + +To properly utilize and easily modify authority, ye must use plugins like [LuckPerms](https://luckperms.net). + +*** + +## Understanding the basic authority system + +In Minecraft, basic management authority groups be provided. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Player**\ + Generally be the authority group given to all players. +2. **Mediator**\ + Can ignore spawn protection. +3. **World Administrator**\ + Can use all commands and command blocks related to world management.\ + Be the default authority group applied to datapacks and command blocks. +4. **Administrator**\ + Can use all commands related to player management. +5. **Super Administrator**\ + Can use all commands including server management.\ + Be the default authority group applied to console and operators. + +*** + +## Setting authority + +*** + +## All authority + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Default**: `None` + +Allows players to mount entities by crouching and interacting with the entity. + +When mounted on an entity, players can control the entity's movement with the movement keys and jump or fly with the jump key. + +The [Namespaced ID](#user-content-fn-2)[^2] of the entity be entered in `(Namespaced Key)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Default**: `None` + +Allows players to use special abilities of entities while mounted on them. + +Not all entities have accessible special abilities. Refer below for a list of all available special abilities. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Post yer ideas on [Plazma Discord](https://plazmamc.org/discord) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +View currently available special abilities + +- **`crepper`**\ + Explodes when the jump key be pressed.\ + If a player has the `allow.powered.creeper` authority, they can hold the jump key to charge. +- **`dolphin`**\ + Dashes when the jump key be pressed. +- **`phantom`**\ + Fires flames when the jump key be pressed. +- **`wither`**\ + Fires wither skulls when interacted with. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Default**: `World Administrator` + +Allows the use of the [`/compass` command](commands.md#compass). + +#### `bukkit.command.credits` + +- **Default**: `World Administrator` + +Allows the use of the [`/credits (Player)` command](commands.md#credits). + +By adding `.other` after the authority name, allows it to be used on other players. + +#### `bukkit.command.demo` + +- **Default**: `World Administrator` + +Allows the use of the [`/demo (Player)` command](commands.md#demo). + +By adding `.other` after the authority name, allows it to be used on other players. + +#### `bukkit.command.ping` + +- **Default**: `World Administrator` + +Allows the use of the [`/ping (Player)` command](commands.md#ping). + +By adding `.other` after the authority name, allows it to be used on other players. + +#### `bukkit.command.ram` + +- **Default**: `World Administrator` + +Allows the use of the [`/ram` command](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Default**: `World Administrator` + +Allows the use of the [`/rambar (Player)` command](commands.md#rambar). + +By adding `.other` after the authority name, allows it to be used on other players. + +#### `bukkit.command.restart` + +- **Default**: `World Administrator` + +Allows the use of the [`/restart` command](commands.md#restart). + +#### `bukkit.command.tps` + +- **Default**: `World Administrator` + +Allows the use of the [`/tps` command](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Default**: `World Administrator` + +Allows the use of the [`/tpsbar (Player)` command](commands.md#tpsbar). + +By adding `.other` after the authority name, allows it to be used on other players. + +#### `bukkit.command.timings` + +- **Default**: `World Administrator` + +Allows the use of the [`/timings` command](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Check [Spark](https://spark.lucko.me/docs/Command-Usage) for similar commands. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Default**: `World Administrator` + +Allows the use of the [`/uptime` command](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Default**: `World Administrator` + +Allows the use of the `/gamemode (GameMode) (Player)` command. + +By adding `.other` after the authority name, allows it to be used on other players. + +#### `paper.antixray.bypass` + +- **Default**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +This benefits both sides by enhancing performance. + +> Refer to the page below to learn how to configure X-Ray settings. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Default**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Default**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Default**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Default**: `None` + +Allows the use of MiniMessage tags on anvils. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Default**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Default**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Default**: `None` + +Excludes players from being kicked for idle status. + +#### `purpur.debug.f3n` + +- **Default**: `World Administrator` + +Allows players to change game modes with `F3 + N` key combination. + +This only functions if the player has authority for that game mode. + +#### `purpur.drop.spawners` + +- **Default**: `None` + +Dropping a spawner block with the configured item will drop the spawner block. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Default**: `None` + +Changes the size of ender chests. + +`(NumberString)` can be `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Default**: `None` + +Allows totems of undying to function even when in the inventory. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Default**: `None` + +Allow the player to ignore the connection limit. + +#### `purpur.mending_shift_click` + +- **Default**: `None` + +Allow the player to mend the item they are holding by `crouching and interacting`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Default**: `None` + +Allow the player to install spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Default**: `None` + +Allow the player to teleport instantly when using the Nether portal. + +#### `purpur.sign.color` + +- **Default**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Default**: `None` + +Allow the use of obfuscation code `(&o)` on signs. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Default**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Default**: `None` + +Allow players to `interact` with TNT using shears to prevent explosion. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Planned permissions + +#### `plazma.bypass.ncr-require` + +- **Default**: `None` + +Allow players to connect even if [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) mod is not installed. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Sailor. + +[^2]: Example: `ender_dragon` diff --git a/en-PT/origin/plazma/adminstration/README.md b/en-PT/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..10533d0f1 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Use Plazma to create yer own server. +--- + +# ⚒️ Shipmate management guide diff --git a/en-PT/origin/plazma/adminstration/expert/README.md b/en-PT/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b4ccf734e --- /dev/null +++ b/en-PT/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Learn about how to handle Plazma professionally. +--- + +# 🎓 Advanced diff --git a/en-PT/origin/plazma/adminstration/expert/fix-exploits.md b/en-PT/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..581525697 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Learn about known vulnerabilities and how to fix 'em. +--- + +# ⚠️ Known vulnerabilities and fixin' ways diff --git a/en-PT/origin/plazma/adminstration/expert/optimize.md b/en-PT/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..e8d1c6bad --- /dev/null +++ b/en-PT/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Discover how to optimize Plazma. +--- + +# 🧹 Optimize diff --git a/en-PT/origin/plazma/adminstration/expert/vanillaize.md b/en-PT/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..64f72e28e --- /dev/null +++ b/en-PT/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Learn how to restore Paper and vanilla patches, me hearties. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper be not offerin' options for most of vanilla's error fixin' patches. + +Currently, Plazma be workin' on makin' it possible to disable such error fixin' through configuration. + +Hence, this guide be still in the makin', with information subject to change at any time. +{% endhint %} diff --git a/en-PT/origin/plazma/adminstration/faq.md b/en-PT/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..14bf8ac25 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/faq.md @@ -0,0 +1,42 @@ +--- +description: Learn about the frequently asked questions, ye scallywag. +--- + +# ⁉️ Frequently Asked Questions + +{% hint style="info" %} + +### Can't find the answer ye be lookin' for? + +[Official Discord Server](https://discord.gg/MmfC52K8A8) or [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) be where ye can ask the community! +{% endhint %} + +### Execution be not happenin' with a message bein' displayed + +If `no main manifest attribute, in plazma-(version).jar` be showin' in the console, the downloaded file be a development API file, and ye need to download **Reobf Paperweight** from the GitHub page. + +To learn more in detail, be referrin' to the followin' page. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Warnings be displayed every time the server be startin' + +Plazma be containin' some unstable patches and may always have a chance of malfunction, hence the server be displayin' the followin' warning message each time it starts. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ye can disable the said warning message usin' the [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +To learn more in detail, be referrin' to the followin' page. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available from 1.20.1 diff --git a/en-PT/origin/plazma/adminstration/getting-started/README.md b/en-PT/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..f07a702c1 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Discover how to make a server with Plazma. +--- + +# 👟 Gettin' Started + +To use Plazma reliably, yer system must meet the followin' requirements. + +| | Minimum | Recommended | +| :-----------: | ------: | ----------: | +| Architecture | x64 | - | +| RAM | 8GB | 16GB | +| Storage Space | 1GB | 8GB | +| JRE | 17 | 21 | + +For smooth configuration file edits, it be good to install an editor like [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE Installation + +As the name suggests, Minecraft: **"Java"** Edition be developed in Java, so ye need JRE[^1] to run it. + +Plazma be based on Mojang Studios' official server platform, so ye also need to install JRE to use Plazma. + +### 1.1 Checkin' for JRE + +To check if JRE be installed on yer system, type [`cmd /k java --version`](#user-content-fn-4) in the Run window and run it. + +If it be outputtin' like this, skip to [Step 2](setup.md#id-2). + +{% code title="Correct Output" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +If it don't output like that, or if it be like this, then JRE be either not there or too old, so ye need to do [Step 1.2](setup.md#id-1.2). + +{% code title="JRE not installed" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE bein' too ol'" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE Install + +In this guide, we be usin' Azul Zulu as [one o' the types](#user-content-fn-5)[^5] o' JRE. + +After ye be finishin' the install, run [step 1.1](setup.md#id-1.1) again t' make sure the install be completed correctly. + +{% tabs %} +{% tab title="Windows" %} + +1. First off, download **JDK 21** from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) in `.msi` format. +2. Run the downloaded install wizard and click `Next`. +3. After activatin' `Set JAVA_HOME variable` in the menu displayed in the center-left o' the window, click `Next`. +4. Press `Install` t' complete the JRE install. + {% endtab %} + +{% tab title="macOS" %} +Download **JDK 21** in `.dmg` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) and run the install wizard t' install JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +First off, run the followin' command in the terminal t' add Azul Zulu repository t' APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, run the followin' command in the terminal t' install JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Ye can install JRE by enterin' the followin' command. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma offers various types o' executable files. + +{% hint style="warning" %} + +### In most cases, ye be usin' `Reobf Paperclip`. + +The followin' be fer developers or those curious about the characteristics o' each type.\ +If ye be a regular user, ye can skip t' [step 3](setup.md#id-3) without any issues. +{% endhint %} + +
+ +Learn More + +The name o' the executable file be `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mappin' type).jar`. + +- **Mappin' Type**\ + Mappin' be a kind o' map that connects Minecraft's actual code with the obfuscated code. + - **Reobf**\ + Reobfuscation, also known as Spigot mappin', be used in most NMS plugins.\ + It be scheduled t' be discontinued from 1.20.5 onwards. + - **Mojmap**\ + Mojang mappin', the vanilla Minecraft mappin'. +- **Version Manager**\ + The version manager be a launcher necessary fer server operation, patchin' server files, and libraries. + - **Paperclip**\ + Developed by the PaperMC team fer Paper and other derivative platforms, it downloads libraries and applies patches t' the server. + - **Bundler**\ + The vanilla Minecraft version manager. + +
+ +*** + +## 3. Start Script Creation + +T' easily start Plazma and automatically restart the server, ye need t' create a [start script](#user-content-fn-6)[^6]. + +Ye can create the start script via [Flags.sh](https://flags.sh).\ +Just enter the memory ye want t' use fer Plazma, and the command will be automatically optimized. + +Ye can download the start script by clickin' the download button at the bottom left.\ +**Make sure the downloaded start script matches yer operatin' system.** + +*** + +## 4. File Organization + +Now, move the downloaded start script and Plazma t' a new folder. + +{% hint style="warning" %} + +### The folder name must have no spaces and be set in English. + +Otherwise, Plazma or JRE may not function correctly. +{% endhint %} + +Now, run the start script. For Windows, ye must select **Allow** in the firewall permission prompt. + +*** + +## 5. EULA Agreement + +Once ye run the start script, a `eula.txt` file will be created in the folder. + +The EULA[^9] be a license agreement ye must agree t' by usin' the services o' [Mojang Studios](#user-content-fn-10)[^10]. + +If ye do not agree t' the EULA, ye cannot start the server and may face sanctions such as account suspension fer violatin' the EULA. + +T' agree t' the EULA, change `eula=false` in the `eula.txt` file t' `eula=true` and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operatin' systems block external access by default t' prevent risky access from outside via the **firewall** and **router**. + +Since ye allowed the firewall in [step 3](setup.md#id-3) fer Windows, ye just need t' do port forwardin'. + +{% hint style="info" %} + +### This guide assumes it be written fer Windows operatin' system and a router capable o' usin' [**UPnP**](#user-content-fn-12)[^12]. + +If yer router does not support UPnP, ye must search fer the specific panel fer each router, as they vary. + +Alternatively, ye can use [Ngrok](https://ngrok.com/) t' generate a temporary address. +{% endhint %} + +{% hint style="warning" %} + +### Fer Linux or macOS, and other (semi-) UNIX-based operatin' systems, the method fer settin' up the firewall service varies, so ye must search fer the specific information. + +{% endhint %} + +### 6.1 Checkin' the Need fer Port Forwardin' + +Enter the followin' in the run window and execute it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output be `True`, ye be good t' go, but if it be `False`, ye need t' set up port forwardin'. + +### 6.2 Connectin' t' the Server + +{% tabs %} +{% tab title="External Connection" %} +If port forwardin' be not needed or ye have already successfully set up port forwardin', ye can now connect t' the server. + +The address t' connect t' the server can be found [here](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Attemptin' UPnP Port Forwardin'" %} +In the `purpur.yml` file in the server folder, enable `network.upnp-port-forwarding` t' `true`. + +Then, after restartin' the server, Plazma will automatically attempt port forwardin'. + +The success o' UPnP will be determined by the message output t' the console, which will be displayed as `[UPnP] (message)`. + +| Message | Meanin' | +| --------------------------------- | ----------------------------------- | +| `Successfully opened port (port)` | Port forwardin' successful. | +| `Port (port) is already open` | Another service be usin' that port. | +| `Failed t' open port (port)` | Port forwardin' failed. | +| `Service be unavailable` | The router does not support UPnP. | + +When the server shuts down, Plazma will automatically close the port. +{% endtab %} + +{% tab title="Generatin' a Temporary Address with Ngrok" %} +Usin' Ngrok be useful fer short-term tests, collaborative play, or playin' with friends. + +1. Download the `Windows (64-bit)` ZIP file from the [Ngrok website](https://ngrok.com/download). +2. Place the downloaded Ngrok in the server folder. +3. Generate an authentication token from the [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Run the command displayed in the `Command Line` section in the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top o' the run script, and `taskkill /f /t /im ngrok.exe` at the bottom. +6. At the tippity top o' th' console be showin' `Forwardin' tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, 'n `0.tcp.jp.ngrok.io:12345` becometh th' server's address. +7. Ye can now connect through that address from th' outside. + {% endtab %} + +{% tab title="Connectin' from Local" %} +If ye be tryin' t' connect t' th' server from yer local machine, ye can use th' `IPv4 Address` that be shown when runnin' `cmd /k ipconfig` in th' command prompt. + +For example, if 'tis shown as follows after runnin' th' command, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Ye can connect t' th' server from yer local machine by attemptin' t' connect t' th' `192.168.3.7` shown in th' IPv4 address. + +If th' server 'n th' game be runnin' on th' same PC, ye can connect usin' `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Evolution Stage + +Once ye have successfully started th' server 'n 'tis runnin' properly, 'tis time t' customize th' server. + +Learn how t' customize th' server through th' guide below. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java Execution Environment. + +[^2]: Plazma's foundation Paper be based on Spigot, 'n Spigot be based on th' official server platform. + +[^3]: Pressin' Windows key + R + +[^4]: For Linux, in th' terminal type `java --version` + +[^5]: JRE be one o' th' open-source projects, like Minecraft server platforms, there be various types. + +[^6]: Usually known as a **launcher**. + +[^7]: If ye enable "Auto-restart", th' server will restart automatically. Ye can end by pressin' `Control + C`. + +[^8]: It be not advisable t' exceed more than half o' th' system's capacity. + + For instance, if ye be havin' a total system memory capacity o' 8GB, settin' it above 4GB be not bein' recommended. + +[^9]: End-User License Agreement, Final User Use Covenant. For more details, check out [Minecraft website](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: In the case o' South Korea, under the Game Industry Promotion Act Article 32, Paragraph 1, Item 9, **Korea Microsoft Corporation** bein' able to pursue legal action. + +[^12]: Universal Plug & Play. Plazma in Purpur be communicatin' automatically with the router through this technology, so there be no need to be doin' port forwardin' directly when the server be runnin', the port be openin' only when the server be runnin'. + +[^13]: If ye don't have an account, sign up for Ngrok with yer Google or GitHub account. diff --git a/en-PT/origin/plazma/adminstration/getting-started/customization.md b/en-PT/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..bd39d4ca1 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Learn how to userize the server. +--- + +# 🎨 Userization diff --git a/en-PT/origin/plazma/adminstration/reference/arguments.md b/en-PT/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..1381056ed --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Learn about the start arguments and system properties, me hearties. +--- + +# 🎛️ Arguments and Properties + +Start variables and system properties be values added to the [command used for Plazma execution](#user-content-fn-1)[^1], allowing for changing unchangeable values after Plazma be run. + +Depending on the location where they be added to the command, they be divided into **start arguments** and **system properties**, arrr. + +*** + +## System properties + +System properties be values processed by the JVM before Plazma be initialized and entered before `-jar`, matey. + +{% hint style="warning" %} + +### Modifying system properties can change how Plazma and the JVM operate, and can have a significant impact on the game, arrr! + +If ye not be sure what each system property does, **never use it!** +{% endhint %} + +### How to use + +System properties be entered as Java command arguments between `java` and `-jar`, me hearties. + +For instance, if ye be wanting to apply the `Plazma.dummyProperty` system property, entering it as follows will set the property to `37` upon initialization of Plazma, arrr. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` signifies that the argument be not embedded in the JVM but be an additional argument exclusive to Plazma, arrr, + +If no value be entered for the property, the value be fixed to [`true`, arrr.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### The Paperweight server platform series be including a `.` in the property name to distinguish system properties for each platform, matey. + +In some terminals like Windows Powershell, these arguments may not be allowed, so ye be needing to add `"` to both ends of the argument, arrr. +{% endhint %} + +### All system properties + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Updates discontinued sign formats, arrr. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging related to entity information, matey. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables NMS revision to enable proper loading of debug information in the IDE, arrr, and automatically remaps internal version information, arrr. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the Spigot Watchdog warning system, me hearties. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the confirmation message for the `/reload` command, arrr. + +{% hint style="danger" %} + +### The `/reload` command be very unstable, so any issues occurring after using `/reload` be the responsibility of the user, arrr. + +If ye be a plugin developer and need to update a plugin, use hotswapping instead of `/reload`, arrr. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables plugins using the standard input/output system, arrr. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Issues a warning when legacy formatting be detected in chat components, arrr. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables server pattern matching verification when players connect to the server, arrr. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging for missing keys in NBT objects, me hearties. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging for head blocks with invalid profile information, arrr. + +Logs all invalid head blocks within the world with their locations, arrr. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the limit of 128 plugin channels per player, me hearties. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the plugin class prioritization system, arrr. + +Useful if issues arise from plugin shading, arrr. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables the Netty flush consolidation system, arrr. + +#### `Paper.excessiveTELimit` + +- **Type**: `Integer` +- **Default Value**: `750` + +Splits entities into multiple packets for transmission if they exceed the set value, arrr. + +#### `Paper.filterThreshold` + +- **Type**: `Integer` +- **Default Value**: `8192` + +Sets the maximum packet size the server can receive at once, arrr. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Disables Java version checking, me hearties. + +{% hint style="danger" %} + +### This may allow the JVM to attempt to access non-existent code! + +This could permanently damage world files and overall game mechanics, arrr. + +Any issues caused by this be the responsibility of the user, and Plamza provides no support for it, arrr. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Integer` +- **Default Value**: `64` + +Sets the limit for plugin channel names, me hearties. + +#### `Paper.maxSignLength` + +- **Type**: `Integer` +- **Default Value**: `80` + +Sets the maximum length of characters that can be entered on one line of a sign, arrr. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Integer` +- **Default Value**: `(world version) + 1` + +Sets the version of world update information to initialize first, arrr. + +Useful when needing to update large amounts of chunks but otherwise not used, arrr. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Default Value**: `True` + +Enables processing of comments in YAML files, arrr. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Integer` +- **Default Value**: `30` + +If a player does not receive any data for the set amount of time in seconds, they be kicked from the server, arrr. + +Normally, the game[^7] constantly sends a [heartbeat signal](#user-content-fn-8)[^8] to the server, so players do not get kicked, but if the game stops responding, the player be considered to have crashed and be kicked from the server without further processing, arrr. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Ignores comments in server properties, arrr. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables debug logging for synchronous chunk loading, arrr. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables Minecraft's [default chunk writing system](#user-content-fn-10)[^10], matey. + +This saves each chunk in order, causing significant performance degradation, arrr. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Enables Explicit Flushing for network channels, arrr. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Always logs errors that occur outside the main thread, arrr. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Default Value**: `False` + +Outputs a warning if scheduled tasks have excessive wait times, arrr. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Default Value**: `False` + +When using the default provided executable, only applies patches without starting the server, arrr. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Default Value**: `false` + +{% hint style="warning" %} + +### This property be planned to move to start arguments after 1.20.5, matey. + +{% endhint %} + +Applies more stringent configuration optimization at the beginning, me hearties. + +When activated, the server becometh faster and safer, but may blocketh some glitches or have a great impact on game play. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default Value**: `false` + +Suppresseth the warning message[^11] that appeareth when Plazma be initializ'd. + +### Discontinued booty + +Below system booty be a discontinued booty. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Default Value**: `false` +- **Abandoned**: Timings bein' removed from Plazma front-end since + +Determines if it be acceptable t' exceed th' maximum value that can be sent t' Aikar's Timings API. + +Even if done so, if not handled by th' API, rate limitin' be applied. + +*** + +## Startin' Arguments + +Startin' Arguments be input after `-jar *.jar` fer Plazma initialization an' be processed together with it. + +### Usin' Method + +System properties be input as program command arguments after `-jar *.jar`. + +For example, if ye be tryin' t' apply th' `nogui` startin' argument,\ +enterin' as follows will make Plazma process th' `nogui` argument durin' initialization. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Total Startin' Arguments + +#### `bukkit-settings` + +- **Alias**: `b` +- **Default**: `bukkit.yml` + +Sets th' name an' location of [Bukkit Configuration File](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Default**: `commands.yml` + +Sets th' name an' location of [Bukkit Command Configuration File](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Default**: `server.properties` + +Sets th' name an' location of [Server Properties](../reference/configurations/property.md) file. + +#### `demo` + +Starts th' server with a demo world. + +#### `eraseCache` + +Removes any leftover cache files after world upgrade. + +#### `forceUpgrade` + +Forces an upgrade o' th' world, ignorin' th' version. + +#### `help` + +- **Alias**: `?` + +Displays Plazma's total startin' arguments an' descriptions. + +#### `initSettings` + +Only generates configuration files an' shuts down th' server. + +#### `jfrProfile` + +Enables JFR profiling. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Default**: `(Server Properties)` + +Sets th' maximum number o' [players](#user-content-fn-14). + +#### `nogui` + +Disables th' graphical interface panel. + +#### `nojline` + +Disables JLine an' uses vanilla console. + +#### `online-mode` + +- **Alias**: `o` +- **Default**: `(Server Properties)` + +Chooses whether t' authenticate players with Mojang authentication servers. + +**If not usin' Velocity or other proxies, may be sanctioned fer violatin' [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Default**: `paper.yml` + +{% hint style="warning" %} + +### This argument has been deprecated since 1.19.4 + +{% endhint %} + +Sets th' location o' th' deprecated PaperSpigot configuration file. + +This be used t' migrate existin' configurations t' a new configuration file an' be not used thereafter. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Default**: `config` + +Sets th' name an' location o' th' folder where [Paper Configuration File](../reference/configurations/paper/README.md) be located. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Sets th' name an' location o' th' folder where [Plazma Configuration File](../reference/configurations/plazma/README.md) be located. + +#### `plugins` + +- **Alias**: `p` +- **Default**: `plugins` + +Sets th' location o' th' plugin folder. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Default**: `pufferfish.yml` + +Sets th' name an' location of [Pufferfish Configuration File](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Default**: `purpur.yml` + +Sets th' name an' location of [Purpur Configuration File](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Starts th' server in a complete vanilla state (safe mode). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Default**: `(Server Properties)` + +Sets th' host name or [Internet Protocol](#user-content-fn-13) address of th' server. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Default**: `(Server Properties)` + +Sets th' port o' th' server. + +#### `server-name` + +- **Default**: `A Plazma Server` + +Sets th' name o' th' server. + +#### `spigot-settings` + +- **Alias**: `S` +- **Default**: `spigot.yml` + +Sets th' name an' location of [Spigot Configuration File](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Outputs th' Plazma version. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Default**: `(Server Folder)` + +Sets th' location where world files be stored. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Default**: `(Server Properties)` + +Sets th' name o' th' world file. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Position where arguments be processed changes dependin' on where they be appended. + +[^3]: For example, if ye be wantin' t' set (enable) `Plazma.iKnowWhatIAmDoing` t' `true`, enterin' `-DPlazma.iKnowWhatIAmDoing=true` be th' same as enterin' `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: For example, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Matey. + +[^8]: Signal notifying that ye be properly connected to the server like a heartbeat. + +[^9]: Using Purpur's AFK bootin' feature, ye can boot players who be away from their seats. + +[^10]: Sync Chunk Write System, Matey. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: In the game, `world optimization` also operates on the same principle. + +[^13]: Internet Protocol, IP. + +[^14]: `Level 2` or higher administrators are excluded. diff --git a/en-PT/origin/plazma/adminstration/reference/commands.md b/en-PT/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..3afd0db71 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Discover the commands available in Plazma. +--- + +# 🖥️ Commands diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/bukkit.md b/en-PT/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e84eaa8aa --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in bukkit.yml means. +--- + +# 🪣 Bukkit diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/paper/README.md b/en-PT/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..43473cc41 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Learn the purpose of each file in the config folder. +--- + +# 🛩️ Paper diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/paper/global.md b/en-PT/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..0110c7573 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🛩️ Parchment (Worldwide Configuration) diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/paper/world.md b/en-PT/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..2d7ce52fb --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in the paper-world.yml means. +--- + +# 🛩️ Paper (Worldly Composition) diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/plazma/README.md b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..2e08a7ab2 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Learn the purpose of each file in the config folder. +--- + +# ✨ Port o' Plazma diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/plazma/global.md b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a836b1569 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (전역 구성) diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..1c02eef21 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏴‍☠️ Worldly Composition diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/property.md b/en-PT/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..cce4704d6 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: find out what each node in the server.properties means. +--- + +# 🪨 Server.properties diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/pufferfish.md b/en-PT/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04ffee13e --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 Pufferfish diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/purpur/README.md b/en-PT/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fe215c95b --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/purpur/global.md b/en-PT/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..5dbfbc807 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur (전역 구성) diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/purpur/world.md b/en-PT/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..fa373699a --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur (Worldly Composition) diff --git a/en-PT/origin/plazma/adminstration/reference/configurations/spigot.md b/en-PT/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..b967c25b1 --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in the spigot.yml means. +--- + +# 🚰 Spigot diff --git a/en-PT/origin/plazma/adminstration/reference/permissions.md b/en-PT/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..4e0fd441d --- /dev/null +++ b/en-PT/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Learn about the authority of Plazma. +--- + +# 🛡️ Authority diff --git a/en-PT/origin/plazma/developers.md b/en-PT/origin/plazma/developers.md new file mode 100644 index 000000000..0d31e830d --- /dev/null +++ b/en-PT/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Use Plazma to develop third-party projects. +--- + +# ⚙️ Developer's Guide diff --git a/en-PT/origin/thunderbolt/README.md b/en-PT/origin/thunderbolt/README.md new file mode 100644 index 000000000..31a8646b6 --- /dev/null +++ b/en-PT/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt be an experimental patch bein' divided into flavors so ye can use it directly, a Plazma-based server platform. +--- + +# 🌩️ Thunderbolt Usage Guide diff --git a/en-PT/origin/volt/README.md b/en-PT/origin/volt/README.md new file mode 100644 index 000000000..ab6aaa6a1 --- /dev/null +++ b/en-PT/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt be Plazma를 기반으로 자신만의 Paperweight 서버 플랫폼을 개발할 수 있는 오픈 소스 템플릿입니다. +--- + +# ⚡ Volt Development Guide diff --git a/en-UD/origin/README.md b/en-UD/origin/README.md new file mode 100644 index 000000000..ab68170b0 --- /dev/null +++ b/en-UD/origin/README.md @@ -0,0 +1,41 @@ +--- +description: 요세뚜 주 해 질문해 를 시코허츠노 suohcseugiD 트로hCsiD 에서 또는 Discord 또는 GitHub Discussions를 통해 질문해 주세요. +--- + +# ʞɔǝɹǝɯɐ ʇo puǝpɐɔ sᴉ sᴉɥ┴ + +{% hint style="info" %} + +**.sdiasdnuɹoɯǝ ǝʇɐɹǝɐɥ ǝɹɐɯǝɹ ǝɥʇ ǝuɹǝɟǝq ǝp ǝɯıɥ ǝsɹǝʌǝɹ ǝɥʇ ǝɹɐɯǝɹ** + +[![Translation Status](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) .뷺sᄉㅥog ɛɿ(øɈźʞn · ̚ nɿoɯ sɘsoxɘʞː ɘíčɿɘx ɯoɈ čn ɘɈpoɯǝsp ɯɘc. + +{% endhint %} + +### ?emanos ot degnerts eb nevahs gnihtemos rehtoM + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### ¿ɯɹǝɥ ǝɥɔᴉs ǝɥʇ sᴉɥ┴ + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### ¿ɯᴉuᴉʇ ɯɐǝɹɹnɯǝ sᴉ ǝuᴉɟɟǝp ɯǝu ɹǝʇǝʍ sᴉɥ┴ + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `ƃuᴉɹɐɥ` ɯǝ ɯɐuǝɯǝ ɯɐ ɹǝɥʇɐǝɥ ǝɥʇ ɹǝɥʇɐǝɥ ɓuᴉɹɐɥ ɹǝʇǝʍ sᴉɥ┴ <ɐ ɥǝʇ-1 ɓuᴉɹɐɥ="ɯɐu-1" ɥǝ="ɐ"> + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/en-UD/origin/SUMMARY.md b/en-UD/origin/SUMMARY.md new file mode 100644 index 000000000..cf8db7c97 --- /dev/null +++ b/en-UD/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# sɘɿɒlǝɔ oʇ sǝɔnɔoʇ + +- [🏠 ɯǝlcomǝ ʇo puoɔs ɹǝʇɐɯnɹɐɔ](README.md) + - [⚛️ htiGub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 ɔısnɔɹp](https://discord.gg/MmfC52K8A8) + - [📊 sʇɐʇs](https://bstats.org/plugin/server-implementation/Plazma) + +## amzalP + +- [✨ amzalP ǝsn ɔıpǝ](plazma/README.md) +- [❓ amzalPɹɐl](plazma/about/README.md) + - [⬇️ ǝuopnolɹɐ](plazma/about/downloads.md) + - [✅ ǝuɹǝp ıɯɐɹuɐ sɐɯʇɐ](plazma/about/supported-versions.md) +- (⚒️.ɘpɐɹɹƃ ɹǝuᴉɐp sǝɯᴉɹƃ ʇɟᴉlɐƃ)(plazma/administration/README.md) + - (👟.ǝpɹᴉɥs ɐɹǝʇɹᴉɐɯ)(plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 ǝɹnsɹǝuɹ] + - [🖥️ ɯouɹǝɯǝ] + - [🛡️ ǝɥɔɹɐu] + - [🎛️ ɹǝuɟǝs ɐuɯ sᴉɥʇuɐɯ] + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 ʇɐʞǝɯ] + - [🚰 ʇɯᴉƃ] + - [🛩️ ɹɐǝɹ] + - [🌏 ǝɹɐʇ ɟnɹouᴉɟ] + - [🏳️ World configuration](plazma/administration/reference/configurations/paper/world.md) + - [🐡 ɟnɹouᴉɟ] + - [🦑 ɹɯɯd] + - [🌏 ǝɹɐʇ ɟnɹouᴉɟ] + - [🏳️ World configuration](plazma/administration/reference/configurations/purpur/world.md) + - [✨ ɐɯouɹɐ] + - [🌏 ǝɹɐʇ ɟnɹouᴉɟ] + - [🏳️ World configuration](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 sᴉɯɥɐ] + - [🧹 ǝɯouuᴉɐɯ] + - [🔀 ɹoʞsᴉ](plazma/administration/expert/proxy.md) + - [↩️ uoᴉɐuouɥɐ] + - [🩻 X-Ray ɹǝɯɐu](plazma/administration/expert/xray.md) + - [⚠️ sᴉɯɯɐɯouɥɐ ɘuɯɐᴉlɐɯ] + - [⁉️ uɯoɯ ǝnbǝɯ uoɹq] + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ ɐılǝɹɐɯɹ ǝɔıp](plazma/developers.md) + - [✏️ sǝɹǝɥoɹɐılɐ](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ sdɹɐɯouɔ](https://jd.plazmamc.org/) + +## tɘɿɒɘɿɒlʇ + +- [🌩️ ǝɯɹɐɥɔɹɐɯ ɘɯıpǝ](thunderbolt/README.md) + +## ʇoʎ + +- [⚡ ʌoɹʇ ɓuılǝpɹɐʇ ǝɔıpǝ](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ ɯouǝuɯɐ ǝɹɹǝɯsɹǝɔ] diff --git a/en-UD/origin/amzalp/adminstration/d-u-s/README.md b/en-UD/origin/amzalp/adminstration/d-u-s/README.md new file mode 100644 index 000000000..e716bf053 --- /dev/null +++ b/en-UD/origin/amzalp/adminstration/d-u-s/README.md @@ -0,0 +1,2 @@ +# 📜 ɹǝdɐɹǝuɔǝs + diff --git a/en-UD/origin/amzalp/adminstration/d-u-s/ui-id/README.md b/en-UD/origin/amzalp/adminstration/d-u-s/ui-id/README.md new file mode 100644 index 000000000..e16f02c2e --- /dev/null +++ b/en-UD/origin/amzalp/adminstration/d-u-s/ui-id/README.md @@ -0,0 +1,2 @@ +# 🎨 ƃuıɐɹɟ ǝɹɐʇɥıd + diff --git a/en-UD/origin/miscellaneous/README.md b/en-UD/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/en-UD/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/en-UD/origin/plazma/README.md b/en-UD/origin/plazma/README.md new file mode 100644 index 000000000..8900a652e --- /dev/null +++ b/en-UD/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: .snoitpalf ot noitamrofni ytilaer eht sserp ot noitseuqer tsetnoc suomixE :avaJ tfosorciM naht esiralcnuoc lanoitpmahtuo eht dna aizamrepxe 를데살최 실험적의 를다식메 게임 여러와 최적화 실험적의 기반 Paper 는amzaPl +--- + +# scoD esagU amzaPl ✨ + +## scoD amzaPl ot emocleW 👋 + +!다니즘커메게러뉴사용자화와 최적화실험적의 기반 Paper 를다식메 게임 여러와 최적화 실험적의 기반 Paper 는amzaPl + +{% hint style="info" %} + +**?yonna uoy lausaeht enilahp aenom** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! + +{% endhint %} + +### amzaPl tuohtuobA + +> .morfniatalf레브서무인플 란머피레브서 란머피레브서인플 서버의 어떤인플 란머피레브서 란머피레브서인플 는amzaPl + +{/tuoba/"lru=fer-tnetnoc %} +[tuoba](tuoba/) +{/tnetnoc-dne %} + +### srotaritnA roF + +> .esorytmahtuo데살를드데살만신자레자뉴만신자레자뉴데살자신만의 서버를 만들어 amzaPl roF + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### srepoleveD roF + +> .dm.developers/"lru=fer-tnetnoc %} +> [dm.developers](dm.developers/) +> {/tnetnoc-dne %} + +.dm.srepoleveD roF + +*** diff --git a/en-UD/origin/plazma/about/README.md b/en-UD/origin/plazma/about/README.md new file mode 100644 index 000000000..46b501283 --- /dev/null +++ b/en-UD/origin/plazma/about/README.md @@ -0,0 +1,72 @@ +--- +description: .morfniatalf레브서무인플 란머피레브서 란머피레브서인플 서버의 어떤인플 란머피레브서 란머피레브서인플 는amzaPl +--- + +# ¿What is Plazma? + +- **Plazma** is a server platform based on [Paper](https://github.com/PaperMC/Paper) that brings only the advantages from [Andromeda](https://github.com/EarendelArchived/Andromeda) and [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- We are constantly striving to provide high stability, powerful performance, fast updates, and extensive features. + +## 📋 Goals of Plazma + +- We are striving to become a server platform with fast updates and high stability. +- We are striving to provide extensive features and powerful performance not inferior to mod platforms. +- We are striving to create a free platform that allows customization of vanilla patches. + +## ⚙️ Key Features + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Fastest updates**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ensures that Plazma's included patches are always kept up to date, providing the fastest updates among Paper-based server platforms. +6. **Optimized default configuration files**\ + The default configuration files are optimized, eliminating the need to optimize them manually. +7. **Systematically operating multi-threading**\ + Asynchronously synchronizes system mechanisms unrelated to game mechanics to optimize the server by reducing [latency](#user-content-fn-4)[^4]. +8. **Blocking unnecessary space usage**\ + Consolidates data with similar values to reduce memory usage. + +## ✨ Use Cases + +- nɹǝɥʇouɐ ǝɥʇ\*\*\ + ɐılɐɹʇsnɐ [IPECTER](https://github.com/IPECTER)ǝs uǝɹɐɯɹǝɥ ɐılɐɹʇsnɐɹɐ ǝɥʇ\*\*\ + NMSɐɹ ɹᴉɟılǝɥɔɐ ǝɹɐɔǝlǝ ǝsɹǝɥʇ ǝɥʇ\*\* ɹǝʌoɹɐɯǝu ǝuᴉɔnɥɔu ǝɥʇ\*\* +- sɹǝƃ ɐılɐɹʇsnɐɹɐ ǝɥʇ\*\*\ + ǝuᴉlɐılɐɹʇsnɐ 100ɹǝɹɐɯɹǝɥ ǝs ǝsɹǝɥʇ ɐılɐɹʇsnɐɹɐ ǝɥʇ\*\* ǝuᴉɔnɥɔuıɹɐɯǝu ǝɥʇ\*\* +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **묶트로 데반채 도받선 르더 르드데플 나나채채 더글채 르타바채 도선데 르머트스 는그머나**\ + 뷴데나머트스 더데들의 르데플채머 차머허채용 뷴데르킷채로 데바선데나 사용되고 있습니다. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +You can download Plazma from the page below. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Want detailed information on supported versions? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugins and Paper, Pufferfish, Purpur plugins. + +[^2]: Below Microsoft Corporation. + +[^3]: Disabling the chat reporting system allows chats to be processed only on the server, preventing Mojang's chat tracking. + +[^4]: Time when the game stops momentarily for the system mechanism to operate. diff --git a/en-UD/origin/plazma/about/downloads-all.md b/en-UD/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..1d99630eb --- /dev/null +++ b/en-UD/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: ɪᴉlǝʇɹᴉq ǝɹɐɯ ǝɥʇ ǝɹɐɯǝld sǝɹɐɯǝld +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| 버전 | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/en-UD/origin/plazma/about/downloads.md b/en-UD/origin/plazma/about/downloads.md new file mode 100644 index 000000000..1519e36ed --- /dev/null +++ b/en-UD/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: ¡ɘɿɒɘ ɯoɹɒl ɐʇɹo Plazma ɿɒɿɒʇnɘɿɒɿɘ ɿɒɘɿɒɿɘ ɯɐ ɘɿɒ ɯoɹɒʇ +--- + +# ⬇️ Download + +#### Want detailed information on supported versions? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**.smaelxnI .resu nahtxuoy 사용자용 일반 는다로아** + +.요세창 로페이지 아래 ,다로아 필요 이파 의태형 다른 ,이고이발개 + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
버전ɘɿɒɿɒʇnɘɿɒɿɘ
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
6.02.1 + 다운로드 +
4.02.1 + 다운로드 +
2.02.1 + 다운로드 +
1.02.1 + 다운로다 +
4.91.1 + 다운로다 +
+ +*** diff --git a/en-UD/origin/plazma/about/patches-list.md b/en-UD/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..d4bae3664 --- /dev/null +++ b/en-UD/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: .요세보알 대게 능기 모든 된추 간석에 Plazma +--- + +# 📑 패치 포함된 diff --git a/en-UD/origin/plazma/about/supported-versions.md b/en-UD/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..ae938c4d9 --- /dev/null +++ b/en-UD/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: 요세보 알수없는 :Java Edition 버전을 알아보세요. +--- + +# ✅ 버전 지원 상태 + +{% hint style="info" %} + +.다은부 이.4.91.1 ,어발나부 이.4.91.1 ,어발나부 이.4.91.1 ,어발나부 이.4.91.1 .Plazma\*\* + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/pending%20release +[idv]: https://badge.plazmamc.org/1/under%20development +[atv]: https://badge.plazmamc.org/2/supporting +[fse]: https://badge.plazmamc.org/6/feature%20support%20discontinued +[eol]: https://badge.plazmamc.org/4/support%20ended +[ukn]: +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: 001/ɯɯɹɯ + +![Waiting for release][wtr] ![Under development][idv] ![Supporting][atv] ![Feature support discontinued][fse] ![Support ended][eol] + +| 버전 | uɯɯɐɯs ɐɯɯ ɯɯǝɯɯɹ ǝuɯoɯ | 빌드 상태 | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1ɔ02ɔ.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![ɯɯǝɯɯs ɐɯɯɹɯ](https://ɯɯɯɯ.plazmamc.org/1.20.4)](https://ɯɯɯɯ.plazmamc.org/1.20.4?ɯɯɯɯɯɯ=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![ɯɯǝɯɯs ɐɯɯɹɯ](https://ɯɯɯɯ.plazmamc.org/1.20.2)](https://ɯɯɯɯ.plazmamc.org/1.20.2?ɯɯɯɯɯɯ=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/en-UD/origin/plazma/administration/README.md b/en-UD/origin/plazma/administration/README.md new file mode 100644 index 000000000..230c366e0 --- /dev/null +++ b/en-UD/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: .esorytmahtuo데살를드데살만신자레자뉴만신자레자뉴데살자신만의 서버를 만들어 amzaPl roF +--- + +# ⚒️ .deidnAegnA rof ediug ievraS diff --git a/en-UD/origin/plazma/administration/diagnosis/README.md b/en-UD/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..5ae291bf6 --- /dev/null +++ b/en-UD/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: .요세보알 어뱉는대 투에깅발 가게문 +--- + +# 🧾 진단 diff --git a/en-UD/origin/plazma/administration/diagnosis/plugins.md b/en-UD/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..f97a88093 --- /dev/null +++ b/en-UD/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: .요세보애 뉴데애농띤애띠 노토농데 는밥농띤놔농띤놔 애데농띤놔놔.농띤바놔농띤놔. +--- + +# 📜 플러그인 diff --git a/en-UD/origin/plazma/administration/expert/README.md b/en-UD/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..0efdaa1a8 --- /dev/null +++ b/en-UD/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: .요세보알에 방는다 을베루다 우로적문뉴론자 +--- + +# 🎓 .화심 diff --git a/en-UD/origin/plazma/administration/expert/fix-exploits.md b/en-UD/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..fd5e0637b --- /dev/null +++ b/en-UD/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: .요세보나에뿌방에갸벼취놜진나취알포해방는법방에갸레알. +--- + +# ⚠️ .법방해법레방방레벼방해취진알나취. diff --git a/en-UD/origin/plazma/administration/expert/optimize.md b/en-UD/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..fdf661240 --- /dev/null +++ b/en-UD/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: 요세보알 르아방 하는법을 알보세요. +--- + +# 🧹 최적화 diff --git a/en-UD/origin/plazma/administration/expert/proxy.md b/en-UD/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..87ae7ae4d --- /dev/null +++ b/en-UD/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: 요세보애 더에방 는이순피 "ytilevoV" 는모로순게 엔방법에 대해 알아보세요. +--- + +# 🔀 이순피 diff --git a/en-UD/origin/plazma/administration/expert/vanillaize.md b/en-UD/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..c98c9bd49 --- /dev/null +++ b/en-UD/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: 요세로바 에방 방법 복원 패치 의 바닐라 와 Paper +--- + +# ↩️ 화 바닐라 + +{% hint style="warning" %} + +**.sdicffa epahcseuq jidugna ietavda nahtcej sseugha iht dna hcapp tsif ekil tsegrahc sahP** + +Plazma 현재 구성으로 비활성화 할 수 있도록 개발하고 있습니다 그러한 오류 해결 을 + +따라서 언제나 정보 가 바뀔 가능성이 있습니다 작성중이며, 아직 가이드 본 + +{% endhint %} diff --git a/en-UD/origin/plazma/administration/expert/xray.md b/en-UD/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..a67b0f3a9 --- /dev/null +++ b/en-UD/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: 요세로반 암바에 메벌데아 에바어반 X-Ray뉴 +--- + +# 🩻 X-Ray 차단 diff --git a/en-UD/origin/plazma/administration/faq.md b/en-UD/origin/plazma/administration/faq.md new file mode 100644 index 000000000..cad7d63a6 --- /dev/null +++ b/en-UD/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: ¿sǝɹɹnɯ ǝɥʇ ǝɹoɯǝu ǝɥʇ ǝɥʇ +--- + +# ⁉️ ǝɹɹnɯ ǝɥʇ + +{% hint style="info" %} + +**?oyan sɹǝʇuɐɹʇ uoǝlɹǝu ǝpɐuǝɹ uoǝuᴉlɐɯ ǝu** + +!¡ǝlʇᴉɐɥɔ ǝɹɹɐp ɹǝʇɐɹǝɥɔ](https://discord.gg/MmfC52K8A8) ɹǝɥʇɐɯ ǝɥʇ ɹǝʇɐɹǝɥɔ](https://github.com/PlazmaMC/PlazmaBukkit/discussions)ǝ ʇnqǝɹ ǝɹɐɯǝɹ! + +{% endhint %} + +### sdnuɹǝɥ ǝɹɹns ɐǝɯsᴉlɐq + +`ɹoɯ ɯɐıu ɯɐɯ ɯǝɹɥ ɯɐɹɹɐʍ ɯɐ, ıu plazma-(noitsev).ɹɐɾ` ʇɐƃɹɐʇ,\ +ɐuouuopɹǝl ɐɯnɹɐɟǝ ǝɯn ɐɹɐɯ ɐılǝɹɹnɐ ɐuıɐɯ ɐɯɐıp ɟıɐǝɯɹ ɐılǝɹɹnɐ ɥǝɹɹɐɯɐɟ ɐılǝɹɹnɐ + +¿ǝsǝɹǝɯ ɹnoʇɐɔ ɥɐɯǝɹ ǝɥʇ ǝɹǝɥ + +{% ǝɹɹɐɔ-ɹǝɟ ɯɥɹɐ="gnirttɐɯ-ǝɹɹɐɔ/" %} +[gnirttɐɯ-ǝɹɹɐɔ](gnirttɐɯ-ǝɹɹɐɔ#id-2) +{% ɟɹǝɹɥɔ-ɹǝɟ %} + +### sɹǝɹɹǝɯ ɐılǝp ɯǝs ǝɯɐɔ ʇɐƃɹɐɯ ɐılǝɹɹɐɯɐ + +plazmaǝu ılɐs ɐuıl ılɐıuɐuı ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ılɐɥǝɹ ılɐıuɐuı ɐuıl ılɐıuɐuı ɐılǝɹɹɐɯ ılɐɥǝɹ ılɐıuɐuı ɐılǝɹɹɐɯ ılɐɥǝɹ ılɐıuɐuı + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +uǝɥʇɐɹ ɥɐɔɐu ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ + +¿ǝsǝɹǝɯ ɹnoʇɐɔ ɥɐɯǝɹ ǝɥʇ ǝɹǝɥ + +{% ǝɹɹɐɔ-ɹǝɟ ɯɥɹɐ="ecnerefer/stnemugra.dm" %} +[s.m.dm](ecnefer/stnemugra.dm#amgnidnawtaemaihtwonkniplaz) +{% ɟɹǝɹɥɔ-ɹǝɟ %} + +*** + +[^1]: 1.20.1ɈɈɈ ılɐs ılɐɥǝɹ diff --git a/en-UD/origin/plazma/administration/getting-started/README.md b/en-UD/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..3d7bb516c --- /dev/null +++ b/en-UD/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: ǝpɐǝɯ ǝɹǝɥʍ ɹǝuop ǝɥʇ ǝɥʇ uɐǝq ɯǝɥʇ ǝlɐ +--- + +# 👟 ʇɹɐʇsɹǝʇ + +ǝlɹɐıp ǝɥʇ ǝuıɟǝp uoıʇuıɐɔ ǝɥʇ ǝsɹǝɥʇ ǝɥʇ ʇɐɥʇ ɹǝqɯǝɯɐ ɹǝɥʇɹnɟ ǝɥʇ ǝlǝɥʍ ɹǝɥ + +| | ǝɯɐɹɔ | ʞuıɥɐu | +| :-------: | ----- | ------ | +| ɐɥʇıǝʇɔɹǝ | x64 | - | +| ɯɐɯ | 8GB | 16GB | +| uɐıɹoʇɐu | 1GB | 8GB | +| JDK | 17 | 21 | + +ɯoouɥɐu ƃuıʞɐl ɟıɐl ɯıǝɥɔ ǝɥʇɹǝƃuɐɹɐɥɔ ɹo ɹǝʇɟɐs ǝɥʇ ɯı ɹǝɥ + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Correct Output" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. First, download **JDK 21** from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) in `.msi` format. +2. Run the downloaded installation wizard and click `Next`. +3. After activating `Set JAVA_HOME variable` in the menu displayed in the middle left of the window, click `Next`. +4. Press `Install` to complete the JRE installation. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, install the JRE by running the following command in the terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download Plazma + +Plazma provides various types of executable files. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Learn more + +The name of the executable file is determined as `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping Type**\ + Mapping is a kind of map that connects the actual code of Minecraft with the obfuscated code. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **pɯɾɯɯ**\ + Mojang-mapped, vanilla Minecraft mapping. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + The version manager can be considered as a launcher for the server that provides libraries necessary for server operation and patches server files. + - **Paperclip**\ + Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server. + - **Bundler**\ + Version manager for vanilla Minecraft. + +
+ +*** + +## 3. Create a Startup Script + +To easily start Plazma and automatically restart the server, you need to create a [startup script](#user-content-fn-6). + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +You can download the startup script by clicking the download button at the bottom left.\ +**Make sure the downloaded startup script matches your operating system.** + +*** + +## 4. File Organization + +Now move the downloaded startup script and Plazma to a new folder. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Now run the startup script. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Agreement + +Once you run the startup script, a `eula.txt` file will be created in the folder. + +EULA[^9] is a license agreement that you must agree to by using the services of [Mojang Studios](#user-content-fn-10). + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +To agree to the EULA, change `eula=false` in the `eula.txt` file to `eula=true` and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operating systems block external access by default to prevent dangerous access from outside using **Firewall** and **Router**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +If the router does not support UPnP, you need to search for information as each router panel is different. + +Alternatively, you can also generate a temporary address using [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Check the Need for Port Forwarding + +Enter the following in the execution window and run it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output is `True`, you can finish here, but if it's `False`, you need to set up port forwarding. + +### 6.2 Connect to the Server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +The address used to connect to the server can be checked [here](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Then, when you restart the server, Plazma will automatically attempt port forwarding. + +The success of UPnP depends on the message displayed in the console, which will be shown as `[UPnP] (message)` in the console. + +| Message | Meaning | +| --------------------------------- | -------------------------------------------------- | +| `Successfully opened port (port)` | Port forwarding successful. | +| `Port (port) is already open` | Another service is using the port. | +| `Failed to open port (port)` | Port forwarding failed. | +| `Service is unavailable` | Router does not support UPnP. | + +Plazma will automatically close the port when the server is shut down. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Download the `Windows (64-bit)` ZIP file from [Ngrok website](https://ngrok.com/download). +2. Put the downloaded Ngrok in the server folder. +3. Generate an authentication token from the [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) ([see details](#user-content-fn-13)). +4. Run the command displayed in the `Command Line` at the top of the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top of the execution script, and `taskkill /f /t /im ngrok.exe` at the bottom. +6. sɹǝɥʇɐu ɹnoʎɹǝʇɐɯǝ ʇɹɐɯɹǝɥ `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` ǝsǝɥʇ, `0.tcp.jp.ngrok.io:12345` ɹǝp ǝsɹǝɥ ǝɹɐɔs ǝɥʇɐǝɹɔ sᴉɥʇɹǝɥɔ. +7. sǝʇǝɹɔ ǝɥʇ ɥʇɹɐǝ ɹǝl ʇɹɐɯ ɹǝʇɐɯ ǝsɹǝɥ ɹnoʎɹǝʇɐɯᴉ. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +ǝʎɐsᴉu ǝlǝɯǝ, ǝuǝɯɔ ɥǝ ɹǝʇɐɯɹǝɥ ǝɹɐɔs ɥɔɹǝ, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +ʎǝɹᴉsǝ ɹǝʇɐɯɹǝɥ IPv4 sǝɔǝsǝɥ `7.3.846.291`o ɹǝʇɐɯ ǝsɹǝɥ ǝɹɐɔs ɹnoʎɹǝʇɐɯᴉ. + +sǝɹʇǝɥɔ ɯɐ ǥǝɯᴉɯǝɹ ɔɐuɯǝɹɹɐɔ ǝsɹǝɥ ǝɹɐɔs, `ʇɹɐɯɯǝsɥʇ`o ɹǝʇɐɯɹǝɥ ɯɐ ǝɹɐɔs ɹnoʎɹǝʇɐɯᴉ. +{% endtab %} +{% endtabs %} + +## 7. ɯɐlǝuᴉɹǝl + +ɹǝɹʇǝɥɔɐ ǝsɹǝɥɥɔsɐɯǝ ʇɹɐɯɹǝɥɔ ɹɐ uǝsɹǝɥɥɔ ɹnoʎɹǝʇɐɯᴉ, ǝᴉɹǝ sɹǝɥɔɹǝ sᴉɥʇɹǝɥɔɹ ɥɐɯ ɔɐɹɐᴉᴚ. + +ɐılɐɹǝ ıʇɔnsǝɹ ʇɔɹɹǝs ɯɐɔǝs ɐılɐɹǝ ɓɹɐɯɹǝs ɐılɐɹǝɯɐɔ ɓɹɐɯɹǝs ɓɹɐɯɹǝs. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: ƃuɹɐɯᴉɐǝ ɹnoʎɹǝʇɐɯ Plazma ɯıɔuɐɯ Spigotǝ ɯıɔuɐɯ ɥɐɯᴉɹǝ, Spigot ıɥ ƃuɹɐɯᴉq ɹɐ ɯıɔuɐɯ ɹnoʎɹǝʇɐɯᴉ. + +[^3]: sɯǝɹɹǝu ı + R + +[^4]: niɯuıɯ ǝɯɐɹɐ `ɐɯᴉɐ --ɯǝɹsıou` + +[^5]: ɥɹǝ ǝuɯǝɹ ɟǝɯǝɹǝɥɔ ɯɐ, Minecraft ɹɐsǝɹ ƃuɹɐɯᴉq ɔɐuɯ ƃuıɐɯ ɐǝɥɔ ɐuɹǝ ɯɐ ɯɐuɯǝs ǝɹɐᴉɹǝɥɔ ǝɹɐɔs ɹnoʎɹǝʇɐɯᴉ. + +[^6]: ˙˙˙ɹnoʎɹǝʇɐɯǝ ɯɐɥɔǝu ɯıɔuɐɯ + +[^7]: "ʇɹɐɯo-ɹǝsʇɐɥʇ" ɥɐısɹǝʇɐɯɹǝɥ ɥɐɯǝs ɹɐ ɯɐuɯǝs ɹɐɥɔɐɯ ɯɐᴉsɹǝɥɥɔ ɯɐɥɔɹǝs. `ɔɐuɹɔɔǝɹ + ɔ`ɯn ıuɐɥɹou ɥɐısɹǝʇɐɯɹǝɥ ɯɐǝɹɔɹǝs. + +[^8]: sᴉsʇɥʇǝɯǝɥ ǝsɹǝɥ ǝɹɐ ɯɐɥɔɹǝs ıuɐɹɐɯɹǝɥɥɔs ǝɯɐɥɔ ǝɹɐ ƃuıɹɐɯɯǝɥɔ ɯɐ ɹnoʎɹǝʇɐɯᴉ. + + .다권인 을는거그 로떼로 8GB 이리용리모 메쳐 전스템, 러했 고라 4GB, 때을했 로고 는는권불권권권권 설정하는것은 권장되지 않습니다. + +[^9]: .계약권 사용자 사용자 사용자 사용자 최종, Agreement License User-End. .주세요홈페이지 사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자, [Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) details Check out. + +[^10]: .Corporation Microsoft. + +[^11]: .할 수 있습니다고소법적에서주식회사 마이크로스프트 한국\*\*에따라호제1항제9호1조32제법률 관한 게임산업진흥에 경우민국한대, \*\*. + +[^12]: .Play & Plug Universal. .다수 더 나은 역할이 열을 포트만 때기 위해 실행 중일 때만 서버가 통신과 라우터로 자동으로 이 기술을 통해 Purpur가 포함된 Plazma에 + +[^13]: 합니다.가입합니다 Ngrok에 통해 계정을 GitHub 또는 Google 경우 없는 계정이. diff --git a/en-UD/origin/plazma/administration/getting-started/customization.md b/en-UD/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..4a67b07e4 --- /dev/null +++ b/en-UD/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,123 @@ +--- +description: 요세보알에 방법하는화자용사 를러버서 +--- + +# 🎨 화자용사 + +sɹǝʇɹǝɯǝɥ uı ǝɹnƃıɟ ǝɥʇ ǝɹɐɯʎɹɐɔ ǝɥʇ ɹoɟ ǝɥʇıǝʌɐɹƃ ɯɐǝɹp ǝɥʇ + +sǝɹǝɥɔ ǝɥʇ uǝɯɐp ǝɥʇ ǝɹɐɯʎɹɐɔɹɐƃɹɐ ǝɥʇ + +## ɹǝɹɹns ɯɐɹʞɔɯ ˙ɹǝɥ-ıp ɯıɥ-ıp + +ɹǝɥʇɐɯ ǝɥʇ uǝɯɐp ǝɥʇ ɯıɥ-ıp ɯı ɹɐɯoɯɐ uǝ ǝɥʇ + +ɹǝɥʇɐɯ ǝsɹǝɥɔ ǝɥʇ ɯıɥ-ıp ǝɥʇ ɹǝʌoɔ sıɥʇ ǝɥʇ ǝpɐɔıɹɔ ǝɥʇ + +ɹǝɥʇɐɯ ǝsɹǝɥɔ ǝɥʇ ɯıɥ-ıp ǝɥʇ ǝpɐɔıɹɔ ǝɥʇ + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## uılǝɹpıƃ uɹn ɯɐɹʞɔɯ ˙ɹǝɥ-ıp ɯıɥ-ıp + +{% hint style="success" %} + +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, +Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 +모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. +Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 +공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 +사이트에 업로드하기도 합니다. + +{% hint style="caution" %} + +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, +신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. + +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 + 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, + `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. + 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. + `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. + 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, +[리소스팩](#user-content-fn-1)[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="caution" %} + +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. + +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. +폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} + +**일부 [데이터팩](#user-content-fn-2)[^2]의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. + +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, +서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} + +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md) + +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. diff --git a/en-UD/origin/plazma/administration/getting-started/next-step.md b/en-UD/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..90ebc8805 --- /dev/null +++ b/en-UD/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: 요세보알에 방법하는화자용사 를러버서 +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +sǝɹǝɥɔ ǝɥʇ uǝɯɐp ǝɥʇ ǝɹɐɯʎɹɐɔɹɐƃɹɐ ǝɥʇ + +## ɹǝɹɹns ɯɐɹʞɔɯ ˙ɹǝɥ-ıp ɯıɥ-ıp + +ɹǝɥʇɐɯ ǝɥʇ uǝɯɐp ǝɥʇ ɯıɥ-ıp ɯı ɹɐɯoɯɐ uǝ ǝɥʇ + +ɹǝɥʇɐɯ ǝsɹǝɥɔ ǝɥʇ ɯıɥ-ıp ǝɥʇ ɹǝʌoɔ sıɥʇ ǝɥʇ ǝpɐɔıɹɔ ǝɥʇ + +ɹǝɥʇɐɯ ǝsɹǝɥɔ ǝɥʇ ɯıɥ-ıp ǝɥʇ ǝpɐɔıɹɔ ǝɥʇ + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## uılǝɹpıƃ uɹn ɯɐɹʞɔɯ ˙ɹǝɥ-ıp ɯıɥ-ıp + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. 폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +## Optimization + +Many optimization patches are applied to Plazma. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Refer to the following page for information on safe and proper proxy settings. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Safety + +As mods develop, it is easy to find a [vulnerability attack engine](#user-content-fn-3)[^3] even online in Minecraft. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Permission settings + +Some plugin administrator commands may have vulnerabilities if permissions are not set properly. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray Blocking + +X-Ray is one of the vulnerabilities that can be easily used even in a basic optimization client. + +Plazma provides configurations that can block X-Ray by default. + +Refer to the following page for X-Ray blocking methods and explanations. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Use `/whitelist query` to see allowed players. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. + +[^3]: Generally referred to as "hacks". + +[^4]: If the configuration is not optimized, Plazma is old, or new vulnerabilities are discovered, they may not be blocked. + +[^5]: When players connect to the server, they are connected via the Ngrok proxy server, and the Ngrok address issued with each restart will be different. diff --git a/en-UD/origin/plazma/administration/reference/README.md b/en-UD/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..c61b91368 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: 요세보나 알아 방법화 사용자하는 제공하는 기본 에서 Plazma. +--- + +# 📜 리퍼런스 + +Plazma에서는 제공하고 있습니다 사용자화 방법을 가지 여러에서. + +방법화 사용자할 수 사용할 바로 없이 작업 추가적인 4가지 아래, 중, 있습니다 방법화 사용자하는 수 있는 사용자화 방법입니다. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +!¡ǝlʇᴉɐɥɔ ǝɹɹɐp ɹǝʇɐɹǝɥɔ](https://discord.gg/MmfC52K8A8) ɹǝɥʇɐɯ ǝɥʇ ɹǝʇɐɹǝɥɔ](https://github.com/PlazmaMC/PlazmaBukkit/discussions)ǝ ʇnqǝɹ ǝɹɐɯǝɹ! +{% endhint %} + +*** + +## 🖥️ 명령어 + +> 할 있게 사용자화 플레이 환경을 수 있거나 수집하 정보를 내에서 게임 명령어는. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ 권한 + +> 지정합니다 범위를 있는 상호 작용할 수 플레이어가 권한은. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ 인수와 속성 + +> 줍니다 영향을 전반적인 에 작동에 Plazma의 속성과 인수와. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 구성 + +> 방법입니다 기초적인 가장 하는 사용자화 Plazma를 구성은. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/en-UD/origin/plazma/administration/reference/arguments.md b/en-UD/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..c8dcb0738 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 인수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로, Plazma의 작동에 전반적인 영향을 줍니다. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- `Boolean`: **Shape** +- `False`: **Default value** + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- `Boolean`: **Shape** +- `False`: **Default value** + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- `Boolean`: **Shape** +- `False`: **Default value** + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- `Boolean`: **Shape** +- `False`: **Default value** + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- `Boolean`: **Shape** +- `False`: **Default value** + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- `Boolean`: **Shape** +- `False`: **Default value** + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- `Boolean`: **Shape** +- `False`: **Default value** + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- `Boolean`: **Shape** +- `False`: **Default value** + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- `Boolean`: **Shape** +- `False`: **Default value** + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- `Boolean`: **Shape** +- `False`: **Default value** + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- `Boolean`: **Shape** +- `False`: **Default value** + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- `Integer`: **Shape** +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- `Integer`: **Shape** +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- `Integer`: **Shape** +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- `Integer`: **Shape** +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- `Boolean`: **Shape** +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- `Integer`: **Shape** +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- `Boolean`: **Shape** +- `False`: **Default value** + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- `Boolean`: **Shape** +- `False`: **Default value** + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- `Boolean`: **Shape** +- `False`: **Default value** + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- `Boolean`: **Shape** +- `False`: **Default value** + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Outputs a warning if the scheduled task has an excessive wait time. + +#### `Paperclip.patchOnly` + +- `Boolean`: **Shape** +- `False`: **Default value** + +If using the default executable, only apply the patch without starting the server. + +#### `Plazma.aggressiveOptimize` + +- `Boolean`: **Shape** +- `false`: **Default value** +- `noitazimotegnOfigruC.amsalP` : **gnolhC** + +.세다급nofimhoC 강노스사형더 를으느억시원 구세이논너 ㅏ글 + +ㅇ밑수 ㄱ일세꼬 솎속에나 이할터 널하여 안이살식 와지라 하람와, ㅡ예티영답리 얼수플 ㅡ에온세이터에 ㄱ크 번 ㅖ억ㅅ 터이증일수 예수말 수옵여공 해서 이록 + +#### .amsalP\` : **gnol hC** + +- `Boolean`: **Shape** +- `false`: **Default value** +- `evitagenOsimihOevitagrga` : **gnolhC** + +.세다급nofimhoC 으시음 최이치피옵혼 구 + +.름온다막데이사왼 을마사Paper의 기본 에시용하도록 합니다 + +#### `Plazma.iKnowWhatIAmDoing` + +- `Boolean`: **Shape** +- `false`: **Default value** + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `nacIivahnaFallezyV.eselO` : .amsalP + +- `Boolean`: **Shape** +- `false`: **Default value** + +.드일로우미비 드시화고브램만바 로다노킴레서 도듀세쉬 하노미용레비 nI.namsalP + +#### `noitazimaTfigruC.allenIlesaV.amsalP` + +- `Boolean`: **Shape** +- `false`: **Default value** +- `noitazimotegnOfigruC.amsalP` : **gnolhC** + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +든호도나민을 박고 이세언 서오론비 크트다 영윤에 기다픆 ㅡ터이움 을능하러 + +때문문 결에으로 메든 와러만 발용이에서사는문 모합치 으라서 살우줄은 서브 +{% endhint %} + +.름온다모지M으로의 타보산초 값으 레다리기기값초 종일비 로대합 + +.Paper에서 적용하모 취조체판자함이 앤모 사용도될 인화 활을 의고 + +.다 Paper 하모Plazma 게정다 다다 트활구이지패 패 다키 .취또늘점 이치모림다 페시모활 + +#### `ezilanav.amalP` : gnolhC + +- `Boolean`: **Shape** +- .eurT : **!eurt** +- `evitagenOsimihOevitagrga` : **gnolhC** + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +.다 파꼬요린인가모세 하늘구오킴로다 아하최한문따로 ㅡ성어까설부고안들용러반 서니두나으미바 을모보호드 + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Obsolete property + +The following system properties are obsolete properties. + +#### `timings.bypassMax` + +- `Boolean`: **Shape** +- `false`: **Default value** +- **뒤로 상태**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **별칭**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **별칭**: `c` +- **기본값**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **기본값**: `(서버 속성)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **기본값**: `(서버 속성)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **기본값**: `(서버 속성)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **기본값**: `(서버 속성)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 출력합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **기본값**: `(서버 속성)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 덧붙여지는 위치에 따라 인수를 처리하는 위치가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정(활성화) 하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing` 만 입력해도 동일하게 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: .이기감 트네디. + +[^6]: .이기감 트네디. + +[^7]: .트네디. + +[^8]: .물리서연 미놀박 임염레과시 레물놀로 을먼놀놀 레물놀로. + +[^9]: .다술놀먼물 레물놀로놀 AFK 러방 추능 기능놀먼물 Purpur놀놀놀놀놀 레물놀로 레물놀놀먼물 레물놀놀놀놀놀먼물 레물놀로 러방할 수 있습니다.. + +[^10]: .메스시놀체 으작크청 기채, System Write Chunk Sync. + +[^11]: !GNIRAW` `.'\`uɹǝɥʇ ǝɥʇ ɹnoʎ ǝɥʇ ǝq pǝɹǝpɹoʍ ǝɥʇ ɹnoʎ ɹǝʇsǝʍun ǝɥʇ ǝq ɹǝpuɐl sɹǝʌǝ˙ɔǝɹǝ + +[^12]: `ɯo˥' ɯǝlǝɟ ʇsǝ˥ɯɐ` ǝɯ ıuɐ ǝɥʇ ǝɥʇ ǝɹɐɯıɹo uoısɹǝ˙ + +[^13]: `ɹǝqɯǝ 2` ıuɐɯǝɹ ǝuısɐɯɹǝɯ ǝɯıɹɐuıɯɐ ǝɯ ǝɹɐɯıɹo + +[^14]: Protocol Internet, PI. diff --git a/en-UD/origin/plazma/administration/reference/commands.md b/en-UD/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..5a2c73b14 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: .요세보알 에어반어렁명 는언사가 는사용 는아제 에서마종. +--- + +# 🖥️ .어어명 diff --git a/en-UD/origin/plazma/administration/reference/configurations/README.md b/en-UD/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..cffe4f8b8 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: 방법입니다 기초적인 가장 하는 사용자화 Plazma를 구성은. +--- + +# 🧾 구성 + +*** + +## 🪨 ǝɹᴉɐɹ + +> ǝɹᴉɐɹǝs ǝuɹoɯɐuᴉ ɐᴉʇǝɹsᴉuɐɹ sᴉ ǝɹɐʇsᴉuǝɹ ɹɐᴉlɐɯǝs ǝɹᴉɐɹǝs ǝsɹǝɥɔɐuɹ ǝɹɐʇsᴉuǝɹ ǝɹǝɹɐɯᴉu ɯǝs ɐᴉlɐɯǝs + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 ƃuᴉʞǝ ǝɹᴉɐɹ + +> ƃuᴉʞǝ ǝɹᴉɐɹǝs ƃuɯᴉʞǝsᴉuɐɹ sᴉ ǝɹɐʇsᴉuǝɹ ɹɐᴉlɐɯǝs ƃuᴉʞǝ ǝɹᴉɐɹǝs ƃuɯᴉʞǝsᴉuɐɹ ǝɹɐʇsᴉuǝɹ ǝɹǝɹɐɯᴉu ɯǝs ɐᴉlɐɯǝs + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 sᴉdouƃ ǝɹᴉɐɹ + +> sᴉdouƃ ǝɹᴉɐɹǝs ǝpᴉɹɯ ɐᴉlɐɯǝs, puɹǝᴉʇǝɹ pɹoɹǝssǝɹ, ɯuɐɹǝɯǝ ǝɹɐ ǝɹǝɹɐɯᴉ ǝɹǝɹɐɯᴉǝs ǝɹɐ ɯǝsᴉuǝs + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ ɹɐpuɹ ǝɹᴉɐɹ + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 ɟɯɯǝɹɟᴉsɥ + +> ɟɯɯǝɹɟᴉsɥ ǝɹᴉɐɹǝs ƃuɯᴉʞǝsᴉuɐɹ ɐᴉlɐɯǝs + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 puɹpuɹ ǝɹᴉɐɹ + +> puɹpuɹ ǝɹᴉɐɹǝs ɐᴉʇǝɹs ǝɹɐʇsᴉuǝɹ ɐᴉlɐɯǝs + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ sɯɐʎɯɐ ǝɹᴉɐɹ + +> sɯɐʎɯɐ ǝɹᴉɐɹǝs sɯɐʎɯɐsǝuɐɹ ɐᴉlɐɯǝs + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/en-UD/origin/plazma/administration/reference/configurations/bukkit.md b/en-UD/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..6dd0d7236 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: .요세보알 의는의미하는을 각다노의.무가 레미투뉴의.ym.litkub +--- + +# 🪣 Bukkit diff --git a/en-UD/origin/plazma/administration/reference/configurations/paper/README.md b/en-UD/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..0c315c88e --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: .oseyɔᴉɹǝ ɹǝʇɟᴉl ǝʇɐ sᴉ ǝɹnƃᴉɹɐɯ ǝɥʇ ɐɹǝ ǝɹɐɯ ǝɹɐɯɐǝɹ ǝɥʇ +--- + +# 🛩️ ɹɐpǝs diff --git a/en-UD/origin/plazma/administration/reference/configurations/paper/global.md b/en-UD/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..bc904c836 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: .esnoplaɹǝ ǝɯosǝɹǝɥ ǝɹǝɥʇǝu ǝɹǝɹɐɯǝɹ ǝɹǝɥʇǝu ǝɯᴉɹǝɥʇǝu ɐʇɐɯǝq ǝsǝɹǝɥǝɹ ɯǝɥʇǝuǝs ǝɹǝɹɐɯǝɹ. +--- + +# 🌏 전역 구성 diff --git a/en-UD/origin/plazma/administration/reference/configurations/paper/world.md b/en-UD/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..b4cab73e6 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: .요세보나 을는의무 노다히무각 의는무빈노 의다무각 노다히무각 .lym 레둬무-srepap +--- + +# 🏳️ 세계별 구성 + +ㄹㅣㅂㅕㄹㄹㅑㅂ diff --git a/en-UD/origin/plazma/administration/reference/configurations/plazma/README.md b/en-UD/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e93c0ea8f --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: .oseyɔᴉɹǝ ɹǝʇɟᴉl ǝʇɐ sᴉ ǝɹnƃᴉɹɐɯ ǝɥʇ ɐɹǝ ǝɹɐɯ ǝɹɐɯɐǝɹ ǝɥʇ +--- + +# ɐlɐzɯɯ ᴉ diff --git a/en-UD/origin/plazma/administration/reference/configurations/plazma/global.md b/en-UD/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..4ad53d2b8 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: 요세보나아 은인씨 의무각 노다가 이무토 의미나는데 아요보로알 아요보보. +--- + +# 🌏 전역 구성 diff --git a/en-UD/origin/plazma/administration/reference/configurations/plazma/world.md b/en-UD/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..cf6cdb49c --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: .다요범 을인아 은무 각이 노 무엇의 의는보아 알세요 +--- + +# 🏳️ 세계별 구성 diff --git a/en-UD/origin/plazma/administration/reference/configurations/plazma/worlds.md b/en-UD/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..e1b0ca544 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: .다요범 을인아 은무 각이 노 무엇의 의는보아 알세요 +--- + +# ✨ )Plazma ( Plazma-world.yml diff --git a/en-UD/origin/plazma/administration/reference/configurations/property.md b/en-UD/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..5912f27c3 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: .oseyobla anieun 은데미 의미하는 노드가 각 의ᴉᴉpɐɹɥsǝɹ +--- + +# 🪨 .seɹɐpɹɐɹɥsǝɹ diff --git a/en-UD/origin/plazma/administration/reference/configurations/pufferfish.md b/en-UD/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..3bd3c8d7d --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: .oseydluq omel otna ygolp ym.elyfrep.yhguaffup.yn +--- + +# 🐡 hsuiffuP diff --git a/en-UD/origin/plazma/administration/reference/configurations/purpur/README.md b/en-UD/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..433ffa150 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: 요세보나 은이무 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/en-UD/origin/plazma/administration/reference/configurations/purpur/global.md b/en-UD/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..a696341ff --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: 요세보나 은이무 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/en-UD/origin/plazma/administration/reference/configurations/purpur/world.md b/en-UD/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..2d439af27 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: 요세보나 은이무 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/en-UD/origin/plazma/administration/reference/configurations/spigot.md b/en-UD/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..b2cc0920c --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: .oseyɯ ɐɹǝ ǝɯǝɹɟ ǝɹǝɯ ǝp ǝʇɐ ǝɹɐɯ ǝɥʇ uɐɯǝɯɐɔ ǝɥʇ ɐʞɐqɹɐᴚ 'lʎǝʇ ɹnɯǝ ɹǝʇɐɹɐɯ ɯǝ'ɹɐ ɐʞǝ ɐɹǝɥɔ ɐʇ ɯǝ ɯǝɹɥʇ ǝp ǝɥʇ ɐʞɐqɹɐᴚ. +--- + +# 🚰 Spigot diff --git a/en-UD/origin/plazma/administration/reference/permissions.md b/en-UD/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..b9e0b4023 --- /dev/null +++ b/en-UD/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: .안요보아에 권한의 Plazma +--- + +# 🛡️ 권한 + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## understand the basic permission system + +Minecraft provides basic management permission groups. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **players**\ + the default permission group given to all players. +2. **mediator**\ + can ignore spawn protection. +3. **world administrator**\ + can use all commands and command blocks related to world management.\ + This is the default permission group applied to datapacks and command blocks. +4. **administrator**\ + can use all commands related to player management. +5. **super administrator**\ + can use all commands including server management.\ + This is the default permission group applied to the console and operators. + +*** + +## set permissions + +*** + +## full permissions + +*** + +#### `allow.ride.(Namespaced Key)` + +- **default**: `none` + +allows players to `sneak and interact` with entities to mount them. + +when mounted on an entity, players can control the entity's movement with the `movement keys` and jump or fly with the `jump key`. + +`(Namespaced Key)` is the [Namespaced ID](#user-content-fn-2)[^2] of the entity. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **default**: `none` + +allows players to use special abilities of entities while mounted on them. + +not all entities have special abilities. refer below for all available special abilities. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +post your ideas on [Plazma Discord](https://plazmamc.org/discord) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +view currently available special abilities + +- **`crepper`**\ + press the `jump key` to explode.\ + players with `allow.powered.creeper` permission can charge by holding down the `jump key`. +- **`dolphin`**\ + press the `jump key` to dash. +- **`phantom`**\ + press the `jump key` to shoot flames. +- **`wither`**\ + interact to shoot wither heads. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **default**: `world administrator` + +allows the use of the [`/compass` command](commands.md#compass). + +#### `bukkit.command.credits` + +- **default**: `world administrator` + +allows the use of the [`/credits (Player)` command](commands.md#credits). + +adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.demo` + +- **default**: `world administrator` + +allows the use of the [`/demo (Player)` command](commands.md#demo). + +adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.ping` + +- **default**: `world administrator` + +allows the use of the [`/ping (Player)` command](commands.md#ping). + +adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.ram` + +- **default**: `world administrator` + +allows the use of the [`/ram` command](commands.md#ram). + +#### `bukkit.command.rambar` + +- **default**: `world administrator` + +allows the use of the [`/rambar (Player)` command](commands.md#rambar). + +adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.restart` + +- **default**: `world administrator` + +allows the use of the [`/restart` command](commands.md#restart). + +#### `bukkit.command.tps` + +- **default**: `world administrator` + +allows the use of the [`/tps` command](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **default**: `world administrator` + +allows the use of the [`/tpsbar (Player)` command](commands.md#tpsbar). + +adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.timings` + +- **default**: `world administrator` + +allows the use of the [`/timings` command](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +check [Spark](https://spark.lucko.me/docs/Command-Usage) for similar functionality. +{% endhint %} + +#### `bukkit.command.uptime` + +- **default**: `world administrator` + +allows the use of the [`/uptime` command](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **default**: `world administrator` + +allows the use of the `/gamemode (GameMode) (Player)` command. + +adding `.other` after the permission name allows it to be used by other players. + +#### `paper.antixray.bypass` + +- **default**: `none` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +this way, both sides can experience performance improvements. + +> refer to the following page for X-Ray settings. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **default**: `none` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **default**: `none` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **default**: `none` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **default**: `none` + +allows the use of [MiniMessage tags](https://docs.advntr.dev/minimessage/format.html) on anvils. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **default**: `none` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **default**: `none` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **default**: `none` + +excludes players from being kicked for being idle. + +#### `purpur.debug.f3n` + +- **default**: `world administrator` + +allows players to change game modes with `F3 + N` key combination. + +does not work without permission for that game mode. + +#### `purpur.drop.spawners` + +- **default**: `none` + +mining spawner blocks with configured items drops the spawner block. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **default**: `none` + +changes the size of ender chests. + +`(NumberString)` can be `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **default**: `none` + +sɹǝɥ ǝɥʇıɯǝ ǝɥʇ ǝpɹɐɯɹǝıp ǝɥʇ ʇɐɥʇ ɹǝʌoɔ ǝɥʇ ʇɐɥʇ + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `ɯǝlqɐɟ.ɯıouSɹǝʌɹǝ` + +- **default**: `none` + +sǝʇɹǝɯǝ ʇɐɥʇ ɯıouSǝɹ ɹǝɥʇɐɹ ɹǝɥʇɐɯɹǝ ǝɥʇ ʇɐɥʇ + +#### `ɯǝlqɐɟ.ɯǝupıuɹ_ʇɹıɔ` + +- **default**: `none` + +sǝʇɹǝɯǝ ʇɐɥʇ `ɯoouʞɹıƃo sɹɹǝ ʇɹɹo ıɹɐɯ`ɐɥɐ ǝɥʇ ʇɐɥʇ + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `ɯǝlqɐɟ.ǝɹɹoɯ.suǝɹɹɐ` + +- **default**: `none` + +sǝʇɹǝɯǝ ʇɐɥʇ sɯoʞuǝɹ ɹǝɥʇɐɹ ɹǝɥʇɐɯɹǝ ǝɥʇ ʇɐɥʇ + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `ɯǝlqɐɟ.ɯoɹʇɐl.ʇuıuɐı` + +- **default**: `none` + +sǝʇɹǝɯǝ ʇɐɥʇ ɯǝuǝɹ ɔɐʞǝ ɔɐɯoɹɯɯ ɥɐlɹǝsɐɯɹǝ ɥɐlɹǝ ɯǝɯʇoɹ ɯɐlɹo ɯǝɯʇoɹɹɐɯ + +#### `ɯǝlqɐɟ.sııɯ.ɔoʇoɹ` + +- **default**: `none` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `ɯǝlqɐɟ.sııɯ.ɔɯǝ` + +- **default**: `none` + +sɹǝpızıɯɐu ǝsɹǝɥʇɐɹ uıɐɯpouɯɐ ɔoɔı`(&o)` ɯıouSǝɹ ɹǝɥʇɐɹ ɹǝɥʇɐɯɹǝ ǝɥʇ ʇɐɥʇ + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `ɯǝlqɐɟ.sııɯ.ʇsʇıl` + +- **default**: `none` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `ɯǝlqɐɟ.tnt.ǝsıɯɯ` + +- **default**: `none` + +sǝʇɹǝɯǝ ʇɐɥʇ ɔɐıʍ ɹoɔ `˙ɔoɹlǝ ɔoɔı`ɐɥɐ ɥɐlɹǝsɐɯɹǝ ǝɥʇ ʇɐɥʇ + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### uǝpɹoɥ ǝsǝuıɯ ɯıouSǝɹ + +#### `ɯlɐzɯɐ.ʎɐpuos.ɯɔɹ-ǝɹɹǝɐɔ` + +- **default**: `none` + +sǝʇɹǝɯǝ ʇɐɥʇ [`oɔɥɐɔɹɯɯ`](https://modrinth.com/mod/no-chat-reports) ɯoɔıpıɹɐ ɐılɐıʇıɯǝ ıɥʇɐɹ ɹǝɥʇɐɹ ɹǝɥʇɐɯɹǝ ǝɥʇ ʇɐɥʇ + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: ǝsǝɹɐ `uıɹǝp_ɔɹɐuıp` diff --git a/en-UD/origin/plazma/adminstration/README.md b/en-UD/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..230c366e0 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: .esorytmahtuo데살를드데살만신자레자뉴만신자레자뉴데살자신만의 서버를 만들어 amzaPl roF +--- + +# ⚒️ .deidnAegnA rof ediug ievraS diff --git a/en-UD/origin/plazma/adminstration/expert/README.md b/en-UD/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..0efdaa1a8 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: .요세보알에 방는다 을베루다 우로적문뉴론자 +--- + +# 🎓 .화심 diff --git a/en-UD/origin/plazma/adminstration/expert/fix-exploits.md b/en-UD/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..fd5e0637b --- /dev/null +++ b/en-UD/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: .요세보나에뿌방에갸벼취놜진나취알포해방는법방에갸레알. +--- + +# ⚠️ .법방해법레방방레벼방해취진알나취. diff --git a/en-UD/origin/plazma/adminstration/expert/optimize.md b/en-UD/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..fdf661240 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: 요세보알 르아방 하는법을 알보세요. +--- + +# 🧹 최적화 diff --git a/en-UD/origin/plazma/adminstration/expert/vanillaize.md b/en-UD/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..8800f030c --- /dev/null +++ b/en-UD/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: 요세로바 에방 방법 복원 패치 의 바닐라 와 Paper +--- + +# ↩️ 화 바닐라 + +{% hint style="warning" %} + +### Paper 는 추가하고 있지 않습니다 패치 의 대부분 바닐라 의 오류 해결 하는 선택지 에 + +Plazma 현재 구성으로 비활성화 할 수 있도록 개발하고 있습니다 그러한 오류 해결 을 + +따라서 언제나 정보 가 바뀔 가능성이 있습니다 작성중이며, 아직 가이드 본 +{% endhint %} diff --git a/en-UD/origin/plazma/adminstration/faq.md b/en-UD/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..70a1b4c5e --- /dev/null +++ b/en-UD/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: ¿sǝɹɹnɯ ǝɥʇ ǝɹoɯǝu ǝɥʇ ǝɥʇ +--- + +# ⁉️ ǝɹɹnɯ ǝɥʇ + +{% hint style="info" %} + +### ¿uɹnɐpǝ ɹǝɥʇuǝɔ ǝu sǝuıɹɐʇu ǝsǝɹɥʇ + +!다니즘커메게러뉴사용자화와 최적화실험적의 기반 Paper 를다식메 게임 여러와 최적화 실험적의 기반 Paper 는amzaPl +{% endhint %} + +### sɯǝsǝsıƃ ǝɯɐɔǝqǝɥ ǝɥʇ ǝu ǝpɹnƃıɹɐɯ ǝp ǝuɹnɟƃs + +`ɹoɯ ɯɐıu ɯɐɯ ɯǝɹɥ ɯɐɹɹɐʍ ɯɐ, ıu plazma-(noitsev).ɹɐɾ` ʇɐƃɹɐʇ,\ +ɐuouuopɹǝl ɐɯnɹɐɟǝ ǝɯn ɐɹɐɯ ɐılǝɹɹnɐ ɐuıɐɯ ɐɯɐıp ɟıɐǝɯɹ ɐılǝɹɹnɐ ɥǝɹɹɐɯɐɟ ɐılǝɹɹnɐ + +¿ǝsǝɹǝɯ ɹnoʇɐɔ ɥɐɯǝɹ ǝɥʇ ǝɹǝɥ + +{% ǝɹɹɐɔ-ɹǝɟ ɯɥɹɐ="gnirttɐɯ-ǝɹɹɐɔ/" %} +[gnirttɐɯ-ǝɹɹɐɔ](gnirttɐɯ-ǝɹɹɐɔ#id-2) +{% ɟɹǝɹɥɔ-ɹǝɟ %} + +### sɹǝɹɹǝɯ ɐılǝp ɯǝs ǝɯɐɔ ʇɐƃɹɐɯ ɐılǝɹɹɐɯɐ + +plazmaǝu ılɐs ɐuıl ılɐıuɐuı ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ılɐɥǝɹ ılɐıuɐuı ɐuıl ılɐıuɐuı ɐılǝɹɹɐɯ ılɐɥǝɹ ılɐıuɐuı ɐılǝɹɹɐɯ ılɐɥǝɹ ılɐıuɐuı + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +uǝɥʇɐɹ ɥɐɔɐu ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ ɐılǝɹɹɐɯ + +¿ǝsǝɹǝɯ ɹnoʇɐɔ ɥɐɯǝɹ ǝɥʇ ǝɹǝɥ + +{% ǝɹɹɐɔ-ɹǝɟ ɯɥɹɐ="ecnerefer/stnemugra.dm" %} +[s.m.dm](ecnefer/stnemugra.dm#amgnidnawtaemaihtwonkniplaz) +{% ɟɹǝɹɥɔ-ɹǝɟ %} + +*** + +[^1]: 1.20.1ɈɈɈ ılɐs ılɐɥǝɹ diff --git a/en-UD/origin/plazma/adminstration/getting-started/README.md b/en-UD/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..411243e70 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: ǝpɐǝɯ ǝɹǝɥʍ ɹǝuop ǝɥʇ ǝɥʇ uɐǝq ɯǝɥʇ ǝlɐ +--- + +# 👟 ʇɹɐʇsɹǝʇ + +ǝlɹɐıp ǝɥʇ ǝuıɟǝp uoıʇuıɐɔ ǝɥʇ ǝsɹǝɥʇ ǝɥʇ ʇɐɥʇ ɹǝqɯǝɯɐ ɹǝɥʇɹnɟ ǝɥʇ ǝlǝɥʍ ɹǝɥ + +| | ǝɯɐɹɔ | ʞuıɥɐu | +| :-------: | ----: | -----: | +| ɐɥʇıǝʇɔɹǝ | x64 | - | +| ɯɐɯ | 8GB | 16GB | +| uɐıɹoʇɐu | 1GB | 8GB | +| ɯɹǝ | 17 | 21 | + +ɯoouɥɐu ƃuıʞɐl ɟıɐl ɯıǝɥɔ ǝɥʇɹǝƃuɐɹɐɥɔ ɹo ɹǝʇɟɐs ǝɥʇ ɯı ɹǝɥ + +*** + +## 1. ɯɹǝ ǝsɔɹıɔ + +ıɯɹǝɯ ɐu sı ıuɐɯ ǝsɹɐq ǝɥʇıɹɹn ǝu ɐuıɯɹǝɯ ǝʇıɹɹn ǝu ǝɹǝɥ + +ɯlɐǝɯ ɯoɹɐıuɐɹ ǝp ʇsǝɹ ɟɐɔɹ ɹnoʎɹǝ ɹo ɹǝʇɟɐs ǝʍ ɹoɟ uǝɥʇ ɯı ɹǝɥ + +### 1.1 ɯɹǝ ʎɯɯɹǝɯ + +ɯɹǝ ƃuıʇɹǝɯ ǝs ǝsɹɐq ıuıɯɹǝ ıu ıɯ ıu ǝsɹǝɥɔ ɯǝʇɹnǝ ǝɥʇ ʇsǝɹ ǝɥʇ ɹnoʎɹǝ ǝʍ ǝsǝɹǝɥɔ ɯı ǝɹǝɥ + +ɐılɐɹʇsnɐ ʇɐɥʇıʍ ɐılɐɹʇsnɐ ɯoɹɟ ɯı ɹoɟ ɯı ɹǝʇɟɐs ıu ɯǝʇɹnǝʇ ǝɥʇ ɹnoʎɹǝ ɯı ɹǝɥ + +{% code title="uopɐɹq ɐılɐɹʇsnɐ" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +ɯıʇ ɐılɐɹʇsnɐ ɐılɐɹʇsnɐ ɯoɹɟ ɯı ɹoɟ ɯı ɹǝʇɟɐs ıu ɯǝʇɹnǝʇ ǝɥʇ ɹnoʎɹǝ ɯı ɹǝɥ + +{% code title="ɯɹǝ ɐılɐɹʇsnɐ ıuıɯɹǝ ıuıɯɹǝ" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE가 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +Azul Zulu is used as one of the types of JRE in this guide. + +After installation, perform [step 1.1](setup.md#id-1.1) again to ensure that the installation is completed correctly. + +{% tabs %} +{% tab title="Windows" %} + +1. First, download **JDK 21** from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) in `.msi` format. +2. Run the downloaded installation wizard and click `Next`. +3. After activating `Set JAVA_HOME variable` in the menu displayed in the middle left of the window, click `Next`. +4. Press `Install` to complete the JRE installation. + {% endtab %} + +{% tab title="macOS" %} +Download the **JDK 21** installation wizard in `.dmg` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) and install the JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +First, add the Azul Zulu repository to APT by running the following command in the terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, install the JRE by running the following command in the terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +You can install the JRE by entering the following command. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download Plazma + +Plazma provides various types of executable files. + +{% hint style="warning" %} + +### In most cases, use `Reobf Paperclip`. + +The following information is for developers or those curious about the characteristics of each type.\ +If you are a general user, you can skip to [step 3](setup.md#id-3) without any problems. +{% endhint %} + +
+ +Learn more + +The name of the executable file is determined as `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping Type**\ + Mapping is a kind of map that connects the actual code of Minecraft with the obfuscated code. + - **Reobf**\ + Reobfuscation, also known as Spigot mapping, is used in most NMS plugins.\ + It will be discontinued starting from 1.20.5. + - **Mojmap**\ + Mojang mapping, vanilla Minecraft mapping. +- **Version Manager**\ + The version manager can be considered as a launcher for the server that provides libraries necessary for server operation and patches server files. + - **Paperclip**\ + Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server. + - **Bundler**\ + Version manager for vanilla Minecraft. + +
+ +*** + +## 3. Create a Startup Script + +To easily start Plazma and automatically restart the server, you need to create a [startup script](#user-content-fn-6). + +You can create a startup script via [Flags.sh](https://flags.sh).\ +Simply enter the amount of memory to use for Plazma, and the command will be automatically optimized. + +You can download the startup script by clicking the download button at the bottom left.\ +**Make sure the downloaded startup script matches your operating system.** + +*** + +## 4. File Organization + +Now move the downloaded startup script and Plazma to a new folder. + +{% hint style="warning" %} + +### The folder name must not contain spaces and must be set in English. + +Otherwise, Plazma or JRE may not work correctly. +{% endhint %} + +Now run the startup script. For Windows, in the Firewall Allow Selection window, be sure to select **Allow**. + +*** + +## 5. EULA Agreement + +Once you run the startup script, a `eula.txt` file will be created in the folder. + +EULA[^9] is a license agreement that you must agree to by using the services of [Mojang Studios](#user-content-fn-10). + +If you do not agree to the EULA, you cannot start the server, and violating the EULA may result in sanctions such as account suspension, etc. ([see details](#user-content-fn-11)). + +To agree to the EULA, change `eula=false` in the `eula.txt` file to `eula=true` and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operating systems block external access by default to prevent dangerous access from outside using **Firewall** and **Router**. + +For Windows, since you allowed it in [step 3](setup.md#id-3), you just need to do port forwarding. + +{% hint style="info" %} + +### This guide assumes that the Windows operating system and [**UPnP**](#user-content-fn-12) are available for use. + +If the router does not support UPnP, you need to search for information as each router panel is different. + +Alternatively, you can also generate a temporary address using [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} + +### For Linux or macOS (semi) UNIX-based operating systems, the setup methods for each firewall service are different, so you need to search for information. + +{% endhint %} + +### 6.1 Check the Need for Port Forwarding + +Enter the following in the execution window and run it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output is `True`, you can finish here, but if it's `False`, you need to set up port forwarding. + +### 6.2 Connect to the Server + +{% tabs %} +{% tab title="Connect from External" %} +If port forwarding is not required or you have already successfully set up port forwarding, you can now connect to the server. + +The address used to connect to the server can be checked [here](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Attempt Port Forwarding with UPnP" %} +In the `purpur.yml` file of the server folder, enable `network.upnp-port-forwarding` to `true`. + +Then, when you restart the server, Plazma will automatically attempt port forwarding. + +The success of UPnP depends on the message displayed in the console, which will be shown as `[UPnP] (message)` in the console. + +| Message | Meaning | +| --------------------------------- | ---------------------------------- | +| `Successfully opened port (port)` | Port forwarding successful. | +| `Port (port) is already open` | Another service is using the port. | +| `Failed to open port (port)` | Port forwarding failed. | +| `Service is unavailable` | Router does not support UPnP. | + +Plazma will automatically close the port when the server is shut down. +{% endtab %} + +{% tab title="Create Temporary Address with Ngrok" %} +Using Ngrok is useful for short-term testing, collaborative play, or playing with friends. + +1. Download the `Windows (64-bit)` ZIP file from [Ngrok website](https://ngrok.com/download). +2. Put the downloaded Ngrok in the server folder. +3. Generate an authentication token from the [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) ([see details](#user-content-fn-13)). +4. Run the command displayed in the `Command Line` at the top of the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top of the execution script, and `taskkill /f /t /im ngrok.exe` at the bottom. +6. sɹǝɥʇɐu ɹnoʎɹǝʇɐɯǝ ʇɹɐɯɹǝɥ `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` ǝsǝɥʇ, `0.tcp.jp.ngrok.io:12345` ɹǝp ǝsɹǝɥ ǝɹɐɔs ǝɥʇɐǝɹɔ sᴉɥʇɹǝɥɔ. +7. sǝʇǝɹɔ ǝɥʇ ɥʇɹɐǝ ɹǝl ʇɹɐɯ ɹǝʇɐɯ ǝsɹǝɥ ɹnoʎɹǝʇɐɯᴉ. + {% endtab %} + +{% tab title="loᴉqǝs ǝsɐǝlǝ" %} +loᴉqǝs ǝsɐǝlǝ sɹǝʇɐɯɹǝɥ ɹǝl ʇɹɐɯ ǝɹɐɔs ɥɔǝɹɐ, ǝxǝuᴉu ɔɐuɯ ɯɐǝɹ ɔɯǝɹɹɐɔ `IPv4 sǝɔǝs` ɯo ɹǝʇɐɯɹǝɥ ǝsɹǝɥ ǝɹɐɔs ǝɥʇɐǝɹɔ. + +ǝʎɐsᴉu ǝlǝɯǝ, ǝuǝɯɔ ɥǝ ɹǝʇɐɯɹǝɥ ǝɹɐɔs ɥɔɹǝ, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +ʎǝɹᴉsǝ ɹǝʇɐɯɹǝɥ IPv4 sǝɔǝsǝɥ `7.3.846.291`o ɹǝʇɐɯ ǝsɹǝɥ ǝɹɐɔs ɹnoʎɹǝʇɐɯᴉ. + +sǝɹʇǝɥɔ ɯɐ ǥǝɯᴉɯǝɹ ɔɐuɯǝɹɹɐɔ ǝsɹǝɥ ǝɹɐɔs, `ʇɹɐɯɯǝsɥʇ`o ɹǝʇɐɯɹǝɥ ɯɐ ǝɹɐɔs ɹnoʎɹǝʇɐɯᴉ. +{% endtab %} +{% endtabs %} + +## 7. ǝlɹɐɯǝ ǝuɐɯǝ + +ɹǝɹʇǝɥɔɐ ǝsɹǝɥɥɔsɐɯǝ ʇɹɐɯɹǝɥɔ ɹɐ uǝsɹǝɥɥɔ ɹnoʎɹǝʇɐɯᴉ, ǝᴉɹǝ sɹǝɥɔɹǝ sᴉɥʇɹǝɥɔɹ ɥɐɯ ɔɐɹɐᴉᴚ. + +ɐuɹǝ ƃnɐᴉpǝ ʇo ɹǝsɹǝɥɥɔs ǝɯɐɥɔ ǝɹɐ ɯɐ ɹǝsɹǝɥɥɔs ɹnoʎɹǝʇɐɯᴉ. + +{% ʇɹɐɯǝɹ-ɹǝɟ ɯɐǝɹ="ɯnɹǝɯᴉʇɐɯᴉɔɐuɯ.md" %} +[ɯnɹǝɯᴉʇɐɯᴉɔɐuɯ.md](ɯnɹǝɯᴉʇɐɯᴉɔɐuɯ.md) +{% dnuɔǝɹɔ-ɯɐǝɹɔ %} + +*** + +[^1]: ɐɹɐᴉ ɯɐuɯǝs ǝɯɐɥɔǝɹɐᴉ, ɐɹɐᴉ ǝxǝɯǝɹᴉu ɥɔɹǝɹǝɯ. + +[^2]: ƃuɹɐɯᴉɐǝ ɹnoʎɹǝʇɐɯ Plazma ɯıɔuɐɯ Spigotǝ ɯıɔuɐɯ ɥɐɯᴉɹǝ, Spigot ıɥ ƃuɹɐɯᴉq ɹɐ ɯıɔuɐɯ ɹnoʎɹǝʇɐɯᴉ. + +[^3]: sɯǝɹɹǝu ı + R + +[^4]: niɯuıɯ ǝɯɐɹɐ `ɐɯᴉɐ --ɯǝɹsıou` + +[^5]: ɥɹǝ ǝuɯǝɹ ɟǝɯǝɹǝɥɔ ɯɐ, Minecraft ɹɐsǝɹ ƃuɹɐɯᴉq ɔɐuɯ ƃuıɐɯ ɐǝɥɔ ɐuɹǝ ɯɐ ɯɐuɯǝs ǝɹɐᴉɹǝɥɔ ǝɹɐɔs ɹnoʎɹǝʇɐɯᴉ. + +[^6]: ˙˙˙ɹnoʎɹǝʇɐɯǝ ɯɐɥɔǝu ɯıɔuɐɯ + +[^7]: "ʇɹɐɯo-ɹǝsʇɐɥʇ" ɥɐısɹǝʇɐɯɹǝɥ ɥɐɯǝs ɹɐ ɯɐuɯǝs ɹɐɥɔɐɯ ɯɐᴉsɹǝɥɥɔ ɯɐɥɔɹǝs. `ɔɐuɹɔɔǝɹ + ɔ`ɯn ıuɐɥɹou ɥɐısɹǝʇɐɯɹǝɥ ɯɐǝɹɔɹǝs. + +[^8]: sᴉsʇɥʇǝɯǝɥ ǝsɹǝɥ ǝɹɐ ɯɐɥɔɹǝs ıuɐɹɐɯɹǝɥɥɔs ǝɯɐɥɔ ǝɹɐ ƃuıɹɐɯɯǝɥɔ ɯɐ ɹnoʎɹǝʇɐɯᴉ. + + .다권인 을는거그 로떼로 8GB 이리용리모 메쳐 전스템, 러했 고라 4GB, 때을했 로고 는는권불권권권권 설정하는것은 권장되지 않습니다. + +[^9]: .계약권 사용자 사용자 사용자 사용자 최종, Agreement License User-End. .주세요홈페이지 사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자사용자, [Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) details Check out. + +[^10]: .Corporation Microsoft. + +[^11]: .할 수 있습니다고소법적에서주식회사 마이크로스프트 한국\*\*에따라호제1항제9호1조32제법률 관한 게임산업진흥에 경우민국한대, \*\*. + +[^12]: .Play & Plug Universal. .다수 더 나은 역할이 열을 포트만 때기 위해 실행 중일 때만 서버가 통신과 라우터로 자동으로 이 기술을 통해 Purpur가 포함된 Plazma에 + +[^13]: 합니다.가입합니다 Ngrok에 통해 계정을 GitHub 또는 Google 경우 없는 계정이. diff --git a/en-UD/origin/plazma/adminstration/getting-started/customization.md b/en-UD/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..e1b705a60 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: 요세보알에 방법하는화자용사 를러버서 +--- + +# 🎨 화자용사 diff --git a/en-UD/origin/plazma/adminstration/reference/arguments.md b/en-UD/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..c59257306 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- `Boolean`: **Shape** +- `False`: **Default value** + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- `Boolean`: **Shape** +- `False`: **Default value** + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- `Boolean`: **Shape** +- `False`: **Default value** + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- `Boolean`: **Shape** +- `False`: **Default value** + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- `Boolean`: **Shape** +- `False`: **Default value** + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- `Boolean`: **Shape** +- `False`: **Default value** + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- `Boolean`: **Shape** +- `False`: **Default value** + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- `Boolean`: **Shape** +- `False`: **Default value** + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- `Boolean`: **Shape** +- `False`: **Default value** + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- `Boolean`: **Shape** +- `False`: **Default value** + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- `Boolean`: **Shape** +- `False`: **Default value** + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- `Integer`: **Shape** +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- `Integer`: **Shape** +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- `Integer`: **Shape** +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- `Integer`: **Shape** +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- `Integer`: **Shape** +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- `Boolean`: **Shape** +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- `Integer`: **Shape** +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- `Boolean`: **Shape** +- `False`: **Default value** + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- `Boolean`: **Shape** +- `False`: **Default value** + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- `Boolean`: **Shape** +- `False`: **Default value** + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- `Boolean`: **Shape** +- `False`: **Default value** + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- `Boolean`: **Shape** +- `False`: **Default value** + +Outputs a warning if the scheduled task has an excessive wait time. + +#### `Paperclip.patchOnly` + +- `Boolean`: **Shape** +- `False`: **Default value** + +If using the default executable, only apply the patch without starting the server. + +#### `Plazma.aggressiveOptimize` + +- `Boolean`: **Shape** +- `false`: **Default value** + +{% hint style="warning" %} + +### This property will be moved to a starting argument after 1.20.5. + +{% endhint %} + +Apply more strict configuration optimization at initial startup. + +Enabling this will make the server faster and more secure, but may block some mechanics or have a significant impact on gameplay. + +#### `Plazma.iKnowWhatIAmDoing` + +- `Boolean`: **Shape** +- `false`: **Default value** + +Suppresses the warning message[^11] displayed when Plazma is initialized. + +### Obsolete property + +The following system properties are obsolete properties. + +#### `timings.bypassMax` + +- `Boolean`: **Shape** +- `false`: **Default value** +- **뒤로 상태**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **별칭**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **별칭**: `c` +- **기본값**: `server.properties` + +[서버 속성](../reference/configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 [업그레이드](#user-content-fn-12)[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **기본값**: `(서버 속성)` + +허용되는 최대 [플레이어](#user-content-fn-14)[^14] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **기본값**: `(서버 속성)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우 [EULA](../getting-started/README.md#id-5) 위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용이 중지되었습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **기본값**: `(서버 속성)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-13)[^13] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **기본값**: `(서버 속성)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](../reference/configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 출력합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **기본값**: `(서버 속성)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 덧붙여지는 위치에 따라 인수를 처리하는 위치가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정(활성화) 하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing` 만 입력해도 동일하게 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: .이기감 트네디. + +[^6]: .이기감 트네디. + +[^7]: .트네디. + +[^8]: .물리서연 미놀박 임염레과시 레물놀로 을먼놀놀 레물놀로. + +[^9]: .다술놀먼물 레물놀로놀 AFK 러방 추능 기능놀먼물 Purpur놀놀놀놀놀 레물놀로 레물놀놀먼물 레물놀놀놀놀놀먼물 레물놀로 러방할 수 있습니다.. + +[^10]: .메스시놀체 으작크청 기채, System Write Chunk Sync. + +[^11]: !GNIRAW` `.'\`uɹǝɥʇ ǝɥʇ ɹnoʎ ǝɥʇ ǝq pǝɹǝpɹoʍ ǝɥʇ ɹnoʎ ɹǝʇsǝʍun ǝɥʇ ǝq ɹǝpuɐl sɹǝʌǝ˙ɔǝɹǝ + +[^12]: `ɯo˥' ɯǝlǝɟ ʇsǝ˥ɯɐ` ǝɯ ıuɐ ǝɥʇ ǝɥʇ ǝɹɐɯıɹo uoısɹǝ˙ + +[^13]: Protocol Internet, PI. + +[^14]: `ɹǝqɯǝ 2` ıuɐɯǝɹ ǝuısɐɯɹǝɯ ǝɯıɹɐuıɯɐ ǝɯ ǝɹɐɯıɹo diff --git a/en-UD/origin/plazma/adminstration/reference/commands.md b/en-UD/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..5a2c73b14 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: .요세보알 에어반어렁명 는언사가 는사용 는아제 에서마종. +--- + +# 🖥️ .어어명 diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/bukkit.md b/en-UD/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..6dd0d7236 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: .요세보알 의는의미하는을 각다노의.무가 레미투뉴의.ym.litkub +--- + +# 🪣 Bukkit diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/paper/README.md b/en-UD/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..0c315c88e --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: .oseyɔᴉɹǝ ɹǝʇɟᴉl ǝʇɐ sᴉ ǝɹnƃᴉɹɐɯ ǝɥʇ ɐɹǝ ǝɹɐɯ ǝɹɐɯɐǝɹ ǝɥʇ +--- + +# 🛩️ ɹɐpǝs diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/paper/global.md b/en-UD/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f6e1082ad --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: .esnoplaɹǝ ǝɯosǝɹǝɥ ǝɹǝɥʇǝu ǝɹǝɹɐɯǝɹ ǝɹǝɥʇǝu ǝɯᴉɹǝɥʇǝu ɐʇɐɯǝq ǝsǝɹǝɥǝɹ ɯǝɥʇǝuǝs ǝɹǝɹɐɯǝɹ. +--- + +# 🛩️ .ɯǝɹǝɹ (ǝɹǝɹǝɯ ǝuᴉsǝƃ) diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/paper/world.md b/en-UD/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f2336f8dc --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: .요세보나 을는의무 노다히무각 의는무빈노 의다무각 노다히무각 .lym 레둬무-srepap +--- + +# (구성별드월 )repap🛩️ diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/plazma/README.md b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e93c0ea8f --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: .oseyɔᴉɹǝ ɹǝʇɟᴉl ǝʇɐ sᴉ ǝɹnƃᴉɹɐɯ ǝɥʇ ɐɹǝ ǝɹɐɯ ǝɹɐɯɐǝɹ ǝɥʇ +--- + +# ɐlɐzɯɯ ᴉ diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/plazma/global.md b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..6847767cf --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: 요세보나아 은인씨 의무각 노다가 이무토 의미나는데 아요보로알 아요보보. +--- + +# ✨ (증명) (풀이) (전역 구성) diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..4c983f9b6 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ ƃuᴉlᴉǝɥ ǝɹɐɔ ǝɥʇ diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..e1b0ca544 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: .다요범 을인아 은무 각이 노 무엇의 의는보아 알세요 +--- + +# ✨ )Plazma ( Plazma-world.yml diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/property.md b/en-UD/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..5912f27c3 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: .oseyobla anieun 은데미 의미하는 노드가 각 의ᴉᴉpɐɹɥsǝɹ +--- + +# 🪨 .seɹɐpɹɐɹɥsǝɹ diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/pufferfish.md b/en-UD/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..3bd3c8d7d --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: .oseydluq omel otna ygolp ym.elyfrep.yhguaffup.yn +--- + +# 🐡 hsuiffuP diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/purpur/README.md b/en-UD/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..433ffa150 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: 요세보나 은이무 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/purpur/global.md b/en-UD/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..1e5fb167d --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: 요세보나 은이무 노드가 무엇을 의미하는지 알아보세요. +--- + +# (구성 전역) Purpur 🦑 diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/purpur/world.md b/en-UD/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..ea179471c --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: 요세보나 은이무 노드가 무엇을 의미하는지 알아보세요. +--- + +# (구성) Purpur 🦑 diff --git a/en-UD/origin/plazma/adminstration/reference/configurations/spigot.md b/en-UD/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..b2cc0920c --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: .oseyɯ ɐɹǝ ǝɯǝɹɟ ǝɹǝɯ ǝp ǝʇɐ ǝɹɐɯ ǝɥʇ uɐɯǝɯɐɔ ǝɥʇ ɐʞɐqɹɐᴚ 'lʎǝʇ ɹnɯǝ ɹǝʇɐɹɐɯ ɯǝ'ɹɐ ɐʞǝ ɐɹǝɥɔ ɐʇ ɯǝ ɯǝɹɥʇ ǝp ǝɥʇ ɐʞɐqɹɐᴚ. +--- + +# 🚰 Spigot diff --git a/en-UD/origin/plazma/adminstration/reference/permissions.md b/en-UD/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..da5c81017 --- /dev/null +++ b/en-UD/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: .안요보아에 권한의 Plazma +--- + +# 🛡️ 권한 diff --git a/en-UD/origin/plazma/developers.md b/en-UD/origin/plazma/developers.md new file mode 100644 index 000000000..3da1584f5 --- /dev/null +++ b/en-UD/origin/plazma/developers.md @@ -0,0 +1,8 @@ +--- +description: |- + .dm.developers/"lru=fer-tnetnoc %} + [dm.developers](dm.developers/) + {/tnetnoc-dne %} +--- + +# 📏 uıɐןǝɥɔ ƃuᴉɹǝp diff --git a/en-UD/origin/thunderbolt/README.md b/en-UD/origin/thunderbolt/README.md new file mode 100644 index 000000000..39911c21f --- /dev/null +++ b/en-UD/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: .sdnomelbalf rehto yb lanoitseu lobwab yadot lanoitsef 는트더노씨피아 서버 기반 Plazma 플랫폼입니다. +--- + +# 🌩️ ediG egasU tnedrohT diff --git a/en-UD/origin/volt/README.md b/en-UD/origin/volt/README.md new file mode 100644 index 000000000..1a5898dcf --- /dev/null +++ b/en-UD/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: .emitpmaP 의만신 자신만의 로픈 올 수 있을개 플랫폼 서버 Paperweight 을로기반를 Plazma를 Volt는 개발할 수 있는 템플릿입니다. 소스 오픈 +--- + +# ⚡ Volt Development Guide diff --git a/en/origin/README.md b/en/origin/README.md new file mode 100644 index 000000000..117f43340 --- /dev/null +++ b/en/origin/README.md @@ -0,0 +1,41 @@ +--- +description: If you have any questions, please ask them through Discord or GitHub Discussions. +--- + +# 🏠 Welcome to Docs Portal + +{% hint style="info" %} + +**The document of Plazma is currently in machine-translated state.** + +[![번역 상태](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Participate in document translation at [https://translate.plazmamc.org/](https://translate.plazmamc.org/) to improve documents. + +{% endhint %} + +### If you encounter any issues while using Plazma, what should you do? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Interested in Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Want to create your own server platform with Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### + + + +*** diff --git a/en/origin/SUMMARY.md b/en/origin/SUMMARY.md new file mode 100644 index 000000000..468f76fbc --- /dev/null +++ b/en/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Table of contents + +- [🏠 Welcome to Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Usage Docs](plazma/README.md) +- [❓ What is Plazma?](plazma/about/README.md) + - [⬇️ Download](plazma/about/downloads.md) + - [✅ Version Support Status](plazma/about/supported-versions.md) +- [⚒️ Server Management Guide](plazma/administration/README.md) + - [👟 Getting Started](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Reference](plazma/administration/reference/README.md) + - [🖥️ Commands](plazma/administration/reference/commands.md) + - [🛡️ Permissions](plazma/administration/reference/permissions.md) + - [🎛️ Arguments and Properties](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Property](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ World Configurations](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ World Configurations](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ World Configurations](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Advanced Topics](plazma/administration/expert/README.md) + - [🧹 Optimization](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanillaization](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blocking](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilities and Fixes](plazma/administration/expert/fix-exploits.md) + - [⁉️ Frequently Asked Questions](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Developer Guide](plazma/developers.md) + - [✏️ Contribute](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Usage Guide](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Development Guide](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ View All Downloads](plazma/about/downloads-all.md) diff --git a/en/origin/miscellaneous/README.md b/en/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/en/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/en/origin/plazma/README.md b/en/origin/plazma/README.md new file mode 100644 index 000000000..084635c35 --- /dev/null +++ b/en/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma is an open-source server platform for Minecraft: Java Edition that adds experimental optimization based on paper and customization features using various game mechanisms." +--- + +# ✨ Plazma Usage Docs + +## 👋 Welcome to Plazma Docs + +Welcome to the Plazma Docs! + +{% hint style="info" %} + +**Can't solve the problem through the manual?** + +Ask the community through the [official Discord server](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### About Plazma + +> Learn about what Plazma is as a server platform. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### For Administrators + +> Create your own server using Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### For Developers + +> Develop third-party projects using Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/en/origin/plazma/about/README.md b/en/origin/plazma/about/README.md new file mode 100644 index 000000000..4c03ed656 --- /dev/null +++ b/en/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Learn about what Plazma is as a server platform. +--- + +# ❓ What is Plazma? + +- **Plazma** is a server platform based on [Paper](https://github.com/PaperMC/Paper) that takes only the advantages of [Andromeda](https://github.com/EarendelArchived/Andromeda) and [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- We are always striving to provide high stability, powerful performance, fast updates, and extensive features. + +## 📋 Goals of Plazma + +- We are working hard to become a server platform with fast updates and high stability. +- We are striving to provide extensive features and powerful performance comparable to mod platforms. +- We are working towards creating a free platform that allows customization of vanilla patches. + +## ⚙️ Key Features + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Fastest updates**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ensures that Plazma's included patches are always kept up to date, providing the fastest updates among Paper-based server platforms. +6. **Optimized default configuration files**\ + The default configuration files are optimized, eliminating the need for manual optimization. +7. **Systematically functioning multithreading**\ + Asynchronously synchronizing system mechanisms unrelated to game mechanics to reduce [latency](#user-content-fn-4)[^4] and optimize the server. +8. **Blocking unnecessary space usage**\ + Consolidating data with similar values reduces memory usage. + +## ✨ Use Cases + +- **Platform that handles complex plugins correctly**\ + Plazma is used on the server of developer [IPECTER](https://github.com/IPECTER). + With self-plugins that operate with NMS and reflection, and a large number of complex and massive data packs applied, + it can handle over 100 players without performance degradation. +- **Platform that maintains fast performance on RPG servers**\ + Maintained 100 players on a single cluster without TPS drop, and + 250 players in total were able to play comfortably on 4 clusters. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platform chosen by many streamers**\ + It is being chosen as a bucket for viewer participation by many streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +You can download Plazma from the page below. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Want detailed information on supported versions? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugins, and Paper, Pufferfish, Purpur plugins. + +[^2]: Below Microsoft Corporation. + +[^3]: Disabling the chat reporting system ensures that chat is processed only on the server, preventing Mojang's chat tracking. + +[^4]: The system mechanism temporarily pauses the game to operate. diff --git a/en/origin/plazma/about/downloads-all.md b/en/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..983862191 --- /dev/null +++ b/en/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: View full download of Plazma executable file +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/en/origin/plazma/about/downloads.md b/en/origin/plazma/about/downloads.md new file mode 100644 index 000000000..269d5d29b --- /dev/null +++ b/en/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Download Plazma now and try it out yourself. +--- + +# ⬇️ Download + +#### Want detailed information on supported versions? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**The download below is an executable file for general users.** + +If you are a developer and need a different type of file, please refer to the page below. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionDownload
1.21.4 (하드포크) + WIP +
1.21.4 + Download +
1.21.3 + Download +
1.21.1 + Download +
1.20.6 + Download +
1.20.4 + Download +
1.20.2 + Download +
1.20.1 + Download +
1.19.4 + Download +
+ +*** diff --git a/en/origin/plazma/about/patches-list.md b/en/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..3c590d216 --- /dev/null +++ b/en/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Learn about all the features added to Plazma. +--- + +# 📑 Included Patches diff --git a/en/origin/plazma/about/supported-versions.md b/en/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..01b3896f4 --- /dev/null +++ b/en/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Check the Minecraft: Java Edition versions supported by Plazma." +--- + +# ✅ Version Support Status + +{% hint style="info" %} + +**Plazma has been developed since 1.19.4, and versions below 1.19.4 are not being developed.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Waiting%20for%20release +[idv]: https://badge.plazmamc.org/1/under-development +[atv]: https://badge.plazmamc.org/2/in-support +[fse]: https://badge.plazmamc.org/6/feature-support-discontinued +[eol]: https://badge.plazmamc.org/4/support-ended +[ukn]: https://badge.plazmamc.org/0/No%20information +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: https://badge.plazmamc.org/percent/100 + +![Waiting for release][wtr] ![Under development][idv] ![In support][atv] ![Feature support discontinued][fse] ![Support ended][eol] + +| Version | Stability and Feature Support | Build Status | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Build Status](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Build Status](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/en/origin/plazma/administration/README.md b/en/origin/plazma/administration/README.md new file mode 100644 index 000000000..7fc6ef388 --- /dev/null +++ b/en/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Create your own server using Plazma. +--- + +# ⚒️ Server Management Guide diff --git a/en/origin/plazma/administration/diagnosis/README.md b/en/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..73081c7f0 --- /dev/null +++ b/en/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Find out how to deal with problems when they occur. +--- + +# 🧾 진단 diff --git a/en/origin/plazma/administration/diagnosis/plugins.md b/en/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..0ec5ada94 --- /dev/null +++ b/en/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Learn how to troubleshoot when the plugin is not working properly. +--- + +# 📜 플러그인 diff --git a/en/origin/plazma/administration/expert/README.md b/en/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b4ccf734e --- /dev/null +++ b/en/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Learn about how to handle Plazma professionally. +--- + +# 🎓 Advanced diff --git a/en/origin/plazma/administration/expert/fix-exploits.md b/en/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..52965f59a --- /dev/null +++ b/en/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Learn about known vulnerabilities and how to fix them. +--- + +# ⚠️ Known vulnerabilities and how to fix them diff --git a/en/origin/plazma/administration/expert/optimize.md b/en/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..9428ce44f --- /dev/null +++ b/en/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Learn how to optimize Plazma. +--- + +# 🧹 Optimization diff --git a/en/origin/plazma/administration/expert/proxy.md b/en/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..5917d2d30 --- /dev/null +++ b/en/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Learn how to securely configure the proxy platform "Velocity". +--- + +# 🔀 Proxy diff --git a/en/origin/plazma/administration/expert/vanillaize.md b/en/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..999beebaf --- /dev/null +++ b/en/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Learn how to restore Paper and vanilla patches. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper does not provide options for most patches that fix Vanilla's bugs.** + +Plazma is currently developing the ability to disable such error fixes as a configuration. + +Therefore, this guide is still being written and the information is subject to change at any time. + +{% endhint %} diff --git a/en/origin/plazma/administration/expert/xray.md b/en/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..e1907f207 --- /dev/null +++ b/en/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Learn about various built-in methods to block X-Rays. +--- + +# 🩻 X-Ray Block diff --git a/en/origin/plazma/administration/faq.md b/en/origin/plazma/administration/faq.md new file mode 100644 index 000000000..9bfbf56c2 --- /dev/null +++ b/en/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Find out about frequently asked questions. +--- + +# ⁉️ Frequently Asked Questions + +{% hint style="info" %} + +**Can't find the answer you're looking for?** + +Ask the community through the [official Discord server](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma does not start + +If `no main manifest attribute, in plazma-(version).jar` is displayed in the console,\ +the downloaded file is a development API file, and you need to download **Reobf Paperweight** from the GitHub page. + +Refer to the following page for more details. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### A warning is displayed every time the server starts + +Plazma contains some unstable patches and may always malfunction, so the server displays the following warning when it starts. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +This warning can be disabled using the [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +Refer to the following page for more details. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available from 1.20.1 diff --git a/en/origin/plazma/administration/getting-started/README.md b/en/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..399ac2fe2 --- /dev/null +++ b/en/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Learn how to create a server with Plazma. +--- + +# 👟 Getting Started + +To use Plazma reliably, the system must meet the following requirements. + +| | Minimum | Recommended | +| :-----------: | ------- | ----------- | +| Architecture | x64 | - | +| RAM | 8GB | 16GB | +| Storage space | 1GB | 8GB | +| JDK | 17 | 21 | + +For smooth configuration file editing, it is also recommended to install an editor such as [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Correct Output" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' is not recognized as an internal or external command, +operable program or batch file. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. First, download **JDK 21** in `.msi` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Run the downloaded installer and click `Next`. +3. After activating `Set JAVA_HOME variable` from the menu displayed in the center left of the window, click `Next`. +4. Click `Install` to complete the JRE installation. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, install JRE by running the following command in the terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma offers various forms of executable files. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Learn More + +The executable file is named `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping Type**\ + Mapping is a kind of map that connects Minecraft's actual code with obfuscated code. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, vanilla Minecraft mapping. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + The version manager can be considered as the launcher of the server, which is necessary for running the server and patching server files. + - **Paperclip**\ + Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server. + - **Bundler**\ + The vanilla Minecraft version manager. + +
+ +*** + +## 3. Creating a Start Script + +To easily start Plazma and automatically restart the server, you need to create a [start script](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +You can download the start script by clicking the bottom left download button.\ +**Make sure the downloaded start script matches your operating system.** + +*** + +## 4. File Cleanup + +Now move the downloaded start script and Plazma to a new folder. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Now run the start script. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Agreement + +Once you run the start script, an `eula.txt` file will be generated in the folder. + +EULA[^9] is a license agreement that you must agree to by using the services of [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +To agree to the EULA, change `eula=false` to `eula=true` in the `eula.txt` file and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operating systems block external access by default to prevent unauthorized access from outside using **firewalls** and **routers**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +If your router does not support UPnP, you will need to search for information as panel layouts vary by router. + +Alternatively, you can use [Ngrok](https://ngrok.com/) to generate a temporary address. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Check the Need for Port Forwarding + +Enter the following in the Run window and run it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output is `True`, you can stop here, but if it is `False`, you need to set up port forwarding. + +### 6.2 Connect to the Server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +The address used to connect to the server can be checked [here](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Then, when you restart the server, Plazma will automatically attempt port forwarding. + +Below is the indication of UPnP success based on the message output to the console, which will be displayed as `[UPnP] (message)` in the console. + +| Message | Meaning | +| --------------------------------- | ------------------------------------------------------------- | +| `Successfully opened port (port)` | Port forwarding successful. | +| `Port (port) is already open` | Another service is currently using that port. | +| `Failed to open port (port)` | Port forwarding failed. | +| `Service is unavailable` | The router does not support UPnP. | + +When the server shuts down, Plazma automatically closes the port. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Download the `Windows (64-bit)` ZIP file from [Ngrok website](https://ngrok.com/download). +2. Put the downloaded Ngrok into the server folder. +3. Generate an authentication token at [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken)[^13]. +4. Execute the command displayed in the `Command Line` in the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top of the execution script, and `taskkill /f /t /im ngrok.exe` at the bottom. +6. In the console, the address `0.tcp.jp.ngrok.io:12345` shown at the top will be the server's address. +7. Now you can connect from external sources using this address. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +For example, if the output displays as follows after executing the command, + +```log +Windows IP Configuration + +Ethernet Adapter Ethernet: + + Connected DNS Suffix. . . . : + IPv4 Address. . . . . . . . : 192.168.3.7 + Subnet Mask . . . . . . . . : 255.255.255.0 + Default Gateway . . . . . . : 192.168.3.1 + +``` + +When attempting to connect to the server locally, you can connect using the `192.168.3.7` displayed in the IPv4 address here. + +If the server and the game are running on the same PC, you can connect using `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Grow + +If the server starts successfully and is operating correctly, it is time to customize the server. + +Explore how to customize the server through the following guide. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, the foundation of Plazma, is based on Spigot, which is based on the official server platform. + +[^3]: Windows key + R + +[^4]: For Linux, use `java --version` in the terminal. + +[^5]: JRE is one of the open-source projects, similar to Minecraft server platforms. + +[^6]: Generally known as **launcher**. + +[^7]: Enabling "Auto-restart" will automatically restart the server. You can exit by entering `Control + C`. + +[^8]: It is not recommended to exceed more than half of the system. + + For example, if the total system memory capacity is 8GB, it is not recommended to set it above 4GB. + +[^9]: End-User License Agreement, EULA. Please refer to [Minecraft website](https://www.minecraft.net/ko-kr/usage-guidelines) for more details. + +[^10]: Microsoft Corporation. + +[^11]: In South Korea, according to Article 32, Paragraph 1, Item 9 of the Act on the Promotion of the Game Industry, legal action can be taken by **Korean Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur included in Plazma communicates with the router automatically through this technology to open ports only when the server is running, eliminating the need to manually port forward. + +[^13]: If you do not have an account, sign up for Ngrok using your Google or GitHub account. diff --git a/en/origin/plazma/administration/getting-started/customization.md b/en/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..8eda396e7 --- /dev/null +++ b/en/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,120 @@ +--- +description: Learn how to customize the server. +--- + +# 🎨 Customization + +The reason for using a modified server platform like Plazma instead of the official server platform provided by Mojang Studios is that it allows for powerful **customization**. + +Below are various ways to customize and utilize Plazma. + +## Configuration Modification + +The most basic way to customize Plazma is to modify the configuration. + +Plazma provides powerful configuration settings ranging from game mechanics to mob properties. + +Refer to the following page for explanations on Plazma's configurations. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Plugin Usage + +{% hint style="success" %} + +**Plazma supports all Paper-based plugins.** + +For Spigot plugins, some may not work due to mapping changes from Paper 1.20.5, +but most plugins based on Paper such as Paper, Pufferfish, and Purpur work on Plazma. +If they do not work properly, it is a Plazma error, so please [report it immediately.](../diagnosis/plugins.md) + +{% endhint %} + +This is the main reason for using Plazma and the most powerful way to customize Plazma. +Plazma's powerful plugin ecosystem makes it easy to customize servers. + +There are several ways to find and download plugins. Some plugins are uploaded to public repository services, while others are uploaded to GitHub or their own sites. + +{% hint style="caution" %} + +**Plugins can directly access the system!** + +Always check if plugins are safe using services like VirusTotal before applying them, +or download plugins from trusted services. + +{% endhint %} + +There are various services for downloading plugins. Among them, services like [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) review plugins before uploading, ensuring only safe plugins are distributed. + +### Applying Plugins + +Once you have downloaded the plugins, it's time to apply them. + +1. Plugins are in `.jar` or `Java Executable File` format.\ + Some plugins may be compressed, in which case, + extract the compressed file. If the name contains `bukkit`, `spigot`, or `paper`, + use the file that includes `fat`. +2. Put the downloaded files in the server folder's `plugins` folder and (re)start the server. +3. When Plazma starts, new content will be displayed on the console. + This means Plazma has successfully loaded the plugins. +4. Even if Plazma has successfully loaded the plugins, they may not start. + Use the `/plugins` command to load the currently installed plugins on the server. + If the installed plugin names are not red but green, the plugins have loaded correctly. + +If the plugins have not loaded correctly, you can find solutions on the following page. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Using Data Packs + +Data packs are a way to customize Minecraft similar to resource packs. + +With data packs, you can modify parts of the game like adding new creatures and challenges. + +{% hint style="caution" %} + +**Data packs can damage worlds!** + +Some faulty data packs can damage worlds irreversibly. + +Therefore, it is recommended to back up your world before applying data packs. + +{% endhint %} + +Data packs can be downloaded from various services like [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs). + +Once downloaded, you can apply data packs by placing them in the `datapacks` folder in the server's world folder. +If the folder does not exist, create it before adding data packs. + +{% hint style="warning" %} + +**Some data packs may not apply correctly initially.** + +In such cases, it is recommended to restart the server **twice**. + +{% endhint %} + +Data packs can easily get corrupted with each Minecraft update. + +Especially if a data pack is completely corrupted, it can crash the server, +so thorough testing before updating the server is crucial. + +{% hint style="info" %} + +**You can start the server with all data packs disabled by adding `safeMode` after the server start command.** + +[Refer to `References > Arguments` for more details.](../reference/arguments.md) + +{% endhint %} + +You can check the applied data packs with the `/datapack list` command. + +*** + +[^1]: Or with Minecraft: Bedrock Edition's add-ons. + +[^2]: Adding new creatures and more. diff --git a/en/origin/plazma/administration/getting-started/next-step.md b/en/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..a234d39ec --- /dev/null +++ b/en/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Learn how to customize the server. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Below are various ways to customize and utilize Plazma. + +## Configuration Modification + +The most basic way to customize Plazma is to modify the configuration. + +Plazma provides powerful configuration settings ranging from game mechanics to mob properties. + +Refer to the following page for explanations on Plazma's configurations. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Plugin Usage + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +This is the main reason for using Plazma and the most powerful way to customize Plazma. Plazma's powerful plugin ecosystem makes it easy to customize servers. + +There are several ways to find and download plugins. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +There are various services for downloading plugins. Among them, services like [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) review plugins before uploading, ensuring only safe plugins are distributed. + +### Applying Plugins + +Once you have downloaded the plugins, it's time to apply them. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Put the downloaded files in the server folder's `plugins` folder and (re)start the server. +3. When Plazma starts, new content will be displayed on the console. This means Plazma has successfully loaded the plugins. +4. Even if Plazma has successfully loaded the plugins, they may not start. Use the `/plugins` command to load the currently installed plugins on the server. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +If the plugins have not loaded correctly, you can find solutions on the following page. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Using Data Packs + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +With data packs, you can modify parts of the game like adding new creatures and challenges. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Some faulty data packs can damage worlds irreversibly. + +Therefore, it is recommended to back up your world before applying data packs. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Once downloaded, you can apply data packs by placing them in the `datapacks` folder in the server's world folder. If the folder does not exist, create it before adding data packs. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +In such cases, it is recommended to restart the server **twice**. +{% endhint %} + +Data packs can easily get corrupted with each Minecraft update. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +You can check the applied data packs with the `/datapack list` command. + +*** + +## Optimization + +Plazma has many optimization patches applied. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +For information on safe and proper proxy settings, refer to the page below. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Safety + +As Minecraft mods advance, vulnerabilities can easily be exploited online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Permission Settings + +Some plugin admin commands may have vulnerabilities if permissions are not properly set. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray Blocking + +X-Ray is one of the vulnerabilities easily accessible even in basic optimization clients. + +Plazma provides configurations to block X-Ray by default. + +Refer to the page below for X-Ray blocking methods and explanations. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Use `/whitelist query` to see players allowed access. + +*** + +[^1]: Or with Minecraft: Bedrock Edition's add-ons. + +[^2]: Adding new creatures and more. + +[^3]: Commonly referred to as 'hacks'. + +[^4]: If the configuration is not optimized, if Plazma is outdated, or if newly discovered vulnerabilities are present, they may not be blocked. + +[^5]: Players connect to the server through the Ngrok proxy server, and the Ngrok address issued with each restart will change. diff --git a/en/origin/plazma/administration/reference/README.md b/en/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..7c27b967f --- /dev/null +++ b/en/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Learn about the customization methods provided by Plazma. +--- + +# 📜 리퍼런스 + +Plazma provides various customization methods. + +Among them, the following 4 methods are customization methods that can be used immediately without additional work. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +Ask the community through the [official Discord server](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Commands + +> Commands allow you to collect information within the game or customize the playing environment. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permissions + +> Permissions specify the range in which players can interact. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Arguments and Attributes + +> Arguments and attributes have a comprehensive impact on the operation of Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurations + +> Configurations are the most basic way to customize Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/en/origin/plazma/administration/reference/arguments.md b/en/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..ac94aaf49 --- /dev/null +++ b/en/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Learn about startup arguments and system properties. +--- + +# 🎛️ Arguments and Properties + +The start arguments and system properties are values appended to the [commands](#user-content-fn-1)[^1] 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)[^2]. + +*** + +## System properties + +System properties inputted before `-jar` are processed in the JVM before Plazma initialization. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Usage + +System properties are inputted as Java command arguments between `java` and `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +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 [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 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. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +If you are a plugin developer and need to update a plugin, use hotswapping instead of `/reload`. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `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. + +{% hint style="danger" %} +**이렇게 하면 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. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Default**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `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). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `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 [default chunk writing system](#user-content-fn-10)[^10]. + +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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `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` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +This can significantly impact server safety and performance. + +Any issues resulting from using this attribute are the responsibility of the server administrator. +{% endhint %} + +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` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +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. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Full Start Argument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Default**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Default**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Default**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Starts the server in demo world. + +#### `eraseCache` + +Removes remaining cache files after world upgrade. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `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)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `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**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Default**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +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 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Default**: `plugins` + +Sets the location of the plugins folder. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Default**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Default**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Starts the server in a completely vanilla state (safe mode). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Default**: `(server properties)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `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 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `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. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: The processing location of the acquisition changes depending on the attached location. + +[^3]: For example, if you want to set `Plazma.iKnowWhatIAmDoing` to `true` (activate), instead of entering `-DPlazma.iKnowWhatIAmDoing=true`, entering `-DPlazma.iKnowWhatIAmDoing` will work the same way. + +[^4]: For example, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: A signal indicating that the server is properly connected like a heartbeat. + +[^9]: Using Purpur's AFK kick feature, you can kick players who are away from their keyboards. + +[^10]: Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: In the game, `world optimization` also operates on the same principle. + +[^13]: Administrators above `level 2` are excluded. + +[^14]: Internet Protocol, IP. diff --git a/en/origin/plazma/administration/reference/commands.md b/en/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..68031b491 --- /dev/null +++ b/en/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Learn about the commands available in Plazma. +--- + +# 🖥️ Commands diff --git a/en/origin/plazma/administration/reference/configurations/README.md b/en/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..9c5124d49 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Configurations are the most basic way to customize Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Attributes + +> Attributes are the most basic configuration files provided in Minecraft. Using attributes allows you to change the basic mechanics of the game. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Configuration + +> Bukkit configuration is the most basic configuration file provided in Plazma. Using Bukkit configuration allows you to change the basic mechanics of a Minecraft server. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Configuration + +> Spigot configuration allows you to modify the detailed mechanics of the game, player processing, operation of commands, and messages. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Configuration + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish configuration allows you to modify the handling of worlds and entities in Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Configuration + +> Purpur attributes allow you to modify the overall basic data of the game. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Configuration + +> Plazma configuration allows you to customize the functions of Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/en/origin/plazma/administration/reference/configurations/bukkit.md b/en/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e84eaa8aa --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in bukkit.yml means. +--- + +# 🪣 Bukkit diff --git a/en/origin/plazma/administration/reference/configurations/paper/README.md b/en/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b363f9c84 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# 🛩️ Paper diff --git a/en/origin/plazma/administration/reference/configurations/paper/global.md b/en/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a0f0eee84 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🌏 전역 구성 diff --git a/en/origin/plazma/administration/reference/configurations/paper/world.md b/en/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f1f6b0d96 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Find out what each node in paper-world.yml represents. +--- + +# 🏳️ 세계별 구성 + +World diff --git a/en/origin/plazma/administration/reference/configurations/plazma/README.md b/en/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5f57cb1ce --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# ✨ Plazma diff --git a/en/origin/plazma/administration/reference/configurations/plazma/global.md b/en/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f95ae5f19 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-global.yml means. +--- + +# 🌏 전역 구성 diff --git a/en/origin/plazma/administration/reference/configurations/plazma/world.md b/en/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..7634be35e --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# 🏳️ 세계별 구성 diff --git a/en/origin/plazma/administration/reference/configurations/plazma/worlds.md b/en/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..890ad8f1b --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# ✨ Plazma (World Composition) diff --git a/en/origin/plazma/administration/reference/configurations/property.md b/en/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..c012dbfd9 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in server.properties means. +--- + +# 🪨 Server.properties diff --git a/en/origin/plazma/administration/reference/configurations/pufferfish.md b/en/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..11ab0ccd5 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in pufferfish.yml means. +--- + +# 🐡 Pufferfish diff --git a/en/origin/plazma/administration/reference/configurations/purpur/README.md b/en/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fe215c95b --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur diff --git a/en/origin/plazma/administration/reference/configurations/purpur/global.md b/en/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..379d3d5a8 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🌏 전역 구성 diff --git a/en/origin/plazma/administration/reference/configurations/purpur/world.md b/en/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..c41642913 --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🏳️ 세계별 구성 diff --git a/en/origin/plazma/administration/reference/configurations/spigot.md b/en/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..2aa01888b --- /dev/null +++ b/en/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in spigot.yml means. +--- + +# 🚰 Spigot diff --git a/en/origin/plazma/administration/reference/permissions.md b/en/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..3085f370a --- /dev/null +++ b/en/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Check the permissions of Plazma. +--- + +# 🛡️ Permission + +Permissions are a simple security tool that sets the scope in which players on the server can interact with each other. + +To properly utilize and easily modify permissions, you should use plugins like [LuckPerms](https://luckperms.net). + +*** + +## Understanding the default permission system + +In Minecraft, basic management permission groups are provided. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Player**\ + This is the permission group typically given to all players. +2. **Mediator**\ + Can bypass spawn protection. +3. **World Administrator**\ + Can use all commands and command blocks related to world management.\ + This is the permission group applied by default to datapacks and command blocks. +4. **Administrator**\ + Can use all commands related to player management. +5. **Super Administrator**\ + Can use all commands including server management.\ + This is the permission group applied by default to the console and operators. + +*** + +## Setting Permissions + +*** + +## Full Permissions + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Default**: `none` + +Allows players to mount entities by `crouching and interacting` with them. + +When mounted on an entity, players can control the entity's movement with the `movement keys` and jump or fly with the `jump key`. + +The [Namespaced ID](#user-content-fn-2)[^2] of the entity is entered in `(Namespaced Key)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Default**: `none` + +Allows players to use special abilities of entities while mounted on them. + +Not all entities have available special abilities. Refer below for a list of all available special abilities. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Post your ideas on [Plazma Discord](https://plazmamc.org/discord) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +View currently available special abilities + +- **`crepper`**\ + Explodes when the `jump key` is pressed.\ + If the player has the `allow.powered.creeper` permission, they can hold down the `jump key` to charge it. +- **`dolphin`**\ + Dashes when the `jump key` is pressed. +- **`phantom`**\ + Shoots fire when the `jump key` is pressed. +- **`wither`**\ + Fires wither heads when `interacted with`. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Default**: `World Administrator` + +Allows the use of the [`/compass` command](commands.md#compass). + +#### `bukkit.command.credits` + +- **Default**: `World Administrator` + +Allows the use of the [`/credits (Player)` command](commands.md#credits). + +Adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.demo` + +- **Default**: `World Administrator` + +Allows the use of the [`/demo (Player)` command](commands.md#demo). + +Adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.ping` + +- **Default**: `World Administrator` + +Allows the use of the [`/ping (Player)` command](commands.md#ping). + +Adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.ram` + +- **Default**: `World Administrator` + +Allows the use of the [`/ram` command](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Default**: `World Administrator` + +Allows the use of the [`/rambar (Player)` command](commands.md#rambar). + +Adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.restart` + +- **Default**: `World Administrator` + +Allows the use of the [`/restart` command](commands.md#restart). + +#### `bukkit.command.tps` + +- **Default**: `World Administrator` + +Allows the use of the [`/tps` command](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Default**: `World Administrator` + +Allows the use of the [`/tpsbar (Player)` command](commands.md#tpsbar). + +Adding `.other` after the permission name allows it to be used by other players. + +#### `bukkit.command.timings` + +- **Default**: `World Administrator` + +Allows the use of the [`/timings` command](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Check [Spark](https://spark.lucko.me/docs/Command-Usage) for similar commands. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Default**: `World Administrator` + +Allows the use of the [`/uptime` command](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Default**: `World Administrator` + +Allows the use of the `/gamemode (GameMode) (Player)` command. + +Adding `.other` after the permission name allows it to be used by other players. + +#### `paper.antixray.bypass` + +- **Default**: `none` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +This improves performance for both sides. + +> Refer to the page below for information on X-Ray configuration. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Default**: `none` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Default**: `none` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Default**: `none` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Default**: `none` + +Allows the use of MiniMessage tags on anvils. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Default**: `none` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Default**: `none` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Default**: `none` + +Excludes players from being kicked for idle status. + +#### `purpur.debug.f3n` + +- **Default**: `World Administrator` + +Allows players to change game modes with the `F3 + N` key combination. + +This only works if the player has permission for that game mode. + +#### `purpur.drop.spawners` + +- **Default**: `none` + +Drops spawner blocks when mining them with the configured item. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Default**: `none` + +Changes the size of ender chests. + +`(NumberString)` can be `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Default**: `none` + +Allows the totem of undying to function even when in the inventory. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Default**: `none` + +Allows the player to ignore the connection limit. + +#### `purpur.mending_shift_click` + +- **Default**: `none` + +Allows the player to repair the item they are holding by `sneak-right-clicking`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Default**: `none` + +Allows the player to place spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Default**: `none` + +Allows the player to instantly teleport when using the Nether portal. + +#### `purpur.sign.color` + +- **Default**: `none` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Default**: `none` + +Allow the use of obfuscation code `(&o)` on signs. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Default**: `none` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Default**: `none` + +Allow players to `interact` with shears to prevent TNT explosions. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Planned permissions + +#### `plazma.bypass.ncr-require` + +- **Default**: `none` + +Allow players to connect even if the [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) mod is not installed. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Example: `ender_dragon` diff --git a/en/origin/plazma/adminstration/README.md b/en/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..7fc6ef388 --- /dev/null +++ b/en/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Create your own server using Plazma. +--- + +# ⚒️ Server Management Guide diff --git a/en/origin/plazma/adminstration/expert/README.md b/en/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b4ccf734e --- /dev/null +++ b/en/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Learn about how to handle Plazma professionally. +--- + +# 🎓 Advanced diff --git a/en/origin/plazma/adminstration/expert/fix-exploits.md b/en/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..52965f59a --- /dev/null +++ b/en/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Learn about known vulnerabilities and how to fix them. +--- + +# ⚠️ Known vulnerabilities and how to fix them diff --git a/en/origin/plazma/adminstration/expert/optimize.md b/en/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..9428ce44f --- /dev/null +++ b/en/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Learn how to optimize Plazma. +--- + +# 🧹 Optimization diff --git a/en/origin/plazma/adminstration/expert/vanillaize.md b/en/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..5a157ead4 --- /dev/null +++ b/en/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Learn how to restore Paper and vanilla patches. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper does not offer choices for most of the patches that fix vanilla errors. + +Plazma is currently developing the ability to disable such error fixes as a configuration. + +Therefore, this guide is still being written and the information is subject to change at any time. +{% endhint %} diff --git a/en/origin/plazma/adminstration/faq.md b/en/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..dcc8f9bd5 --- /dev/null +++ b/en/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Find out about frequently asked questions. +--- + +# ⁉️ Frequently Asked Questions + +{% hint style="info" %} + +### Can't find the answer you're looking for? + +Ask the community through the [Official Discord Server](https://discord.gg/MmfC52K8A8) or [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### The message is displayed but does not run + +If `no main manifest attribute, in plazma-(version).jar` is displayed in the console,\ +the downloaded file is a development API file, and you need to download **Reobf Paperweight** from the GitHub page. + +Refer to the following page for more details. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### A warning is displayed every time the server starts + +Plazma contains some unstable patches and may always malfunction, so the server displays the following warning when it starts. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +This warning can be disabled using the [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +Refer to the following page for more details. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available from 1.20.1 diff --git a/en/origin/plazma/adminstration/getting-started/README.md b/en/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..36380b24c --- /dev/null +++ b/en/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Learn how to create a server with Plazma. +--- + +# 👟 Getting Started + +To use Plazma reliably, the system must meet the following requirements. + +| | Minimum | Recommended | +| :-----------: | ------: | ----------: | +| Architecture | x64 | - | +| RAM | 8GB | 16GB | +| Storage space | 1GB | 8GB | +| JRE | 17 | 21 | + +For smooth configuration file editing, it is also recommended to install an editor such as [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE Installation + +As the name suggests, Minecraft: "Java" Edition is developed in Java, so it requires JRE[^1] to run. + +Since Plazma is based on Mojang Studios' official server platform[^2], JRE must be installed to use Plazma. + +### 1.1 Check for JRE + +To check if JRE is installed on the system, type [`cmd /k java --version`](#user-content-fn-4)[^4] in the Run window and run it. + +If the output is as follows, skip to [Step 2](setup.md#id-2). + +{% code title="Correct Output" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +If it does not output as above, or if it outputs as below, JRE is not installed or is too outdated, so you need to perform [Step 1.2](setup.md#id-1.2). + +{% code title="JRE is not installed" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE is too outdated" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE Installation + +In this guide, we will use Azul Zulu as one of the [types of JRE](#user-content-fn-5)[^5]. + +After installation, redo [Step 1.1](setup.md#id-1.1) to verify that the installation is successful. + +{% tabs %} +{% tab title="Windows" %} + +1. First, download **JDK 21** in `.msi` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Run the downloaded installer and click `Next`. +3. After activating `Set JAVA_HOME variable` from the menu displayed in the center left of the window, click `Next`. +4. Click `Install` to complete the JRE installation. + {% endtab %} + +{% tab title="macOS" %} +Download **JDK 21** in `.dmg` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) and install JRE by running the downloaded installer. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +First, add the Azul Zulu repository to APT by running the following command in the terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, install JRE by running the following command in the terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +You can install JRE by entering the following command. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma offers various forms of executable files. + +{% hint style="warning" %} + +### In most cases, use `Reobf Paperclip`. + +The following information is for developers or those curious about the characteristics of each form.\ +If you are a regular user, you can skip to [Step 3](setup.md#id-3) without any issues. +{% endhint %} + +
+ +Learn More + +The executable file is named `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping Type**\ + Mapping is a kind of map that connects Minecraft's actual code with obfuscated code. + - **Reobf**\ + Reobfuscation, also known as Spigot mapping, is used in most NMS plugins.\ + It will be discontinued starting from 1.20.5. + - **Mojmap**\ + Mojang mapping, vanilla Minecraft mapping. +- **Version Manager**\ + The version manager can be considered as the launcher of the server, which is necessary for running the server and patching server files. + - **Paperclip**\ + Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server. + - **Bundler**\ + The vanilla Minecraft version manager. + +
+ +*** + +## 3. Creating a Start Script + +To easily start Plazma and automatically restart the server, you need to create a [start script](#user-content-fn-6)[^6]. + +You can create a start script through [Flags.sh](https://flags.sh). By entering only the memory to be used for Plazma, the command will be automatically optimized. + +You can download the start script by clicking the bottom left download button.\ +**Make sure the downloaded start script matches your operating system.** + +*** + +## 4. File Cleanup + +Now move the downloaded start script and Plazma to a new folder. + +{% hint style="warning" %} + +### The folder name must not have spaces and must be in English. + +Otherwise, Plazma or JRE may not function correctly. +{% endhint %} + +Now run the start script. For Windows, you must select **Allow** in the firewall permission dialog box at the bottom left. + +*** + +## 5. EULA Agreement + +Once you run the start script, an `eula.txt` file will be generated in the folder. + +EULA[^9] is a license agreement that you must agree to by using the services of [Mojang Studios](#user-content-fn-10)[^10]. + +If you do not agree to the EULA, you cannot start the server, and violating the EULA may result in sanctions such as account suspension. + +To agree to the EULA, change `eula=false` to `eula=true` in the `eula.txt` file and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operating systems block external access by default to prevent unauthorized access from outside using **firewalls** and **routers**. + +For Windows, since you allowed it in [Step 3](setup.md#id-3), you just need to do port forwarding. + +{% hint style="info" %} + +### This guide assumes that you are using a Windows operating system and a router that supports [**UPnP**](#user-content-fn-12)[^12]. + +If your router does not support UPnP, you will need to search for information as panel layouts vary by router. + +Alternatively, you can use [Ngrok](https://ngrok.com/) to generate a temporary address. +{% endhint %} + +{% hint style="warning" %} + +### For Linux or macOS (semi) UNIX-based operating systems, settings for each firewall service vary, so you need to search for information. + +{% endhint %} + +### 6.1 Check the Need for Port Forwarding + +Enter the following in the Run window and run it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output is `True`, you can stop here, but if it is `False`, you need to set up port forwarding. + +### 6.2 Connect to the Server + +{% tabs %} +{% tab title="External Connection" %} +If port forwarding is not needed or if you have already successfully set up port forwarding, you can now connect to the server. + +The address used to connect to the server can be checked [here](https://ip.pe.kr/) +{% endtab %} + +{% tab title="Attempt port forwarding with UPnP" %} +In the `purpur.yml` file of the server folder, enable `network.upnp-port-forwarding` to `true`. + +Then, when you restart the server, Plazma will automatically attempt port forwarding. + +Below is the indication of UPnP success based on the message output to the console, which will be displayed as `[UPnP] (message)` in the console. + +| Message | Meaning | +| --------------------------------- | --------------------------------------------- | +| `Successfully opened port (port)` | Port forwarding successful. | +| `Port (port) is already open` | Another service is currently using that port. | +| `Failed to open port (port)` | Port forwarding failed. | +| `Service is unavailable` | The router does not support UPnP. | + +When the server shuts down, Plazma automatically closes the port. +{% endtab %} + +{% tab title="Create a temporary address with Ngrok" %} +Using Ngrok is useful for short-term testing, collaborative play, or playing with friends. + +1. Download the `Windows (64-bit)` ZIP file from [Ngrok website](https://ngrok.com/download). +2. Put the downloaded Ngrok into the server folder. +3. Generate an authentication token at [Ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken)[^13]. +4. Execute the command displayed in the `Command Line` in the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top of the execution script, and `taskkill /f /t /im ngrok.exe` at the bottom. +6. In the console, the address `0.tcp.jp.ngrok.io:12345` shown at the top will be the server's address. +7. Now you can connect from external sources using this address. + {% endtab %} + +{% tab title="Connect locally" %} +If you are trying to connect to the server locally, you can connect using the `IPv4 address` displayed by running `cmd /k ipconfig` in the command prompt. + +For example, if the output displays as follows after executing the command, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +When attempting to connect to the server locally, you can connect using the `192.168.3.7` displayed in the IPv4 address here. + +If the server and the game are running on the same PC, you can connect using `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Evolution Stage + +If the server starts successfully and is operating correctly, it is time to customize the server. + +Learn how to customize the server through the guide below. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java Execution Environment. + +[^2]: Paper, the foundation of Plazma, is based on Spigot, which is based on the official server platform. + +[^3]: Windows key + R + +[^4]: For Linux, use `java --version` in the terminal. + +[^5]: JRE is one of the open-source projects, similar to Minecraft server platforms. + +[^6]: Generally known as **launcher**. + +[^7]: Enabling "Auto-restart" will automatically restart the server. You can exit by entering `Control + C`. + +[^8]: It is not recommended to exceed more than half of the system. + + For example, if the total system memory capacity is 8GB, it is not recommended to set it above 4GB. + +[^9]: End-User License Agreement, EULA. Please refer to [Minecraft website](https://www.minecraft.net/ko-kr/usage-guidelines) for more details. + +[^10]: Microsoft Corporation. + +[^11]: In South Korea, according to Article 32, Paragraph 1, Item 9 of the Act on the Promotion of the Game Industry, legal action can be taken by **Korean Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur included in Plazma communicates with the router automatically through this technology to open ports only when the server is running, eliminating the need to manually port forward. + +[^13]: If you do not have an account, sign up for Ngrok using your Google or GitHub account. diff --git a/en/origin/plazma/adminstration/getting-started/customization.md b/en/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..b0db4c5db --- /dev/null +++ b/en/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Learn how to customize the server. +--- + +# 🎨 Customization diff --git a/en/origin/plazma/adminstration/reference/arguments.md b/en/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..a3473b7b2 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,522 @@ +--- +description: Learn about startup arguments and system properties. +--- + +# 🎛️ Arguments and Properties + +Startup variables and system properties are values appended to the [commands used](#user-content-fn-1)[^1] in Plazma execution, allowing the values that cannot be changed after Plazma is executed to be changed. + +Depending on the [location where appended to the command](#user-content-fn-2)[^2], they are divided into **startup arguments** and **system properties**. + +*** + +## System properties + +System properties inputted before `-jar` are processed in the JVM before Plazma initialization. + +{% hint style="warning" %} + +### Modifying system properties can change the operation of Plazma and the JVM, potentially having a significant impact on the game! + +If you are not sure about the role of each system property, **never use them!** +{% endhint %} + +### Usage + +System properties are inputted as Java command arguments between `java` and `-jar`. + +For example, when applying the `Plazma.dummyProperty` system property, entering as follows will initialize Plazma with the value `37` in the next property. + +```batch +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, + +and if no value is entered for the property, the value is fixed to [`true.`](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### The Paperweight series server platforms include a `.` in the property name to distinguish system properties for each platform. + +In some terminals such as Windows Powershell, these arguments may not be allowed, so `"` must be added at both ends of the argument. + +### 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. + +{% hint style="danger" %} + +### Since the `/reload` command is highly unstable, all issues occurring after its use are the responsibility of the user. + +If you are a plugin developer and need to update a plugin, use hotswapping instead of `/reload`. +{% endhint %} + +#### `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` + +Disables the limit of 128 plugin channels per player. + +#### `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` + +- **Type**: `Integer` +- **Default**: `750` + +Splits entities into multiple packets if they exceed the set value. + +#### `Paper.filterThreshold` + +- **Type**: `Integer` +- **Default**: `8192` + +Sets the maximum packet size the server can receive at once. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables Java version verification. + +{% hint style="danger" %} + +### This allows the JVM to attempt to access non-existent code! + +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. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Integer` +- **Default**: `64` + +Sets the limit for plugin channel names. + +#### `Paper.maxSignLength` + +- **Type**: `Integer` +- **Default**: `80` + +Sets the maximum length of characters that can be entered on one line of a sign. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `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` + +- **Type**: `Integer` +- **Default**: `30` + +Kicks players if no data is received from them for the entered value (in seconds). + +Normally, the game[^7] continuously sends [heartbeat signals](#user-content-fn-8)[^8] to the server, so players are not kicked, + +#### `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 [default chunk writing system](#user-content-fn-10)[^10]. + +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` + +{% hint style="warning" %} + +### This property will be moved to startup arguments after 1.20.5. + +{% endhint %} + +Applies stricter configuration optimization at the initial startup. + +Activating it makes the server faster and safer, but it may block some gimmicks or have a significant impact on gameplay. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default**: `false` + +Suppresses the warning[^11] displayed when Plazma is initialized. + +### 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. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Full Start Argument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Default**: `bukkit.yml` + +Sets the name and location of the [Bukkit configuration file](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Default**: `commands.yml` + +Sets the name and location of the [Bukkit command configuration file](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Default**: `server.properties` + +Sets the name and location of the [server properties](../reference/configurations/property.md) file. + +#### `demo` + +Starts the server in demo world. + +#### `eraseCache` + +Removes remaining cache files after world upgrade. + +#### `forceUpgrade` + +Forces upgrading the world regardless of version. + +#### `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)` + +Sets the maximum number of allowed [players](#user-content-fn-14). + +#### `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. + +**May be sanctioned for violating the [EULA](../getting-started/README.md#id-5) if not using Velocity or other proxies.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Default**: `paper.yml` + +{% hint style="warning" %} + +### This argument has been deprecated since 1.19.4 + +{% endhint %} + +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` + +Sets the name and location of the folder where [Paper configuration files](../reference/configurations/paper/README.md) are located. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Sets the name and location of the folder where [Plazma configuration files](../reference/configurations/plazma/README.md) are located. + +#### `plugins` + +- **Alias**: `p` +- **Default**: `plugins` + +Sets the location of the plugins folder. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Default**: `pufferfish.yml` + +Sets the name and location of the [Pufferfish configuration file](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Default**: `purpur.yml` + +Sets the name and location of the [Purpur configuration file](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Starts the server in a completely vanilla state (safe mode). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Default**: `(server properties)` + +Sets the host name or [Internet Protocol](#user-content-fn-13) address of the server. + +#### `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` + +Sets the name and location of the [Spigot configuration file](../reference/configurations/spigot.md). + +#### `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. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: The processing location of the acquisition changes depending on the attached location. + +[^3]: For example, if you want to set `Plazma.iKnowWhatIAmDoing` to `true` (activate), instead of entering `-DPlazma.iKnowWhatIAmDoing=true`, entering `-DPlazma.iKnowWhatIAmDoing` will work the same way. + +[^4]: For example, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: A signal indicating that the server is properly connected like a heartbeat. + +[^9]: Using Purpur's AFK kick feature, you can kick players who are away from their keyboards. + +[^10]: Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: In the game, `world optimization` also operates on the same principle. + +[^13]: Internet Protocol, IP. + +[^14]: Administrators above `level 2` are excluded. diff --git a/en/origin/plazma/adminstration/reference/commands.md b/en/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..68031b491 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Learn about the commands available in Plazma. +--- + +# 🖥️ Commands diff --git a/en/origin/plazma/adminstration/reference/configurations/bukkit.md b/en/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e84eaa8aa --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in bukkit.yml means. +--- + +# 🪣 Bukkit diff --git a/en/origin/plazma/adminstration/reference/configurations/paper/README.md b/en/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b363f9c84 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# 🛩️ Paper diff --git a/en/origin/plazma/adminstration/reference/configurations/paper/global.md b/en/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..df1e2d629 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🛩️ Paper (Global Configuration) diff --git a/en/origin/plazma/adminstration/reference/configurations/paper/world.md b/en/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..ad88edab1 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-world.yml represents. +--- + +# 🛩️ Paper (Composition by world) diff --git a/en/origin/plazma/adminstration/reference/configurations/plazma/README.md b/en/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5f57cb1ce --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# ✨ Plazma diff --git a/en/origin/plazma/adminstration/reference/configurations/plazma/global.md b/en/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..996ee3054 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-global.yml means. +--- + +# ✨ Plazma (Global Configuration) diff --git a/en/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/en/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..c9818eb71 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ World Composition diff --git a/en/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/en/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..890ad8f1b --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# ✨ Plazma (World Composition) diff --git a/en/origin/plazma/adminstration/reference/configurations/property.md b/en/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..c012dbfd9 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in server.properties means. +--- + +# 🪨 Server.properties diff --git a/en/origin/plazma/adminstration/reference/configurations/pufferfish.md b/en/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..11ab0ccd5 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in pufferfish.yml means. +--- + +# 🐡 Pufferfish diff --git a/en/origin/plazma/adminstration/reference/configurations/purpur/README.md b/en/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fe215c95b --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur diff --git a/en/origin/plazma/adminstration/reference/configurations/purpur/global.md b/en/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..ce44baced --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur (Global Configuration) diff --git a/en/origin/plazma/adminstration/reference/configurations/purpur/world.md b/en/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..5ecbd5d15 --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur (Composition by world) diff --git a/en/origin/plazma/adminstration/reference/configurations/spigot.md b/en/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..2aa01888b --- /dev/null +++ b/en/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in spigot.yml means. +--- + +# 🚰 Spigot diff --git a/en/origin/plazma/adminstration/reference/permissions.md b/en/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..31d1a20fb --- /dev/null +++ b/en/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Check the permissions of Plazma. +--- + +# 🛡️ Permission diff --git a/en/origin/plazma/developers.md b/en/origin/plazma/developers.md new file mode 100644 index 000000000..697830a52 --- /dev/null +++ b/en/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Develop third-party projects using Plazma. +--- + +# ⚙️ Developer Guide diff --git a/en/origin/thunderbolt/README.md b/en/origin/thunderbolt/README.md new file mode 100644 index 000000000..7059ee081 --- /dev/null +++ b/en/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt is a Plazma-based server platform that allows you to directly try experimental patches by distinguishing them as flavors. +--- + +# 🌩️ Thunderbolt Usage Guide diff --git a/en/origin/volt/README.md b/en/origin/volt/README.md new file mode 100644 index 000000000..250b310ec --- /dev/null +++ b/en/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt is an open-source template that allows you to develop your own Paperweight server platform based on Plazma. +--- + +# ⚡ Volt Development Guide diff --git a/es-ES/origin/README.md b/es-ES/origin/README.md new file mode 100644 index 000000000..62e4e8307 --- /dev/null +++ b/es-ES/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Si tienes alguna pregunta, por favor hazla a través de Discord o GitHub Discussions. +--- + +# 🏠 Bienvenido al Portal de Documentos + +{% hint style="info" %} + +**Los documentos de Plazma están actualmente en estado de traducción automática.** + +[![Estado de traducción](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Participe en la traducción de documentos en [https://translate.plazmamc.org/](https://translate.plazmamc.org/) para mejorar los documentos. + +{% endhint %} + +### ¿Ha surgido algún problema durante el uso de Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### ¿Interesado en Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### ¿Quieres crear tu propia plataforma de servidor con Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `PATROCINADOR` ¿Necesitas más información relacionada con Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/es-ES/origin/SUMMARY.md b/es-ES/origin/SUMMARY.md new file mode 100644 index 000000000..ece81cf40 --- /dev/null +++ b/es-ES/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Tabla de contenidos + +- [🏠 Bienvenido al Portal de Documentos](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documentación de Uso de Plazma](plazma/README.md) +- [❓ ¿Qué es Plazma?](plazma/about/README.md) + - [⬇️ Descargar](plazma/about/downloads.md) + - [✅ Estado de Soporte de Versiones](plazma/about/supported-versions.md) +- [⚒️ Guía de administración del servidor](plazma/administration/README.md) + - [👟 Empezar](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referencia](plazma/administration/reference/README.md) + - [🖥️ Comandos](plazma/administration/reference/commands.md) + - [🛡️ Permisos](plazma/administration/reference/permissions.md) + - [🎛️ Argumentos y Propiedades](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Propiedad](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configuración Global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Configuraciones mundiales](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configuración Global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Configuraciones mundiales](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configuración Global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Configuraciones mundiales](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avanzado](plazma/administration/expert/README.md) + - [🧹 Optimización](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vainillizar](plazma/administration/expert/vanillaize.md) + - [🩻 Bloqueo de X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilidades y Soluciones](plazma/administration/expert/fix-exploits.md) + - [⁉️ Preguntas Frecuentes](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Guía para Desarrolladores](plazma/developers.md) + - [✏️ Contribuir](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Guía de Uso de Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Guía de Desarrollo de Volt](volt/README.md) + +## Misceláneo + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Ver Todos los Descargas](plazma/about/downloads-all.md) diff --git a/es-ES/origin/miscellaneous/README.md b/es-ES/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/es-ES/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/es-ES/origin/plazma/README.md b/es-ES/origin/plazma/README.md new file mode 100644 index 000000000..2fb0d9060 --- /dev/null +++ b/es-ES/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma es una plataforma de servidor de código abierto para Minecraft: Java Edition que agrega optimización experimental basada en papel y personalización de varios mecanismos de juego." +--- + +# ✨ Documentos de Uso de Plazma + +## 👋 Bienvenido a los Documentos de Plazma + +¡Bienvenido a la guía de uso de Plazma! + +{% hint style="info" %} + +**¿No se puede resolver el problema a través del manual?** + +¡Haz preguntas a la comunidad a través del [servidor Discord oficial](https://discord.gg/MmfC52K8A8) o las [Discusiones de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Acerca de Plazma + +> Descubre qué es Plazma como plataforma de servidor. + +{% content-ref url="about/" %} +[acerca de](about/) +{% endcontent-ref %} + +### Para Administradores + +> Crea tu propio servidor con Plazma. + +{% content-ref url="administration/" %} +[administración](administration/) +{% endcontent-ref %} + +### Para Desarrolladores + +> Desarrolla proyectos de terceros con Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/es-ES/origin/plazma/about/README.md b/es-ES/origin/plazma/about/README.md new file mode 100644 index 000000000..b2f210d65 --- /dev/null +++ b/es-ES/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Descubre qué es Plazma como plataforma de servidor. +--- + +# ❓ ¿Qué es Plazma? + +- **Plazma** es una plataforma de servidor basada en [Paper](https://github.com/PaperMC/Paper), que solo toma las ventajas de [Andromeda](https://github.com/EarendelArchived/Andromeda) y [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Siempre estamos esforzándonos por ofrecer alta estabilidad, rendimiento potente, actualizaciones rápidas y una amplia gama de funciones. + +## 📋 Objetivos de Plazma + +- Estamos trabajando para convertirnos en una plataforma de servidor con actualizaciones rápidas y alta estabilidad. +- Estamos trabajando para ofrecer una amplia gama de funciones y un rendimiento potente, no menos que una plataforma de modding. +- Estamos trabajando para crear una plataforma libre donde se pueda personalizar incluso los parches de Vanilla. + +## ⚙️ Características principales + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Actualizaciones más rápidas**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) mantiene los parches incluidos en Plazma siempre actualizados, ofreciendo las actualizaciones más rápidas entre las plataformas de servidor basadas en Paper. +6. **Optimización de archivos de configuración predeterminados**\ + Los archivos de configuración aplicados por defecto están optimizados, por lo que no es necesario optimizarlos manualmente. +7. **Funcionamiento sistemático de múltiples hilos**\ + Asincroniza los mecanismos del sistema que no están relacionados con los mecanismos del juego para optimizar el servidor reduciendo el [tiempo de latencia](#user-content-fn-4)[^4]. +8. **Bloqueo del uso de espacio innecesario**\ + Combina todos los datos con valores similares en uno solo para reducir el uso de memoria. + +## ✨ Casos de uso + +- **Plataforma que maneja incluso los complejos complementos correctamente**\ + Utilizado en el servidor del desarrollador [IPECTER](https://github.com/IPECTER) con Plazma.\ + A pesar de la gran cantidad de paquetes de datos complejos y extensos plugins propios que funcionan con NMS y reflexión,\ + puede admitir más de 100 jugadores sin caídas de rendimiento. +- **Plataforma que mantiene un rendimiento rápido incluso en servidores de RPG**\ + Ha mantenido de forma estable a 100 jugadores en un único clúster sin caídas de TPS,\ + y hasta 250 jugadores en 4 clústeres pudieron jugar sin problemas. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Plataforma elegida por muchos streamers**\ + Ha sido elegida como el cubo de participación de los espectadores de muchos streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Descargar + +Puedes descargar Plazma desde la página a continuación. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### ¿Quieres más información sobre el soporte de versiones? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plugins de Bukkit, CraftBukkit, Spigot y los plugins de Paper, Pufferfish, Purpur. + +[^2]: Propiedad de Microsoft Corporation. + +[^3]: Al desactivar el sistema de reporte de chat, el chat se manejará únicamente en el servidor, evitando el rastreo de chat de Mojang. + +[^4]: Tiempo en el que el juego se detiene momentáneamente para que funcione el mecanismo del sistema. diff --git a/es-ES/origin/plazma/about/downloads-all.md b/es-ES/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..b34943b17 --- /dev/null +++ b/es-ES/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Descargar archivo de ejecución de Plazma ver todo +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versión | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/es-ES/origin/plazma/about/downloads.md b/es-ES/origin/plazma/about/downloads.md new file mode 100644 index 000000000..18ece1e0a --- /dev/null +++ b/es-ES/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Descargue Plazma ahora mismo y pruébelo usted mismo. +--- + +# ⬇️ Descargar + +#### ¿Quieres más información sobre el soporte de versiones? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**El siguiente archivo de descarga es un archivo ejecutable para usuarios generales.** + +Si eres desarrollador y necesitas otro tipo de archivo, consulta la siguiente página. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersiónDescargar
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + descargar +
1.20.1 + descargar +
1.19.4 + descargar +
+ +*** diff --git a/es-ES/origin/plazma/about/patches-list.md b/es-ES/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..6a42e348f --- /dev/null +++ b/es-ES/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Descubre todas las funciones agregadas a Plazma. +--- + +# 📑 Parches incluidos diff --git a/es-ES/origin/plazma/about/supported-versions.md b/es-ES/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..0f53195ae --- /dev/null +++ b/es-ES/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Descubre las versiones de Minecraft: Java Edition compatibles con Plazma." +--- + +# ✅ Estado de soporte de la versión + +{% hint style="info" %} + +**Plazma se ha desarrollado desde la versión 1.19.4 en adelante, las versiones anteriores a 1.19.4 no están siendo desarrolladas.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/En%20espera%20de%20lanzamiento +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Sin%20información +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Esperando lanzamiento][wtr] ![En desarrollo][idv] ![Soporte activo][atv] ![Soporte de funciones interrumpido][fse] ![Soporte finalizado][eol] + +| Versión | Estabilidad y soporte de funciones | Estado de construcción | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Estado de construcción](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Estado de construcción](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Estado de construcción](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/es-ES/origin/plazma/administration/README.md b/es-ES/origin/plazma/administration/README.md new file mode 100644 index 000000000..dc213f8e5 --- /dev/null +++ b/es-ES/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Crea tu propio servidor con Plazma. +--- + +# ⚒️ Guía de administración del servidor diff --git a/es-ES/origin/plazma/administration/diagnosis/README.md b/es-ES/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..018ddebe8 --- /dev/null +++ b/es-ES/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo manejar la situación cuando surja un problema. +--- + +# 🧾 진단 diff --git a/es-ES/origin/plazma/administration/diagnosis/plugins.md b/es-ES/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..ae0d69a58 --- /dev/null +++ b/es-ES/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo solucionar cuando el complemento no funciona correctamente. +--- + +# 📜 플러그인 diff --git a/es-ES/origin/plazma/administration/expert/README.md b/es-ES/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..c5db7ad02 --- /dev/null +++ b/es-ES/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo manejar Plazma de manera profesional. +--- + +# 🎓 Avanzado diff --git a/es-ES/origin/plazma/administration/expert/fix-exploits.md b/es-ES/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..6091abebb --- /dev/null +++ b/es-ES/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descubra las vulnerabilidades conocidas y cómo solucionarlas. +--- + +# ⚠️ Vulnerabilidades conocidas y formas de solucionarlas diff --git a/es-ES/origin/plazma/administration/expert/optimize.md b/es-ES/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..0f69fd671 --- /dev/null +++ b/es-ES/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo optimizar Plazma. +--- + +# 🧹 Optimización diff --git a/es-ES/origin/plazma/administration/expert/proxy.md b/es-ES/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..1be50efff --- /dev/null +++ b/es-ES/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo configurar de forma segura la plataforma de proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/es-ES/origin/plazma/administration/expert/vanillaize.md b/es-ES/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..54e478914 --- /dev/null +++ b/es-ES/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Descubre cómo restaurar el parche de Paper y Vanilla. +--- + +# ↩️ Vanillaizar + +{% hint style="warning" %} + +**Paper no agrega opciones a la mayoría de los parches que solucionan errores de vanilla.** + +Actualmente, Plazma está desarrollando una configuración para desactivar dicha corrección de errores. + +Por lo tanto, esta guía aún está en proceso de escritura y la información está sujeta a cambios en cualquier momento. + +{% endhint %} diff --git a/es-ES/origin/plazma/administration/expert/xray.md b/es-ES/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..2e79a850d --- /dev/null +++ b/es-ES/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Descubra los diversos métodos integrados para bloquear X-Ray. +--- + +# 🩻 Bloqueo de X-Ray diff --git a/es-ES/origin/plazma/administration/faq.md b/es-ES/origin/plazma/administration/faq.md new file mode 100644 index 000000000..9d0adb855 --- /dev/null +++ b/es-ES/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Descubre las preguntas frecuentes. +--- + +# ⁉️ Preguntas frecuentes + +{% hint style="info" %} + +**¿No puedes encontrar la respuesta que buscas?** + +¡Haz preguntas a la comunidad a través del [servidor Discord oficial](https://discord.gg/MmfC52K8A8) o las [Discusiones de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma no se inicia + +Si aparece `no main manifest attribute, in plazma-(version).jar` en la consola,\ +el archivo descargado es un archivo de API de desarrollo y debes descargar **Reobf Paperweight** desde la página de GitHub. + +Consulta la siguiente página para obtener más información. + +{% content-ref url="getting-started/" %} +[inicio](getting-started#id-2) +{% endcontent-ref %} + +### Se muestra una advertencia cada vez que se inicia el servidor + +Plazma contiene parches inestables y siempre existe la posibilidad de mal funcionamiento, por lo que muestra advertencias al iniciar el servidor. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Puedes desactivar esta advertencia utilizando la propiedad del sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Consulta la siguiente página para obtener más información. + +{% content-ref url="reference/arguments.md" %} +[argumentos.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponible a partir de la versión 1.20.1 diff --git a/es-ES/origin/plazma/administration/getting-started/README.md b/es-ES/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..c7065352f --- /dev/null +++ b/es-ES/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Descubra cómo crear un servidor con Plazma. +--- + +# 👟 Empezar + +Para utilizar Plazma de manera estable, el sistema debe cumplir con los siguientes requisitos. + +| | Mínimo | Recomendado | +| :-----------------------: | ------ | ----------- | +| Arquitectura | x64 | - | +| RAM | 8GB | 16GB | +| Espacio de almacenamiento | 1GB | 8GB | +| JDK | 17 | 21 | + +Para facilitar la edición de archivos de configuración, también es recomendable instalar un editor como [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Salida correcta" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +Entorno de tiempo de ejecución OpenJDK Zulu21.32+17-CA (compilación 21.0.2+13-LTS) +Servidor VM de 64 bits de OpenJDK Zulu21.32+17-CA (compilación 21.0.2+13-LTS, modo mixto, compartido) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' no es un comando interno o externo, programa ejecutable o archivo por lotes. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Opción no reconocida: --version +Error: No se pudo crear la Máquina Virtual de Java. +Error: Se ha producido una excepción fatal. El programa se cerrará. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Primero, descargue **JDK 21** de [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) en formato `.msi`. +2. Ejecute el asistente de instalación descargado y haga clic en `Siguiente`. +3. Después de activar `Set JAVA_HOME variable` en el menú mostrado en el centro izquierdo de la ventana, haga clic en `Siguiente`. +4. Presione `Instalar` para completar la instalación de JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Luego, ejecute el siguiente comando en la terminal para instalar JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Descarga de Plazma + +Plazma ofrece varios archivos ejecutables. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Ver más detalles + +El nombre del archivo ejecutable se establece como `plazma-(administrador de versiones)-1.20.4-R0.1-SNAPSHOT-(formato de mapeo).jar`. + +- **Formato de mapeo**\ + El mapeo es una especie de mapa que une el código real de Minecraft con el código ofuscado. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mapeado por Mojang, es el mapeo de Minecraft de vainilla. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Administrador de versiones**\ + El administrador de versiones es un lanzador de servidores que proporciona las bibliotecas necesarias para ejecutar el servidor y parchear los archivos del servidor. + - **Paperclip**\ + Desarrollado por el equipo de PaperMC para Paper y otras plataformas derivadas, se encarga de descargar bibliotecas y aplicar parches al servidor. + - **Bundler**\ + Administrador de versiones de Minecraft Vanilla. + +
+ +*** + +## 3. Creación de script de inicio + +Para iniciar Plazma fácilmente y reiniciar el servidor automáticamente, es necesario crear un [script de inicio](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Puede descargar el script de inicio haciendo clic en el botón de descarga en la esquina inferior izquierda.\ +**Asegúrese de que el script descargado sea compatible con su sistema operativo.** + +*** + +## 4. Organización de archivos + +Mueva el script de inicio descargado y Plazma a una nueva carpeta. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Ejecute el script de inicio. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Aceptación del EULA + +Una vez que ejecute el script de inicio, se creará un archivo `eula.txt` en la carpeta. + +El EULA[^9] es un acuerdo de licencia que debe aceptar para utilizar los servicios de [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Para aceptar el EULA, cambie `eula=false` a `eula=true` en el archivo `eula.txt` y guárdelo. + +*** + +## 6. Permitir acceso externo (Windows) + +Los sistemas operativos modernos bloquean el acceso externo por defecto con el fin de prevenir accesos no autorizados mediante el **firewall** y el **enrutador**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Si el enrutador no admite UPnP, las instrucciones pueden variar según el modelo del enrutador y se recomienda buscar información específica. + +También se puede utilizar [Ngrok](https://ngrok.com/) para generar una dirección temporal. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Verificación de la necesidad de reenvío de puertos + +Ingrese y ejecute lo siguiente en la ventana de ejecución. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Si la salida es `True`, no es necesario realizar más acciones. Si es `False`, debe configurar el reenvío de puertos. + +### 6.2 Conexión al servidor + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Puede encontrar la dirección utilizada para conectarse al servidor [aquí](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Luego, al reiniciar el servidor, Plazma intentará realizar el reenvío automático de puertos. + +A continuación se muestra el resultado del éxito del UPnP según el mensaje mostrado en la consola, que se mostrará como `[UPnP] (mensaje)` en la consola. + +| Mensaje | Significado | +| ------------------------------------ | --------------------------------------------------------- | +| `Puerto abierto con éxito (puerto)` | Éxito en el reenvío de puertos. | +| `El puerto (puerto) ya está abierto` | Otro servicio está utilizando ese puerto. | +| `Error al abrir el puerto (puerto)` | Fallo en el reenvío de puertos. | +| `El servicio no está disponible` | El enrutador no es compatible con UPnP. | + +Cuando el servidor se apaga, Plazma cierra automáticamente el puerto. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Descargue el archivo ZIP de `Windows (64-bit)` desde la [página de Ngrok](https://ngrok.com/download). +2. Coloque el Ngrok descargado en la carpeta del servidor. +3. Genere un token de autenticación desde el [tablero de Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Ejecute el comando mostrado en la `Línea de comandos` en la carpeta del servidor. +5. Agregue `start /b ngrok tcp --region jp 25565` en la parte superior del script de ejecución, y `taskkill /f /t /im ngrok.exe` en la parte inferior. +6. En `Reenvío tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` mostrado en la parte superior de la consola, `0.tcp.jp.ngrok.io:12345` será la dirección del servidor. +7. Ahora puede conectarse desde el exterior utilizando esta dirección. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Por ejemplo, si la ejecución del comando muestra una dirección `IPv4` como la siguiente, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Puede intentar conectarse al servidor local utilizando la dirección `192.168.3.7` mostrada en la dirección IPv4. + +Si el servidor y el juego se ejecutan en la misma PC, puede conectarse utilizando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. 발전하기 + +Una vez que el servidor se ha iniciado con éxito y está funcionando correctamente, es hora de personalizar el servidor. + +Explore a través de este manual cómo personalizar el servidor. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, en el que se basa Plazma, se basa en Spigot, que a su vez se basa en la plataforma oficial del servidor de Spigot. + +[^3]: Windows key + R + +[^4]: Para Linux, use `java --version` en la terminal. + +[^5]: JRE es un proyecto de código abierto con múltiples variantes, al igual que las plataformas de servidores de Minecraft. + +[^6]: Comúnmente conocido como **launcher**. + +[^7]: Al activar "Auto-reinicio", el servidor se reiniciará automáticamente. Puede detenerlo ingresando `Control + C`. + +[^8]: No se recomienda superar la mitad de la capacidad del sistema. + + Por ejemplo, si la capacidad total de memoria del sistema es de 8GB, no se recomienda configurar más de 4GB. + +[^9]: Acuerdo de Licencia para el Usuario Final, EULA. Consulte el [sitio web de Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) para obtener más información. + +[^10]: Corporación Microsoft. + +[^11]: Según el Artículo 32, Párrafo 1, Punto 9 de la Ley de Promoción de la Industria de Juegos de la República de Corea, **Korea Microsoft Corporation** tiene el derecho de presentar una demanda legal. + +[^12]: Universal Plug & Play. Purpur incluido en Plazma se comunica automáticamente con el enrutador a través de esta tecnología para abrir puertos solo cuando el servidor está en funcionamiento, eliminando la necesidad de reenvío de puertos directo. + +[^13]: Si no tiene una cuenta, regístrese en Ngrok a través de una cuenta de Google o GitHub. diff --git a/es-ES/origin/plazma/administration/getting-started/customization.md b/es-ES/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..37cfac11e --- /dev/null +++ b/es-ES/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Descubre cómo personalizar el servidor. +--- + +# 🎨 Personalización de usuario + +La razón por la que se utiliza una plataforma de servidor modificada como Plazma en lugar de utilizar la plataforma oficial de servidores proporcionada por Mojang Studios es la capacidad de realizar una **personalización** poderosa. + +A continuación se presentan varias formas de personalizar y utilizar Plazma. + +## Modificación de la configuración + +La forma más básica de personalizar Plazma es modificar la configuración. + +Plazma proporciona ajustes de configuración poderosos que van desde los mecanismos del juego hasta las propiedades de los mobs. + +Consulte la página siguiente para obtener información sobre la configuración de Plazma. + +{% content-ref url="../reference/configurations/" %} +[configuraciones](../reference/configurations/) +{% endcontent-ref %} + +## Uso de complementos + +{% hint style="éxito" %} + +**Plazma soporta correctamente todos los complementos basados en Paper.** + +En el caso de los complementos de Spigot, debido a los cambios de mapeo de Paper a partir de la versión 1.20.5, algunos pueden no funcionar correctamente, pero la mayoría de los complementos basados en Paper, como Paper, Pufferfish y Purpur, funcionarán correctamente en Plazma. Si un complemento no funciona correctamente, se debe informar inmediatamente [aquí.](../diagnosis/plugins.md) + +{% endhint %} + +Esta es la razón principal para usar Plazma y la forma más poderosa de personalizarlo. +El sólido ecosistema de complementos de Plazma permite personalizar fácilmente el servidor. + +Hay varias formas de encontrar y descargar complementos. Algunos complementos se cargan en servicios de repositorios públicos, mientras que otros se pueden cargar en GitHub o en su propio sitio web. + +{% hint style="precaución" %} + +**¡Los complementos pueden acceder directamente al sistema!** + +Antes de aplicar un complemento, siempre asegúrese de que sea seguro utilizando servicios como VirusTotal, o descargando los complementos de servicios confiables. + +{% endhint %} + +Hay varios servicios para descargar complementos. Entre ellos, servicios como [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisan los complementos antes de ser cargados para garantizar que solo se distribuyan complementos seguros. + +### Aplicación de complementos + +Una vez descargados los complementos, es hora de aplicarlos. + +1. Los complementos están en formato `.jar` o archivo ejecutable de Java. Algunos pueden estar comprimidos, en cuyo caso, si contienen `bukkit`, `spigot` o `paper` en el nombre y un archivo `fat`, se debe usar el archivo `fat`. +2. Coloque los archivos descargados en la carpeta 'plugins' del servidor y reinicie el servidor. +3. Cuando Plazma se inicie, verá nueva información en la consola. + Esto indica que Plazma ha cargado los complementos correctamente. +4. A pesar de que Plazma haya cargado los complementos correctamente, es posible que no se inicien. + Puede usar el comando `/plugins` para ver los complementos cargados en el servidor. + Si el nombre de un complemento instalado es rojo en lugar de verde, significa que el complemento se ha cargado correctamente. + +Si un complemento no se ha cargado correctamente, puede encontrar soluciones en la siguiente página. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Uso de paquetes de datos + +Los paquetes de datos son una forma de personalizar Minecraft similar a los [paquetes de recursos](#user-content-fn-1). + +Con los paquetes de datos, puede agregar nuevas entidades y desafíos al juego, entre otras modificaciones internas. + +{% hint style="precaución" %} + +**¡Los paquetes de datos pueden dañar el mundo!** + +Algunos paquetes de datos defectuosos pueden dañar el mundo de forma irreversible. + +Por lo tanto, se recomienda hacer una copia de seguridad del mundo antes de aplicar paquetes de datos. + +{% endhint %} + +Los paquetes de datos se pueden descargar de varios servicios, como [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs). + +Una vez descargados los paquetes de datos, se pueden aplicar colocándolos en la carpeta 'datapacks' del mundo del servidor. +Si la carpeta no existe, simplemente créela y añada los paquetes de datos. + +{% hint style="warning" %} + +**Algunos [paquetes de datos](#user-content-fn-2) pueden no aplicarse correctamente la primera vez.** + +En caso de esto, se recomienda reiniciar el servidor **2 veces**. + +{% endhint %} + +Los paquetes de datos pueden dañarse fácilmente con cada actualización de Minecraft. + +Especialmente si un paquete de datos se daña por completo, es importante realizar pruebas exhaustivas antes de actualizar el servidor para evitar conflictos. + +{% hint style="info" %} + +**Después de ingresar `safeMode` detrás del comando de inicio del servidor, puede desactivar todos los paquetes de datos y reiniciar el servidor.** + +[Consulte `Referencia > Argumentos` para obtener más información detallada.](../reference/arguments.md) + +{% endhint %} + +Puede verificar los paquetes de datos aplicados con el comando `/datapack list`. + +*** + +[^1]: O también en Minecraft: Bedrock Edition con complementos como la adición de entidades. + +[^2]: Añadir entidades al juego, entre otras cosas. diff --git a/es-ES/origin/plazma/administration/getting-started/next-step.md b/es-ES/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..002f4b914 --- /dev/null +++ b/es-ES/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Descubre cómo personalizar el servidor. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +A continuación se presentan varias formas de personalizar y utilizar Plazma. + +## Modificación de la configuración + +La forma más básica de personalizar Plazma es modificar la configuración. + +Plazma proporciona ajustes de configuración poderosos que van desde los mecanismos del juego hasta las propiedades de los mobs. + +Consulte la página siguiente para obtener información sobre la configuración de Plazma. + +{% content-ref url="../reference/configurations/" %} +[configuraciones](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Uso de complementos + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Esta es la razón principal para usar Plazma y la forma más poderosa de personalizarlo. El sólido ecosistema de complementos de Plazma permite personalizar fácilmente el servidor. + +Hay varias formas de encontrar y descargar complementos. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Hay varios servicios para descargar complementos. Entre ellos, servicios como [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisan los complementos antes de ser cargados para garantizar que solo se distribuyan complementos seguros. + +### Aplicación de complementos + +Una vez descargados los complementos, es hora de aplicarlos. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Coloque los archivos descargados en la carpeta 'plugins' del servidor y reinicie el servidor. +3. Cuando Plazma se inicie, verá nueva información en la consola. Esto indica que Plazma ha cargado los complementos correctamente. +4. A pesar de que Plazma haya cargado los complementos correctamente, es posible que no se inicien. Puede usar el comando `/plugins` para ver los complementos cargados en el servidor. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Si un complemento no se ha cargado correctamente, puede encontrar soluciones en la siguiente página. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Uso de paquetes de datos + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Con los paquetes de datos, puede agregar nuevas entidades y desafíos al juego, entre otras modificaciones internas. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Algunos paquetes de datos defectuosos pueden dañar el mundo de forma irreversible. + +Por lo tanto, se recomienda hacer una copia de seguridad del mundo antes de aplicar paquetes de datos. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Una vez descargados los paquetes de datos, se pueden aplicar colocándolos en la carpeta 'datapacks' del mundo del servidor. Si la carpeta no existe, simplemente créela y añada los paquetes de datos. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +En caso de esto, se recomienda reiniciar el servidor **2 veces**. +{% endhint %} + +Los paquetes de datos pueden dañarse fácilmente con cada actualización de Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Puede verificar los paquetes de datos aplicados con el comando `/datapack list`. + +*** + +## Optimización + +Plazma tiene muchas correcciones de optimización aplicadas. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Consulte la siguiente página para obtener información sobre la configuración segura y correcta del proxy. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Seguridad + +Con el desarrollo de mods, en Minecraft es posible encontrar fácilmente un [motor de ataque de vulnerabilidades](#user-content-fn-3). + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Configuración de permisos + +Algunos comandos de administrador de complementos pueden tener vulnerabilidades si los permisos no están configurados correctamente. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Bloqueo de X-Ray + +X-Ray es una de las vulnerabilidades que se pueden utilizar fácilmente incluso en clientes de optimización básica. + +Plazma proporciona una configuración para bloquear X-Ray de forma predeterminada. + +Consulte la siguiente página para obtener información sobre cómo bloquear X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Lista blanca + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Para ver los jugadores permitidos, use `/whitelist query`. + +*** + +[^1]: O también en Minecraft: Bedrock Edition con complementos como la adición de entidades. + +[^2]: Añadir entidades al juego, entre otras cosas. + +[^3]: Comúnmente conocido como "hackeo". + +[^4]: Es posible que las configuraciones no estén optimizadas, que Plazma sea antiguo o que no bloquee vulnerabilidades recién descubiertas. + +[^5]: Los jugadores se conectan al servidor a través del servidor proxy Ngrok, y la dirección de Ngrok emitida en cada reinicio será diferente. diff --git a/es-ES/origin/plazma/administration/reference/README.md b/es-ES/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..c6db1b9eb --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Descubra los métodos de personalización proporcionados por Plazma. +--- + +# 📜 리퍼런스 + +Plazma ofrece varios métodos de personalización. + +Entre ellos, estos 4 métodos son formas de personalización que se pueden utilizar de inmediato sin necesidad de realizar ninguna tarea adicional. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +¡Haz preguntas a la comunidad a través del [servidor Discord oficial](https://discord.gg/MmfC52K8A8) o las [Discusiones de GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Comandos + +> Los comandos permiten recopilar información dentro del juego o personalizar el entorno de juego para los usuarios. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permisos + +> Los permisos especifican el alcance de interacción que los jugadores pueden tener. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumentos y propiedades + +> Los argumentos y propiedades tienen un impacto general en el funcionamiento de Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configuraciones + +> Las configuraciones son la forma más básica de personalizar Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/es-ES/origin/plazma/administration/reference/arguments.md b/es-ES/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..a2cdddd48 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Aprenda sobre los argumentos de inicio y las propiedades del sistema. +--- + +# 🎛️ Argumentos y propiedades + +El inicio de la adquisición y las propiedades del sistema son valores adicionales adjuntos a los comandos utilizados en la ejecución de Plazma[^1], los cuales tienen un impacto general en el funcionamiento de Plazma. + +De acuerdo con la ubicación a la que se adjunta el comando, se divide en **argumentos de inicio** y **atributos del sistema**. + +*** + +## Propiedades del sistema + +Las propiedades del sistema se ingresan antes de `-jar` y son procesadas por JVM antes de la inicialización de Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Modo de uso + +Las propiedades del sistema se ingresan como argumentos de Java entre `java` y `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +El prefijo `-D` indica que el argumento no está integrado en JVM, sino que es un argumento exclusivo de Plazma, y + +Si no se ingresa ningún valor en los atributos, el valor se fija en [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Propiedades del sistema completas + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Actualiza el formato de los carteles obsoletos. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración relacionados con la información de las entidades. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la revisión de NMS y remapea automáticamente la información de la versión interna para que pueda ser correctamente cargada por el IDE. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva el sistema de advertencia del Watchdog de Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva el mensaje de confirmación del comando `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Si eres desarrollador de plugins y necesitas actualizar un plugin, utiliza el hotswap en lugar de `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva los plugins que utilizan el sistema de entrada y salida estándar. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Advierte cuando se detecta un formato de legado en los componentes del chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la verificación de patrones del servidor al conectarse un jugador. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración para claves faltantes en objetos NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración para perfiles de calaveras incorrectos. + +Registra la ubicación de todas las calaveras incorrectas en el mundo. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la priorización de clases de plugins. + +Útil en caso de problemas con los sombreadores de plugins. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la consolidación de envío de Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valor predeterminado**: `750` + +Envía fragmentos de entidades en múltiples paquetes si exceden el valor establecido. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valor predeterminado**: `8192` + +Establece el tamaño máximo de paquetes que el servidor puede recibir de una sola vez. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la verificación de la versión de Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Esto puede causar daños permanentes en archivos como mundos, y desestabilizar completamente el juego. + +Cualquier problema causado por esto es responsabilidad del usuario, y Plamza no brindará soporte al respecto. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valor predeterminado**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valor predeterminado**: `80` + +Establece la longitud máxima de caracteres que se pueden ingresar en una línea de un cartel. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valor predeterminado**: `(versión del mundo) + 1` + +Establece la versión de la información de actualización del mundo que se inicializará primero. + +Útil cuando se necesitan actualizar grandes cantidades de fragmentos, pero no se usa en otros casos. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `True` + +Activa el procesamiento de comentarios en archivos YAML. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valor predeterminado**: `30` + +Expulsa al jugador si no ha recibido ningún dato durante el tiempo especificado (en segundos). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Ignora los comentarios de las propiedades del servidor. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración de la carga sincronizada de fragmentos. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa el sistema de escritura de fragmentos sincronizado por defecto de Minecraft. + +Esto guarda cada fragmento en orden, causando una gran degradación del rendimiento. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa el vaciado explícito de los canales de red. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Registra siempre los errores que no ocurren en el hilo principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Muestra una advertencia si una tarea programada tiene un retraso excesivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Si se utiliza el archivo de ejecución predeterminado, aplica solo el parche sin iniciar el servidor. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` +- **Conflicto**: `Plazma.disableConfigOptimization` + +Optimiza la configuración inicial más agresivamente. + +Al activarlo, el servidor se vuelve más rápido y seguro, pero puede tener un gran impacto en el juego. + +#### `Plazma.disableConfigOptimization` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` +- **Conflicto**: `Plazma.aggressiveOptimize` + +No optimiza la configuración inicial. + +Esto establece el uso de la configuración básica de Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` + +Desactiva el branding de Plazma y usa el favicon predeterminado de vanilla del servidor. + +#### `Plazma.useVanillaConfiguration` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` +- **Conflicto**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Esto puede tener un gran impacto en la seguridad y rendimiento del servidor. + +Cualquier problema derivado del uso de esta propiedad recae en el administrador del servidor. +{% endhint %} + +Establece la configuración inicial en los valores predeterminados proporcionados por Mojang. + +Esto desactiva todos los parches de vulnerabilidades aplicados por Paper. + +Los parches de vulnerabilidades se pueden volver a activar en la configuración de Paper o Plazma. + +#### `Plazma.vanillaize` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `true` +- **Conflicto**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Establece la configuración inicial de forma más cercana a la de vanilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Propiedad obsoleta + +Las siguientes propiedades del sistema son obsoletas. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` +- **Obsoleto**: Timings ha sido eliminado de Plazma desde + +Determina si se puede exceder el máximo de valores que se pueden enviar a la API de Timings de Aikar. + +Incluso si se hace esto, si no se maneja la excepción en la API, se aplicará un límite de velocidad. + +*** + +## Argumento de inicio + +El argumento de inicio se ingresa después de `-jar *.jar` para inicializar Plazma y se procesa junto con él. + +### Modo de uso + +Las propiedades del sistema se ingresan como argumentos de programa después de `-jar *.jar`. + +Por ejemplo, si se intenta aplicar el argumento de inicio `nogui`,\ +al ingresar de la siguiente manera, Plazma procesará el argumento `nogui` durante la inicialización. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumento de inicio completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valor predeterminado**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Valor predeterminado**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Valor predeterminado**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Inicia el servidor en modo demo. + +#### `eraseCache` + +Elimina los archivos de caché restantes después de actualizar el mundo. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Muestra todos los argumentos de inicio de Plazma y sus descripciones. + +#### `initSettings` + +Crea solo los archivos de configuración y luego cierra el servidor. + +#### `jfrProfile` + +Activa el perfilado JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valor predeterminado**: `(server properties)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Desactiva el panel de interfaz gráfica. + +#### `nojline` + +Deshabilita JLine y utiliza la consola vanilla. + +#### `modo-en-línea` + +- **Alias**: `o` +- **Valor predeterminado**: `(server properties)` + +Selecciona si verificar a los jugadores con el servidor de autenticación de Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `configuración-de-paper` + +- **Alias**: `paper` +- **Valor predeterminado**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Establece la ubicación de los archivos de configuración de PaperSpigot descontinuados. + +Se utiliza para migrar la configuración existente a un nuevo archivo de configuración, y luego ya no se usa. + +#### `directorio-de-configuración-de-paper` + +- **Alias**: `paper-dir` +- **Valor predeterminado**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `directorio-de-configuración-de-plazma` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Valor predeterminado**: `plugins` + +Establece la ubicación de la carpeta de plugins. + +#### `configuración-de-pufferfish` + +- **Alias**: `pufferfish` +- **Valor predeterminado**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `configuración-de-purpur` + +- **Alias**: `purpur` +- **Valor predeterminado**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `modo-seguro` + +Inicia el servidor en un estado completamente vanilla. + +#### `ip-del-servidor` + +- **Alias**: `h`, `host` +- **Valor predeterminado**: `(server properties)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `puerto-del-servidor` + +- **Alias**: `p`, `port` +- **Valor predeterminado**: `(server properties)` + +Establece el puerto del servidor. + +#### `nombre-del-servidor` + +- **Valor predeterminado**: `Un Servidor Plazma` + +Establece el nombre del servidor. + +#### `configuración-de-spigot` + +- **Alias**: `S` +- **Valor predeterminado**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `versión` + +- **Alias**: `v` + +Muestra la versión de Plazma. + +#### `directorio-del-mundo` + +- **Alias**: `W`, `universo`, `contenedor-de-mundo` +- **Valor predeterminado**: `(carpeta del servidor)` + +Establece la ubicación donde se guardan los archivos del mundo. + +#### `nombre-del-mundo` + +- **Alias**: `w`, `mundo` +- **Valor predeterminado**: `(server properties)` + +Establece el nombre del archivo del mundo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: El manejo de argumentos cambia dependiendo de su ubicación adicional. + +[^3]: Por ejemplo, si desea establecer `Plazma.iKnowWhatIAmDoing` en `true`, solo ingresar `-DPlazma.iKnowWhatIAmDoing` es suficiente en lugar de `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Por ejemplo, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de eventos. + +[^6]: Detector de eventos. + +[^7]: Cliente. + +[^8]: Señal que indica que el servidor está conectado correctamente, como un latido del corazón. + +[^9]: Con la función de expulsión AFK de Purpur, también se puede expulsar a los jugadores ausentes. + +[^10]: Sistema de escritura de fragmentos sincronizados, Sync Chunk Write System. + +[^11]: `¡ADVERTENCIA! Plazma puede causar problemas inesperados, así que asegúrate de probarlo a fondo antes de usarlo en un servidor público.` + +[^12]: La `optimización del mundo` en el juego también funciona de la misma manera. + +[^13]: Se excluyen los administradores de nivel 2 o superior. + +[^14]: Protocolo de Internet, IP. diff --git a/es-ES/origin/plazma/administration/reference/commands.md b/es-ES/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..dda48beeb --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descubre los comandos disponibles en Plazma. +--- + +# 🖥️ Comandos diff --git a/es-ES/origin/plazma/administration/reference/configurations/README.md b/es-ES/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..929ae6ab9 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Las configuraciones son la forma más básica de personalizar Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atributos + +> Los atributos son los archivos de configuración más básicos proporcionados en Minecraft. Al utilizar los atributos, se pueden cambiar los mecanismos básicos del juego. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configuración de Bukkit + +> La configuración de Bukkit es el archivo de configuración más básico proporcionado en Plazma. Al utilizar la configuración de Bukkit, se pueden cambiar los mecanismos básicos del servidor de Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configuración de Spigot + +> La configuración de Spigot permite modificar el funcionamiento y mensajes detallados del juego, el procesamiento de jugadores y comandos. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configuración de Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configuración de Pufferfish + +> La configuración de Pufferfish permite modificar el procesamiento de mundos y entidades en Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configuración de Purpur + +> La configuración de Purpur permite modificar los datos básicos generales del juego. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configuración de Plazma + +> La configuración de Plazma permite personalizar las funciones de Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/es-ES/origin/plazma/administration/reference/configurations/bukkit.md b/es-ES/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..89646c181 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/es-ES/origin/plazma/administration/reference/configurations/paper/README.md b/es-ES/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..61c1508eb --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Averigüe cuál es el propósito de cada archivo en la carpeta de configuración. +--- + +# 🛩️ Papel diff --git a/es-ES/origin/plazma/administration/reference/configurations/paper/global.md b/es-ES/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a2b781e6e --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/es-ES/origin/plazma/administration/reference/configurations/paper/world.md b/es-ES/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f9c3d1c17 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Descubre qué significa cada nodo en paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Mundo diff --git a/es-ES/origin/plazma/administration/reference/configurations/plazma/README.md b/es-ES/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..a8542e965 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Averigüe cuál es el propósito de cada archivo en la carpeta de configuración. +--- + +# ✨ Plazma diff --git a/es-ES/origin/plazma/administration/reference/configurations/plazma/global.md b/es-ES/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..408c0e3ae --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descubre lo que cada nodo en plazma-global.yml significa. +--- + +# 🌏 전역 구성 diff --git a/es-ES/origin/plazma/administration/reference/configurations/plazma/world.md b/es-ES/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..9df62b29d --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/es-ES/origin/plazma/administration/reference/configurations/plazma/worlds.md b/es-ES/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..14e7b5121 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en plazma-world.yml. +--- + +# ✨ Plazma (Composición por mundo) diff --git a/es-ES/origin/plazma/administration/reference/configurations/property.md b/es-ES/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..753d4ffb2 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descubra lo que significa cada nodo en server.properties. +--- + +# 🪨 Server.properties diff --git a/es-ES/origin/plazma/administration/reference/configurations/pufferfish.md b/es-ES/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..bb6399b5b --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo de pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/es-ES/origin/plazma/administration/reference/configurations/purpur/README.md b/es-ES/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..6f53517a3 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en purpur.yml. +--- + +# 🦑 Purpur diff --git a/es-ES/origin/plazma/administration/reference/configurations/purpur/global.md b/es-ES/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..c5f62d2c7 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/es-ES/origin/plazma/administration/reference/configurations/purpur/world.md b/es-ES/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..5d49026c1 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/es-ES/origin/plazma/administration/reference/configurations/spigot.md b/es-ES/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..38779f804 --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descubre qué significa cada nodo en spigot.yml. +--- + +# 🚰 Spigot diff --git a/es-ES/origin/plazma/administration/reference/permissions.md b/es-ES/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..c2b7b0fed --- /dev/null +++ b/es-ES/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Descubre los permisos de Plazma. +--- + +# 🛡️ Permiso + +Los permisos son herramientas de seguridad simples que establecen el alcance en el que los jugadores pueden interactuar en el servidor. + +Para aprovechar y modificar los permisos fácilmente, se debe utilizar un plugin como [LuckPerms](https://luckperms.net). + +*** + +## Comprender el sistema de permisos básico + +Minecraft proporciona grupos de permisos de administración básicos. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Jugador**\ + Es el grupo de permisos que se otorga a todos los jugadores de forma predeterminada. +2. **Moderador**\ + Puede ignorar la protección de spawn. +3. **Administrador de mundo**\ + Puede utilizar todos los comandos y bloques de comandos relacionados con la gestión del mundo.\ + Es el grupo de permisos por defecto aplicado a los datapacks y bloques de comandos. +4. **Administrador**\ + Puede utilizar todos los comandos relacionados con la gestión de jugadores. +5. **Superadministrador**\ + Puede utilizar todos los comandos, incluidos los de gestión del servidor.\ + Es el grupo de permisos por defecto aplicado a la consola y a los operadores. + +*** + +## Configuración de permisos + +*** + +## Permisos completos + +*** + +#### `allow.ride.(Clave con espacio de nombres)` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores montar en entidades al agacharse e interactuar con ellas. + +Al montar en una entidad, se puede controlar su movimiento con las teclas de movimiento y saltar o volar con la tecla de salto. + +En `(Clave con espacio de nombres)` se debe introducir el [ID con espacio de nombres](#user-content-fn-2)[^2] de la entidad. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Clave con espacio de nombres)` + +- **Por defecto**: `Ninguno` + +Permite al jugador usar las habilidades especiales de la entidad mientras está montado en ella. + +No todas las entidades tienen habilidades especiales disponibles. Consulte a continuación todas las habilidades especiales disponibles. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +¡Publica tus ideas en [Plazma Discord](https://plazmamc.org/discord) o [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Ver todas las habilidades especiales disponibles actualmente + +- **`crepper`**\ + Al presionar la tecla de salto, explota.\ + Si el jugador tiene el permiso `allow.powered.creeper`, puede cargar manteniendo presionada la tecla de salto. +- **`dolphin`**\ + Al presionar la tecla de salto, embiste. +- **`phantom`**\ + Al presionar la tecla de salto, dispara llamas. +- **`wither`**\ + Al interactuar, dispara la cabeza de wither. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/credits (Jugador)`](commands.md#credits). + +Al agregar `.other` después del nombre del permiso, se permite su uso a otros jugadores. + +#### `bukkit.command.demo` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/demo (Jugador)`](commands.md#demo). + +Al agregar `.other` después del nombre del permiso, se permite su uso a otros jugadores. + +#### `bukkit.command.ping` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/ping (Jugador)`](commands.md#ping). + +Al agregar `.other` después del nombre del permiso, se permite su uso a otros jugadores. + +#### `bukkit.command.ram` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/rambar (Jugador)`](commands.md#rambar). + +Al agregar `.other` después del nombre del permiso, se permite su uso a otros jugadores. + +#### `bukkit.command.restart` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/tpsbar (Jugador)`](commands.md#tpsbar). + +Al agregar `.other` después del nombre del permiso, se permite su uso a otros jugadores. + +#### `bukkit.command.timings` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Para obtener información sobre comandos similares, consulte [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(Modo de juego)` + +- **Por defecto**: `Administrador del mundo` + +Permite el uso del comando `/gamemode (Modo de juego) (Jugador)`. + +Al agregar `.other` después del nombre del permiso, se permite su uso a otros jugadores. + +#### `paper.antixray.bypass` + +- **Por defecto**: `Ninguno` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Esto beneficia el rendimiento de ambas partes. + +> Consulte la página a continuación para obtener información sobre cómo configurar el X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Por defecto**: `Ninguno` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Por defecto**: `Ninguno` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Por defecto**: `Ninguno` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Por defecto**: `Ninguno` + +Permite el uso de etiquetas [MiniMessage](https://docs.advntr.dev/minimessage/format.html) en los yunques. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Por defecto**: `Ninguno` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Por defecto**: `Ninguno` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Por defecto**: `Ninguno` + +Excluye al jugador de ser expulsado por inactividad. + +#### `purpur.debug.f3n` + +- **Por defecto**: `Administrador del mundo` + +Permite al jugador cambiar el modo de juego con la tecla `F3 + N`. + +Solo funciona si tiene permiso para ese modo de juego. + +#### `purpur.drop.spawners` + +- **Por defecto**: `Ninguno` + +Al minar bloques de spawner con el objeto configurado, se suelta el bloque de spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NúmeroTexto)` + +- **Por defecto**: `Ninguno` + +Cambia el tamaño del cofre de ender. + +Puedes ingresar `one`, `two`, `three`, `four`, `five`, `six` en `(NúmeroTexto)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Por defecto**: `Ninguno` + +Permite que el tótem de inmortalidad funcione aunque esté en el inventario. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores ignorar el límite de jugadores conectados. + +#### `purpur.mending_shift_click` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores reparar los objetos que llevan al hacer `clic derecho mientras están agachados`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores colocar spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores teletransportarse instantáneamente al usar un portal del Nether. + +#### `purpur.sign.color` + +- **Por defecto**: `Ninguno` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Por defecto**: `Ninguno` + +Permite utilizar el código de obfuscación `(&o)` en los letreros. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Por defecto**: `Ninguno` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores desactivar la explosión de TNT al interactuar con unas tijeras. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permiso previsto + +#### `plazma.bypass.ncr-require` + +- **Por defecto**: `Ninguno` + +Permite a los jugadores conectarse aunque no tengan instalado el mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operador. + +[^2]: Ejemplo: `ender_dragon` diff --git a/es-ES/origin/plazma/adminstration/README.md b/es-ES/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..dc213f8e5 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Crea tu propio servidor con Plazma. +--- + +# ⚒️ Guía de administración del servidor diff --git a/es-ES/origin/plazma/adminstration/expert/README.md b/es-ES/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..c5db7ad02 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo manejar Plazma de manera profesional. +--- + +# 🎓 Avanzado diff --git a/es-ES/origin/plazma/adminstration/expert/fix-exploits.md b/es-ES/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..6091abebb --- /dev/null +++ b/es-ES/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descubra las vulnerabilidades conocidas y cómo solucionarlas. +--- + +# ⚠️ Vulnerabilidades conocidas y formas de solucionarlas diff --git a/es-ES/origin/plazma/adminstration/expert/optimize.md b/es-ES/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..0f69fd671 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo optimizar Plazma. +--- + +# 🧹 Optimización diff --git a/es-ES/origin/plazma/adminstration/expert/vanillaize.md b/es-ES/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..652336cb5 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Descubre cómo restaurar el parche de Paper y Vanilla. +--- + +# ↩️ Vanillaizar + +{% hint style="warning" %} + +### Paper no ofrece opciones para parchear la mayoría de los errores de Vanilla. + +Actualmente, Plazma está desarrollando una configuración para desactivar dicha corrección de errores. + +Por lo tanto, esta guía aún está en proceso de escritura y la información está sujeta a cambios en cualquier momento. +{% endhint %} diff --git a/es-ES/origin/plazma/adminstration/faq.md b/es-ES/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..a680a5b6d --- /dev/null +++ b/es-ES/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Descubre las preguntas frecuentes. +--- + +# ⁉️ Preguntas frecuentes + +{% hint style="info" %} + +### ¿No puedes encontrar la respuesta que buscas? + +¡Haz preguntas a la comunidad a través del [servidor Discord oficial](https://discord.gg/MmfC52K8A8) o [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### El programa no se ejecuta y muestra un mensaje + +Si aparece `no main manifest attribute, in plazma-(version).jar` en la consola,\ +el archivo descargado es un archivo de API de desarrollo y debes descargar **Reobf Paperweight** desde la página de GitHub. + +Consulta la siguiente página para obtener más información. + +{% content-ref url="getting-started/" %} +[inicio](getting-started#id-2) +{% endcontent-ref %} + +### Se muestra una advertencia cada vez que se inicia el servidor + +Plazma contiene parches inestables y siempre existe la posibilidad de mal funcionamiento, por lo que muestra advertencias al iniciar el servidor. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Puedes desactivar esta advertencia utilizando la propiedad del sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Consulta la siguiente página para obtener más información. + +{% content-ref url="reference/arguments.md" %} +[argumentos.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponible a partir de la versión 1.20.1 diff --git a/es-ES/origin/plazma/adminstration/getting-started/README.md b/es-ES/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..b23d99c62 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Descubra cómo crear un servidor con Plazma. +--- + +# 👟 Empezar + +Para utilizar Plazma de manera estable, el sistema debe cumplir con los siguientes requisitos. + +| | Mínimo | Recomendado | +| :-----------------------: | -----: | ----------: | +| Arquitectura | x64 | - | +| RAM | 8GB | 16GB | +| Espacio de almacenamiento | 1GB | 8GB | +| JRE | 17 | 21 | + +Para facilitar la edición de archivos de configuración, también es recomendable instalar un editor como [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalación de JRE + +Como su nombre indica, Minecraft: **"Java"** Edition está desarrollado en Java y requiere JRE[^1] para ejecutarse. + +Dado que Plazma se basa en la plataforma oficial de servidores de Mojang Studios[^2], también es necesario instalar JRE para utilizar Plazma. + +### 1.1 Verificación de JRE + +Para verificar si JRE está instalado en el sistema, escriba y ejecute [`cmd /k java --version`](#user-content-fn-4)[^4] en la ventana de ejecución. + +Si se muestra la siguiente salida, vaya al [Paso 2](setup.md#id-2). + +{% code title="Salida correcta" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Si no se muestra como se indica anteriormente, o se muestra como se indica a continuación, significa que JRE no está instalado o está obsoleto, por lo que debe realizar el [Paso 1.2](setup.md#id-1.2). + +{% code title="JRE no instalado" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE obsoleto" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalación de JRE + +En esta guía, utilizaremos Azul Zulu como [una de las variantes](#user-content-fn-5)[^5] de JRE. + +Después de completar la instalación, vuelva a realizar el [Paso 1.1](setup.md#id-1.1) para verificar que la instalación se haya realizado correctamente. + +{% tabs %} +{% tab title="Windows" %} + +1. Primero, descargue **JDK 21** de [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) en formato `.msi`. +2. Ejecute el asistente de instalación descargado y haga clic en `Siguiente`. +3. Después de activar `Set JAVA_HOME variable` en el menú mostrado en el centro izquierdo de la ventana, haga clic en `Siguiente`. +4. Presione `Instalar` para completar la instalación de JRE. + {% endtab %} + +{% tab title="macOS" %} +Descargue el asistente de instalación de **JDK 21** en formato `.dmg` desde [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) y ejecútelo para instalar JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Primero, ejecute el siguiente comando en la terminal para agregar el repositorio de Azul Zulu a APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Luego, ejecute el siguiente comando en la terminal para instalar JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Puede instalar JRE ejecutando el siguiente comando. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Descarga de Plazma + +Plazma ofrece varios archivos ejecutables. + +{% hint style="warning" %} + +### En la mayoría de los casos, se utiliza `Reobf Paperclip`. + +La siguiente información es para desarrolladores o aquellos interesados en las características de cada tipo.\ +Si es un usuario común, no hay problema en saltar al [Paso 3](setup.md#id-3). +{% endhint %} + +
+ +Ver más detalles + +El nombre del archivo ejecutable se establece como `plazma-(administrador de versiones)-1.20.4-R0.1-SNAPSHOT-(formato de mapeo).jar`. + +- **Formato de mapeo**\ + El mapeo es una especie de mapa que une el código real de Minecraft con el código ofuscado. + - **Reobf**\ + Reobfuscation, también conocido como mapeo de Spigot, se utiliza en la mayoría de los complementos NMS.\ + A partir de la versión 1.20.5, dejará de utilizarse. + - **Mojmap**\ + Mapeo de Mojang, es el mapeo de Minecraft Vanilla. +- **Administrador de versiones**\ + El administrador de versiones es un lanzador de servidores que proporciona las bibliotecas necesarias para ejecutar el servidor y parchear los archivos del servidor. + - **Paperclip**\ + Desarrollado por el equipo de PaperMC para Paper y otras plataformas derivadas, se encarga de descargar bibliotecas y aplicar parches al servidor. + - **Bundler**\ + Administrador de versiones de Minecraft Vanilla. + +
+ +*** + +## 3. Creación de script de inicio + +Para iniciar Plazma fácilmente y reiniciar el servidor automáticamente, es necesario crear un [script de inicio](#user-content-fn-6)[^6]. + +Puede generar el script de inicio a través de [Flags.sh](https://flags.sh).\ +Simplemente ingrese la cantidad de memoria que desea asignar a Plazma y el comando se optimizará automáticamente. + +Puede descargar el script de inicio haciendo clic en el botón de descarga en la esquina inferior izquierda.\ +**Asegúrese de que el script descargado sea compatible con su sistema operativo.** + +*** + +## 4. Organización de archivos + +Mueva el script de inicio descargado y Plazma a una nueva carpeta. + +{% hint style="warning" %} + +### El nombre de la carpeta no debe contener espacios y debe estar en inglés. + +De lo contrario, Plazma o JRE podrían no funcionar correctamente. +{% endhint %} + +Ejecute el script de inicio. Para Windows, es necesario seleccionar **Permitir** en la ventana de selección de permisos de firewall. + +*** + +## 5. Aceptación del EULA + +Una vez que ejecute el script de inicio, se creará un archivo `eula.txt` en la carpeta. + +El EULA[^9] es un acuerdo de licencia que debe aceptar para utilizar los servicios de [Mojang Studios](#user-content-fn-10)[^10]. + +Si no acepta el EULA, no podrá iniciar el servidor y podría recibir sanciones, como la suspensión de la cuenta, por infringir el EULA[^11]. + +Para aceptar el EULA, cambie `eula=false` a `eula=true` en el archivo `eula.txt` y guárdelo. + +*** + +## 6. Permitir acceso externo (Windows) + +Los sistemas operativos modernos bloquean el acceso externo por defecto con el fin de prevenir accesos no autorizados mediante el **firewall** y el **enrutador**. + +En el caso de Windows, como se ha permitido en el [Paso 3](setup.md#id-3), solo es necesario configurar el reenvío de puertos. + +{% hint style="info" %} + +### Esta guía asume que se está utilizando un sistema operativo Windows y un enrutador que admite [**UPnP**](#user-content-fn-12)[^12]. + +Si el enrutador no admite UPnP, las instrucciones pueden variar según el modelo del enrutador y se recomienda buscar información específica. + +También se puede utilizar [Ngrok](https://ngrok.com/) para generar una dirección temporal. +{% endhint %} + +{% hint style="warning" %} + +### Para sistemas basados en UNIX como Linux o macOS, los métodos de configuración de servicios de firewall varían, por lo que es necesario buscar información específica. + +{% endhint %} + +### 6.1 Verificación de la necesidad de reenvío de puertos + +Ingrese y ejecute lo siguiente en la ventana de ejecución. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Si la salida es `True`, no es necesario realizar más acciones. Si es `False`, debe configurar el reenvío de puertos. + +### 6.2 Conexión al servidor + +{% tabs %} +{% tab title="Acceso externo" %} +Si no es necesario el reenvío de puertos o si ya se ha realizado con éxito, ahora puede conectarse al servidor. + +Puede encontrar la dirección utilizada para conectarse al servidor [aquí](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Intento de reenvío de puertos UPnP" %} +En el archivo `purpur.yml` de la carpeta del servidor, active `network.upnp-port-forwarding` a `true`. + +Luego, al reiniciar el servidor, Plazma intentará realizar el reenvío automático de puertos. + +A continuación se muestra el resultado del éxito del UPnP según el mensaje mostrado en la consola, que se mostrará como `[UPnP] (mensaje)` en la consola. + +| Mensaje | Significado | +| ------------------------------------ | ----------------------------------------- | +| `Puerto abierto con éxito (puerto)` | Éxito en el reenvío de puertos. | +| `El puerto (puerto) ya está abierto` | Otro servicio está utilizando ese puerto. | +| `Error al abrir el puerto (puerto)` | Fallo en el reenvío de puertos. | +| `El servicio no está disponible` | El enrutador no es compatible con UPnP. | + +Cuando el servidor se apaga, Plazma cierra automáticamente el puerto. +{% endtab %} + +{% tab title="Creación de dirección temporal con Ngrok" %} +El método con Ngrok es útil para pruebas a corto plazo, juegos colaborativos o jugar con amigos. + +1. Descargue el archivo ZIP de `Windows (64-bit)` desde la [página de Ngrok](https://ngrok.com/download). +2. Coloque el Ngrok descargado en la carpeta del servidor. +3. Genere un token de autenticación desde el [tablero de Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Ejecute el comando mostrado en la `Línea de comandos` en la carpeta del servidor. +5. Agregue `start /b ngrok tcp --region jp 25565` en la parte superior del script de ejecución, y `taskkill /f /t /im ngrok.exe` en la parte inferior. +6. En `Reenvío tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` mostrado en la parte superior de la consola, `0.tcp.jp.ngrok.io:12345` será la dirección del servidor. +7. Ahora puede conectarse desde el exterior utilizando esta dirección. + {% endtab %} + +{% tab title="Acceso local" %} +Si desea conectarse al servidor localmente, puede hacerlo utilizando la dirección IPv4 que se muestra al ejecutar `cmd /k ipconfig` en la ventana de comandos. + +Por ejemplo, si la ejecución del comando muestra una dirección `IPv4` como la siguiente, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Puede intentar conectarse al servidor local utilizando la dirección `192.168.3.7` mostrada en la dirección IPv4. + +Si el servidor y el juego se ejecutan en la misma PC, puede conectarse utilizando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Etapa de desarrollo + +Una vez que el servidor se ha iniciado con éxito y está funcionando correctamente, es hora de personalizar el servidor. + +Consulte la guía a continuación para aprender cómo personalizar el servidor. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Entorno de ejecución de Java, Java Runtime Environment. + +[^2]: Paper, en el que se basa Plazma, se basa en Spigot, que a su vez se basa en la plataforma oficial del servidor de Spigot. + +[^3]: Windows key + R + +[^4]: Para Linux, use `java --version` en la terminal. + +[^5]: JRE es un proyecto de código abierto con múltiples variantes, al igual que las plataformas de servidores de Minecraft. + +[^6]: Comúnmente conocido como **launcher**. + +[^7]: Al activar "Auto-reinicio", el servidor se reiniciará automáticamente. Puede detenerlo ingresando `Control + C`. + +[^8]: No se recomienda superar la mitad de la capacidad del sistema. + + Por ejemplo, si la capacidad total de memoria del sistema es de 8GB, no se recomienda configurar más de 4GB. + +[^9]: Acuerdo de Licencia para el Usuario Final, EULA. Consulte el [sitio web de Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) para obtener más información. + +[^10]: Corporación Microsoft. + +[^11]: Según el Artículo 32, Párrafo 1, Punto 9 de la Ley de Promoción de la Industria de Juegos de la República de Corea, **Korea Microsoft Corporation** tiene el derecho de presentar una demanda legal. + +[^12]: Universal Plug & Play. Purpur incluido en Plazma se comunica automáticamente con el enrutador a través de esta tecnología para abrir puertos solo cuando el servidor está en funcionamiento, eliminando la necesidad de reenvío de puertos directo. + +[^13]: Si no tiene una cuenta, regístrese en Ngrok a través de una cuenta de Google o GitHub. diff --git a/es-ES/origin/plazma/adminstration/getting-started/customization.md b/es-ES/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..7636a2325 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Descubre cómo personalizar el servidor. +--- + +# 🎨 Personalización de usuario diff --git a/es-ES/origin/plazma/adminstration/reference/arguments.md b/es-ES/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..0ceb643ff --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Aprenda sobre los argumentos de inicio y las propiedades del sistema. +--- + +# 🎛️ Argumentos y propiedades + +Los valores de los argumentos de inicio y las propiedades del sistema son valores adjuntos a los [comandos utilizados](#user-content-fn-1)[^1] en la ejecución de Plazma,\ +permitiendo cambiar valores que no pueden ser modificados después de la ejecución de Plazma. + +De acuerdo al [lugar donde se adjunta el comando](#user-content-fn-2)[^2], se dividen en **argumentos de inicio** y **propiedades del sistema**. + +*** + +## Propiedades del sistema + +Las propiedades del sistema se ingresan antes de `-jar` y son procesadas por JVM antes de la inicialización de Plazma. + +{% hint style="warning" %} + +### Modificar las propiedades del sistema puede alterar el funcionamiento de Plazma y JVM, ¡pudiendo tener un gran impacto en el juego! + +Si no está seguro de la función de cada propiedad del sistema, **¡no las utilice nunca!** +{% endhint %} + +### Modo de uso + +Las propiedades del sistema se ingresan como argumentos de Java entre `java` y `-jar`. + +Por ejemplo, si desea aplicar la propiedad del sistema `Plazma.dummyProperty`,\ +al ingresar de la siguiente manera, el valor `37` se asignará a la siguiente propiedad y Plazma se inicializará. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +El prefijo `-D` indica que el argumento no está integrado en JVM, sino que es un argumento exclusivo de Plazma, y + +si no se proporciona ningún valor a la propiedad, el valor se fijará en [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### La plataforma de servidores de la serie Paperweight incluye un punto `.` en el nombre de la propiedad para distinguir las propiedades del sistema entre cada plataforma. + +En algunos terminales como Windows Powershell, es posible que no se permitan estos argumentos, por lo que se debe agregar `"` al principio y al final de los argumentos. [^4] +{% endhint %} + +### Propiedades del sistema completas + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Actualiza el formato de los carteles obsoletos. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración relacionados con la información de las entidades. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la revisión de NMS y remapea automáticamente la información de la versión interna para que pueda ser correctamente cargada por el IDE. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva el sistema de advertencia del Watchdog de Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva el mensaje de confirmación del comando `/reload`. + +{% hint style="danger" %} + +### Debido a que el comando `/reload` es muy inestable, cualquier problema que surja en el servidor después de usarlo será responsabilidad del usuario. + +Si eres desarrollador de plugins y necesitas actualizar un plugin, utiliza el hotswap en lugar de `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva los plugins que utilizan el sistema de entrada y salida estándar. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Advierte cuando se detecta un formato de legado en los componentes del chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la verificación de patrones del servidor al conectarse un jugador. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración para claves faltantes en objetos NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración para perfiles de calaveras incorrectos. + +Registra la ubicación de todas las calaveras incorrectas en el mundo. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva el límite de 128 canales de plugins por jugador. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la priorización de clases de plugins. + +Útil en caso de problemas con los sombreadores de plugins. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la consolidación de envío de Netty. + +#### `Paper.excessiveTELimit` + +- **Tipo**: `Integer` +- **Valor predeterminado**: `750` + +Envía fragmentos de entidades en múltiples paquetes si exceden el valor establecido. + +#### `Paper.filterThreshold` + +- **Tipo**: `Integer` +- **Valor predeterminado**: `8192` + +Establece el tamaño máximo de paquetes que el servidor puede recibir de una sola vez. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Desactiva la verificación de la versión de Java. + +{% hint style="danger" %} + +### Esto puede permitir que JVM intente acceder a código inexistente. + +Esto puede causar daños permanentes en archivos como mundos, y desestabilizar completamente el juego. + +Cualquier problema causado por esto es responsabilidad del usuario, y Plamza no brindará soporte al respecto. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tipo**: `Integer` +- **Valor predeterminado**: `64` + +Establece el límite de caracteres para los nombres de los canales de plugins. + +#### `Paper.maxSignLength` + +- **Tipo**: `Integer` +- **Valor predeterminado**: `80` + +Establece la longitud máxima de caracteres que se pueden ingresar en una línea de un cartel. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tipo**: `Integer` +- **Valor predeterminado**: `(versión del mundo) + 1` + +Establece la versión de la información de actualización del mundo que se inicializará primero. + +Útil cuando se necesitan actualizar grandes cantidades de fragmentos, pero no se usa en otros casos. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `True` + +Activa el procesamiento de comentarios en archivos YAML. + +#### `Paper.playerConnection.keepAlive` + +- **Tipo**: `Integer` +- **Valor predeterminado**: `30` + +Expulsa al jugador si no ha recibido ningún dato durante el tiempo especificado (en segundos). + +Normalmente, el juego[^7] envía continuamente una [señal de latido](#user-content-fn-8)[^8] al servidor, por lo que no se expulsa al jugador, pero + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Ignora los comentarios de las propiedades del servidor. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa los registros de depuración de la carga sincronizada de fragmentos. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa el sistema de escritura de fragmentos sincronizado por defecto de Minecraft. + +Esto guarda cada fragmento en orden, causando una gran degradación del rendimiento. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Activa el vaciado explícito de los canales de red. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Registra siempre los errores que no ocurren en el hilo principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Muestra una advertencia si una tarea programada tiene un retraso excesivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `False` + +Si se utiliza el archivo de ejecución predeterminado, aplica solo el parche sin iniciar el servidor. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` + +{% hint style="warning" %} + +### Esta propiedad se moverá a los argumentos de inicio después de la versión 1.20.5. + +{% endhint %} + +Aplica una optimización de configuración más estricta al inicio inicial. + +Al activar, el servidor se vuelve más rápido y seguro, pero puede bloquear algunas mecánicas o tener un gran impacto en el juego. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` + +Suprime el mensaje de advertencia[^11] que se muestra al inicializarse Plazma. + +### Propiedad obsoleta + +Las siguientes propiedades del sistema son obsoletas. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valor predeterminado**: `false` +- **Obsoleto**: Timings ha sido eliminado de Plazma desde + +Determina si se puede exceder el máximo de valores que se pueden enviar a la API de Timings de Aikar. + +Incluso si se hace esto, si no se maneja la excepción en la API, se aplicará un límite de velocidad. + +*** + +## Argumento de inicio + +El argumento de inicio se ingresa después de `-jar *.jar` para inicializar Plazma y se procesa junto con él. + +### Modo de uso + +Las propiedades del sistema se ingresan como argumentos de programa después de `-jar *.jar`. + +Por ejemplo, si se intenta aplicar el argumento de inicio `nogui`,\ +al ingresar de la siguiente manera, Plazma procesará el argumento `nogui` durante la inicialización. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumento de inicio completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valor predeterminado**: `bukkit.yml` + +Establece el nombre y la ubicación del [archivo de configuración de Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Valor predeterminado**: `commands.yml` + +Establece el nombre y la ubicación del [archivo de configuración de comandos de Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Valor predeterminado**: `server.properties` + +Establece el nombre y la ubicación del archivo de [propiedades del servidor](../reference/configurations/property.md). + +#### `demo` + +Inicia el servidor en modo demo. + +#### `eraseCache` + +Elimina los archivos de caché restantes después de actualizar el mundo. + +#### `forceUpgrade` + +Actualiza el mundo de forma forzada ignorando la versión[^12]. + +#### `help` + +- **Alias**: `?` + +Muestra todos los argumentos de inicio de Plazma y sus descripciones. + +#### `initSettings` + +Crea solo los archivos de configuración y luego cierra el servidor. + +#### `jfrProfile` + +Activa el perfilado JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valor predeterminado**: `(server properties)` + +Establece el número máximo permitido de [jugadores](#user-content-fn-14). + +#### `nogui` + +Desactiva el panel de interfaz gráfica. + +#### `nojline` + +Deshabilita JLine y utiliza la consola vanilla. + +#### `modo-en-línea` + +- **Alias**: `o` +- **Valor predeterminado**: `(server properties)` + +Selecciona si verificar a los jugadores con el servidor de autenticación de Mojang. + +**Si no se usa Velocity u otros proxies, puede resultar en una violación del [EULA](../getting-started/README.md#id-5).** + +#### `configuración-de-paper` + +- **Alias**: `paper` +- **Valor predeterminado**: `paper.yml` + +{% hint style="warning" %} + +### Este argumento ha sido descontinuado después de la versión 1.19.4 + +{% endhint %} + +Establece la ubicación de los archivos de configuración de PaperSpigot descontinuados. + +Se utiliza para migrar la configuración existente a un nuevo archivo de configuración, y luego ya no se usa. + +#### `directorio-de-configuración-de-paper` + +- **Alias**: `paper-dir` +- **Valor predeterminado**: `config` + +Establece el nombre y la ubicación de la carpeta donde se encuentran los archivos de configuración de Paper. + +#### `directorio-de-configuración-de-plazma` + +- **Alias**: `plazma-dir` + +Establece el nombre y la ubicación de la carpeta donde se encuentran los archivos de configuración de Plazma. + +#### `plugins` + +- **Alias**: `p` +- **Valor predeterminado**: `plugins` + +Establece la ubicación de la carpeta de plugins. + +#### `configuración-de-pufferfish` + +- **Alias**: `pufferfish` +- **Valor predeterminado**: `pufferfish.yml` + +Establece el nombre y la ubicación del archivo de configuración de Pufferfish. + +#### `configuración-de-purpur` + +- **Alias**: `purpur` +- **Valor predeterminado**: `purpur.yml` + +Establece el nombre y la ubicación del archivo de configuración de Purpur. + +#### `modo-seguro` + +Inicia el servidor en un estado completamente vanilla. + +#### `ip-del-servidor` + +- **Alias**: `h`, `host` +- **Valor predeterminado**: `(server properties)` + +Establece el nombre del host del servidor o la dirección IP [Protocolo de Internet](#user-content-fn-13)[^13]. + +#### `puerto-del-servidor` + +- **Alias**: `p`, `port` +- **Valor predeterminado**: `(server properties)` + +Establece el puerto del servidor. + +#### `nombre-del-servidor` + +- **Valor predeterminado**: `Un Servidor Plazma` + +Establece el nombre del servidor. + +#### `configuración-de-spigot` + +- **Alias**: `S` +- **Valor predeterminado**: `spigot.yml` + +Establece el nombre y la ubicación del archivo de configuración de Spigot. + +#### `versión` + +- **Alias**: `v` + +Muestra la versión de Plazma. + +#### `directorio-del-mundo` + +- **Alias**: `W`, `universo`, `contenedor-de-mundo` +- **Valor predeterminado**: `(carpeta del servidor)` + +Establece la ubicación donde se guardan los archivos del mundo. + +#### `nombre-del-mundo` + +- **Alias**: `w`, `mundo` +- **Valor predeterminado**: `(server properties)` + +Establece el nombre del archivo del mundo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: El manejo de argumentos cambia dependiendo de su ubicación adicional. + +[^3]: Por ejemplo, si desea establecer `Plazma.iKnowWhatIAmDoing` en `true`, solo ingresar `-DPlazma.iKnowWhatIAmDoing` es suficiente en lugar de `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Por ejemplo, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de eventos. + +[^6]: Detector de eventos. + +[^7]: Cliente. + +[^8]: Señal que indica que el servidor está conectado correctamente, como un latido del corazón. + +[^9]: Con la función de expulsión AFK de Purpur, también se puede expulsar a los jugadores ausentes. + +[^10]: Sistema de escritura de fragmentos sincronizados, Sync Chunk Write System. + +[^11]: `¡ADVERTENCIA! Plazma puede causar problemas inesperados, así que asegúrate de probarlo a fondo antes de usarlo en un servidor público.` + +[^12]: La `optimización del mundo` en el juego también funciona de la misma manera. + +[^13]: Protocolo de Internet, IP. + +[^14]: Se excluyen los administradores de nivel 2 o superior. diff --git a/es-ES/origin/plazma/adminstration/reference/commands.md b/es-ES/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..dda48beeb --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descubre los comandos disponibles en Plazma. +--- + +# 🖥️ Comandos diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/bukkit.md b/es-ES/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..89646c181 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/paper/README.md b/es-ES/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..61c1508eb --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Averigüe cuál es el propósito de cada archivo en la carpeta de configuración. +--- + +# 🛩️ Papel diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/paper/global.md b/es-ES/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..524958861 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en paper-global.yml. +--- + +# 🛩️ Paper (Configuración global) diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/paper/world.md b/es-ES/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..3195eb0da --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Descubre qué significa cada nodo en paper-world.yml. +--- + +# 🛩️ Papel (Composición mundial) diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/plazma/README.md b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..a8542e965 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Averigüe cuál es el propósito de cada archivo en la carpeta de configuración. +--- + +# ✨ Plazma diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/plazma/global.md b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f5d965937 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descubre lo que cada nodo en plazma-global.yml significa. +--- + +# ✨ Plazma (Configuración Global) diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..ce1802004 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Configuración por mundo diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..14e7b5121 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en plazma-world.yml. +--- + +# ✨ Plazma (Composición por mundo) diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/property.md b/es-ES/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..753d4ffb2 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descubra lo que significa cada nodo en server.properties. +--- + +# 🪨 Server.properties diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/pufferfish.md b/es-ES/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..bb6399b5b --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo de pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/purpur/README.md b/es-ES/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..6f53517a3 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en purpur.yml. +--- + +# 🦑 Purpur diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/purpur/global.md b/es-ES/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..1f295c157 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en purpur.yml. +--- + +# 🦑 Purpur (composición global) diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/purpur/world.md b/es-ES/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..cbaf3857d --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra qué significa cada nodo en purpur.yml. +--- + +# 🦑 Purpur (구성 del mundo) diff --git a/es-ES/origin/plazma/adminstration/reference/configurations/spigot.md b/es-ES/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..38779f804 --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descubre qué significa cada nodo en spigot.yml. +--- + +# 🚰 Spigot diff --git a/es-ES/origin/plazma/adminstration/reference/permissions.md b/es-ES/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..82dcaf1be --- /dev/null +++ b/es-ES/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Descubre los permisos de Plazma. +--- + +# 🛡️ Permiso diff --git a/es-ES/origin/plazma/developers.md b/es-ES/origin/plazma/developers.md new file mode 100644 index 000000000..6c985c2ce --- /dev/null +++ b/es-ES/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Desarrolla proyectos de terceros con Plazma. +--- + +# ⚙️ Guía del desarrollador diff --git a/es-ES/origin/thunderbolt/README.md b/es-ES/origin/thunderbolt/README.md new file mode 100644 index 000000000..dfd9fa84b --- /dev/null +++ b/es-ES/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt es una plataforma de servidor basada en Plazma que permite probar parches experimentales directamente al distinguirlos como Flavor. +--- + +# 🌩️ Guía de uso de Thunderbolt diff --git a/es-ES/origin/volt/README.md b/es-ES/origin/volt/README.md new file mode 100644 index 000000000..f25a55b5f --- /dev/null +++ b/es-ES/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt es una plantilla de código abierto que permite desarrollar su propia plataforma de servidor Paperweight basada en Plazma. +--- + +# ⚡ Guía de Desarrollo de Volt diff --git a/et/origin/README.md b/et/origin/README.md new file mode 100644 index 000000000..86f5d3fc6 --- /dev/null +++ b/et/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Kui teil on küsimusi, siis palun esitage need Discordi või GitHubi arutelude kaudu. +--- + +# 🏠 Tere tulemast dokumentide portaali + +{% hint style="info" %} + +**Plazma dokumentatsioon on hetkel masintõlkega.** + +[![Tõlke olek](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) said dokumentide t6LKedoks osaledes parandage dokumenti. + +{% endhint %} + +### Kui teil tekib probleeme Plazma kasutamisel, siis mida teha? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Kas olete huvitatud Thunderboltist? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Kas soovite luua oma serveriplatvormi Volta abil? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Kui vajate rohkem teavet seoses Minecraftiga? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/et/origin/SUMMARY.md b/et/origin/SUMMARY.md new file mode 100644 index 000000000..22e4df61d --- /dev/null +++ b/et/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Sisukord + +- [🏠 Tere tulemast dokumentatsiooni portaali](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Kasutusjuhend](plazma/README.md) +- [❓ Mis on Plazma?](plazma/about/README.md) + - [⬇️ Laadi alla](plazma/about/downloads.md) + - [✅ Toetatud versioonid](plazma/about/supported-versions.md) +- [⚒️ Serveri halduse juhend](plazma/administration/README.md) + - [👟 Alustamine](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Viited](plazma/administration/reference/README.md) + - [🖥️ Käsud](plazma/administration/reference/commands.md) + - [🛡️ Õigused](plazma/administration/reference/permissions.md) + - [🎛️ Argumendid ja Omadused](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Omadus](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Ülemaailmne Konfiguratsioon](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Maailma konfiguratsioonid](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Ülemaailmne Konfiguratsioon](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Maailma konfiguratsioonid](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Ülemaailmne Konfiguratsioon](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Maailma konfiguratsioonid](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Ekspert](plazma/administration/expert/README.md) + - [🧹 Optimeerimine](plazma/administration/expert/optimize.md) + - [🔀 Proksü](plazma/administration/expert/proxy.md) + - [↩️ Vanilla muutmine](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray blokeerimine](plazma/administration/expert/xray.md) + - [⚠️ Haavatavused ja Nende Parandamine](plazma/administration/expert/fix-exploits.md) + - [⁉️ Korduma Kippuvad Küsimused](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Arendaja juhend](plazma/developers.md) + - [✏️ Kaasa aitama](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Kasutusjuhend](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Arendusjuhend](volt/README.md) + +## Mitmesugust + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Kõik Allalaadimised](plazma/about/downloads-all.md) diff --git a/et/origin/miscellaneous/README.md b/et/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/et/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/et/origin/plazma/README.md b/et/origin/plazma/README.md new file mode 100644 index 000000000..95ed708ed --- /dev/null +++ b/et/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma on Minecraft: Java Edition'i jaoks avatud lähtekoodiga serveriplatvorm, mis lisab paberipõhise eksperimentaalse optimeerimise ja mitme mängumehhanismi kohandamise võimaluse." +--- + +# ✨ Plazma Kasutusjuhendid + +## 👋 Tere tulemast Plazma juhenditesse + +Tere tulemast Plazma kasutusjuhenditesse! + +{% hint style="info" %} + +**Kas probleemi ei saa lahendada juhendist?** + +[Ametlik Discordi server](https://discord.gg/MmfC52K8A8) või küsige kogukonnalt küsimusi [GitHubi arutelud](https://github.com/PlazmaMC/PlazmaBukkit/discussions) kaudu! + +{% endhint %} + +### Plazma kohta + +> Uurige, milline platvorm Plazma on. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Administraatoritele + +> Looge oma server Plazma abil. + +{% content-ref url="administration/" %} +[haldus](administration/) +{% endcontent-ref %} + +### Arendajatele + +> Arendage kolmanda osapoole projekt Plazma abil välja. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/et/origin/plazma/about/README.md b/et/origin/plazma/about/README.md new file mode 100644 index 000000000..421290b86 --- /dev/null +++ b/et/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Uurige, milline platvorm Plazma on. +--- + +# ❓ Mis on Plazma? + +- **Plazma** on [Andromeda](https://github.com/EarendelArchived/Andromeda) ja [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) eelistega [Paper](https://github.com/PaperMC/Paper) platvormil põhinev serveri platvorm. +- Pakume pidevat stabiilsust ja võimsust, kiiret uuendamist ning ulatuslikke funktsioone. + +## 📋 Plazma eesmärk + +- Püüame saavutada kiiret uuendamist ja stabiilset serveri platvormi. +- Püüame pakkuda ulatuslikke funktsioone ja võimsust, mis ei jää maha moodi platvormist. +- Püüame luua vaba platvormi, mis võimaldab kohandada ka vanilje parandusi. + +## ⚙️ Peamised funktsioonid + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Kõige kiiremad uuendused**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) hoiab Plazma kaasas olevad parandused alati ajakohasena, pakkudes kõige kiiremaid uuendusi Paperil põhinevate serveri platvormide hulgas. +6. **Vaikimisi konfiguratsioonifaili optimeerimine**\ + Vaikimisi rakendatud konfiguratsioonifail on optimeeritud, nii et te ei pea seda ise optimeerima. +7. **Süsteemselt toimiv mitmekeerneline**\ + Asünkroniseerib süsteemi mehhanismid, mis ei ole seotud mängu mehhanismidega, et optimeerida serverit ja vähendada [viivitusi](#user-content-fn-4)[^4]. +8. **Tarbetu ruumi kasutamise blokeerimine**\ + Ühendab sarnase väärtusega andmed ühte, et vähendada mälukasutust. + +## ✨ Kasutusjuhud + +- **Iseseisvalt töötav platvorm, mis suudab korralikult töödelda keerulisi plugin-e**\ + Plazmat kasutatakse arendaja [IPECTER](https://github.com/IPECTER) serveris.\ + NMS ja peegeldusel põhinevad enda pluginad, keerulised ja mahukad andmepakid on laialdaselt rakendatud,\ + ning see võtab vastu üle 100 mängija ilma jõudluseta. +- **RPG-serveris säilitatakse kiire jõudlus**\ + Ühe klasteriga hoiti 100 mängijat stabiilselt ilma TPS-i languseta ning\ + 4 klasteriga sai kokku 250 mängijat mängida sujuvalt. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Paljud voogedastajad valivad platvormi**\ + Paljud voogedastajad on selle valinud oma vaatajate osalusämbrina. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Lae alla + +Allpool saate alla laadida Plazma. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Kui soovite rohkem teada versioonide toetamise kohta? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot pistikprogrammid ja Paper, Pufferfish, Purpur pistikprogrammid. + +[^2]: Allpool Microsoft Corporation. + +[^3]: Kui deaktiveerite vestluse raporteerimise süsteemi, töödeldakse vestlusi täielikult serveris, takistades Mojangi vestluste jälgimist. + +[^4]: Süsteemi mehhanismi toimimiseks peab mäng mõneks ajaks peatuma. diff --git a/et/origin/plazma/about/downloads-all.md b/et/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..e93677f85 --- /dev/null +++ b/et/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma käivitusfaili allalaadimine kogu vaade +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versioon | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/et/origin/plazma/about/downloads.md b/et/origin/plazma/about/downloads.md new file mode 100644 index 000000000..3fedea8d5 --- /dev/null +++ b/et/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Laadige Plazma kohe alla ja proovige seda otse kasutada. +--- + +# ⬇️ Lae alla + +#### Kui soovite rohkem teada versioonide toetamise kohta? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Allalaadimine allpool on tavalise kasutaja jaoks mõeldud käivitatav fail.** + +Kui olete arendaja ja vajate muid failivorminguid, vaadake allolevat lehekülge. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersioonAllalaadimine
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + allalaadimine +
1.20.1 + Allalaadimine +
1.19.4 + Allalaadimine +
+ +*** diff --git a/et/origin/plazma/about/patches-list.md b/et/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..eaca0e29e --- /dev/null +++ b/et/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Tutvuge kõigi Plazma lisatud funktsioonidega. +--- + +# 📑 Sisaldab plaastreid diff --git a/et/origin/plazma/about/supported-versions.md b/et/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..d3f4f970e --- /dev/null +++ b/et/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Uurige, millist Minecraft: Java Edition versiooni toetab Plazma." +--- + +# ✅ Versiooni toetus olek + +{% hint style="info" %} + +**Plazma on arendatud alates versioonist 1.19.4 ja versioonid alla 1.19.4 ei ole arendamisel.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Ootel%20olev%20väljalase +[idv]: https://badge.plazmamc.org/1/arendamisel +[atv]: https://badge.plazmamc.org/2/toetus +[fse]: https://badge.plazmamc.org/6/funktsioonide%20toe%20peatamine +[eol]: https://badge.plazmamc.org/4/toe%20lõpetamine +[ukn]: https://badge.plazmamc.org/0/teave%20puudub +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/tavaline +[100]: https://badge.plazmamc.org/percent/100 + +![ootel][wtr] ![arendamisel][idv] ![toetus][atv] ![funktsioonide toe peatamine][fse] ![toe lõpetamine][eol] + +| Versioon | Stabiilsus ja funktsionaalsus | Ehitus olek | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![ehitusseisund](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![ehitus olek](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![ehitus olek](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/et/origin/plazma/administration/README.md b/et/origin/plazma/administration/README.md new file mode 100644 index 000000000..1913521c8 --- /dev/null +++ b/et/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Looge oma server Plazma abil. +--- + +# ⚒️ Serveri halduse juhend diff --git a/et/origin/plazma/administration/diagnosis/README.md b/et/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..b17868452 --- /dev/null +++ b/et/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, kuidas probleemide tekkimisel reageerida. +--- + +# 🧾 진단 diff --git a/et/origin/plazma/administration/diagnosis/plugins.md b/et/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..34ae06167 --- /dev/null +++ b/et/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Kui pistikprogramm ei tööta korralikult, siis leidke lahendus sellele probleemile. +--- + +# 📜 플러그인 diff --git a/et/origin/plazma/administration/expert/README.md b/et/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..33a8af989 --- /dev/null +++ b/et/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Uurige, kuidas käsitleda Plazmat professionaalselt. +--- + +# 🎓 Süvendatud diff --git a/et/origin/plazma/administration/expert/fix-exploits.md b/et/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..2c024aa9a --- /dev/null +++ b/et/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Tutvuge teadaolevate haavatavustega ja nende lahendamise viisidega. +--- + +# ⚠️ Teadaolevad haavatavused ja nende lahendamise meetodid diff --git a/et/origin/plazma/administration/expert/optimize.md b/et/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..11e92614c --- /dev/null +++ b/et/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Uurige, kuidas optimeerida Plazma. +--- + +# 🧹 Optimeerimine diff --git a/et/origin/plazma/administration/expert/proxy.md b/et/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..60a1e6141 --- /dev/null +++ b/et/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Uurige, kuidas turvaliselt seadistada proksiplatvormi "Velocity". +--- + +# 🔀 Proksiplatvorm diff --git a/et/origin/plazma/administration/expert/vanillaize.md b/et/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..b7b6b3a94 --- /dev/null +++ b/et/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Uurige, kuidas taastada Paper ja vanillaparandus. +--- + +# ↩️ Vanillastamine + +{% hint style="warning" %} + +**Paper ei lisa valikuid enamikule vanillavigade parandamise paikadele.** + +Plazma töötab praegu selle võimaluse väljatöötamiseks, et saaks sellised vead konfigureerida. + +Seetõttu on see juhend endiselt koostamisel ja teave võib alati muutuda. + +{% endhint %} diff --git a/et/origin/plazma/administration/expert/xray.md b/et/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..24ae88152 --- /dev/null +++ b/et/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Uurige mitmeid sisseehitatud meetodeid X-Ray blokeerimiseks. +--- + +# 🩻 X-Ray blokeerimine diff --git a/et/origin/plazma/administration/faq.md b/et/origin/plazma/administration/faq.md new file mode 100644 index 000000000..03267d6b5 --- /dev/null +++ b/et/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Uurige sagedaste küsimuste kohta. +--- + +# ⁉️ Sagedased küsimused + +{% hint style="info" %} + +**Kas te ei leia soovitud vastust?** + +[Ametlik Discordi server](https://discord.gg/MmfC52K8A8) või küsige kogukonnalt küsimusi [GitHubi arutelud](https://github.com/PlazmaMC/PlazmaBukkit/discussions) kaudu! + +{% endhint %} + +### Plazma ei käivitu + +Kui konsoolil kuvatakse `no main manifest attribute, in plazma-(version).jar`,\ +tähendab see, et allalaaditud fail on arendusliku API-fail, peate alla laadima GitHubi lehelt **Reobf Paperweight**. + +Lisateabe saamiseks vaadake järgmist lehekülge. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Serveri käivitamisel kuvatakse hoiatus + +Plazmas on mõned ebastabiilsed parandused ja seetõttu võib alati esineda talitlushäireid, seetõttu kuvab server käivitamisel järgmise hoiatuse. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Seda hoiatust saab keelata kasutades [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] süsteemiatribuuti. + +Lisateabe saamiseks vaadake järgmist lehekülge. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Saadaval alates versioonist 1.20.1 diff --git a/et/origin/plazma/administration/getting-started/README.md b/et/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..90cb445a4 --- /dev/null +++ b/et/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Uurige, kuidas luua server Plazma abil. +--- + +# 👟 Alustamine + +Plazma stabiilseks kasutamiseks peab süsteem vastama järgmistele nõuetele. + +| | Miinimum | Soovitatav | +| :-----------: | -------- | ---------- | +| Arhitektuur | x64 | - | +| RAM | 8GB | 16GB | +| Salvestusruum | 1GB | 8GB | +| JDK | 17 | 21 | + +Sujuva konfiguratsioonifailide muutmise jaoks on soovitatav installida redaktorid nagu [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Õige väljund" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' pole sisemine ega väline käsk, käivitatav programm või +partiifail. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Esiteks laadige alla [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) **JDK 21** `.msi` vormingus. +2. Käivitage allalaaditud installimisviisard ja klõpsake „Edasi“. +3. **Aktiveerige menüüs „Seadke JAVA_HOME muutuja“ vasakul keskel** ja klõpsake seejärel „Järgmine“. +4. Vajutage nuppu „Install“ JRE installimiseks „Lõpeta“. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Seejärel installige JRE järgmise käsu abil terminalis. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma allalaadimine + +Plazma pakub mitmesuguseid käivitatavaid faile. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Lisateave + +Käivitatava faili nimi on `plazma-(versioonihaldur)-1.20.4-R0.1-SNAPSHOT-(kaardistamise vorm).jar`. + +- **Kaardistamise vorm**\ + Kaardistamine on omamoodi kaart, mis ühendab Minecrafti tegeliku koodi ja obfuskeeritud koodi. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-kaardistatud, see on Vanilla Minecrafti kaardistamine. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Versioonihaldur**\ + Versioonihaldur on serveri käivitamiseks vajalike raamatukogude ja serverifailidega pakkimise serveri käivitaja. + - **Paperclip**\ + PaperMC meeskond on välja töötanud halduri Paper ja muudele platvormidele, mis laadivad alla raamatukogud ja rakendavad serverisse plaastreid. + - **Pakendaja**\ + Vanilje Minecrafti versioonihaldur. + +
+ +*** + +## 3. Käivitusskripti loomine + +Plazma lihtsaks käivitamiseks ja serveri automaatseks taaskäivitamiseks peate looma [käivitusskripti](#user-content-fn-6). + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Käivitusskripti saate alla laadida all vasakus allnurgas oleva nupu abil.\ +**Veenduge, et allalaaditud käivitusskript vastab teie operatsioonisüsteemile.** + +*** + +## 4. Failide korraldamine + +Liigutage nüüd allalaaditud käivitusskript ja Plazma uude kausta. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Käivitage nüüd käivitusskript. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA nõustamine + +Kui käivitate käivitusskripti, luuakse kausta `eula.txt` fail. + +EULA on [Mojang Studios](#user-content-fn-10) teenuste kasutamiseks vajalik litsentsileping, millega tuleb nõustuda. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA nõustumiseks muutke `eula=false` failis `eula=true` ja salvestage see. + +*** + +## 6. Välise ühenduse lubamine (Windows) + +Kaasaegsed operatsioonisüsteemid blokeerivad vaikimisi välise juurdepääsu tulemüüri ja ruuteriga. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Kui ruuter ei toeta UPnP-d, siis iga ruuteri paneel on erinev ja peate ise otsima teavet. + +Samuti võite kasutada [Ngrok](https://ngrok.com/), et luua ajutine aadress. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Portide edastamise vajaduse kontrollimine + +Sisestage ja käivitage järgmine käsk käivitusaknas. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Kui väljund on `True`, võite siin lõpetada, kuid kui see on `False`, peate seadistama portide edastamise. + +### 6.2 Ühendus serveriga + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Serveriga ühenduse loomisel kasutatav aadress on võimalik kontrollida [siin](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Seejärel taaskäivitage server, et Plazma prooviks automaatselt portide edastamist. + +Allpool on toodud UPnP edukuse kontrollimiseks konsoolile kuvatavad sõnumid, konsoolis kuvatakse `[UPnP] (sõnum)`. + +| Sõnum | Tähendus | +| ---------------------------------- | --------------------------------------------------- | +| `Port (port) edukalt avatud` | Portide edastamine õnnestus. | +| `Port (port) on juba avatud` | Muu teenus kasutab seda porti juba. | +| `Porti (port) ei õnnestunud avada` | Portide edastamine ebaõnnestus. | +| `Teenus pole saadaval` | Ruuter ei toeta UPnP-d. | + +Kui server peatub, sulgeb Plazma automaatselt pordid. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Laadige alla [Ngrok veebisaidilt](https://ngrok.com/download) `Windows (64-bit)` ZIP-fail. +2. Pange allalaaditud Ngrok serveri kausta. +3. Looge [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) jaoks [autentimistoken](#user-content-fn-13). +4. Käivitage serveri kaustas kuvatav käsk käsureal. +5. Lisage käivitusskripti ülaossa `start /b ngrok tcp --region jp 25565`, allosas `taskkill /f /t /im ngrok.exe`. +6. Konsooli ülaosas kuvatud `Edastamine tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` korral on serveri aadressiks `0.tcp.jp.ngrok.io:12345`. +7. Nüüd saate selle aadressi kaudu väljastpoolt ühendust luua. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Näiteks, kui käivitamisel kuvatakse järgmine väljund, + +```log +Windows IP konfiguratsioon + +Etherneti adapter Ethernet: + + Ühendatud DNS suffiks. . . . : + IPv4 aadress. . . . . . . . . : 192.168.3.7 + Alamvõrgu mask . . . . . . . : 255.255.255.0 + Vaikimisi värav . . . . . . : 192.168.3.1 + +``` + +Siis proovige ühendada kohalikult serveriga, kasutades IPv4 aadressil näidatud `192.168.3.7`. + +Kui server ja mäng töötavad samal arvutil, saate ühenduda aadressil `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Edasi areneda + +Kui server on edukalt käivitatud ja töötab korralikult, on aeg seda kasutajapõhiseks muuta. + +Tutvuge allpool oleva juhendiga, kuidas kohandada serverit. + +{% content-ref url="järgmine-samm.md" %} +[järgmine-samm.md](järgmine-samm.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma baasil paber kasutab Spigot'i ja Spigot tugineb ametlikule serveri platvormile. + +[^3]: Windowsi klahv + R + +[^4]: Linuxi puhul käsurealt `java --version` + +[^5]: JRE on üks avatud lähtekoodiga projektidest ja sarnaselt Minecrafti serveri platvormiga on mitmeid erinevaid versioone. + +[^6]: Tavaliselt tuntakse seda **käivitajana**. + +[^7]: Kui aktiveerite „Automaatse taaskäivituse“, taaskäivitatakse server automaatselt. Väljumiseks sisestage `Control + C`. + +[^8]: Soovitatav ei ole süsteemi üle poole koormata. + + Näiteks, kui süsteemi kogumälu maht on 8 GB, siis ei soovitata seda seada üle 4 GB. + +[^9]: Lõppkasutaja litsentsileping, lõppkasutaja litsentsileping. Lisateabe saamiseks vaadake [Minecrafti kodulehte](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Kui tegemist on Lõuna-Korea mängutööstuse edendamise seaduse § 32 lõike 1 punktiga 9, siis on võimalik esitada õiguslik kaebus **Korea Microsoft Corporation** vastu. + +[^12]: Universaalne pistik & mängi. Plazma'ga lisatud Purpur suhtleb automaatselt ruuteriga selle tehnoloogia abil, avades pordi ainult siis, kui server töötab, nii et pole vaja otse portide edastamist teha. + +[^13]: Kui teil pole kontot, registreeruge Ngrokis Google'i või GitHubi konto kaudu. diff --git a/et/origin/plazma/administration/getting-started/customization.md b/et/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..bbad7eae7 --- /dev/null +++ b/et/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,121 @@ +--- +description: Uurige, kuidas kohandada serverit kasutaja vajadustele vastavaks. +--- + +# 🎨 Kasutaja kohandamine + +Plazmat kasutatakse ametliku serveriplatvormi asemel Mojang Studios'i ametliku serveriplatvormi asemel kasutamiseks, kuna see võimaldab tugevat **kasutaja kohandamist**. + +Allpool on mitu viisi, kuidas Plazmat kohandada ja kasutada. + +## Konfiguratsiooni muutmine + +Plazma kasutaja kohandamise kõige põhilisem viis on konfiguratsiooni muutmine. + +Plazma pakub võimsaid konfiguratsiooniseadeid alates mängumehhanismidest kuni olendite omadusteni. + +Lisateavet Plazma konfiguratsioonide kohta leiate allolevast lehest. + +{% content-ref url="../reference/configurations/" %} +[konfiguratsioonid](../reference/configurations/) +{% endcontent-ref %} + +## Plugin'i kasutamine + +{% hint style="success" %} + +**Plazma toetab kõiki paberil põhinevaid pistikprogramme.** + +Spigot pistikprogrammid võivad alates 1.20.5-st Paperi mäppimise muutuste tõttu osaliselt mitte toimida, kuid +Plazma toetab kõiki Paperil põhinevaid pistikprogramme, sealhulgas Paper, Pufferfish ja Purpur, ning kui pistikprogramm ei tööta korralikult, on see Plazma viga, nii et palun [teatage sellest kohe.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma kasutamine on peamine põhjus ja tugevaim viis Plazmat kasutajate kohandamiseks. +Plazma tugev pistikprogrammide ökosüsteem võimaldab serverit hõlpsasti kohandada. + +Pistikprogrammi leidmiseks ja allalaadimiseks on mitu võimalust. Mõned pistikprogrammid laaditakse üles avalikele hoidlateenustele ja mõned GitHubi või oma +veebisaitidele. + +{% hint style="caution" %} + +**Pistikprogrammidel võib olla otsest juurdepääsu süsteemile!** + +Enne pistikprogrammi rakendamist kasutage teenust nagu VirusTotal, et veenduda selle turvalisuses või +laadige pistikprogramm alla usaldusväärsest teenusest. + +{% endhint %} + +Pistikprogrammi allalaadimiseks on mitu teenust. Nende hulgas on [SpigotMC foorum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/), kus pistikprogrammide üleslaadimisele eelneb hindamine ning ebaturvalised pistikprogrammid kõrvaldatakse, tagades turvaliste pistikprogrammide leviku. + +### Pistikprogrammi rakendamine + +Kui olete pistikprogrammi alla laadinud, on aeg see rakendada. + +1. Pistikprogramm on `.jar` või `Java käivitatav fail`.\ + Mõned pistikprogrammid võivad olla arhiivifailidena pakitud, mil juhul + tuleb arhiiv lahti pakkida ja kasutada faili, kus on nimi sisaldab `bukkit`, `spigot` või `paper`, + ing kui failis on ka `fat`, siis tuleks kasutada `fat` faili. +2. Pange allalaaditud fail serveri kausta `plugins` ja (taas)käivitage server. +3. Kui Plazma käivitub, kuvatakse konsoolis uut sisu. + See tähendab, et Plazma on pistikprogrammi edukalt laadinud. +4. Kuigi Plazma on pistikprogrammi edukalt laadinud, võib pistikprogramm mitte käivituda. + Kasutades käsku `/plugins`, saate laadida serverisse hetkel laetud pistikprogrammid. + Kui paigaldatud pistikprogrammi nimi pole punane, vaid roheline, on pistikprogramm edukalt laetud. + +Kui pistikprogramm pole edukalt laadinud, leiate allpool lehelt probleemile lahenduse. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Andmepakettide kasutamine + +Andmepaketid on Minecrafti poolt pakutav kasutajate kohandamise meetod, mis on sarnane +[resurssipakettidega](#user-content-fn-1)[^1]. + +Andmepakettide abil saate lisada uusi eluvorme ja väljakutseid ning muuta mängu sisemust. + +{% hint style="caution" %} + +**Andmepaketid võivad kahjustada maailma!** + +Mõned vigased andmepaketid võivad maailma kahjustada ja see on pöördumatu. + +Seetõttu on soovitatav enne andmepakettide rakendamist varundada maailm. + +{% endhint %} + +Andmepakette saab alla laadida mitmest teenusest, sealhulgas [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) ja mitmetest muudest teenustest. + +Kui olete andmepaketi alla laadinud, saate selle rakendada serveri maailma kaustas `datapacks`. +Kui kausta pole, tuleb see luua ja lisada. + +{% hint style="warning" %} + +**Mõned [andmepaketid](#user-content-fn-2)[^2] ei pruugi esialgu korralikult rakenduda.** + +Sellisel juhul soovitatakse server **2 korda** taaskäivitada. + +{% endhint %} + +Andmepaketid võivad iga Minecrafti versiooni värskendamisel kergesti kahjustuda. + +Eriti kui andmepakett on täielikult kahjustunud, võib server kokku kukkuda, +seega on oluline enne serveri värskendamist läbi viia piisavalt teste. + +{% hint style="info" %} + +**Serveri käivitamise käsu järel saate sisestada `safeMode`, et kõik andmepaketid keelata ja seejärel server käivitada.** + +[Lisateabe saamiseks vaadake `Viited > Argumendid` osa.](../reference/arguments.md) + +{% endhint %} + +Rakendatud andmepakette saab kontrollida käsu `/datapack list` abil. + +*** + +[^1]: Või Minecrafti: Bedrock Editioni lisandmoodul. + +[^2]: Lisades uusi eluvorme jms. diff --git a/et/origin/plazma/administration/getting-started/next-step.md b/et/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..067ef1969 --- /dev/null +++ b/et/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Uurige, kuidas kohandada serverit kasutaja vajadustele vastavaks. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Allpool on mitu viisi, kuidas Plazmat kohandada ja kasutada. + +## Konfiguratsiooni muutmine + +Plazma kasutaja kohandamise kõige põhilisem viis on konfiguratsiooni muutmine. + +Plazma pakub võimsaid konfiguratsiooniseadeid alates mängumehhanismidest kuni olendite omadusteni. + +Lisateavet Plazma konfiguratsioonide kohta leiate allolevast lehest. + +{% content-ref url="../reference/configurations/" %} +[konfiguratsioonid](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Plugin'i kasutamine + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma kasutamine on peamine põhjus ja tugevaim viis Plazmat kasutajate kohandamiseks. Plazma tugev pistikprogrammide ökosüsteem võimaldab serverit hõlpsasti kohandada. + +Pistikprogrammi leidmiseks ja allalaadimiseks on mitu võimalust. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Pistikprogrammi allalaadimiseks on mitu teenust. Nende hulgas on [SpigotMC foorum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/), kus pistikprogrammide üleslaadimisele eelneb hindamine ning ebaturvalised pistikprogrammid kõrvaldatakse, tagades turvaliste pistikprogrammide leviku. + +### Pistikprogrammi rakendamine + +Kui olete pistikprogrammi alla laadinud, on aeg see rakendada. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Pange allalaaditud fail serveri kausta `plugins` ja (taas)käivitage server. +3. Kui Plazma käivitub, kuvatakse konsoolis uut sisu. See tähendab, et Plazma on pistikprogrammi edukalt laadinud. +4. Kuigi Plazma on pistikprogrammi edukalt laadinud, võib pistikprogramm mitte käivituda. Kasutades käsku `/plugins`, saate laadida serverisse hetkel laetud pistikprogrammid. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Kui pistikprogramm pole edukalt laadinud, leiate allpool lehelt probleemile lahenduse. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Andmepakettide kasutamine + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Andmepakettide abil saate lisada uusi eluvorme ja väljakutseid ning muuta mängu sisemust. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Mõned vigased andmepaketid võivad maailma kahjustada ja see on pöördumatu. + +Seetõttu on soovitatav enne andmepakettide rakendamist varundada maailm. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Kui olete andmepaketi alla laadinud, saate selle rakendada serveri maailma kaustas `datapacks`. Kui kausta pole, tuleb see luua ja lisada. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Sellisel juhul soovitatakse server **2 korda** taaskäivitada. +{% endhint %} + +Andmepaketid võivad iga Minecrafti versiooni värskendamisel kergesti kahjustuda. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Rakendatud andmepakette saab kontrollida käsu `/datapack list` abil. + +*** + +## Optimeerimine + +Plazmas on rakendatud palju optimeerimisparandusi. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proksia + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Turvalise ja õige proksia seadistuse kohta leiate lisateavet allpool toodud lehelt. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Turvalisus + +Minecrafti modifikatsioonid on arenenud ja võrgus on lihtne leida [haavatavus ründemootorit](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Õiguste seadistamine + +Mõne pistikprogrammi administraatori käskude puhul võib esineda haavatavusi, kui õigusi pole õigesti seadistatud. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokeerimine + +X-Ray on üks lihtsasti kasutatavaid haavatavusi isegi põhilises optimeerimiskliendis. + +Plazmas on vaikimisi X-Ray blokeerimise konfiguratsioon. + +X-Ray blokeerimise meetodid ja selgitused leiate allpool toodud lehelt. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Valge nimekirja + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Lubatud mängijate nägemiseks kasutage `/whitelist query` käsku. + +*** + +[^1]: Või Minecrafti: Bedrock Editioni lisandmoodul. + +[^2]: Lisades uusi eluvorme jms. + +[^3]: Tavaliselt tuntakse seda "häkkimisena". + +[^4]: Kui konfiguratsioon pole optimeeritud või kui Plazma on vananenud või kui on avastatud uusi haavatavusi, võib blokeering puududa. + +[^5]: Mängijad ühenduvad serveriga Ngrok proksiserveri kaudu ja iga taaskäivitusega antakse välja erinev Ngrok aadress. diff --git a/et/origin/plazma/administration/reference/README.md b/et/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..24db57aa9 --- /dev/null +++ b/et/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Uurige Plazma poolt pakutavaid vaikimisi kasutajakohandamise meetodeid. +--- + +# 📜 리퍼런스 + +Plazma pakub mitmeid erinevaid kasutajakohandamise meetodeid. + +Nendest neljast meetodist saab kasutada kohe ilma täiendavate toiminguteta. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Ametlik Discordi server](https://discord.gg/MmfC52K8A8) või küsige kogukonnalt küsimusi [GitHubi arutelud](https://github.com/PlazmaMC/PlazmaBukkit/discussions) kaudu! +{% endhint %} + +*** + +## 🖥️ Käsud + +> Käsud võimaldavad koguda teavet mängus või kohandada kasutajaliidest. + +{% content-ref url="commands.md" %} +[käsud.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Õigused + +> Õigused määravad mängijate vahelise suhtluse ulatuse. + +{% content-ref url="permissions.md" %} +[õigused.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumendid ja atribuudid + +> Argumendid ja atribuudid mõjutavad oluliselt Plazma toimimist. + +{% content-ref url="arguments.md" %} +[argumendid.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguratsioon + +> Konfiguratsioon on kõige põhilisem viis Plazma kohandamiseks. + +{% content-ref url="configurations/" %} +[konfiguratsioonid](configurations/) +{% endcontent-ref %} + +*** diff --git a/et/origin/plazma/administration/reference/arguments.md b/et/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..593483578 --- /dev/null +++ b/et/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Uurige algust ja süsteemi atribuute. +--- + +# 🎛️ Algused ja atribuudid + +Algusparameetrid ja süsteemi omadused on väärtused, mis lisatakse Plazma käivitamisel kasutatavatele käskudele, mis mõjutavad Plazma üldist toimimist. + +[Käivitusparameetrite lisamine](#user-content-fn-2)[^2] jaguneb **algparameetriteks** ja **süsteemi atribuutideks** vastavalt nende lisamise kohale käskudele. + +*** + +## Süsteemi atribuudid + +Süsteemi atribuudid sisestatakse `-jar` ette ja töödeldakse JVM poolt enne Plazma alglaadimist. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Kasutusjuhend + +Süsteemi atribuudid sisestatakse Java käsu argumendina `java` ja `-jar` vahel. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` tähistab, et see argument pole JVM-is sisse ehitatud, vaid lisatud eraldi Plazma jaoks, + +Kui atribuudile ei sisestata mingit väärtust, siis väärtus fikseeritakse [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Kogu süsteemi atribuudid + +#### `convertLegacySigns` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Uuendab kasutusel mitte olevaid märgistusi. + +#### `debug.entities` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab sisse seotud entiteedi teabe silumise. + +#### `debug.rewriteForIDE` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Võimaldab IDE-l korralikult lugeda silumisinfot, keelates NMS revisiooni ja automaatselt ümberkaardistades sisemise versiooni info. + +#### `disable.watchdog` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab välja Spigoti valvekoera hoiatussüsteemi. + +#### `letMeReload` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab `/reload` käsu uuesti laadimise kinnitussõnumi. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Kui olete pistikprogrammi arendaja ja peate pistikprogrammi uuendama, siis kasutage `hotswap` asemel `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab pistikprogrammi, mis kasutab standardset sisend-väljund süsteemi. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Hoiatab, kui kasutusel on lõpetatud vormingud vestluse komponentides. + +#### `Paper.bypassHostCheck` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab serveri mustri sobitamise kontrolli, kui mängija serveriga ühendust loob. + +#### `Paper.debugDynamicMissingKeys` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Aktiveerib tõrkeotsingu logi puuduvate NBT võtmete kohta. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Aktiveerib tõrkeotsingu logi valede koljuprofiilide kohta. + +See logib kõik valesti paigutatud koljuprofiilid asukohaga ja maailmas. + +#### `Paper.disableChannelLimit` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab pistikprogrammi klassi prioriteedi süsteemi. + +Kasulik probleemide korral pistikprogrammi varjundiga. + +#### `Paper.disableFlushConsolidate` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab Netty loputamise konsolideerimise süsteemi. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Vaikimisi väärtus**: `750` + +Juhul, kui entiteete on rohkem kui määratud väärtus, jagatakse need mitmeks paketiks edastamiseks. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Vaikimisi väärtus**: `8192` + +Määrab serveri vastuvõetavate maksimaalsete paketi suuruse. + +#### `Paper.ignoreJavaVersion` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab Java versiooni kontrolli. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +See võib püsivalt kahjustada maailma ja üldiselt faile ning mängu mehaanikat rikkuda. + +Kõik sellest tulenevad probleemid on teie enda vastutusel ja Plazma ei paku sellele mingit tuge. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Vaikimisi väärtus**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Vaikimisi väärtus**: `80` + +Määrab märgi maksimaalse pikkuse ühes reas. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Vaikimisi väärtus**: `(maailma versioon) + 1` + +Määrab algse maailma uuendusteabe versiooni. + +Kasutatakse peamiselt massiliste tükkide värskenduste korral, kuid muul juhul pole vajalik. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `True` + +Lülitab sisse YAML failide kommentaaride töötlemise. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Vaikimisi väärtus**: `30` + +Kui mängijalt pole määratud aja jooksul (sekundites) saadud andmeid, siis mängija välja visatakse. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Ignoreerib serveri omaduste kommentaare. + +#### `Paper.debug-sync-loads` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab sisse sünkroonse tüki laadimise silumise. + +#### `Paper.enable-sync-chunk-writes` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab sisse Minecrafti [vaikimisi tüki kirjutamise süsteemi](#user-content-fn-10)[^10]. + +See salvestab iga tüki järjestikku, mis põhjustab märkimisväärset jõudluse langust. + +#### `Paper.explicit-flush` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab võrgukanali selgeks loputamise. + +#### `Paper.strict-thread-checks` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Logib alati peamises lõimes esinenud vigu. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Hoiatab, kui planeeritud ülesannetel on liiga suur viivitus. + +#### `Paperclip.patchOnly` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Kui kasutatakse vaikimisi käivitusfaili, rakendatakse ainult paigaldus ilma serveri käivitamiseta. + +#### `Plazma.aggressiveOptimize` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` +- **Kokkupõrge**: `Plazma.disableConfigOptimization` + +Optimeerib algseadistust tugevamini. + +Aktiveerimisel muutub server kiiremaks ja turvalisemaks, kuid võib mõjutada tugevalt mängimiskogemust. + +#### `Plazma.disableConfigOptimization` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` +- **Kokkupõrge**: `Plazma.aggressiveOptimize` + +Ei optimeeri algseadistust agressiivselt. + +See kasutab Paberi vaikimisi seadistust. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` + +Keelab Plazma brändi ja kasutab vaikimisi serveri veebilogi. + +#### `Plazma.useVanillaConfiguration` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` +- **Kokkupõrge**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +See võib oluliselt mõjutada serveri turvalisust ja jõudlust. + +Kõik selle omadusest tulenevad probleemid on serveri administraatori vastutusel. +{% endhint %} + +Optimeerib algseadistust Mojangi poolt pakutud vaikeseadistusega. + +See deaktiveerib kõik paberist rakendatud haavatavuste parandused. + +Haavatavuste parandusi saab uuesti lubada Paberi või Plazma seadistustes. + +#### `Plazma.vanillaize` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `true` +- **Kokkupõrge**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Optimeerib algseadistust lähemale vanillale. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Kasutatud omadus on lõpetatud + +Allpool olevad süsteemi omadused on lõpetatud + +#### `timings.bypassMax` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` +- **Kasutamise lõpetatud**: Timings on Plazmas eemaldatud alates esipaneeli eemaldamisest + +Otsustab, kas võib ületada Aikari Timings API-sse saadetavate väärtuste maksimumi + +Kui API-s erinditöötlust pole, rakendatakse viivituse piirangut + +*** + +## Algusargumendid + +Algusargumendid sisestatakse `-jar *.jar` järel, et Plazma saaks alglaadimise ajal neid töödelda + +### Kasutusjuhend + +Süsteemi omadused sisestatakse `-jar *.jar` järel programmi käsureana + +Näiteks kui soovite rakendada `nogui` algusargumendina,\ +siis järgmiselt sisestades töötleb Plazma alglaadimise ajal `nogui` argumendi + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Kogu algusargumendid + +#### `bukkit-settings` + +- **Lühend**: `b` +- **Vaikimisi väärtus**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Lühend**: `c` +- **Vaikimisi väärtus**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Lühend**: `c` +- **Vaikimisi väärtus**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Alustab serverit demomaailmaga + +#### `eraseCache` + +Eemaldab pärast maailma värskendamist allesjäänud vahemälu failid + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Lühend**: `?` + +Väljastab Plazma kõik algusargumendid ja selgitused + +#### `initSettings` + +Loo ainult konfiguratsioonifail ja sulge server + +#### `jfrProfile` + +Lülitab sisse JFR-profiliseerimise + +#### `max-players` + +- **Lühend**: `s`, `size` +- **Vaikimisi väärtus**: `(serveri omadus)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Keelab graafilise kasutajaliidese paneeli + +#### `nojline` + +Keelab JLine'i ja kasutab tavakonsooli + +#### `online-mode` + +- **Lühend**: `o` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Valib, kas autentida mängijad Mojangi autentimisserveris + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Lühend**: `paper` +- **Vaikimisi väärtus**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Määrab kasutatava PaperSpigoti konfiguratsioonifaili asukoha + +Seda kasutatakse varasema seadistuse uude faili migreerimiseks ja seejärel enam ei kasutata + +#### `paper-settings-directory` + +- **Lühend**: `paper-dir` +- **Vaikimisi väärtus**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Lühend**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Lühend**: `p` +- **Vaikimisi väärtus**: `plugins` + +Määrab pistikprogrammide kausta asukoha + +#### `pufferfish-settings` + +- **Lühend**: `pufferfish` +- **Vaikimisi väärtus**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Lühend**: `purpur` +- **Vaikimisi väärtus**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Alustab serverit täielikult tavalises olekus + +#### `server-ip` + +- **Lühend**: `h`, `host` +- **Vaikimisi väärtus**: `(serveri omadus)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Lühend**: `p`, `port` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Määrab serveri pordi + +#### `server-name` + +- **Vaikimisi väärtus**: `A Plazma Server` + +Määrab serveri nime + +#### `spigot-settings` + +- **Lühend**: `S` +- **Vaikimisi väärtus**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Lühend**: `v` + +Väljastab Plazma versiooni + +#### `world-dir` + +- **Lühend**: `W`, `universe`, `world-container` +- **Vaikimisi väärtus**: `(serveri kaust)` + +Määrab, kuhu salvestatakse maailma failid + +#### `world-name` + +- **Lühend**: `w`, `world` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Määrab maailma faili nime + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Sõltuvalt lisatud asukohast muutub argumendi töötlemise asukoht + +[^3]: Näiteks kui soovite seadistada `Plazma.iKnowWhatIAmDoing` väärtuseks `true`, siis töötab sama moodi, kui sisestate ainult `-DPlazma.iKnowWhatIAmDoing` asemel `-DPlazma.iKnowWhatIAmDoing=true` + +[^4]: Näiteks, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Sündmuse tuvastaja. + +[^6]: Sündmuse tuvastaja. + +[^7]: Klient. + +[^8]: Signaal, mis teavitab serveri ja kliendi normaalsest ühendusest nagu südamelöök. + +[^9]: Purpuri AFK väljaviskamise funktsiooni abil saate välja visata ka mängija, kes on lahkunud. + +[^10]: Sync Chunk Write System, süngroonse tüki kirjutamise süsteem. + +[^11]: `HOIATUS! Plazma võib põhjustada ootamatuid probleeme, seega veenduge, et testite seda põhjalikult enne selle kasutamist avalikul serveril.` + +[^12]: Mängus `maailma optimeerimine` toimib samal põhimõttel. + +[^13]: `Tase 2` või kõrgemad administraatorid on välja arvatud. + +[^14]: Interneti protokoll, IP. diff --git a/et/origin/plazma/administration/reference/commands.md b/et/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..b25763e2c --- /dev/null +++ b/et/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Tutvuge Plazma saadaval olevate käskudega. +--- + +# 🖥️ Käsud diff --git a/et/origin/plazma/administration/reference/configurations/README.md b/et/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..663cb0499 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfiguratsioon on kõige põhilisem viis Plazma kohandamiseks. +--- + +# 🧾 구성 + +*** + +## 🪨 Omadus + +> Omadus on Minecraftis pakutav kõige põhilisem konfiguratsioonifail. Omaduste abil saab muuta mängu põhilisi mehhanisme. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkiti konfiguratsioon + +> Bukkiti konfiguratsioon on Plazmas pakutav kõige põhilisem konfiguratsioonifail. Bukkiti konfiguratsiooni abil saab muuta Minecrafti serveri põhilisi mehhanisme. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigoti konfiguratsioon + +> Spigoti konfiguratsioon võimaldab muuta mängu detailseid mehhanisme, mängijate töötlemist, käskude toimimist ja sõnumeid. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paperi konfiguratsioon + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfishi + +> Pufferfishi konfiguratsioon võimaldab muuta Plazma maailma ja olevuste töötlemist. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpuri konfiguratsioon + +> Purpuri omadus võimaldab muuta mängu üldist põhiandmeid. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfiguratsioon + +> Plazma konfiguratsioon võimaldab kohandada Plazma funktsioone. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/et/origin/plazma/administration/reference/configurations/bukkit.md b/et/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..15e55afe3 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga bukkit.yml sõlm tähendab. +--- + +# 🪣 Bukkit diff --git a/et/origin/plazma/administration/reference/configurations/paper/README.md b/et/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..d641db907 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mis on iga faili config kaustas otstarve. +--- + +# 🛩️ Paber diff --git a/et/origin/plazma/administration/reference/configurations/paper/global.md b/et/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f506e98fb --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga paper-global.yml sõlm tähendab. +--- + +# 🌏 전역 구성 diff --git a/et/origin/plazma/administration/reference/configurations/paper/world.md b/et/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..7e11849f4 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Uurige, mida iga paper-world.yml sõlme tähendab. +--- + +# 🏳️ 세계별 구성 + +maailma diff --git a/et/origin/plazma/administration/reference/configurations/plazma/README.md b/et/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..ac7dabd31 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mis on iga faili config kaustas otstarve. +--- + +# ✨ Plazma diff --git a/et/origin/plazma/administration/reference/configurations/plazma/global.md b/et/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..e971c4fcf --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida tähendab iga plazma-global.yml sõlm. +--- + +# 🌏 전역 구성 diff --git a/et/origin/plazma/administration/reference/configurations/plazma/world.md b/et/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..ff191d4bb --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga plazma-world.yml sõlme tähendab. +--- + +# 🏳️ 세계별 구성 diff --git a/et/origin/plazma/administration/reference/configurations/plazma/worlds.md b/et/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..05c449292 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga plazma-world.yml sõlme tähendab. +--- + +# ✨ Plazma (maailmade koosseis) diff --git a/et/origin/plazma/administration/reference/configurations/property.md b/et/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..9bc6bc30f --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga server.properties sõlm tähendab. +--- + +# 🪨 Server.properties diff --git a/et/origin/plazma/administration/reference/configurations/pufferfish.md b/et/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..a391b61ec --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga pufferfish.yml sõlme tähendab. +--- + +# 🐡 Pufferfish diff --git a/et/origin/plazma/administration/reference/configurations/purpur/README.md b/et/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fbdc7261f --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga purpur.yml sõlm tähendab. +--- + +# 🦑 Purpur diff --git a/et/origin/plazma/administration/reference/configurations/purpur/global.md b/et/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..82dbc5427 --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga purpur.yml sõlm tähendab. +--- + +# 🌏 전역 구성 diff --git a/et/origin/plazma/administration/reference/configurations/purpur/world.md b/et/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..4ee0994ab --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga purpur.yml sõlm tähendab. +--- + +# 🏳️ 세계별 구성 diff --git a/et/origin/plazma/administration/reference/configurations/spigot.md b/et/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..8f378d59e --- /dev/null +++ b/et/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida tähendab iga spigot.yml sõlme. +--- + +# 🚰 Spigot diff --git a/et/origin/plazma/administration/reference/permissions.md b/et/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..012de3809 --- /dev/null +++ b/et/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Uurige Plazma õigusi. +--- + +# 🛡️ Õigused + +Õigused on lihtne turvavahend, mis määrab serveri mängijate vahelise suhtluse ulatuse. + +Õiguste korralikuks kasutamiseks ja lihtsaks muutmiseks tuleks kasutada pistikprogramme nagu [LuckPerms](https://luckperms.net). + +*** + +## Mõistke vaikimisi õiguste süsteemi + +Minecraftis on vaikimisi haldusõiguste gruppe. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Mängija**\ + Tavaline õiguste grupp, mis antakse tavaliselt kõigile mängijatele. +2. **Vahendaja**\ + Võib ignoreerida spawnpunktide kaitset. +3. **Maailma administraator**\ + Saab kasutada kõiki maailma haldamise ja sellega seotud käsklusi ning käsu plokke.\ + See on vaikimisi rakendatav õiguste grupp andmepakettidele ja käsu plokkidele. +4. **Administraator**\ + Saab kasutada kõiki mängijate haldamise ja sellega seotud käsklusi. +5. **Peakasutaja**\ + Saab kasutada kõiki serveri haldamise ja sellega seotud käsklusi.\ + See on vaikimisi rakendatav õiguste grupp konsoolile ja administraatoritele. + +*** + +## Määrake õigused + +*** + +## Kogu õigus + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Vaikimisi**: `Puudub` + +Lubab mängijal kummarduda ja suhelda üksustega, et neile peale istuda. + +Üksust peale istudes saate kasutada `liikumisklahve` selle liigutamiseks ja hüppamiseks või lendamiseks `hüppeklahviga`. + +`(Namespaced Key)` tähistab üksuse [Namespaced ID](#user-content-fn-2)[^2]. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Vaikimisi**: `Puudub` + +Lubab mängijal kasutada üksuse erilisi võimeid, kui ta sõidab üksusel. + +Kõikide üksuste erivõimed ei pruugi olla saadaval. Vaadake kõikide saadaolevate erivõimete kohta allpool. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Avaldage oma ideed [Plazma Discordis](https://plazmamc.org/discord) või [GitHubi aruteludes](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Vaadake praegu saadaolevaid erivõimeid + +- **`creeper`**\ + Vajutades `hüppeklahvi` plahvatab.\ + Kui mängijal on lubatud `allow.powered.creeper` õigus, saab ta plahvatuse laadimiseks hoida `hüppeklahvi` all. +- **`delfiin`**\ + Vajutades `hüppeklahvi` teeb hüppe edasi. +- **`phantom`**\ + Vajutades `hüppeklahvi` tulistab tulekahju. +- **`wither`**\ + `Suhtlemisel` tulistab wither pea. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/compass` käsku](commands.md#compass). + +#### `bukkit.command.credits` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/credits (Mängija)` käsku](commands.md#credits). + +Lisades õigusele nimele `.other`, võimaldab see seda kasutada teistel mängijatel. + +#### `bukkit.command.demo` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/demo (Mängija)` käsku](commands.md#demo). + +Lisades õigusele nimele `.other`, võimaldab see seda kasutada teistel mängijatel. + +#### `bukkit.command.ping` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/ping (Mängija)` käsku](commands.md#ping). + +Lisades õigusele nimele `.other`, võimaldab see seda kasutada teistel mängijatel. + +#### `bukkit.command.ram` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/ram` käsku](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/rambar (Mängija)` käsku](commands.md#rambar). + +Lisades õigusele nimele `.other`, võimaldab see seda kasutada teistel mängijatel. + +#### `bukkit.command.restart` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/restart` käsku](commands.md#restart). + +#### `bukkit.command.tps` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/tps` käsku](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/tpsbar (Mängija)` käsku](commands.md#tpsbar). + +Lisades õigusele nimele `.other`, võimaldab see seda kasutada teistel mängijatel. + +#### `bukkit.command.timings` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/timings` käsku](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Vaadake sarnaseid käsklusi [Sparki](https://spark.lucko.me/docs/Command-Usage) lehelt. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/uptime` käsku](commands.md#uptime). + +#### `minecraft.command.gamemode.(Mängurežiim)` + +- **Vaikimisi**: `Maailma administraator` + +Lubab kasutada [`/gamemode (Mängurežiim) (Mängija)` käsku. + +Lisades õigusele nimele `.other`, võimaldab see seda kasutada teistel mängijatel. + +#### `paper.antixray.bypass` + +- **Vaikimisi**: `Puudub` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +See võimaldab mõlemal poolel paremat jõudlust kogeda. + +> X-Ray seadistamiseks vaadake allpool olevat lehekülge. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Vaikimisi**: `Puudub` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Vaikimisi**: `Puudub` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Vaikimisi**: `Puudub` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Vaikimisi**: `Puudub` + +Võimaldab kasutada sepikutel [MiniMessage sildid](https://docs.advntr.dev/minimessage/format.html). + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Vaikimisi**: `Puudub` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Vaikimisi**: `Puudub` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Vaikimisi**: `Puudub` + +Võimaldab mängijal jääda passiivse väljaviskamise sihtrühmast välja. + +#### `purpur.debug.f3n` + +- **Vaikimisi**: `Maailma administraator` + +Võimaldab mängijal kasutada mängurežiimi muutmiseks klahvikombinatsiooni `F3 + N`. + +See ei tööta, kui puudub vastav mängurežiimi õigus. + +#### `purpur.drop.spawners` + +- **Vaikimisi**: `Puudub` + +Kui kaevate konfigureeritud esemega spawneriploki, siis see kukub maha. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Vaikimisi**: `Puudub` + +Muudab Enderi kirstu suurust. + +`(NumberString)` võib olla `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Vaikimisi**: `Puudub` + +Võimaldab toimida surematu käsna inventaris. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Vaikimisi**: `Puudub` + +Mängijale lubatakse ignoreerida ühenduse piirangut. + +#### `purpur.mending_shift_click` + +- **Vaikimisi**: `Puudub` + +Mängijale lubatakse eseme remontimise võimaldamiseks `kummargil olles koostööd teha`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Vaikimisi**: `Puudub` + +Mängijale lubatakse paigaldada spawnereid. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Vaikimisi**: `Puudub` + +Mängijale lubatakse kohe pärast Netheri portaali kasutamist kohe teleporteeruda. + +#### `purpur.sign.color` + +- **Vaikimisi**: `Puudub` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Vaikimisi**: `Puudub` + +Luba kasutada märkide kodeerimist `(&o)` märkidele. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Vaikimisi**: `Puudub` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Vaikimisi**: `Puudub` + +Luba mängijal takistada TNT plahvatust `vastastikuse tegevusega` kääride abil. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Antud õigus tuleb. + +#### `plazma.bypass.ncr-require` + +- **Vaikimisi**: `Puudub` + +Luba mängijal ühenduda isegi kui pole paigaldatud [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) moodulit. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operaator. + +[^2]: Näide: `ender_dragon` diff --git a/et/origin/plazma/adminstration/README.md b/et/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..1913521c8 --- /dev/null +++ b/et/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Looge oma server Plazma abil. +--- + +# ⚒️ Serveri halduse juhend diff --git a/et/origin/plazma/adminstration/expert/README.md b/et/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..33a8af989 --- /dev/null +++ b/et/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Uurige, kuidas käsitleda Plazmat professionaalselt. +--- + +# 🎓 Süvendatud diff --git a/et/origin/plazma/adminstration/expert/fix-exploits.md b/et/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..2c024aa9a --- /dev/null +++ b/et/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Tutvuge teadaolevate haavatavustega ja nende lahendamise viisidega. +--- + +# ⚠️ Teadaolevad haavatavused ja nende lahendamise meetodid diff --git a/et/origin/plazma/adminstration/expert/optimize.md b/et/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..11e92614c --- /dev/null +++ b/et/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Uurige, kuidas optimeerida Plazma. +--- + +# 🧹 Optimeerimine diff --git a/et/origin/plazma/adminstration/expert/vanillaize.md b/et/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..561b22271 --- /dev/null +++ b/et/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Uurige, kuidas taastada Paper ja vanillaparandus. +--- + +# ↩️ Vanillastamine + +{% hint style="warning" %} + +### Paper ei paku valikut enamiku vanillavigade parandamiseks. + +Plazma töötab praegu selle võimaluse väljatöötamiseks, et saaks sellised vead konfigureerida. + +Seetõttu on see juhend endiselt koostamisel ja teave võib alati muutuda. +{% endhint %} diff --git a/et/origin/plazma/adminstration/faq.md b/et/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..aa7dc9d61 --- /dev/null +++ b/et/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Uurige sagedaste küsimuste kohta. +--- + +# ⁉️ Sagedased küsimused + +{% hint style="info" %} + +### Kas te ei leia soovitud vastust? + +Küsige kogukonna käest küsimusi [ametlikus Discordi serveris](https://discord.gg/MmfC52K8A8) või [GitHubi küsimustes](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Kui käivitamisel kuvatakse sõnum, siis see ei käivitu + +Kui konsoolil kuvatakse `no main manifest attribute, in plazma-(version).jar`,\ +tähendab see, et allalaaditud fail on arendusliku API-fail, peate alla laadima GitHubi lehelt **Reobf Paperweight**. + +Lisateabe saamiseks vaadake järgmist lehekülge. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Serveri käivitamisel kuvatakse hoiatus + +Plazmas on mõned ebastabiilsed parandused ja seetõttu võib alati esineda talitlushäireid, seetõttu kuvab server käivitamisel järgmise hoiatuse. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Seda hoiatust saab keelata kasutades [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] süsteemiatribuuti. + +Lisateabe saamiseks vaadake järgmist lehekülge. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Saadaval alates versioonist 1.20.1 diff --git a/et/origin/plazma/adminstration/getting-started/README.md b/et/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..72a92ac55 --- /dev/null +++ b/et/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Uurige, kuidas luua server Plazma abil. +--- + +# 👟 Alustamine + +Plazma stabiilseks kasutamiseks peab süsteem vastama järgmistele nõuetele. + +| | Miinimum | Soovitatav | +| :-----------: | -------: | ---------: | +| Arhitektuur | x64 | - | +| RAM | 8GB | 16GB | +| Salvestusruum | 1GB | 8GB | +| JRE | 17 | 21 | + +Sujuva konfiguratsioonifailide muutmise jaoks on soovitatav installida redaktorid nagu [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE installimine + +Nagu nimest nähtub, on Minecraft: **"Java"** Edition arendatud Java abil ja selle käitamiseks on vajalik JRE[^1]. + +Kuna Plazma põhineb Mojang Studiosi ametlikul serveriplatvormil [^2], tuleb Plazma kasutamiseks installida ka JRE. + +### 1.1 JRE olemasolu kontrollimine + +JRE olemasolu süsteemis saab kontrollida, sisestades ja käivitades [käsuaknas](#user-content-fn-3) [`cmd /k java --version`](#user-content-fn-4). + +Kui järgmine tulemus ilmub, liikuge [2. etappi](setup.md#id-2). + +{% code title="Õige tulemus" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Kui sellist tulemust ei kuvata või kuvatakse järgmine, siis JRE puudub või see on liiga vana ning tuleb järgida [1.2 etappi](setup.md#id-1.2). + +{% code title="JRE puudub" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE on liiga vana" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE install + +Selles juhendis kasutatakse Azul Zulu JRE ühte tüüpi. + +Pärast installimist kontrollige uuesti [1.1 samm](setup.md#id-1.1), et veenduda, kas installimine õnnestus. + +{% tabs %} +{% tab title="Windows" %} + +1. Esiteks laadige alla [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) **JDK 21** `.msi` vormingus. +2. Käivitage allalaaditud installimisviisard ja klõpsake „Edasi“. +3. **Aktiveerige menüüs „Seadke JAVA_HOME muutuja“ vasakul keskel** ja klõpsake seejärel „Järgmine“. +4. Vajutage nuppu „Install“ JRE installimiseks „Lõpeta“. + {% endtab %} + +{% tab title="macOS" %} +Laadige alla [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) **JDK 21** `.dmg` vormingus installimisviisard ja käivitage JRE installimine. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Lisage kõigepealt APT-sse Azul Zulu depoo järgmise käsu abil. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Seejärel installige JRE järgmise käsu abil terminalis. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +JRE saate installida järgmise käsu abil. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma allalaadimine + +Plazma pakub mitmesuguseid käivitatavaid faile. + +{% hint style="warning" %} + +### Enamasti kasutatakse `Reobf Paperclip`. + +Allpool olev teave on mõeldud arendajatele või neile, kes on huvitatud erinevate vormide omadustest.\ +Tavaline kasutaja võib [3. sammu](setup.md#id-3) vahele jätta ilma probleemideta. +{% endhint %} + +
+ +Lisateave + +Käivitatava faili nimi on `plazma-(versioonihaldur)-1.20.4-R0.1-SNAPSHOT-(kaardistamise vorm).jar`. + +- **Kaardistamise vorm**\ + Kaardistamine on omamoodi kaart, mis ühendab Minecrafti tegeliku koodi ja obfuskeeritud koodi. + - **Reobf**\ + Uuesti obfuskeerimine, tuntud ka kui Spigot kaardistamine, kasutatakse enamikus NMS pistikprogrammides.\ + Alates versioonist 1.20.5 lõpetatakse selle kasutamine. + - **Mojmap**\ + Mojangi kaardistamine, vanilje Minecrafti kaardistamine. +- **Versioonihaldur**\ + Versioonihaldur on serveri käivitamiseks vajalike raamatukogude ja serverifailidega pakkimise serveri käivitaja. + - **Paperclip**\ + PaperMC meeskond on välja töötanud halduri Paper ja muudele platvormidele, mis laadivad alla raamatukogud ja rakendavad serverisse plaastreid. + - **Pakendaja**\ + Vanilje Minecrafti versioonihaldur. + +
+ +*** + +## 3. Käivitusskripti loomine + +Plazma lihtsaks käivitamiseks ja serveri automaatseks taaskäivitamiseks peate looma [käivitusskripti](#user-content-fn-6). + +[Flags.sh](https://flags.sh) abil saate luua käivitusskripti.\ +Kui sisestate ainult [mälu, mida kasutada](#user-content-fn-8), optimeeritakse käsk automaatselt. + +Käivitusskripti saate alla laadida all vasakus allnurgas oleva nupu abil.\ +**Veenduge, et allalaaditud käivitusskript vastab teie operatsioonisüsteemile.** + +*** + +## 4. Failide korraldamine + +Liigutage nüüd allalaaditud käivitusskript ja Plazma uude kausta. + +{% hint style="warning" %} + +### Kausta nimi peab olema ilma tühikuteta ja olema inglise keeles. + +Muidu Plazma või JRE ei pruugi korralikult töötada. +{% endhint %} + +Käivitage nüüd käivitusskript. Windowsi korral peate tulemüürivaliku aknas kindlasti valima **Luba**. + +*** + +## 5. EULA nõustamine + +Kui käivitate käivitusskripti, luuakse kausta `eula.txt` fail. + +EULA on [Mojang Studios](#user-content-fn-10) teenuste kasutamiseks vajalik litsentsileping, millega tuleb nõustuda. + +Kui te ei nõustu EULA-ga, ei saa serverit käivitada ja EULA rikkumise korral võidakse rakendada [karistusi](#user-content-fn-11). + +EULA nõustumiseks muutke `eula=false` failis `eula=true` ja salvestage see. + +*** + +## 6. Välise ühenduse lubamine (Windows) + +Kaasaegsed operatsioonisüsteemid blokeerivad vaikimisi välise juurdepääsu tulemüüri ja ruuteriga. + +Windowsi korral, kuna tulemüür on lubatud [3. etapis](setup.md#id-3), piisab ainult portide edastamisest. + +{% hint style="info" %} + +### Käesolevas juhendis eeldatakse, et kasutate Windowsi operatsioonisüsteemi ja [**UPnP**](#user-content-fn-12) võimaldavat ruuterit. + +Kui ruuter ei toeta UPnP-d, siis iga ruuteri paneel on erinev ja peate ise otsima teavet. + +Samuti võite kasutada [Ngrok](https://ngrok.com/), et luua ajutine aadress. +{% endhint %} + +{% hint style="warning" %} + +### Linuxi või macOS-i ja muude (pool) UNIX-i süsteemide korral tuleb iga tulemüüri teenuse jaoks seadistusmeetodid erineda, seega peate ise otsima teavet. + +{% endhint %} + +### 6.1 Portide edastamise vajaduse kontrollimine + +Sisestage ja käivitage järgmine käsk käivitusaknas. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Kui väljund on `True`, võite siin lõpetada, kuid kui see on `False`, peate seadistama portide edastamise. + +### 6.2 Ühendus serveriga + +{% tabs %} +{% tab title="Väliselt ühendamine" %} +Kui portide edastamine pole vajalik või kui olete juba portide edastamise edukalt seadistanud, saate nüüd serveriga ühendust võtta. + +Serveriga ühenduse loomisel kasutatav aadress on võimalik kontrollida [siin](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP kaudu portide edastamise katse" %} +Muutke serveri kaustas `purpur.yml` `network.upnp-port-forwarding` väärtus `true`-ks. + +Seejärel taaskäivitage server, et Plazma prooviks automaatselt portide edastamist. + +Allpool on toodud UPnP edukuse kontrollimiseks konsoolile kuvatavad sõnumid, konsoolis kuvatakse `[UPnP] (sõnum)`. + +| Sõnum | Tähendus | +| ---------------------------------- | ----------------------------------- | +| `Port (port) edukalt avatud` | Portide edastamine õnnestus. | +| `Port (port) on juba avatud` | Muu teenus kasutab seda porti juba. | +| `Porti (port) ei õnnestunud avada` | Portide edastamine ebaõnnestus. | +| `Teenus pole saadaval` | Ruuter ei toeta UPnP-d. | + +Kui server peatub, sulgeb Plazma automaatselt pordid. +{% endtab %} + +{% tab title="Ngrokiga ajutise aadressi loomine" %} +Ngrok on kasulik lühiajaliste testide, kogukondlike mängude või sõpradega mängimise jaoks. + +1. Laadige alla [Ngrok veebisaidilt](https://ngrok.com/download) `Windows (64-bit)` ZIP-fail. +2. Pange allalaaditud Ngrok serveri kausta. +3. Looge [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) jaoks [autentimistoken](#user-content-fn-13). +4. Käivitage serveri kaustas kuvatav käsk käsureal. +5. Lisage käivitusskripti ülaossa `start /b ngrok tcp --region jp 25565`, allosas `taskkill /f /t /im ngrok.exe`. +6. Konsooli ülaosas kuvatud `Edastamine tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` korral on serveri aadressiks `0.tcp.jp.ngrok.io:12345`. +7. Nüüd saate selle aadressi kaudu väljastpoolt ühendust luua. + {% endtab %} + +{% tab title="Lokaalne ühendus" %} +Kui soovite serveriga ühendust luua kohalikult, saate käsurealt käivitada `cmd /k ipconfig` ja kasutada väljundis kuvatud `IPv4 aadressi` ühenduse loomiseks. + +Näiteks, kui käivitamisel kuvatakse järgmine väljund, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Siis proovige ühendada kohalikult serveriga, kasutades IPv4 aadressil näidatud `192.168.3.7`. + +Kui server ja mäng töötavad samal arvutil, saate ühenduda aadressil `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Edasimineku etapp + +Kui server on edukalt käivitatud ja töötab korralikult, on aeg seda kasutajapõhiseks muuta. + +Tutvuge alloleva juhendiga, kuidas serverit kohandada. + +{% content-ref url="customization.md" %} +[kohandamine.md](kohandamine.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java käitamiskeskkond. + +[^2]: Plazma baasil paber kasutab Spigot'i ja Spigot tugineb ametlikule serveri platvormile. + +[^3]: Windowsi klahv + R + +[^4]: Linuxi puhul käsurealt `java --version` + +[^5]: JRE on üks avatud lähtekoodiga projektidest ja sarnaselt Minecrafti serveri platvormiga on mitmeid erinevaid versioone. + +[^6]: Tavaliselt tuntakse seda **käivitajana**. + +[^7]: Kui aktiveerite „Automaatse taaskäivituse“, taaskäivitatakse server automaatselt. Väljumiseks sisestage `Control + C`. + +[^8]: Soovitatav ei ole süsteemi üle poole koormata. + + Näiteks, kui süsteemi kogumälu maht on 8 GB, siis ei soovitata seda seada üle 4 GB. + +[^9]: Lõppkasutaja litsentsileping, lõppkasutaja litsentsileping. Lisateabe saamiseks vaadake [Minecrafti kodulehte](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Kui tegemist on Lõuna-Korea mängutööstuse edendamise seaduse § 32 lõike 1 punktiga 9, siis on võimalik esitada õiguslik kaebus **Korea Microsoft Corporation** vastu. + +[^12]: Universaalne pistik & mängi. Plazma'ga lisatud Purpur suhtleb automaatselt ruuteriga selle tehnoloogia abil, avades pordi ainult siis, kui server töötab, nii et pole vaja otse portide edastamist teha. + +[^13]: Kui teil pole kontot, registreeruge Ngrokis Google'i või GitHubi konto kaudu. diff --git a/et/origin/plazma/adminstration/getting-started/customization.md b/et/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..ea0e5cd15 --- /dev/null +++ b/et/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Uurige, kuidas kohandada serverit kasutaja vajadustele vastavaks. +--- + +# 🎨 Kasutaja kohandamine diff --git a/et/origin/plazma/adminstration/reference/arguments.md b/et/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..f50beddd1 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Uurige algust ja süsteemi atribuute. +--- + +# 🎛️ Algused ja atribuudid + +Algusmuutujad ja süsteemi atribuudid on väärtused, mis lisatakse [kasutatavatele käskudele](#user-content-fn-1)[^1] Plazma käivitamisel,\ +võimaldades muuta muutumatuid väärtusi pärast Plazma käivitamist. + +Sõltuvalt [käsu lisamise kohast](#user-content-fn-2)[^2] jagunevad **algusmuutujad** ja **süsteemi atribuudid**. + +*** + +## Süsteemi atribuudid + +Süsteemi atribuudid sisestatakse `-jar` ette ja töödeldakse JVM poolt enne Plazma alglaadimist. + +{% hint style="warning" %} + +### Süsteemi atribuutide muutmisel võib muutuda Plazma ja JVM käitumine ning see võib mõjutada mängu suuresti! + +Kui te ei tea täpselt, millist rolli iga süsteemi atribuut täidab, siis **ärge kasutage seda kunagi!** +{% endhint %} + +### Kasutusjuhend + +Süsteemi atribuudid sisestatakse Java käsu argumendina `java` ja `-jar` vahel. + +Näiteks kui soovite rakendada `Plazma.dummyProperty` süsteemi atribuuti,\ +siis sisestage järgmine väärtus ja järgmine atribuut sisestatakse `37` ja Plazma alglaadimisel algväärtuseks. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` tähistab, et see argument pole JVM-is sisse ehitatud, vaid lisatud eraldi Plazma jaoks, + +kui väärtust ei sisestata, siis väärtus [`true`ks fikseeritakse.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight seeria serveriplatvormidel on süsteemi atribuutide eristamiseks igal platvormil atribuudi nimes punkt sees. + +Mõnedes terminalides, nagu Windows Powershell, võib selliseid argumente mitte lubada, seega tuleb argumentide mõlemale otsale lisada `"`. + +### Kogu süsteemi atribuudid + +#### `convertLegacySigns` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Uuendab kasutusel mitte olevaid märgistusi. + +#### `debug.entities` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab sisse seotud entiteedi teabe silumise. + +#### `debug.rewriteForIDE` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Võimaldab IDE-l korralikult lugeda silumisinfot, keelates NMS revisiooni ja automaatselt ümberkaardistades sisemise versiooni info. + +#### `disable.watchdog` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab välja Spigoti valvekoera hoiatussüsteemi. + +#### `letMeReload` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab `/reload` käsu uuesti laadimise kinnitussõnumi. + +{% hint style="danger" %} + +### Kuna `/reload` käsk on väga ebastabiilne, siis kõik probleemid pärast `/reload` kasutamist on kasutaja enda vastutusel. + +Kui olete pistikprogrammi arendaja ja peate pistikprogrammi uuendama, siis kasutage `hotswap` asemel `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab pistikprogrammi, mis kasutab standardset sisend-väljund süsteemi. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Hoiatab, kui kasutusel on lõpetatud vormingud vestluse komponentides. + +#### `Paper.bypassHostCheck` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab serveri mustri sobitamise kontrolli, kui mängija serveriga ühendust loob. + +#### `Paper.debugDynamicMissingKeys` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Aktiveerib tõrkeotsingu logi puuduvate NBT võtmete kohta. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Aktiveerib tõrkeotsingu logi valede koljuprofiilide kohta. + +See logib kõik valesti paigutatud koljuprofiilid asukohaga ja maailmas. + +#### `Paper.disableChannelLimit` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab 128 pistikprogrammi kanali piirangu mängija kohta. + +#### `Paper.disableClassPrioritization` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab pistikprogrammi klassi prioriteedi süsteemi. + +Kasulik probleemide korral pistikprogrammi varjundiga. + +#### `Paper.disableFlushConsolidate` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab Netty loputamise konsolideerimise süsteemi. + +#### `Paper.excessiveTELimit` + +- **Tüüp**: `Integer` +- **Vaikimisi väärtus**: `750` + +Juhul, kui entiteete on rohkem kui määratud väärtus, jagatakse need mitmeks paketiks edastamiseks. + +#### `Paper.filterThreshold` + +- **Tüüp**: `Integer` +- **Vaikimisi väärtus**: `8192` + +Määrab serveri vastuvõetavate maksimaalsete paketi suuruse. + +#### `Paper.ignoreJavaVersion` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Keelab Java versiooni kontrolli. + +{% hint style="danger" %} + +### See võib põhjustada JVM-i juurdepääsu mitteeksisteerivale koodile! + +See võib püsivalt kahjustada maailma ja üldiselt faile ning mängu mehaanikat rikkuda. + +Kõik sellest tulenevad probleemid on teie enda vastutusel ja Plazma ei paku sellele mingit tuge. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tüüp**: `Integer` +- **Vaikimisi väärtus**: `64` + +Määrab pistikprogrammi kanali[^6] nime piirangu. + +#### `Paper.maxSignLength` + +- **Tüüp**: `Integer` +- **Vaikimisi väärtus**: `80` + +Määrab märgi maksimaalse pikkuse ühes reas. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tüüp**: `Integer` +- **Vaikimisi väärtus**: `(maailma versioon) + 1` + +Määrab algse maailma uuendusteabe versiooni. + +Kasutatakse peamiselt massiliste tükkide värskenduste korral, kuid muul juhul pole vajalik. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `True` + +Lülitab sisse YAML failide kommentaaride töötlemise. + +#### `Paper.playerConnection.keepAlive` + +- **Tüüp**: `Integer` +- **Vaikimisi väärtus**: `30` + +Kui mängijalt pole määratud aja jooksul (sekundites) saadud andmeid, siis mängija välja visatakse. + +Tavaliselt saadab mäng [jätkuvalt serverisse](#user-content-fn-8)[^8] südamelöögisignaale, nii et [ei visata välja,](#user-content-fn-9)[^9] kuid kui mäng ei vasta, siis loetakse kokkupõrkeks ja mängija visatakse välja. + +#### `Paper.skipServerPropertiesComments` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Ignoreerib serveri omaduste kommentaare. + +#### `Paper.debug-sync-loads` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab sisse sünkroonse tüki laadimise silumise. + +#### `Paper.enable-sync-chunk-writes` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab sisse Minecrafti [vaikimisi tüki kirjutamise süsteemi](#user-content-fn-10)[^10]. + +See salvestab iga tüki järjestikku, mis põhjustab märkimisväärset jõudluse langust. + +#### `Paper.explicit-flush` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Lülitab võrgukanali selgeks loputamise. + +#### `Paper.strict-thread-checks` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Logib alati peamises lõimes esinenud vigu. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Hoiatab, kui planeeritud ülesannetel on liiga suur viivitus. + +#### `Paperclip.patchOnly` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `False` + +Kui kasutatakse vaikimisi käivitusfaili, rakendatakse ainult paigaldus ilma serveri käivitamiseta. + +#### `Plazma.aggressiveOptimize` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` + +{% hint style="warning" %} + +### See atribuut liigub alates versioonist 1.20.5 algusparameetritesse. + +{% endhint %} + +Rakendab algseid optimeerimisi rangemalt esimese käivitamise ajal. + +Kui aktiveerite, muutub server kiiremaks ja turvalisemaks, kuid see võib blokeerida mõned mehaanikad või mõjutada oluliselt mängimist. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` + +Pärssib hoiatusteksti[^11], mis ilmub Plazma lähtestamisel. + +### Kasutatud omadus on lõpetatud + +Allpool olevad süsteemi omadused on lõpetatud + +#### `timings.bypassMax` + +- **Tüüp**: `Boolean` +- **Vaikimisi väärtus**: `false` +- **Kasutamise lõpetatud**: Timings on Plazmas eemaldatud alates esipaneeli eemaldamisest + +Otsustab, kas võib ületada Aikari Timings API-sse saadetavate väärtuste maksimumi + +Kui API-s erinditöötlust pole, rakendatakse viivituse piirangut + +*** + +## Algusargumendid + +Algusargumendid sisestatakse `-jar *.jar` järel, et Plazma saaks alglaadimise ajal neid töödelda + +### Kasutusjuhend + +Süsteemi omadused sisestatakse `-jar *.jar` järel programmi käsureana + +Näiteks kui soovite rakendada `nogui` algusargumendina,\ +siis järgmiselt sisestades töötleb Plazma alglaadimise ajal `nogui` argumendi + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Kogu algusargumendid + +#### `bukkit-settings` + +- **Lühend**: `b` +- **Vaikimisi väärtus**: `bukkit.yml` + +Määrab Bukkiti seadistusfaili nime ja asukoha + +#### `command-settings` + +- **Lühend**: `c` +- **Vaikimisi väärtus**: `commands.yml` + +Määrab Bukkiti käskude seadistusfaili nime ja asukoha + +#### `config` + +- **Lühend**: `c` +- **Vaikimisi väärtus**: `server.properties` + +Määrab serveri omaduste faili nime ja asukoha + +#### `demo` + +Alustab serverit demomaailmaga + +#### `eraseCache` + +Eemaldab pärast maailma värskendamist allesjäänud vahemälu failid + +#### `forceUpgrade` + +Eirab versiooni ja sunnib maailma [värskendama](#user-content-fn-12)[^12] + +#### `help` + +- **Lühend**: `?` + +Väljastab Plazma kõik algusargumendid ja selgitused + +#### `initSettings` + +Loo ainult konfiguratsioonifail ja sulge server + +#### `jfrProfile` + +Lülitab sisse JFR-profiliseerimise + +#### `max-players` + +- **Lühend**: `s`, `size` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Määrab lubatud maksimaalse [mängijate](#user-content-fn-14)[^14] arvu + +#### `nogui` + +Keelab graafilise kasutajaliidese paneeli + +#### `nojline` + +Keelab JLine'i ja kasutab tavakonsooli + +#### `online-mode` + +- **Lühend**: `o` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Valib, kas autentida mängijad Mojangi autentimisserveris + +**Kui ei kasutata Velocity ega muid proksiservereid, võib see viia [EULA](../getting-started/README.md#id-5) rikkumiseni.** + +#### `paper-settings` + +- **Lühend**: `paper` +- **Vaikimisi väärtus**: `paper.yml` + +{% hint style="warning" %} + +### See argument on pärast 1.19.4 kasutamist lõpetanud + +{% endhint %} + +Määrab kasutatava PaperSpigoti konfiguratsioonifaili asukoha + +Seda kasutatakse varasema seadistuse uude faili migreerimiseks ja seejärel enam ei kasutata + +#### `paper-settings-directory` + +- **Lühend**: `paper-dir` +- **Vaikimisi väärtus**: `config` + +Määrab Paperi konfiguratsioonifailide kausta nime ja asukoha + +#### `plazma-settings-directory` + +- **Lühend**: `plazma-dir` + +Määrab Plazma konfiguratsioonifailide kausta nime ja asukoha + +#### `plugins` + +- **Lühend**: `p` +- **Vaikimisi väärtus**: `plugins` + +Määrab pistikprogrammide kausta asukoha + +#### `pufferfish-settings` + +- **Lühend**: `pufferfish` +- **Vaikimisi väärtus**: `pufferfish.yml` + +Määrab Pufferfishi konfiguratsioonifaili nime ja asukoha + +#### `purpur-settings` + +- **Lühend**: `purpur` +- **Vaikimisi väärtus**: `purpur.yml` + +Määrab Purpuri konfiguratsioonifaili nime ja asukoha + +#### `safeMode` + +Alustab serverit täielikult tavalises olekus + +#### `server-ip` + +- **Lühend**: `h`, `host` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Määrab serveri hostinime või [Interneti protokolli](#user-content-fn-13)[^13] aadressi + +#### `server-port` + +- **Lühend**: `p`, `port` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Määrab serveri pordi + +#### `server-name` + +- **Vaikimisi väärtus**: `A Plazma Server` + +Määrab serveri nime + +#### `spigot-settings` + +- **Lühend**: `S` +- **Vaikimisi väärtus**: `spigot.yml` + +Määrab Spigoti seadistusfaili nime ja asukoha + +#### `version` + +- **Lühend**: `v` + +Väljastab Plazma versiooni + +#### `world-dir` + +- **Lühend**: `W`, `universe`, `world-container` +- **Vaikimisi väärtus**: `(serveri kaust)` + +Määrab, kuhu salvestatakse maailma failid + +#### `world-name` + +- **Lühend**: `w`, `world` +- **Vaikimisi väärtus**: `(serveri omadus)` + +Määrab maailma faili nime + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Sõltuvalt lisatud asukohast muutub argumendi töötlemise asukoht + +[^3]: Näiteks kui soovite seadistada `Plazma.iKnowWhatIAmDoing` väärtuseks `true`, siis töötab sama moodi, kui sisestate ainult `-DPlazma.iKnowWhatIAmDoing` asemel `-DPlazma.iKnowWhatIAmDoing=true` + +[^4]: Näiteks, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Sündmuse tuvastaja. + +[^6]: Sündmuse tuvastaja. + +[^7]: Klient. + +[^8]: Signaal, mis teavitab serveri ja kliendi normaalsest ühendusest nagu südamelöök. + +[^9]: Purpuri AFK väljaviskamise funktsiooni abil saate välja visata ka mängija, kes on lahkunud. + +[^10]: Sync Chunk Write System, süngroonse tüki kirjutamise süsteem. + +[^11]: `HOIATUS! Plazma võib põhjustada ootamatuid probleeme, seega veenduge, et testite seda põhjalikult enne selle kasutamist avalikul serveril.` + +[^12]: Mängus `maailma optimeerimine` toimib samal põhimõttel. + +[^13]: Interneti protokoll, IP. + +[^14]: `Tase 2` või kõrgemad administraatorid on välja arvatud. diff --git a/et/origin/plazma/adminstration/reference/commands.md b/et/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..b25763e2c --- /dev/null +++ b/et/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Tutvuge Plazma saadaval olevate käskudega. +--- + +# 🖥️ Käsud diff --git a/et/origin/plazma/adminstration/reference/configurations/bukkit.md b/et/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..15e55afe3 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga bukkit.yml sõlm tähendab. +--- + +# 🪣 Bukkit diff --git a/et/origin/plazma/adminstration/reference/configurations/paper/README.md b/et/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..d641db907 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mis on iga faili config kaustas otstarve. +--- + +# 🛩️ Paber diff --git a/et/origin/plazma/adminstration/reference/configurations/paper/global.md b/et/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..d9d308254 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga paper-global.yml sõlm tähendab. +--- + +# 🛩️ Paber (globaalne seadistus) diff --git a/et/origin/plazma/adminstration/reference/configurations/paper/world.md b/et/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..ff9ace446 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga paper-world.yml sõlme tähendab. +--- + +# 🛩️ Paber (maailma tasandil koosseis) diff --git a/et/origin/plazma/adminstration/reference/configurations/plazma/README.md b/et/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..ac7dabd31 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mis on iga faili config kaustas otstarve. +--- + +# ✨ Plazma diff --git a/et/origin/plazma/adminstration/reference/configurations/plazma/global.md b/et/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..4a1e2bc79 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida tähendab iga plazma-global.yml sõlm. +--- + +# ✨ Plazma (globaalne seadistus) diff --git a/et/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/et/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..6eae65f92 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Maailma tasandil koosseis diff --git a/et/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/et/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..05c449292 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga plazma-world.yml sõlme tähendab. +--- + +# ✨ Plazma (maailmade koosseis) diff --git a/et/origin/plazma/adminstration/reference/configurations/property.md b/et/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..9bc6bc30f --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga server.properties sõlm tähendab. +--- + +# 🪨 Server.properties diff --git a/et/origin/plazma/adminstration/reference/configurations/pufferfish.md b/et/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..a391b61ec --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida iga pufferfish.yml sõlme tähendab. +--- + +# 🐡 Pufferfish diff --git a/et/origin/plazma/adminstration/reference/configurations/purpur/README.md b/et/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fbdc7261f --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga purpur.yml sõlm tähendab. +--- + +# 🦑 Purpur diff --git a/et/origin/plazma/adminstration/reference/configurations/purpur/global.md b/et/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..93a71c181 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga purpur.yml sõlm tähendab. +--- + +# 🦑 Purpur (üldine koosseis) diff --git a/et/origin/plazma/adminstration/reference/configurations/purpur/world.md b/et/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..5f85fe686 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Vaadake, mida iga purpur.yml sõlm tähendab. +--- + +# 🦑 Purpur (maailma koosseis) diff --git a/et/origin/plazma/adminstration/reference/configurations/spigot.md b/et/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..8f378d59e --- /dev/null +++ b/et/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Uurige, mida tähendab iga spigot.yml sõlme. +--- + +# 🚰 Spigot diff --git a/et/origin/plazma/adminstration/reference/permissions.md b/et/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..54cb9af25 --- /dev/null +++ b/et/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Uurige Plazma õigusi. +--- + +# 🛡️ Õigused diff --git a/et/origin/plazma/developers.md b/et/origin/plazma/developers.md new file mode 100644 index 000000000..ebb1033ad --- /dev/null +++ b/et/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Arendage kolmanda osapoole projekt Plazma abil välja. +--- + +# ⚙️ Arendaja juhend diff --git a/et/origin/thunderbolt/README.md b/et/origin/thunderbolt/README.md new file mode 100644 index 000000000..9dcbd4df6 --- /dev/null +++ b/et/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt on eksperimentaalne plaaster, mis eristab maitse järgi, võimaldades otse kasutada Plazma-põhist serveriplatvormi. +--- + +# 🌩️ Thunderbolti kasutusjuhend diff --git a/et/origin/volt/README.md b/et/origin/volt/README.md new file mode 100644 index 000000000..3dd2bd864 --- /dev/null +++ b/et/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt on avatud lähtekoodiga mall, mis võimaldab teil arendada oma Paperweight serveriplatvormi Plazma baasil. +--- + +# ⚡ Volti arendusjuhend diff --git a/ew/origin/README.md b/ew/origin/README.md new file mode 100644 index 000000000..4dd494e48 --- /dev/null +++ b/ew/origin/README.md @@ -0,0 +1,41 @@ +--- +description: If you have any questions, please ask them through Discord or GitHub Discussions. +--- + +# 🏠 Welcome to Docs Portal + +{% hint style="info" %} + +**The document of Plazma is currently in a machine-translated state.** + +[![번역 상태](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Participate in document translation at [https://translate.plazmamc.org/](https://translate.plazmamc.org/) to improve the documents. + +{% endhint %} + +### If you encounter any issues while using Plazma, what should you do? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### If you are interested in Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### If you want to create your own server platform with Volt, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` If you need more information about Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ew/origin/SUMMARY.md b/ew/origin/SUMMARY.md new file mode 100644 index 000000000..62b5452c9 --- /dev/null +++ b/ew/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Table of contents + +- [🏠 Welcome to Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Usage Docs](plazma/README.md) +- [❓ What is Plazma?](plazma/about/README.md) + - [⬇️ Download](plazma/about/downloads.md) + - [✅ Version Support Status](plazma/about/supported-versions.md) +- [⚒️ Server Management Guide](plazma/administration/README.md) + - [👟 Getting Started](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Reference](plazma/administration/reference/README.md) + - [🖥️ Commands](plazma/administration/reference/commands.md) + - [🛡️ Permissions](plazma/administration/reference/permissions.md) + - [🎛️ Arguments and Properties](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Property](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ World Configurations](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ World Configurations](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global Configuration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ World Configurations](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Advanced](plazma/administration/expert/README.md) + - [🧹 Optimization](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blocking](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilities and Fixes](plazma/administration/expert/fix-exploits.md) + - [⁉️ Frequently Asked Questions](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Developer Guide](plazma/developers.md) + - [✏️ Contribute](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Usage Guide](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Development Guide](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ View All Downloads](plazma/about/downloads-all.md) diff --git a/ew/origin/miscellaneous/README.md b/ew/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ew/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ew/origin/plazma/README.md b/ew/origin/plazma/README.md new file mode 100644 index 000000000..af600055c --- /dev/null +++ b/ew/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma is an open source server platform for Minecraft: Java Edition that adds experimental optimization based on paper and customization features using various game mechanisms." +--- + +# ✨ Plazma Usage Docs + +## 👋 Welcome to Plazma Docs + +Welcome to the Plazma Usage Docs! + +{% hint style="info" %} + +**Can't solve the problem through the manual?** + +Ask the community questions through the [official Discord server](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### About Plazma + +> Learn about what Plazma server platform is. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### For Administrators + +> Create your own server using Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### For Developers + +> Develop third-party projects using Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ew/origin/plazma/about/README.md b/ew/origin/plazma/about/README.md new file mode 100644 index 000000000..abda66c10 --- /dev/null +++ b/ew/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Learn about what Plazma server platform is. +--- + +# ❓ What is Plazma? + +- **Plazma** is a server platform based on [Paper](https://github.com/PaperMC/Paper) that takes only the advantages of [Andromeda](https://github.com/EarendelArchived/Andromeda) and [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- We are always striving to provide high stability, powerful performance, fast updates, and extensive features. + +## 📋 Goals of Plazma + +- We are working hard to become a server platform with fast updates and high stability. +- We are striving to provide extensive features and powerful performance comparable to mod platforms. +- We are working towards creating a free platform that allows customization of vanilla patches. + +## ⚙️ Key Features + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Fastest updates**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ensures that Plazma's included patches are always kept up to date, providing the fastest updates among Paper-based server platforms. +6. **Optimized default configuration files**\ + The default configuration files are optimized, eliminating the need for manual optimization. +7. **Systematically functioning multithreading**\ + Asynchronously synchronizing system mechanisms unrelated to game mechanics to reduce [latency](#user-content-fn-4)[^4] and optimize the server. +8. **Blocking unnecessary space usage**\ + Consolidating data with similar values reduces memory usage. + +## ✨ Use Cases + +- **Platform Handling Complex Plugins Correctly**\ + Plazma is used on developer [IPECTER](https://github.com/IPECTER)'s server.\ + With its own plugins that work with NMS and reflection, and a large number of complex and extensive data packs applied,\ + it can handle over 100 players without performance degradation. +- **Maintaining Fast Performance on RPG Servers**\ + Stably maintaining 100 players on a single cluster without TPS drops, and allowing a total of 250 players to play comfortably on 4 clusters. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platform chosen by many streamers**\ + Chosen as the bucket for viewer participation by many streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +You can download Plazma from the page below. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Want to know more about version support? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugins, and Paper, Pufferfish, Purpur plugins. + +[^2]: Below Microsoft Corporation. + +[^3]: Disabling the chat reporting system ensures that chat is processed only on the server, preventing Mojang's chat tracking. + +[^4]: The system mechanism temporarily pauses the game to operate. diff --git a/ew/origin/plazma/about/downloads-all.md b/ew/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..983862191 --- /dev/null +++ b/ew/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: View full download of Plazma executable file +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ew/origin/plazma/about/downloads.md b/ew/origin/plazma/about/downloads.md new file mode 100644 index 000000000..c28089016 --- /dev/null +++ b/ew/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Download Plazma now and try it out yourself. +--- + +# ⬇️ Download + +#### Want to know more about version support? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**The download below is an executable file for general users.** + +If you are a developer and need a different type of file, please refer to the page below. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionDownload
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Download +
1.20.1 + Download +
1.19.4 + Download +
+ +*** diff --git a/ew/origin/plazma/about/patches-list.md b/ew/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..0eb2a2bce --- /dev/null +++ b/ew/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Check out all the features added to Plazma. +--- + +# 📑 Included patches diff --git a/ew/origin/plazma/about/supported-versions.md b/ew/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..0fd19f4c7 --- /dev/null +++ b/ew/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Check out the Minecraft: Java Edition versions supported by Plazma." +--- + +# ✅ Version Support Status + +{% hint style="info" %} + +**Plazma has been developed since 1.19.4, and versions below 1.19.4 are not being developed.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Waiting%20for%20Release +[idv]: +[atv]: https://badge.plazmamc.org/2/Supported +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/No%20information +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Waiting for release][wtr] ![In development][idv] ![Supported][atv] ![Function support discontinued][fse] ![Support ended][eol] + +| Version | Stability and feature support | Build Status | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ew/origin/plazma/administration/README.md b/ew/origin/plazma/administration/README.md new file mode 100644 index 000000000..7fc6ef388 --- /dev/null +++ b/ew/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Create your own server using Plazma. +--- + +# ⚒️ Server Management Guide diff --git a/ew/origin/plazma/administration/diagnosis/README.md b/ew/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..02f1b199d --- /dev/null +++ b/ew/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Learn how to deal with problems when they occur. +--- + +# 🧾 진단 diff --git a/ew/origin/plazma/administration/diagnosis/plugins.md b/ew/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..acc5bc30a --- /dev/null +++ b/ew/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Find out how to resolve when the plugin is not working properly. +--- + +# 📜 플러그인 diff --git a/ew/origin/plazma/administration/expert/README.md b/ew/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..619026757 --- /dev/null +++ b/ew/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Learn about how to professionally handle Plazma. +--- + +# 🎓 Advanced diff --git a/ew/origin/plazma/administration/expert/fix-exploits.md b/ew/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..515ad4ab1 --- /dev/null +++ b/ew/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Learn about known vulnerabilities and how to fix them. +--- + +# ⚠️ Known vulnerabilities and solutions diff --git a/ew/origin/plazma/administration/expert/optimize.md b/ew/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..9428ce44f --- /dev/null +++ b/ew/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Learn how to optimize Plazma. +--- + +# 🧹 Optimization diff --git a/ew/origin/plazma/administration/expert/proxy.md b/ew/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..5917d2d30 --- /dev/null +++ b/ew/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Learn how to securely configure the proxy platform "Velocity". +--- + +# 🔀 Proxy diff --git a/ew/origin/plazma/administration/expert/vanillaize.md b/ew/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..1b4357337 --- /dev/null +++ b/ew/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Learn how to restore the patch of Paper and Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper does not provide options in most patches that fix Vanilla errors.** + +Currently, Plazma is developing a configuration to disable such error fixes. + +Therefore, this guide is still being written and the information is subject to change at any time. + +{% endhint %} diff --git a/ew/origin/plazma/administration/expert/xray.md b/ew/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..e1907f207 --- /dev/null +++ b/ew/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Learn about various built-in methods to block X-Rays. +--- + +# 🩻 X-Ray Block diff --git a/ew/origin/plazma/administration/faq.md b/ew/origin/plazma/administration/faq.md new file mode 100644 index 000000000..ff69260bd --- /dev/null +++ b/ew/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Check out frequently asked questions. +--- + +# ⁉️ Frequently Asked Questions + +{% hint style="info" %} + +**Can't find the answer you're looking for?** + +Ask the community questions through the [official Discord server](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma does not start + +If `no main manifest attribute, in plazma-(version).jar` is displayed in the console,\ +the downloaded file is a development API file, and you should download **Reobf Paperweight** from the GitHub page. + +Refer to the following page for more details. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### A warning is displayed every time the server starts + +Plazma contains some unstable patches and may always malfunction, so the server displays the following warning when it starts. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +This warning can be disabled using the [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +Refer to the following page for more details. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available from 1.20.1 diff --git a/ew/origin/plazma/administration/getting-started/README.md b/ew/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..0e6cf292c --- /dev/null +++ b/ew/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Learn how to create a server with Plazma. +--- + +# 👟 Getting Started + +To use Plazma stably, the system must meet the following requirements: + +| | Minimum | Recommended | +| :-----------: | ------- | ----------- | +| Architecture | x64 | - | +| RAM | 8GB | 16GB | +| Storage Space | 1GB | 8GB | +| JDK | 17 | 21 | + +For smooth configuration file editing, it is also good to install an editor like [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Correct output" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' is not recognized as an internal or external command, +operable program or batch file. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. First, download **JDK 21** in `.msi` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Run the downloaded installation wizard and click `Next`. +3. After activating `Set JAVA_HOME variable` in the menu displayed in the middle left of the window, click `Next`. +4. Press `Install` to complete the JRE installation. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, install JRE by running the following command in the terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma provides various types of executable files. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Learn more + +The name of the executable file is determined as `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping Type**\ + Mapping is a kind of map that connects the actual code of Minecraft with the obfuscated code. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, the vanilla Minecraft mapping. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + The version manager can be considered as a launcher for the server, which is necessary for running the server and patching server files. + - **Paperclip**\ + Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server. + - **Bundler**\ + The vanilla Minecraft version manager. + +
+ +*** + +## 3. Creating a Startup Script + +To easily start Plazma and automatically restart the server, you need to create a [startup script](#user-content-fn-6). + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +You can download the startup script by clicking the bottom left download button.\ +**Make sure the downloaded startup script matches your operating system.** + +*** + +## 4. File Organization + +Now, move the downloaded startup script and Plazma to a new folder. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Now, run the startup script. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Agreement + +Once you run the startup script, a `eula.txt` file will be generated in the folder. + +EULA[^9] is a license agreement that must be agreed upon by using the services of [Mojang Studios](#user-content-fn-10). + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +To agree to the EULA, change `eula=false` to `eula=true` in the `eula.txt` file and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operating systems block external access by default using **Firewalls** and **Routers** to prevent dangerous access from outside. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +If the router does not support UPnP, you need to search for information yourself as different routers have different panels. + +Alternatively, you can also generate a temporary address using [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Check the Need for Port Forwarding + +Enter the following in the execution window and run it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output is `True`, you can finish here, but if it is `False`, you need to set up port forwarding. + +### 6.2 Connect to the Server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +The address to use when connecting to the server can be checked [here](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Then, when you restart the server, Plazma will automatically attempt port forwarding. + +The success of UPnP will be based on the message output on the console, which will be displayed as `[UPnP] (message)`. + +| Message | Meaning | +| --------------------------------- | -------------------------------------------------- | +| `Successfully opened port (port)` | Port forwarding successful. | +| `Port (port) is already open` | Another service is using the port. | +| `Failed to open port (port)` | Port forwarding failed. | +| `Service is unavailable` | The router does not support UPnP. | + +When the server is shut down, Plazma automatically closes the port. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Download the `Windows (64-bit)` ZIP file from [Ngrok website](https://ngrok.com/download). +2. Put the downloaded Ngrok into the server folder. +3. Generate an authentication token from [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) as mentioned in [footnote 13](#user-content-fn-13). +4. Run the command displayed in the `Command Line` at the top of the execution script in the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top and `taskkill /f /t /im ngrok.exe` at the bottom of the execution script. +6. At the top of the console, the address `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` indicates that `0.tcp.jp.ngrok.io:12345` is the server address. +7. Now you can connect from outside using this address. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +For example, when the following is displayed after running the command, + +```log +Windows IP Configuration + +Ethernet Adapter Ethernet: + + Connected DNS Suffix. . . . : + IPv4 Address. . . . . . . . : 192.168.3.7 + Subnet Mask . . . . . . . . : 255.255.255.0 + Default Gateway . . . . . . : 192.168.3.1 + +``` + +You can connect to the server from your local machine by attempting to connect to the `192.168.3.7` displayed in the IPv4 address. + +If the server and the game are running on the same PC, you can connect using `localhost`. +{% endtab %} +{% endtabs %} + +## 7. To develop + +If you have successfully started the server and it is running correctly, it is now time to customize the server. + +Learn how to customize the server through the following guide. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, based on Plazma, is based on Spigot, which is based on the official server platform. + +[^3]: Windows key + R + +[^4]: For Linux, use `java --version` in the terminal. + +[^5]: JRE is one of the open-source projects, like Minecraft server platforms, there are various types. + +[^6]: It is commonly known as a **launcher**. + +[^7]: Enabling "Auto-restart" will automatically restart the server. You can exit by entering `Control + C`. + +[^8]: It is not recommended to exceed more than half of the system's capacity. + + For example, when the total system memory capacity is 8GB, it is not recommended to set it above 4GB. + +[^9]: End-User License Agreement, EULA. For more information, please check the [Minecraft website](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: In the case of South Korea, according to Article 32, Paragraph 1, Item 9 of the Game Industry Promotion Act, legal action can be taken by **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur included in Plazma automatically communicates with the router through this technology, so there is no need to directly forward ports as the server only opens ports when it is running. + +[^13]: If you do not have an account, sign up for Ngrok using your Google or GitHub account. diff --git a/ew/origin/plazma/administration/getting-started/customization.md b/ew/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..19d1bcde0 --- /dev/null +++ b/ew/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,124 @@ +--- +description: Learn how to customize the server. +--- + +# 🎨 Customization + +The reason for using a modified server platform like Plazma instead of the official server platform provided by Mojang Studios is that it allows for powerful **customization**. + +Below are various ways to customize and utilize Plazma. + +## Configuration Modification + +The most basic way to customize Plazma is to modify its configuration. + +Plazma provides powerful configuration settings ranging from game mechanics to mob properties. + +Refer to the following page for an explanation of Plazma's configurations. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Plugin Usage + +{% hint style="success" %} + +**Plazma supports all Paper-based plugins.** + +For Spigot plugins, some may not work due to mapping changes from Paper 1.20.5, +However, most plugins based on Paper such as Paper, Pufferfish, and Purpur +work on Plazma as well. If a plugin does not work properly, it is an error of Plazma, so please [report it immediately.](../diagnosis/plugins.md) + +{% endhint %} + +This is the main reason for using Plazma and the most powerful way to customize Plazma. +Plazma's powerful plugin ecosystem makes it easy to customize the server. + +There are several ways to find and download plugins. Some plugins +upload plugins to public repository services, while others upload to GitHub or their own +websites. + +{% hint style="caution" %} + +**Plugins can directly access the system!** + +Always check if the plugin is safe using services like VirusTotal before applying it, +or download the plugin from a trusted service. + +{% endhint %} + +There are various services used to download plugins. Among them, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/), etc. review plugins before they are uploaded to ensure that only safe plugins are distributed. + +### Applying Plugins + +Once you have downloaded the plugins, it's time to apply them. + +1. Plugins are in `.jar` or `Java Executable File` format.\ + Some plugins are compressed, in which case + unzip the file and if the name includes `bukkit`, `spigot`, or `paper`, + use the `fat` file if there is a file with `fat`. +2. Place the downloaded file in the `plugins` folder of the server directory and (re)start the server. +3. When Plazma starts, new content will be output on the console. + This means that Plazma has successfully loaded the plugins. +4. Even if Plazma has successfully loaded the plugins, they may not start. + You can load the currently loaded plugins on the server using the `/plugins` command. + If the installed plugin names are not in red but + in green, the plugins have loaded correctly. + +If the plugins have not loaded correctly, you can find solutions on the following page. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Using Datapacks + +Datapacks are a way to customize Minecraft provided similarly to +[Resource Packs](#user-content-fn-1). + +With datapacks, you can modify parts of the game such as adding new creature groups and challenges. + +{% hint style="caution" %} + +**Datapacks can damage worlds!** + +Some faulty datapacks can damage worlds irreversibly. + +Therefore, it is recommended to back up the world before applying datapacks. + +{% endhint %} + +Datapacks can be downloaded from various services such as [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/), etc. + +Once downloaded, you can apply datapacks by placing them in the `datapacks` folder of the server's world directory. +If the folder does not exist, create it and add the datapacks. + +{% hint style="warning" %} + +**Some [datapacks](#user-content-fn-2) may not apply correctly when first applied.** + +In such cases, it is recommended to restart the server **twice**. + +{% endhint %} + +Datapacks can easily be corrupted when Minecraft updates its version. + +Especially when datapacks are completely corrupted, the server may crash, +so it is important to thoroughly test before updating the server. + +{% hint style="info" %} + +**After the server start command, you can enter `safeMode` to disable all datapacks and start the server.** + +[For more information, refer to `References > Arguments and Properties`.](../reference/arguments.md) + +{% endhint %} + +You can check the applied datapacks using the `/datapack list` command. + +*** + +[^1]: Or Minecraft: Bedrock Edition addons. + +[^2]: Adding new creature groups, etc. diff --git a/ew/origin/plazma/administration/getting-started/next-step.md b/ew/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..57a2e649f --- /dev/null +++ b/ew/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Learn how to customize the server. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Below are various ways to customize and utilize Plazma. + +## Configuration Modification + +The most basic way to customize Plazma is to modify its configuration. + +Plazma provides powerful configuration settings ranging from game mechanics to mob properties. + +Refer to the following page for an explanation of Plazma's configurations. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Plugin Usage + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +This is the main reason for using Plazma and the most powerful way to customize Plazma. Plazma's powerful plugin ecosystem makes it easy to customize the server. + +There are several ways to find and download plugins. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +There are various services used to download plugins. Among them, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/), etc. review plugins before they are uploaded to ensure that only safe plugins are distributed. + +### Applying Plugins + +Once you have downloaded the plugins, it's time to apply them. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Place the downloaded file in the `plugins` folder of the server directory and (re)start the server. +3. When Plazma starts, new content will be output on the console. This means that Plazma has successfully loaded the plugins. +4. Even if Plazma has successfully loaded the plugins, they may not start. You can load the currently loaded plugins on the server using the `/plugins` command. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +If the plugins have not loaded correctly, you can find solutions on the following page. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Using Datapacks + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +With datapacks, you can modify parts of the game such as adding new creature groups and challenges. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Some faulty datapacks can damage worlds irreversibly. + +Therefore, it is recommended to back up the world before applying datapacks. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Once downloaded, you can apply datapacks by placing them in the `datapacks` folder of the server's world directory. If the folder does not exist, create it and add the datapacks. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +In such cases, it is recommended to restart the server **twice**. +{% endhint %} + +Datapacks can easily be corrupted when Minecraft updates its version. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +You can check the applied datapacks using the `/datapack list` command. + +*** + +## Optimization + +Plazma has many optimization patches applied. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Refer to the below page for information on safe and proper proxy settings. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Safety + +As Minecraft mods develop, it is easy to find [vulnerability attack engines](#user-content-fn-3) online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Permission Settings + +Some plugin administrator commands may have vulnerabilities if permissions are not properly set. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray Blocking + +X-Ray is one of the vulnerabilities that can easily be used even in basic optimization clients. + +Plazma provides a configuration that can block X-Ray by default. + +Please refer to the below page for X-Ray blocking methods and explanations. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Use `/whitelist query` to see players who are allowed access. + +*** + +[^1]: Or Minecraft: Bedrock Edition addons. + +[^2]: Adding new creature groups, etc. + +[^3]: Commonly referred to as "hacks". + +[^4]: If the configuration is not optimized, or Plazma is old, or new vulnerabilities are not blocked, players may not be blocked when connecting to the server. + +[^5]: When players connect to the server, it is through the Ngrok proxy server, and the Ngrok address issued with each restart will be different. diff --git a/ew/origin/plazma/administration/reference/README.md b/ew/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..d2d6730df --- /dev/null +++ b/ew/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Learn about the default customization methods provided by Plazma. +--- + +# 📜 리퍼런스 + +Plazma offers various customization methods. + +Among them, the following 4 methods are customization methods that can be used immediately without additional work. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +Ask the community questions through the [official Discord server](https://discord.gg/MmfC52K8A8) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Commands + +> Commands allow you to collect information in the game or customize the playing environment. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permissions + +> Permissions specify the range in which players can interact. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Arguments and Attributes + +> Arguments and attributes have a broad impact on the operation of Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurations + +> Configurations are the most basic way to customize Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ew/origin/plazma/administration/reference/arguments.md b/ew/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..8afff0e24 --- /dev/null +++ b/ew/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Learn about startup arguments and system properties. +--- + +# 🎛️ Arguments and Properties + +The start arguments and system properties are values appended to the commands used for Plasma execution, influencing the overall operation of Plasma. + +According to the **start argument** and **system properties** in the position added to the command (#user-content-fn-2)[^2], it will be divided. + +*** + +## System Properties + +System properties are values processed in the JVM before Plazma is initialized and entered in front of `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Usage + +System properties are entered as Java command arguments between `java` and `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indicates that the argument is an exclusive argument added to Plazma, not inherent to JVM, + +If no value is entered for the property, the value is fixed as [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Full 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 to correctly load debug information in IDE, 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. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +If you are a plugin developer and need to update a plugin, use hotswap instead of `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables plugins using standard input and 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's 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 head blocks with invalid profile information. + +Logs all incorrect head blocks in the world with their locations. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Default**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `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 check. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +World and overall files can be permanently corrupted, breaking the game's entire mechanics. + +Any issues that arise from using this are the user's responsibility, and Plamza does not provide any support for it. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Default**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Default**: `80` + +Sets the maximum length of characters that can be entered on a sign line. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Default**: `(world version) + 1` + +Sets the version of initial world update information to be initialized first. + +Useful when a large number of chunks need to be updated, 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 specified time (in seconds). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Default**: `False` + +Ignores server properties comments. + +#### `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 [default chunk writing system](#user-content-fn-10)[^10]. + +This proceeds to save each chunk sequentially, causing significant performance degradation. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables explicit flushing of network channels. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Default**: `False` + +Always logs errors that do not occur on the main thread. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Default**: `False` + +Outputs a warning if scheduled tasks have excessive wait times. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Default**: `False` + +When using the default executable file, only applies patches without starting the server. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Default**: `false` +- **Conflict**: `Plazma.disableConfigOptimization` + +Optimize the initial configuration more strongly. + +Enabling this will make the server faster and safer, but it can have a significant impact on gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolean` +- **Default**: `false` +- **Conflict**: `Plazma.aggressiveOptimize` + +Do not optimize the initial configuration. + +This makes it use Paper's default configuration. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolean` +- **Default**: `false` + +Disable the Plazma branding and use the vanilla default server favicon. + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolean` +- **Default**: `false` +- **Conflict**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +This can have a significant impact on server safety and performance. + +Any issues arising from this property are the responsibility of the server administrator. +{% endhint %} + +Provides the initial configuration with the default values supplied by Mojang. + +This disables all vulnerability patches applied by Paper. + +Vulnerability patches can be re-enabled in either the Paper configuration or Plazma configuration. + +#### `Plazma.vanillaize` + +- **Type**: `Boolean` +- **Default**: `true` +- **Conflict**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Set the initial configuration closer to vanilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### The deprecated property is in use. + +The following system property is a deprecated property. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Default**: `false` +- **Deprecated**: Timings has been removed from Plazma since + +Determines if values exceeding the maximum that can be sent to Aikar's Timings API are allowed. + +Even if done this way, rate limiting will be applied if not handled in the API. + +*** + +## Start Arguments + +Start arguments are entered after `-jar *.jar` to initialize Plazma and are processed together. + +### Usage + +System properties are entered as program command arguments after `-jar *.jar`. + +For example, if you want to apply the `nogui` start argument,\ +enter as follows for Plazma to process the `nogui` argument during initialization. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### All Start Arguments + +#### `bukkit-settings` + +- **Alias**: `b` +- **Default**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Default**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Default**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Starts the server with a demo world. + +#### `eraseCache` + +Removes leftover cache files after world upgrades. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Outputs the full start arguments and descriptions for Plazma. + +#### `initSettings` + +Only generates configuration files and shuts down the server. + +#### `jfrProfile` + +Enables JFR profiling. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Default**: `(server properties)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Disables the graphical interface panel. + +#### `nojline` + +Disables JLine and uses vanilla console. + +#### `online-mode` + +- **Alias**: `o` +- **Default**: `(server properties)` + +Selects whether to authenticate players with Mojang authentication servers. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Default**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Sets the location of the deprecated PaperSpigot configuration file. + +Used to transfer existing configurations to new configuration files, and not used afterwards. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Default**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Default**: `plugins` + +Sets the location of the plugins folder. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Default**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Default**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Starts the server in a completely vanilla state (Safe Mode). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Default**: `(server properties)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `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 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Outputs the Plazma version. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Default**: `(server folder)` + +Sets the location where world files are saved. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Default**: `(server properties)` + +Sets the name of the world file. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: The location for processing arguments changes depending on the appended location. + +[^3]: For example, if you want to set (enable) `Plazma.iKnowWhatIAmDoing` to `true`, entering `-DPlazma.iKnowWhatIAmDoing` alone will work the same as `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: For example, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: A signal indicating that the server is properly connected, like a heartbeat. + +[^9]: Using Purpur's AFK kick feature, you can kick players who are away from their keyboards. + +[^10]: Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: In games, `world optimization` works on the same principle. + +[^13]: Excluding administrators `level 2` and above. + +[^14]: Internet Protocol, IP. diff --git a/ew/origin/plazma/administration/reference/commands.md b/ew/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..68031b491 --- /dev/null +++ b/ew/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Learn about the commands available in Plazma. +--- + +# 🖥️ Commands diff --git a/ew/origin/plazma/administration/reference/configurations/README.md b/ew/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..60185326a --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Configurations are the most basic way to customize Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Properties + +> Properties are the most basic configuration files provided in Minecraft. Using properties allows you to change the basic mechanics of the game. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Configuration + +> Bukkit configuration is the most basic configuration file provided in Plazma. Using Bukkit configuration allows you to change the basic mechanics of a Minecraft server. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Configuration + +> Spigot configuration allows you to modify the detailed mechanics of the game, player processing, operation of commands, and messages. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Configuration + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish configuration allows you to modify the processing of worlds and entities in Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Configuration + +> Purpur properties allow you to modify the overall basic data of the game. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Configuration + +> Plazma configuration allows you to customize the features of Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ew/origin/plazma/administration/reference/configurations/bukkit.md b/ew/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e84eaa8aa --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in bukkit.yml means. +--- + +# 🪣 Bukkit diff --git a/ew/origin/plazma/administration/reference/configurations/paper/README.md b/ew/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b363f9c84 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# 🛩️ Paper diff --git a/ew/origin/plazma/administration/reference/configurations/paper/global.md b/ew/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a0f0eee84 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🌏 전역 구성 diff --git a/ew/origin/plazma/administration/reference/configurations/paper/world.md b/ew/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..edb97534f --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Find out what each node in paper-world.yml means. +--- + +# 🏳️ 세계별 구성 + +World diff --git a/ew/origin/plazma/administration/reference/configurations/plazma/README.md b/ew/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5f57cb1ce --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# ✨ Plazma diff --git a/ew/origin/plazma/administration/reference/configurations/plazma/global.md b/ew/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f95ae5f19 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-global.yml means. +--- + +# 🌏 전역 구성 diff --git a/ew/origin/plazma/administration/reference/configurations/plazma/world.md b/ew/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..7634be35e --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# 🏳️ 세계별 구성 diff --git a/ew/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ew/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..890ad8f1b --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# ✨ Plazma (World Composition) diff --git a/ew/origin/plazma/administration/reference/configurations/property.md b/ew/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..c012dbfd9 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in server.properties means. +--- + +# 🪨 Server.properties diff --git a/ew/origin/plazma/administration/reference/configurations/pufferfish.md b/ew/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..11ab0ccd5 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in pufferfish.yml means. +--- + +# 🐡 Pufferfish diff --git a/ew/origin/plazma/administration/reference/configurations/purpur/README.md b/ew/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fe215c95b --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur diff --git a/ew/origin/plazma/administration/reference/configurations/purpur/global.md b/ew/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..379d3d5a8 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🌏 전역 구성 diff --git a/ew/origin/plazma/administration/reference/configurations/purpur/world.md b/ew/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..c41642913 --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🏳️ 세계별 구성 diff --git a/ew/origin/plazma/administration/reference/configurations/spigot.md b/ew/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..2aa01888b --- /dev/null +++ b/ew/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in spigot.yml means. +--- + +# 🚰 Spigot diff --git a/ew/origin/plazma/administration/reference/permissions.md b/ew/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..1427d016d --- /dev/null +++ b/ew/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Check out the permissions of Plazma. +--- + +# 🛡️ Permissions + +Permission is a simple security tool that sets the scope for players to interact within the server. + +To properly utilize and easily modify permissions, you should use plugins such as [LuckPerms](https://luckperms.net). + +*** + +## Understanding the basic permission system + +Minecraft provides basic management permission groups. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Player**\ + A permission group given to all players by default. +2. **Mediator**\ + Can ignore spawn protection. +3. **World Administrator**\ + Can use all commands and command blocks related to world management.\ + Default permission group applied to datapacks and command blocks. +4. **Administrator**\ + Can use all commands related to player management. +5. **Super Administrator**\ + Can use all commands including server management.\ + Default permission group applied to console and operators. + +*** + +## Setting permissions + +*** + +## Full permissions + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Default**: `None` + +Allows players to `sneak and interact` with entities to mount them. + +When mounted on an entity, players can control the entity's movement with the `movement keys` and jump or fly with the `jump key`. + +`(Namespaced Key)` corresponds to the [Namespaced ID](#user-content-fn-2)[^2] of the entity. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Default**: `None` + +Allows players to use special abilities of entities while riding them. + +Not all entities have available special abilities. Refer below for a list of all available special abilities. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Post your ideas on [Plazma Discord](https://plazmamc.org/discord) or [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +View currently available special abilities + +- **`crepper`**\ + Explodes when the `jump key` is pressed.\ + If players have the `allow.powered.creeper` permission, they can hold down the `jump key` to charge it. +- **`dolphin`**\ + Dashes when the `jump key` is pressed. +- **`phantom`**\ + Shoots flames when the `jump key` is pressed. +- **`wither`**\ + Fires wither skulls when `interacted with`. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Default**: `World Administrator` + +Allows the use of the [`/compass` command](commands.md#compass). + +#### `bukkit.command.credits` + +- **Default**: `World Administrator` + +Allows the use of the [`/credits (Player)` command](commands.md#credits). + +Adding `.other` after the permission name allows it to be used on other players. + +#### `bukkit.command.demo` + +- **Default**: `World Administrator` + +Allows the use of the [`/demo (Player)` command](commands.md#demo). + +Adding `.other` after the permission name allows it to be used on other players. + +#### `bukkit.command.ping` + +- **Default**: `World Administrator` + +Allows the use of the [`/ping (Player)` command](commands.md#ping). + +Adding `.other` after the permission name allows it to be used on other players. + +#### `bukkit.command.ram` + +- **Default**: `World Administrator` + +Allows the use of the [`/ram` command](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Default**: `World Administrator` + +Allows the use of the [`/rambar (Player)` command](commands.md#rambar). + +Adding `.other` after the permission name allows it to be used on other players. + +#### `bukkit.command.restart` + +- **Default**: `World Administrator` + +Allows the use of the [`/restart` command](commands.md#restart). + +#### `bukkit.command.tps` + +- **Default**: `World Administrator` + +Allows the use of the [`/tps` command](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Default**: `World Administrator` + +Allows the use of the [`/tpsbar (Player)` command](commands.md#tpsbar). + +Adding `.other` after the permission name allows it to be used on other players. + +#### `bukkit.command.timings` + +- **Default**: `World Administrator` + +Allows the use of the [`/timings` command](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Check [Spark](https://spark.lucko.me/docs/Command-Usage) for similar functionalities. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Default**: `World Administrator` + +Allows the use of the [`/uptime` command](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Default**: `World Administrator` + +Allows the use of the `/gamemode (GameMode) (Player)` command. + +Adding `.other` after the permission name allows it to be used on other players. + +#### `paper.antixray.bypass` + +- **Default**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +This benefits both sides in terms of performance enhancement. + +> Refer to the following page for X-Ray setup instructions. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Default**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Default**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Default**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Default**: `None` + +Allows the use of [MiniMessage tags](https://docs.advntr.dev/minimessage/format.html) on anvils. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Default**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Default**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Default**: `None` + +Excludes players from being kicked for being idle. + +#### `purpur.debug.f3n` + +- **Default**: `World Administrator` + +Allows players to change game modes using the `F3 + N` key combination. + +This only works if the player has permission for that game mode. + +#### `purpur.drop.spawners` + +- **Default**: `None` + +Dropping a spawner block with the configured item will drop the spawner block. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Default**: `None` + +Changes the size of ender chests. + +Allowed inputs for `(NumberString)` are `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Default**: `None` + +Allow Totem of Undying to function even when in inventory. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Default**: `None` + +Allow players to bypass the connection limit. + +#### `purpur.mending_shift_click` + +- **Default**: `None` + +Allow players to repair held items by `sneaking and interacting`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Default**: `None` + +Allow players to place spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Default**: `None` + +Enable players to instantly teleport when using Nether portals. + +#### `purpur.sign.color` + +- **Default**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Default**: `None` + +Allow the use of obfuscation code `(&o)` on signs. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Default**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Default**: `None` + +Allow players to prevent TNT explosions by `interacting` with shears. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Planned Permissions + +#### `plazma.bypass.ncr-require` + +- **Default**: `None` + +Allow players to connect even without the [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) mod installed. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Example: `ender_dragon` diff --git a/ew/origin/plazma/adminstration/README.md b/ew/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..7fc6ef388 --- /dev/null +++ b/ew/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Create your own server using Plazma. +--- + +# ⚒️ Server Management Guide diff --git a/ew/origin/plazma/adminstration/expert/README.md b/ew/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..619026757 --- /dev/null +++ b/ew/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Learn about how to professionally handle Plazma. +--- + +# 🎓 Advanced diff --git a/ew/origin/plazma/adminstration/expert/fix-exploits.md b/ew/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..515ad4ab1 --- /dev/null +++ b/ew/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Learn about known vulnerabilities and how to fix them. +--- + +# ⚠️ Known vulnerabilities and solutions diff --git a/ew/origin/plazma/adminstration/expert/optimize.md b/ew/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..9428ce44f --- /dev/null +++ b/ew/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Learn how to optimize Plazma. +--- + +# 🧹 Optimization diff --git a/ew/origin/plazma/adminstration/expert/vanillaize.md b/ew/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..86b9f062f --- /dev/null +++ b/ew/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Learn how to restore the patch of Paper and Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper does not offer options for most patches that fix Vanilla errors. + +Currently, Plazma is developing a configuration to disable such error fixes. + +Therefore, this guide is still being written and the information is subject to change at any time. +{% endhint %} diff --git a/ew/origin/plazma/adminstration/faq.md b/ew/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..2160fd48a --- /dev/null +++ b/ew/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Check out frequently asked questions. +--- + +# ⁉️ Frequently Asked Questions + +{% hint style="info" %} + +### Can't find the answer you're looking for? + +Ask the community through the [Official Discord Server](https://discord.gg/MmfC52K8A8) or [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### The message is displayed but not executed + +If `no main manifest attribute, in plazma-(version).jar` is displayed in the console,\ +the downloaded file is a development API file, and you should download **Reobf Paperweight** from the GitHub page. + +Refer to the following page for more details. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### A warning is displayed every time the server starts + +Plazma contains some unstable patches and may always malfunction, so the server displays the following warning when it starts. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +This warning can be disabled using the [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +Refer to the following page for more details. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available from 1.20.1 diff --git a/ew/origin/plazma/adminstration/getting-started/README.md b/ew/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..6296c9ad8 --- /dev/null +++ b/ew/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Learn how to create a server with Plazma. +--- + +# 👟 Getting Started + +To use Plazma stably, the system must meet the following requirements: + +| | Minimum | Recommended | +| :-----------: | ------: | ----------: | +| Architecture | x64 | - | +| RAM | 8GB | 16GB | +| Storage Space | 1GB | 8GB | +| JRE | 17 | 21 | + +For smooth configuration file editing, it is also good to install an editor like [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE Installation + +As the name suggests, Minecraft: **"Java"** Edition is developed in Java, so it requires JRE[^1] to run. + +Since Plazma is based on Mojang Studios' official server platform,[^2] you also need to install JRE to use Plazma. + +### 1.1 Check for JRE + +To check if JRE is installed on your system, type [`cmd /k java --version`](#user-content-fn-4)[^4] in the Run dialog and execute it. + +If the output is as follows, proceed to [Step 2](setup.md#id-2). + +{% code title="Correct Output" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +If the output is not like the above, or if it is as follows, then JRE is either not installed or too outdated, so you need to perform [Step 1.2](setup.md#id-1.2). + +{% code title="JRE not installed" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE is too old" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE Installation + +In this guide, we will use Azul Zulu as one of the types of JREs. + +After installation, please redo [step 1.1](setup.md#id-1.1) to ensure that the installation is completed correctly. + +{% tabs %} +{% tab title="Windows" %} + +1. First, download **JDK 21** in `.msi` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Run the downloaded installation wizard and click `Next`. +3. After activating `Set JAVA_HOME variable` in the menu displayed in the middle left of the window, click `Next`. +4. Press `Install` to complete the JRE installation. + {% endtab %} + +{% tab title="macOS" %} +Download the **JDK 21** installation wizard in `.dmg` format from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) and install JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +First, add the Azul Zulu repository to APT by running the following command in the terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Then, install JRE by running the following command in the terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +You can install JRE by entering the following command. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma Download + +Plazma provides various types of executable files. + +{% hint style="warning" %} + +### In most cases, use `Reobf Paperclip`. + +The following information is for developers or those curious about the characteristics of each type.\ +If you are a regular user, you can skip to [step 3](setup.md#id-3) without any issues. +{% endhint %} + +
+ +Learn more + +The name of the executable file is determined as `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping Type**\ + Mapping is a kind of map that connects the actual code of Minecraft with the obfuscated code. + - **Reobf**\ + Reobfuscation, also known as Spigot mapping, is commonly used in most NMS plugins.\ + It will be discontinued starting from 1.20.5. + - **Mojmap**\ + Mojang mapping, the vanilla Minecraft mapping. +- **Version Manager**\ + The version manager can be considered as a launcher for the server, which is necessary for running the server and patching server files. + - **Paperclip**\ + Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server. + - **Bundler**\ + The vanilla Minecraft version manager. + +
+ +*** + +## 3. Creating a Startup Script + +To easily start Plazma and automatically restart the server, you need to create a [startup script](#user-content-fn-6). + +You can create a startup script via [Flags.sh](https://flags.sh). By entering only the [memory to be used by Plazma](#user-content-fn-8), the command will be automatically optimized. + +You can download the startup script by clicking the bottom left download button.\ +**Make sure the downloaded startup script matches your operating system.** + +*** + +## 4. File Organization + +Now, move the downloaded startup script and Plazma to a new folder. + +{% hint style="warning" %} + +### The folder name must not contain spaces and should be in English. + +Otherwise, Plazma or JRE may not function properly. +{% endhint %} + +Now, run the startup script. For Windows, you must select `Allow` in the Firewall Allow Selection window. + +*** + +## 5. EULA Agreement + +Once you run the startup script, a `eula.txt` file will be generated in the folder. + +EULA[^9] is a license agreement that must be agreed upon by using the services of [Mojang Studios](#user-content-fn-10). + +If you do not agree to the EULA, you cannot start the server, and violating the EULA may result in penalties such as account suspension. Refer to [sanctions](#user-content-fn-11). + +To agree to the EULA, change `eula=false` to `eula=true` in the `eula.txt` file and save it. + +*** + +## 6. Allow External Connections (Windows) + +Modern operating systems block external access by default using **Firewalls** and **Routers** to prevent dangerous access from outside. + +For Windows, since you allowed it in [step 3](setup.md#id-3), you just need to do port forwarding. + +{% hint style="info" %} + +### This guide assumes that it is written for Windows operating systems and routers that can use [**UPnP**](#user-content-fn-12). + +If the router does not support UPnP, you need to search for information yourself as different routers have different panels. + +Alternatively, you can also generate a temporary address using [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} + +### For Linux or macOS, and other (semi) UNIX-based operating systems, the setup methods for each firewall service are different, so you need to search for information yourself. + +{% endhint %} + +### 6.1 Check the Need for Port Forwarding + +Enter the following in the execution window and run it. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +If the output is `True`, you can finish here, but if it is `False`, you need to set up port forwarding. + +### 6.2 Connect to the Server + +{% tabs %} +{% tab title="External Connection" %} +If port forwarding is not required or has already been successful, you can now connect to the server. + +The address to use when connecting to the server can be checked [here](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Attempt Port Forwarding with UPnP" %} +In the `purpur.yml` file in the server folder, enable `network.upnp-port-forwarding` to `true`. + +Then, when you restart the server, Plazma will automatically attempt port forwarding. + +The success of UPnP will be based on the message output on the console, which will be displayed as `[UPnP] (message)`. + +| Message | Meaning | +| --------------------------------- | ---------------------------------- | +| `Successfully opened port (port)` | Port forwarding successful. | +| `Port (port) is already open` | Another service is using the port. | +| `Failed to open port (port)` | Port forwarding failed. | +| `Service is unavailable` | The router does not support UPnP. | + +When the server is shut down, Plazma automatically closes the port. +{% endtab %} + +{% tab title="Generate Temporary Address with Ngrok" %} +Using Ngrok is useful for short-term testing, collaborative play, or playing with friends. + +1. Download the `Windows (64-bit)` ZIP file from [Ngrok website](https://ngrok.com/download). +2. Put the downloaded Ngrok into the server folder. +3. Generate an authentication token from [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken) as mentioned in [footnote 13](#user-content-fn-13). +4. Run the command displayed in the `Command Line` at the top of the execution script in the server folder. +5. Add `start /b ngrok tcp --region jp 25565` at the top and `taskkill /f /t /im ngrok.exe` at the bottom of the execution script. +6. At the top of the console, the address `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` indicates that `0.tcp.jp.ngrok.io:12345` is the server address. +7. Now you can connect from outside using this address. + {% endtab %} + +{% tab title="Connecting from Local" %} +If you are trying to connect to the server from your local machine, you can use the `IPv4 address` displayed by running `cmd /k ipconfig` in the command prompt. + +For example, when the following is displayed after running the command, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +You can connect to the server from your local machine by attempting to connect to the `192.168.3.7` displayed in the IPv4 address. + +If the server and the game are running on the same PC, you can connect using `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Development Stage + +If you have successfully started the server and it is running correctly, it is now time to customize the server. + +Learn how to customize the server through the guide below. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java execution environment. + +[^2]: Paper, based on Plazma, is based on Spigot, which is based on the official server platform. + +[^3]: Windows key + R + +[^4]: For Linux, use `java --version` in the terminal. + +[^5]: JRE is one of the open-source projects, like Minecraft server platforms, there are various types. + +[^6]: It is commonly known as a **launcher**. + +[^7]: Enabling "Auto-restart" will automatically restart the server. You can exit by entering `Control + C`. + +[^8]: It is not recommended to exceed more than half of the system's capacity. + + For example, when the total system memory capacity is 8GB, it is not recommended to set it above 4GB. + +[^9]: End-User License Agreement, EULA. For more information, please check the [Minecraft website](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: In the case of South Korea, according to Article 32, Paragraph 1, Item 9 of the Game Industry Promotion Act, legal action can be taken by **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur included in Plazma automatically communicates with the router through this technology, so there is no need to directly forward ports as the server only opens ports when it is running. + +[^13]: If you do not have an account, sign up for Ngrok using your Google or GitHub account. diff --git a/ew/origin/plazma/adminstration/getting-started/customization.md b/ew/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..b0db4c5db --- /dev/null +++ b/ew/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Learn how to customize the server. +--- + +# 🎨 Customization diff --git a/ew/origin/plazma/adminstration/reference/arguments.md b/ew/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..b4cd26e52 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,522 @@ +--- +description: Learn about startup arguments and system properties. +--- + +# 🎛️ Arguments and Properties + +Startup variables and system properties are values appended to the [commands used](#user-content-fn-1)[^1] in Plazma execution, allowing values that cannot be changed after Plazma has been executed to be changed. + +Depending on the [location of the appendage](#user-content-fn-2)[^2], they are divided into **startup arguments** and **system properties**. + +*** + +## System Properties + +System properties are values processed in the JVM before Plazma is initialized and entered in front of `-jar`. + +{% hint style="warning" %} + +### Modifying system properties can change the operation of Plazma and JVM, potentially having a significant impact on the game! + +If you are not sure what each system property does, **do not use it under any circumstances!** +{% endhint %} + +### Usage + +System properties are entered as Java command arguments between `java` and `-jar`. + +For example, if you want to apply the `Plazma.dummyProperty` system property, entering as follows initializes Plazma with `37` in the next property. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indicates that the argument is an exclusive argument added to Plazma, not inherent to JVM, + +and if no value is entered, the value is fixed to [`true.`](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### The Paperweight series server platform includes a `.` in the property name to distinguish system properties for each platform. + +In some terminals like Windows Powershell, these arguments may not be allowed, so `"` should be added to both ends of the argument. + +### Full 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 to correctly load debug information in IDE, 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. + +{% hint style="danger" %} + +### The `/reload` command is very unstable, so all issues occurring after `/reload` are the responsibility of the user. + +If you are a plugin developer and need to update a plugin, use hotswap instead of `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables plugins using standard input and 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's 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 head blocks with invalid profile information. + +Logs all incorrect head blocks in the world with their locations. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables the limit of 128 plugin channels per player. + +#### `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` + +- **Type**: `Integer` +- **Default**: `750` + +Splits entities into multiple packets if they exceed the set value. + +#### `Paper.filterThreshold` + +- **Type**: `Integer` +- **Default**: `8192` + +Sets the maximum packet size the server can receive at once. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables Java version check. + +{% hint style="danger" %} + +### This may allow JVM to attempt to access non-existent code! + +World and overall files can be permanently corrupted, breaking the game's entire mechanics. + +Any issues that arise from using this are the user's responsibility, and Plamza does not provide any support for it. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Integer` +- **Default**: `64` + +Sets the limit of plugin channel names. + +#### `Paper.maxSignLength` + +- **Type**: `Integer` +- **Default**: `80` + +Sets the maximum length of characters that can be entered on a sign line. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Integer` +- **Default**: `(world version) + 1` + +Sets the version of initial world update information to be initialized first. + +Useful when a large number of chunks need to be updated, but otherwise not used. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Default**: `True` + +Enables processing of comments in YAML files. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Integer` +- **Default**: `30` + +Kicks players if no data is received from them for the specified time (in seconds). + +Normally, the game[^7] continuously sends [heartbeat signals](#user-content-fn-8)[^8] to the server, so players are not kicked, but if the game stops responding, it is considered crashed and the player is kicked without further processing on the server. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Default**: `False` + +Ignores server properties comments. + +#### `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 [default chunk writing system](#user-content-fn-10)[^10]. + +This proceeds to save each chunk sequentially, causing significant performance degradation. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables explicit flushing of network channels. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Default**: `False` + +Always logs errors that do not occur on the main thread. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Default**: `False` + +Outputs a warning if scheduled tasks have excessive wait times. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Default**: `False` + +When using the default executable file, only applies patches without starting the server. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Default**: `false` + +{% hint style="warning" %} + +### This property will be moved to startup arguments after 1.20.5. + +{% endhint %} + +Applies more stringent configuration optimizations at initial startup. + +Activating it makes the server faster and more secure, but it may block some gimmicks or have a significant impact on game play. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default**: `false` + +Suppresses the warning[^11] displayed when Plazma is initialized. + +### The deprecated property is in use. + +The following system property is a deprecated property. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Default**: `false` +- **Deprecated**: Timings has been removed from Plazma since + +Determines if values exceeding the maximum that can be sent to Aikar's Timings API are allowed. + +Even if done this way, rate limiting will be applied if not handled in the API. + +*** + +## Start Arguments + +Start arguments are entered after `-jar *.jar` to initialize Plazma and are processed together. + +### Usage + +System properties are entered as program command arguments after `-jar *.jar`. + +For example, if you want to apply the `nogui` start argument,\ +enter as follows for Plazma to process the `nogui` argument during initialization. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### All Start Arguments + +#### `bukkit-settings` + +- **Alias**: `b` +- **Default**: `bukkit.yml` + +Sets the name and location of the [Bukkit configuration file](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Default**: `commands.yml` + +Sets the name and location of the [Bukkit command configuration file](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Default**: `server.properties` + +Sets the name and location of the [server properties](../reference/configurations/property.md) file. + +#### `demo` + +Starts the server with a demo world. + +#### `eraseCache` + +Removes leftover cache files after world upgrades. + +#### `forceUpgrade` + +Forces an upgrade of the world, ignoring the version. + +#### `help` + +- **Alias**: `?` + +Outputs the full start arguments and descriptions for Plazma. + +#### `initSettings` + +Only generates configuration files and shuts down the server. + +#### `jfrProfile` + +Enables JFR profiling. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Default**: `(server properties)` + +Sets the maximum number of allowed [players](#user-content-fn-14). + +#### `nogui` + +Disables the graphical interface panel. + +#### `nojline` + +Disables JLine and uses vanilla console. + +#### `online-mode` + +- **Alias**: `o` +- **Default**: `(server properties)` + +Selects whether to authenticate players with Mojang authentication servers. + +**Sanctions may apply for violating the [EULA](../getting-started/README.md#id-5) if not using Velocity or other proxies.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Default**: `paper.yml` + +{% hint style="warning" %} + +### This argument has been deprecated since 1.19.4 + +{% endhint %} + +Sets the location of the deprecated PaperSpigot configuration file. + +Used to transfer existing configurations to new configuration files, and not used afterwards. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Default**: `config` + +Sets the name and location of the folder containing the [Paper configuration files](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Sets the name and location of the folder containing the [Plazma configuration files](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Default**: `plugins` + +Sets the location of the plugins folder. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Default**: `pufferfish.yml` + +Sets the name and location of the [Pufferfish configuration file](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Default**: `purpur.yml` + +Sets the name and location of the [Purpur configuration file](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Starts the server in a completely vanilla state (Safe Mode). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Default**: `(server properties)` + +Sets the host name or [Internet Protocol](#user-content-fn-13) address of the server. + +#### `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` + +Sets the name and location of the [Spigot configuration file](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Outputs the Plazma version. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Default**: `(server folder)` + +Sets the location where world files are saved. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Default**: `(server properties)` + +Sets the name of the world file. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: The location for processing arguments changes depending on the appended location. + +[^3]: For example, if you want to set (enable) `Plazma.iKnowWhatIAmDoing` to `true`, entering `-DPlazma.iKnowWhatIAmDoing` alone will work the same as `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: For example, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: A signal indicating that the server is properly connected, like a heartbeat. + +[^9]: Using Purpur's AFK kick feature, you can kick players who are away from their keyboards. + +[^10]: Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: In games, `world optimization` works on the same principle. + +[^13]: Internet Protocol, IP. + +[^14]: Excluding administrators `level 2` and above. diff --git a/ew/origin/plazma/adminstration/reference/commands.md b/ew/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..68031b491 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Learn about the commands available in Plazma. +--- + +# 🖥️ Commands diff --git a/ew/origin/plazma/adminstration/reference/configurations/bukkit.md b/ew/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e84eaa8aa --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in bukkit.yml means. +--- + +# 🪣 Bukkit diff --git a/ew/origin/plazma/adminstration/reference/configurations/paper/README.md b/ew/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b363f9c84 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# 🛩️ Paper diff --git a/ew/origin/plazma/adminstration/reference/configurations/paper/global.md b/ew/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..df1e2d629 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-global.yml means. +--- + +# 🛩️ Paper (Global Configuration) diff --git a/ew/origin/plazma/adminstration/reference/configurations/paper/world.md b/ew/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..85995bc10 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in paper-world.yml means. +--- + +# 🛩️ Paper (World Composition) diff --git a/ew/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ew/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5f57cb1ce --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Find out the purpose of each file in the config folder. +--- + +# ✨ Plazma diff --git a/ew/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ew/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..996ee3054 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-global.yml means. +--- + +# ✨ Plazma (Global Configuration) diff --git a/ew/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ew/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..c9818eb71 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ World Composition diff --git a/ew/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ew/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..890ad8f1b --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in plazma-world.yml means. +--- + +# ✨ Plazma (World Composition) diff --git a/ew/origin/plazma/adminstration/reference/configurations/property.md b/ew/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..c012dbfd9 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in server.properties means. +--- + +# 🪨 Server.properties diff --git a/ew/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ew/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..11ab0ccd5 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in pufferfish.yml means. +--- + +# 🐡 Pufferfish diff --git a/ew/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ew/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..fe215c95b --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur diff --git a/ew/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ew/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..54c3cd073 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purple (Global Configuration) diff --git a/ew/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ew/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..3bfade8ae --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in purpur.yml means. +--- + +# 🦑 Purpur (World Composition) diff --git a/ew/origin/plazma/adminstration/reference/configurations/spigot.md b/ew/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..2aa01888b --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Find out what each node in spigot.yml means. +--- + +# 🚰 Spigot diff --git a/ew/origin/plazma/adminstration/reference/permissions.md b/ew/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..c721dc011 --- /dev/null +++ b/ew/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Check out the permissions of Plazma. +--- + +# 🛡️ Permissions diff --git a/ew/origin/plazma/developers.md b/ew/origin/plazma/developers.md new file mode 100644 index 000000000..697830a52 --- /dev/null +++ b/ew/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Develop third-party projects using Plazma. +--- + +# ⚙️ Developer Guide diff --git a/ew/origin/thunderbolt/README.md b/ew/origin/thunderbolt/README.md new file mode 100644 index 000000000..bfa7c6f07 --- /dev/null +++ b/ew/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt is a Plazma-based server platform that allows you to directly try out experimental patches by distinguishing them as Flavors. +--- + +# 🌩️ Thunderbolt Usage Guide diff --git a/ew/origin/volt/README.md b/ew/origin/volt/README.md new file mode 100644 index 000000000..6cd9912b6 --- /dev/null +++ b/ew/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt is an open source template that allows you to develop your own Paperweight server platform based on Plazma. +--- + +# ⚡ Volt Development Guide diff --git a/fa/origin/README.md b/fa/origin/README.md new file mode 100644 index 000000000..e0bb6a586 --- /dev/null +++ b/fa/origin/README.md @@ -0,0 +1,41 @@ +--- +description: اگر سوالی دارید، لطفاً از طریق Discord یا بحث‌های GitHub سوال کنید. +--- + +# 🏠 به پورتال مستندات خوش آمدید + +{% hint style="info" %} + +**اسناد Plazma در حال حاضر به صورت ترجمه ماشینی شده است.** + +[![وضعیت ترجمه](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) برای شرکت در ترجمه اسناد و بهبود اسناد مشارکت کنید. + +{% endhint %} + +### اگر مشکلی در حین استفاده از پلاسما پیش آمد، چه کنیم؟ + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### اگر به Thunderbolt علاقه‌مند هستید؟ + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### اگر می‌خواهید با Volt پلتفرم سرور خود را بسازید؟ + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` اگر به اطلاعات بیشتر مربوط به Minecraft نیاز دارید؟ + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/fa/origin/SUMMARY.md b/fa/origin/SUMMARY.md new file mode 100644 index 000000000..db641e765 --- /dev/null +++ b/fa/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# فهرست مطالب + +- [🏠 به پرتال اسناد خوش آمدید](README.md) + - [⚛️ گیت‌هاب](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 دیسکورد](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## پلاسما + +- [✨ مستندات استفاده از پلاسما](plazma/README.md) +- [❓ پلاسما چیست؟](plazma/about/README.md) + - [⬇️ دانلود](plazma/about/downloads.md) + - [✅ وضعیت پشتیبانی از نسخه‌ها](plazma/about/supported-versions.md) +- [⚒️ راهنمای مدیریت سرور](plazma/administration/README.md) + - [👟 شروع کردن](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 مرجع](plazma/administration/reference/README.md) + - [🖥️ دستورات](plazma/administration/reference/commands.md) + - [🛡️ مجوزها](plazma/administration/reference/permissions.md) + - [🎛️ آرگومان‌ها و ویژگی‌ها](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 بوکیت](plazma/administration/reference/configurations/bukkit.md) + - [🚰 اسپیگات](plazma/administration/reference/configurations/spigot.md) + - [🛩️ پیپر](plazma/administration/reference/configurations/paper/README.md) + - [🌏 پیکربندی سراسری](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ تنظیمات بر اساس جهان](plazma/administration/reference/configurations/paper/world.md) + - [🐡 ماهی پافرفیش](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 پورپور](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 پیکربندی سراسری](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ تنظیمات بر اساس جهان](plazma/administration/reference/configurations/purpur/world.md) + - [✨ پلاسما](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 پیکربندی سراسری](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ تنظیمات بر اساس جهان](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 پیشرفته](plazma/administration/expert/README.md) + - [🧹 بهینه‌سازی](plazma/administration/expert/optimize.md) + - [🔀 پراکسی](plazma/administration/expert/proxy.md) + - [↩️ وانیلایز](plazma/administration/expert/vanillaize.md) + - [🩻 مسدود کردن پرتو X](plazma/administration/expert/xray.md) + - [⚠️ آسیب‌پذیری‌ها و راه‌حل‌ها](plazma/administration/expert/fix-exploits.md) + - [⁉️ پرسش‌های متداول](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ راهنمای توسعه‌دهندگان](plazma/developers.md) + - [✏️ مشارکت](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ جاوداک‌ها](https://jd.plazmamc.org/) + +## تندربولت + +- [🌩️ راهنمای استفاده از تندربولت](thunderbolt/README.md) + +## ولت + +- [⚡ راهنمای توسعه ولت](volt/README.md) + +## متفرقه + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ دانلود همه](plazma/about/downloads-all.md) diff --git a/fa/origin/miscellaneous/README.md b/fa/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/fa/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/fa/origin/plazma/README.md b/fa/origin/plazma/README.md new file mode 100644 index 000000000..ee6fc32cd --- /dev/null +++ b/fa/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma یک پلتفرم سرور منبع باز برای Minecraft: Java Edition است که بهینه‌سازی تجربی بر اساس کاغذ و قابلیت سفارشی سازی از چند مکانیزم بازی را اضافه کرده است." +--- + +# ✨ مستندات استفاده از Plazma + +## 👋 به مستندات Plazma خوش آمدید + +خوش آمدید به مستندات استفاده از Plazma! + +{% hint style="info" %} + +**آیا نمی توانید مشکل را از طریق راهنما حل کنید؟** + +[سرور رسمی دیسکورد](https://discord.gg/MmfC52K8A8) یا [بحث‌های GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) را برای پرسش‌های خود به جامعه مطرح کنید! + +{% endhint %} + +### درباره Plazma + +> با Plazma آشنا شوید که یک پلتفرم سرور چیست. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### برای مدیران + +> با استفاده از Plazma، سرور خود را ایجاد کنید. + +{% content-ref url="administration/" %} +[مدیریت](administration/) +{% endcontent-ref %} + +### برای توسعه‌دهندگان + +> با استفاده از Plazma، پروژه‌های شخص ثالث را توسعه دهید. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/fa/origin/plazma/about/README.md b/fa/origin/plazma/about/README.md new file mode 100644 index 000000000..eaff77e7a --- /dev/null +++ b/fa/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: با Plazma آشنا شوید که یک پلتفرم سرور چیست. +--- + +# ❓ Plazmaچیست؟ + +- **Plazma** یک پلتفرم سرور مبتنی بر [Paper](https://github.com/PaperMC/Paper) است که فقط از مزایای [Andromeda](https://github.com/EarendelArchived/Andromeda) و [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) استفاده می کند. +- همیشه برای ارائه پایداری بالا، عملکرد قدرتمند، به روزرسانی سریع و ارائه ویژگی های بسیار بزرگ تلاش می کند. + +## 📋 اهداف Plazma + +- برای تبدیل شدن به یک پلتفرم سرور با به روزرسانی سریع و پایداری بالا تلاش می کند. +- برای ارائه ویژگی های بسیار بزرگ و عملکرد قدرتمند مانند پلتفرم های مود، تلاش می کند. +- برای ایجاد یک پلتفرم آزاد که امکان سفارشی سازی پچ های وانیلای را فراهم می کند، تلاش می کند. + +## ⚙️ ویژگی های اصلی + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **سریعترین به روزرسانی**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) اطمینان می دهد که پچ های Plazma همیشه به روز باشند و بهترین به روزرسانی را در میان پلتفرم های سرور مبتنی بر Paper ارائه می دهد. +6. **بهینه سازی فایل های پیکربندی اصلی**\ + فایل های پیکربندی پیش فرض بهینه شده اند، بنابراین شما نیازی به بهینه سازی مستقیم فایل های پیکربندی ندارید. +7. **مدیریت چند رشته ای سازمان یافته**\ + با غیرفعال کردن مکانیزم های سیستم که به مکانیزم های بازی مرتبط نیستند، زمان تاخیر را کاهش داده و سرور را بهینه می کند. +8. **جلوگیری از استفاده از فضای اضافی**\ + با ترکیب داده های مشابه به یکدیگر، حافظه استفاده شده را کاهش دهید. + +## ✨ مورد استفاده + +- **پلتفرمی که حتی با پلاگین‌های پیچیده نیز به درستی کار می‌کند**\ + Plazma در سرورهای [IPECTER](https://github.com/IPECTER) استفاده می‌شود.\ + پلاگین‌های داخلی که با NMS و رفلکشن کار می‌کنند، و دیتاپک‌های پیچیده و بزرگ، بدون کاهش عملکرد، + بیش از 100 نفر از بازیکنان را پذیرفته و بازی می‌کند. +- **پلتفرمی که در سرورهای RPG همچنان عملکرد سریعی دارد**\ + صد نفر از بازیکنان را در یک کلستر تنها با TPS بدون کاهش پایدار نگه داشته و، + با چهار کلستر، مجموعاً 250 نفر از بازیکنان می‌توانند با لذت بازی کنند. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **پلتفرمی که توسط بسیاری از استریمرها انتخاب شده است**\ + این پلتفرم به عنوان سبد مخاطبین بسیاری از استریمرها انتخاب شده و استفاده می‌شود. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ دانلود + +شما می توانید Plazma را از صفحه زیر دانلود کنید. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### آیا می خواهید اطلاعات دقیقی در مورد پشتیبانی از نسخه ها بدانید؟ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: پلاگین های Bukkit، CraftBukkit، Spigot و پلاگین های Paper، Pufferfish، Purpur. + +[^2]: تحت شرکت Microsoft Corporation. + +[^3]: اگر سیستم گزارش چت را غیرفعال کنید، چت به طور کامل توسط سرور پردازش می شود و از ردیابی چت Mojang جلوگیری می شود. + +[^4]: زمانی که مکانیزم های سیستم برای اجرا فعال می شوند، بازی به مدت کوتاهی متوقف می شود. diff --git a/fa/origin/plazma/about/downloads-all.md b/fa/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..14d6a71f1 --- /dev/null +++ b/fa/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: دانلود کامل فایل اجرایی پلاسما +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| نسخه | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/fa/origin/plazma/about/downloads.md b/fa/origin/plazma/about/downloads.md new file mode 100644 index 000000000..5159d6a37 --- /dev/null +++ b/fa/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: همین الان Plazma را دانلود کرده و خودتان استفاده کنید. +--- + +# ⬇️ دانلود + +#### آیا می خواهید اطلاعات دقیقی در مورد پشتیبانی از نسخه ها بدانید؟ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**دانلود زیر نسخه اجرایی برای کاربران عمومی است.** + +اگر توسعه دهنده هستید و نیاز به فرمت دیگری از فایل دارید، لطفاً به صفحه زیر مراجعه کنید. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
نسخهدانلود
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + دانلود +
1.20.1 + دانلود +
1.19.4 + دانلود +
+ +*** diff --git a/fa/origin/plazma/about/patches-list.md b/fa/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..92be5b197 --- /dev/null +++ b/fa/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: برای اطلاعات بیشتر در مورد تمامی ویژگی‌های اضافه شده به Plazma مراجعه کنید. +--- + +# 📑 پچ‌های درج شده diff --git a/fa/origin/plazma/about/supported-versions.md b/fa/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..3afcac9a7 --- /dev/null +++ b/fa/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "نسخه Minecraft: Java Edition که توسط Plazma پشتیبانی می‌شود را بررسی کنید." +--- + +# ✅ وضعیت پشتیبانی از نسخه + +{% hint style="info" %} + +**Plazma از نسخه 1.19.4 به بعد توسعه یافته است و نسخه‌های کمتر از 1.19.4 توسعه داده نشده است.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/در%20حال%20انتظار%20برای%20انتشار +[idv]: https://badge.plazmamc.org/1/در_حال_توسعه +[atv]: https://badge.plazmamc.org/2/پشتیبانی_می‌شود +[fse]: https://badge.plazmamc.org/6/پشتیبانی_ویژگی_متوقف_شده +[eol]: https://badge.plazmamc.org/4/پشتیبانی_متوقف_شده +[ukn]: https://badge.plazmamc.org/0/اطلاعات%20ندارد +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/معمولی +[100]: https://badge.plazmamc.org/percent/100 + +![در\_حال\_انتظار\_برای\_انتشار][wtr] ![در\_حال\_توسعه][idv] ![پشتیبانی\_می‌شود][atv] ![پشتیبانی\_ویژگی\_متوقف\_شده][fse] ![پشتیبانی\_متوقف\_شده][eol] + +| نسخه | پایداری و پشتیبانی از عملکرد | وضعیت ساخت | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![وضعیت\_ساخت](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![وضعیت ساخت](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![وضعیت ساخت](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/fa/origin/plazma/administration/README.md b/fa/origin/plazma/administration/README.md new file mode 100644 index 000000000..c1f69e098 --- /dev/null +++ b/fa/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: با استفاده از Plazma، سرور خود را ایجاد کنید. +--- + +# ⚒️ راهنمای مدیریت سرور diff --git a/fa/origin/plazma/administration/diagnosis/README.md b/fa/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..6c473b764 --- /dev/null +++ b/fa/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: به راه حل برای مقابله با وقوع مشکل بپردازید. +--- + +# 🧾 진단 diff --git a/fa/origin/plazma/administration/diagnosis/plugins.md b/fa/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..9ff5b10e2 --- /dev/null +++ b/fa/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: به روش‌های رفع مشکلات زمانی که افزونه به درستی کار نمی‌کند، مراجعه کنید. +--- + +# 📜 플러그인 diff --git a/fa/origin/plazma/administration/expert/README.md b/fa/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b3473e9d4 --- /dev/null +++ b/fa/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: درباره روش‌های حرفه‌ای کنترل Plazma مطالعه کنید. +--- + +# 🎓 عمیق diff --git a/fa/origin/plazma/administration/expert/fix-exploits.md b/fa/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..de3922d37 --- /dev/null +++ b/fa/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: درباره آسیب‌پذیری‌ها و راه‌حل‌های آن‌ها آگاه شوید. +--- + +# ⚠️ آسیب‌پذیری‌های شناخته‌شده و راه‌حل‌های آن diff --git a/fa/origin/plazma/administration/expert/optimize.md b/fa/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..337aeb45b --- /dev/null +++ b/fa/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: راه های بهینه سازی Plazma را بیابید. +--- + +# 🧹 بهینه سازی diff --git a/fa/origin/plazma/administration/expert/proxy.md b/fa/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..1746a73a9 --- /dev/null +++ b/fa/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: به طریقه ای امن برای تنظیم پلتفرم "Velocity" پروکسی آشنا شوید. +--- + +# 🔀 پروکسی diff --git a/fa/origin/plazma/administration/expert/vanillaize.md b/fa/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..94f704cfd --- /dev/null +++ b/fa/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper و روش بازیابی پچ وانیلایز را بررسی کنید. +--- + +# ↩️ وانیلایز + +{% hint style="warning" %} + +**Paper به بیشتر پچ های رفع اشکال وانیل گزینه ای اضافه نمی کند.** + +در حال حاضر Plazma در حال توسعه امکان غیرفعال کردن این نوع رفع خطاها است. + +بنابراین این راهنما هنوز در حال نوشتن است و همیشه اطلاعات ممکن است تغییر کند. + +{% endhint %} diff --git a/fa/origin/plazma/administration/expert/xray.md b/fa/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..7520012f7 --- /dev/null +++ b/fa/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: به روش‌های مختلف داخلی برای مسدود کردن پرتو ایکس (X-Ray) مسلط شوید. +--- + +# 🩻 مسدود کردن پرتو ایکس (X-Ray) diff --git a/fa/origin/plazma/administration/faq.md b/fa/origin/plazma/administration/faq.md new file mode 100644 index 000000000..0d0bad7f6 --- /dev/null +++ b/fa/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: درباره سوالات متداول بازدید کنید. +--- + +# ⁉️ سوالات متداول + +{% hint style="info" %} + +**آیا نمی‌توانید پاسخ دلخواه خود را پیدا کنید؟** + +[سرور رسمی دیسکورد](https://discord.gg/MmfC52K8A8) یا [بحث‌های GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) را برای پرسش‌های خود به جامعه مطرح کنید! + +{% endhint %} + +### Plazma شروع نمی شود + +اگر پیام `no main manifest attribute, in plazma-(version).jar` در کنسول نمایش داده شده است،\ +فایلی که دانلود کرده اید یک فایل API توسعه‌یافته است، باید **Reobf Paperweight** را از صفحه GitHub دانلود کنید. + +برای اطلاعات بیشتر به صفحه زیر مراجعه کنید. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### هر بار که سرور راه‌اندازی می‌شود، یک هشدار نمایش داده می شود + +Plazma شامل برخی از پچ‌های ناپایدار است و همیشه احتمال اشتباه وجود دارد، بنابراین این هشدارها را هنگام راه‌اندازی سرور چاپ می‌کند. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +این هشدار با استفاده از ویژگی سیستم [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] قابل غیرفعال سازی است. + +برای اطلاعات بیشتر به صفحه زیر مراجعه کنید. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: قابل دسترس از نسخه 1.20.1 diff --git a/fa/origin/plazma/administration/getting-started/README.md b/fa/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..f46d62c25 --- /dev/null +++ b/fa/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: روش ساخت سرور با استفاده از Plazma را بیاموزید. +--- + +# 👟 شروع + +برای استفاده پایدار از Plazma، سیستم باید الزامات زیر را برآورده کند. + +| | حداقل | توصیه شده | +| :-------------: | ----- | --------- | +| معماری | x64 | - | +| RAM | 8GB | 16GB | +| فضای ذخیره‌سازی | 1GB | 8GB | +| JDK | 17 | 21 | + +برای ویرایش فایل‌های پلاگین به صورت صحیح، پیشنهاد می‌شود که [ویژوال استودیو کد](https://code.visualstudio.com/download) یا نرم‌افزارهای ویرایشگر دیگر را نصب کنید. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="خروجی صحیح" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' به عنوان دستور داخلی یا خارجی، برنامه قابل اجرا یا +فایل دسته‌ای قابل اجرا نیست. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% پایان تب %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% پایان تب %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% پایان تب %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% پایان تب %} +{% پایان تب‌ها %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped، مپینگ Minecraft وانیلایی است. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% پایان تب %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% پایان تب %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% پایان تب %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +تنظیمات IP ویندوز + +آداپتور اترنت: + + پسوند DNS متصل شده. . . . : + آدرس IPv4. . . . . . . . . : 192.168.3.7 + ماسک زیرشبکه . . . . . . . : 255.255.255.0 + دروازه پیش فرض . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% پایان تب %} +{% پایان تب‌ها %} + +## 7. پیشرفت + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +از راهنمای زیر برای سفارشی‌سازی سرور آگاه شوید. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [صفحه اصلی Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) را بررسی کنید. + +[^10]: شرکت مایکروسافت. + +[^11]: با توجه به ماده 32 تبصره 1 بند 9 قانون ترویج صنعت بازی کره جنوبی، شرکت **مایکروسافت کره** می‌تواند شکایت قانونی کند. + +[^12]: پلاگین و پخش یونیورسال. با توجه به اینکه Purpur که در Plazma شامل می‌شود، از طریق این تکنولوژی به صورت خودکار با روتر ارتباط برقرار می‌کند و تنها زمانی که سرور در حال اجرا است، پورت‌ها را باز می‌کند، بنابراین نیازی به انجام پورت فورواردینگ مستقیم نیست. + +[^13]: در صورت عدم وجود حساب کاربری، از طریق حساب Google یا GitHub در Ngrok ثبت‌نام کنید. diff --git a/fa/origin/plazma/administration/getting-started/customization.md b/fa/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..f309b3318 --- /dev/null +++ b/fa/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,121 @@ +--- +description: به روش‌های سفارشی‌سازی سرور آشنا شوید. +--- + +# 🎨 سفارشی‌سازی + +دلیل استفاده از پلتفرم سرور تغییر یافته مانند Plazma به جای پلتفرم رسمی ارائه شده توسط Mojang Studios این است که امکان **سفارشی‌سازی** قدرتمند‌تر فراهم می‌کند. + +در زیر چند روش برای سفارشی‌سازی و استفاده از Plazma آمده است. + +## تغییر تنظیمات + +ساده‌ترین روش برای سفارشی‌سازی Plazma، تغییر تنظیمات آن است. + +Plazma تنظیمات قدرتمندی از مکانیزم‌های بازی تا خصوصیات هیولاها ارائه می‌دهد. + +برای توضیحات بیشتر درباره تنظیمات Plazma، به صفحه زیر مراجعه کنید. + +{% content-ref url="../reference/configurations/" %} +[تنظیمات](../reference/configurations/) +{% endcontent-ref %} + +## استفاده از پلاگین + +{% hint style="success" %} + +**Plazma تمامی پلاگین‌های مبتنی بر کاغذ را به طور نرمال پشتیبانی می‌کند.** + +در صورت عدم عملکرد برخی از پلاگین‌ها به دلیل تغییرات مپینگ Paper از نسخه 1.20.5 به بعد، اما +بیشتر پلاگین‌های مبتنی بر Paper مانند Paper، Pufferfish و Purpur در Plazma همچنان عمل می‌کنند و در صورت عدم عملکرد صحیح، این مشکل مربوط به Plazma است لذا لطفاً [گزارش دهید.](../diagnosis/plugins.md) + +{% endhint %} + +اصلی‌ترین دلیل استفاده از Plazma و قوی‌ترین روش تخصیص شخصی Plazma است. +جامعه قدرتمند پلاگین Plazma به شما امکان می‌دهد که سرور را به راحتی شخصی‌سازی کنید. + +برای پیدا کردن و دانلود پلاگین‌ها روش‌های مختلفی وجود دارد. بعضی از پلاگین‌ها +پلاگین‌ها را در سرویس‌های انبار عمومی آپلود می‌کنند و بعضی از پلاگین‌ها را در GitHub یا وب‌سایت‌های خود +آپلود می‌کنند. + +{% hint style="caution" %} + +**پلاگین‌ها می‌توانند به طور مستقیم به سیستم دسترسی داشته باشند!** + +همیشه پیش از اعمال پلاگین از خدماتی مانند VirusTotal برای بررسی ایمنی پلاگین استفاده کنید یا +پلاگین را از سرویس‌های قابل اعتماد دانلود کنید. + +{% endhint %} + +برای دانلود پلاگین‌ها از خدمات مختلفی استفاده می‌شود. از جمله، [انجمن SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) و غیره که پلاگین‌ها قبل از آپلود تحت بازبینی قرار می‌گیرند و پلاگین‌های ناامن را فوراً پردازش کرده و فقط پلاگین‌های ایمن توزیع می‌شوند. + +### اعمال پلاگین + +پس از دانلود پلاگین‌ها، حالا وقت اعمال پلاگین‌هاست. + +1. پلاگین‌ها به صورت `.jar` یا `Java Executable File` هستند.\ + بعضی از پلاگین‌ها به صورت فایل‌های فشرده هستند و در این صورت + پس از باز کردن فایل، اگر نام حاوی `bukkit`، `spigot` یا `paper` باشد و + فایلی با نام `fat` نیز وجود داشته باشد، از فایل `fat` استفاده کنید. +2. فایل دانلود شده را در پوشه `plugins` سرور قرار دهید و سرور را (مجدداً) راه‌اندازی کنید. +3. هنگامی که Plazma شروع به کار می‌کند، محتوای جدیدی در کنسول نمایش داده خواهد شد. + این به این معنی است که Plazma پلاگین‌ها را به طور صحیح بارگذاری کرده است. +4. اگرچه Plazma پلاگین‌ها را به درستی بارگذاری کرده باشد، ممکن است پلاگین‌ها راه‌اندازی نکنند. + با استفاده از دستور `/plugins` می‌توانید پلاگین‌های فعلی سرور را بارگذاری کنید. + اگر نام پلاگین‌های نصب شده قرمز نباشد و سبز باشد، این بعنی است که پلاگین‌ها به درستی بارگذاری شده‌اند. + +اگر پلاگین‌ها به درستی بارگذاری نشدند، می‌توانید راه‌حل مشکل را در صفحه زیر پیدا کنید. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## استفاده از دیتاپک + +دیتاپک یک روش استفاده‌شده در Minecraft به صورت پیش‌فرض برای تخصیص شخصی و مشابه [پک منابع](#user-content-fn-1)[^1] است. + +با استفاده از دیتاپک می‌توانید بخش‌هایی از بازی را مانند اضافه کردن گروه‌های جدید موجودیت و چالش‌های جدید تغییر دهید. + +{% hint style="caution" %} + +**دیتاپک ممکن است باعث آسیب دیدگی جهان شود!** + +بعضی از دیتاپک‌های خراب ممکن است باعث آسیب دیدگی جهان شوند و این غیرقابل بازگشت است. + +بنابراین، پیش از اعمال دیتاپک، پشتیبان‌گیری از جهان توصیه می‌شود. + +{% endhint %} + +دیتاپک نیز می‌توانند از خدمات مختلفی دانلود شوند، مانند [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) و غیره. + +پس از دانلود دیتاپک، می‌توانید آن را در پوشه `datapacks` جهان سرور قرار دهید و اعمال کنید. +در صورت عدم وجود پوشه، می‌توانید آن را ایجاد کرده و اضافه کنید. + +{% hint style="warning" %} + +**در برخی از [دیتاپک](#user-content-fn-2)[^2]‌ها، اولین بار اعمال نمی‌شوند.** + +برای پیشگیری از این موضوع، توصیه می‌شود که سرور را **2 بار** مجدداً راه‌اندازی کنید. + +{% endhint %} + +دیتاپک‌ها ممکن است هر بار که نسخه Minecraft به‌روز شود، به راحتی آسیب ببینند. + +به ویژه، اگر دیتاپک به‌طور کامل آسیب ببیند، به دلیل برخورد سرور، +قبل از به‌روزرسانی سرور، آزمایش کافی را انجام دهید. + +{% hint style="info" %} + +**پس از دستور شروع سرور، با وارد کردن `safeMode` پس از آن، می‌توانید همه دیتاپک‌ها را غیرفعال کرده و سرور را راه‌اندازی کنید.** + +[برای اطلاعات بیشتر، به `مرجع > آرگومان‌ها و ویژگی‌ها` مراجعه کنید.](../reference/arguments.md) + +{% endhint %} + +دیتاپک‌های اعمال شده را می‌توانید با استفاده از دستور `/datapack list` بررسی کنید. + +*** + +[^1]: یا افزونه Minecraft: Bedrock Edition. + +[^2]: اضافه کردن گروه‌های جدید موجودیت و غیره. diff --git a/fa/origin/plazma/administration/getting-started/next-step.md b/fa/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..48a3ff010 --- /dev/null +++ b/fa/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: به روش‌های سفارشی‌سازی سرور آشنا شوید. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +در زیر چند روش برای سفارشی‌سازی و استفاده از Plazma آمده است. + +## تغییر تنظیمات + +ساده‌ترین روش برای سفارشی‌سازی Plazma، تغییر تنظیمات آن است. + +Plazma تنظیمات قدرتمندی از مکانیزم‌های بازی تا خصوصیات هیولاها ارائه می‌دهد. + +برای توضیحات بیشتر درباره تنظیمات Plazma، به صفحه زیر مراجعه کنید. + +{% content-ref url="../reference/configurations/" %} +[تنظیمات](../reference/configurations/) +{% endcontent-ref %} + +*** + +## استفاده از پلاگین + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +اصلی‌ترین دلیل استفاده از Plazma و قوی‌ترین روش تخصیص شخصی Plazma است. جامعه قدرتمند پلاگین Plazma به شما امکان می‌دهد که سرور را به راحتی شخصی‌سازی کنید. + +برای پیدا کردن و دانلود پلاگین‌ها روش‌های مختلفی وجود دارد. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +برای دانلود پلاگین‌ها از خدمات مختلفی استفاده می‌شود. از جمله، [انجمن SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) و غیره که پلاگین‌ها قبل از آپلود تحت بازبینی قرار می‌گیرند و پلاگین‌های ناامن را فوراً پردازش کرده و فقط پلاگین‌های ایمن توزیع می‌شوند. + +### اعمال پلاگین + +پس از دانلود پلاگین‌ها، حالا وقت اعمال پلاگین‌هاست. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. فایل دانلود شده را در پوشه `plugins` سرور قرار دهید و سرور را (مجدداً) راه‌اندازی کنید. +3. هنگامی که Plazma شروع به کار می‌کند، محتوای جدیدی در کنسول نمایش داده خواهد شد. این به این معنی است که Plazma پلاگین‌ها را به طور صحیح بارگذاری کرده است. +4. اگرچه Plazma پلاگین‌ها را به درستی بارگذاری کرده باشد، ممکن است پلاگین‌ها راه‌اندازی نکنند. با استفاده از دستور `/plugins` می‌توانید پلاگین‌های فعلی سرور را بارگذاری کنید. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +اگر پلاگین‌ها به درستی بارگذاری نشدند، می‌توانید راه‌حل مشکل را در صفحه زیر پیدا کنید. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## استفاده از دیتاپک + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +با استفاده از دیتاپک می‌توانید بخش‌هایی از بازی را مانند اضافه کردن گروه‌های جدید موجودیت و چالش‌های جدید تغییر دهید. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +بعضی از دیتاپک‌های خراب ممکن است باعث آسیب دیدگی جهان شوند و این غیرقابل بازگشت است. + +بنابراین، پیش از اعمال دیتاپک، پشتیبان‌گیری از جهان توصیه می‌شود. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +پس از دانلود دیتاپک، می‌توانید آن را در پوشه `datapacks` جهان سرور قرار دهید و اعمال کنید. در صورت عدم وجود پوشه، می‌توانید آن را ایجاد کرده و اضافه کنید. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +برای پیشگیری از این موضوع، توصیه می‌شود که سرور را **2 بار** مجدداً راه‌اندازی کنید. +{% endhint %} + +دیتاپک‌ها ممکن است هر بار که نسخه Minecraft به‌روز شود، به راحتی آسیب ببینند. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +دیتاپک‌های اعمال شده را می‌توانید با استفاده از دستور `/datapack list` بررسی کنید. + +*** + +## بهینه‌سازی + +پلاسما دارای بسیاری از پچ‌های بهینه‌سازی است. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## پراکسی + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +برای اطلاعات بیشتر درباره تنظیمات امن و صحیح پراکسی، به صفحه زیر مراجعه کنید. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## امنیت + +ماینکرافت به گونه‌ای پیشرفته شده است که بتوان به راحتی در آنلاین [موتور حمله آسیب پذیر](#user-content-fn-3)[^3] را پیدا کرد. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### تنظیمات مجوز + +دستورات مدیریتی برخی از افزونه‌ها ممکن است دارای آسیب‌پذیری با تنظیمات مجوز نادرست باشند. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### مسدود کردن X-Ray + +X-Ray یکی از آسیب‌پذیری‌های آسانی است که حتی در کلاینت‌های بهینه‌سازی پیش‌فرض قابل استفاده است. + +پلاسما دارای تنظیماتی است که امکان مسدود کردن X-Ray را فراهم می‌کند. + +برای راهنما و توضیحات مربوط به مسدود کردن X-Ray، لطفاً به صفحه زیر مراجعه کنید. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### لیست سفید + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +برای مشاهده بازیکنان مجاز، از `/whitelist query` استفاده کنید. + +*** + +[^1]: یا افزونه Minecraft: Bedrock Edition. + +[^2]: اضافه کردن گروه‌های جدید موجودیت و غیره. + +[^3]: معمولاً به "هک" معروف هستند. + +[^4]: در صورتی که تنظیمات بهینه‌سازی نشده باشد یا پلاسما قدیمی باشد یا آسیب‌پذیری‌های جدیدی وجود داشته باشد، ممکن است مسدود نشود. + +[^5]: هنگام ورود بازیکن به سرور، از طریق سرور پراکسی Ngrok وارد می‌شود و آدرس Ngrok که هر بار راه‌اندازی متفاوت است، صادر می‌شود. diff --git a/fa/origin/plazma/administration/reference/README.md b/fa/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..051ddeece --- /dev/null +++ b/fa/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: روش‌های سفارشی‌سازی ارائه شده توسط Plazma را بررسی کنید. +--- + +# 📜 리퍼런스 + +Plazma انواع مختلفی از روش‌های سفارشی‌سازی را ارائه می‌دهد. + +از بین این‌ها، 4 روش زیر روش‌های سفارشی‌سازی که بدون نیاز به کارهای اضافی می‌توانید بلافاصله استفاده کنید می‌باشد. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[سرور رسمی دیسکورد](https://discord.gg/MmfC52K8A8) یا [بحث‌های GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) را برای پرسش‌های خود به جامعه مطرح کنید! +{% endhint %} + +*** + +## 🖥️ دستورات + +> دستورات به شما این امکان را می‌دهند که اطلاعات را در بازی جمع‌آوری کنید یا محیط بازی را سفارشی کنید. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ مجوزها + +> مجوزها محدوده‌ای را تعیین می‌کنند که بازیکن می‌تواند در آن تعامل داشته باشد. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ آرگومان‌ها و ویژگی‌ها + +> آرگومان‌ها و ویژگی‌ها تأثیر گسترده‌ای بر عملکرد Plazma دارند. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 پیکربندی + +> پیکربندی، ساده‌ترین روش برای سفارشی‌سازی Plazma می‌باشد. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/fa/origin/plazma/administration/reference/arguments.md b/fa/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..11bbdc22a --- /dev/null +++ b/fa/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +شروعی و ویژگی‌های سیستم به عنوان مقادیر اضافی به [دستورات استفاده شده برای اجرای Plazma](#user-content-fn-1)[^1] اضافه می‌شوند و تأثیر گسترده‌ای بر عملکرد Plazma دارند. + +[موقعیت اضافه شده به دستور](#user-content-fn-2)[^2] منجر به تقسیم آن به **آرگومان شروع** و **ویژگی‌های سیستم** می‌شود. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +اگر هیچ مقداری برای ویژگی‌ها وارد نشود، مقدار به [`true` تثبیت می‌شود](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **نوع**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **نوع**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **نوع**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **نوع**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **نوع**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **نوع**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `false` + +غیرفعال‌سازی برند Plazma و استفاده از فاویکون پیش‌فرض وانیلای سرور. + +#### `Plazma.useVanillaConfiguration` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `false` +- **برخورد**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +این ممکن است تأثیر زیادی بر روی ایمنی و عملکرد سرور داشته باشد. + +تمام مسائلی که با استفاده از این ویژگی ایجاد می‌شوند، مسئولیت مدیر سرور است. +{% endhint %} + +تنظیمات اولیه را به مقادیر پیش‌فرض ارائه شده توسط Mojang تأمین می‌کند. + +این تمام رفع ضعف‌ها را که Paper انجام داده است را غیرفعال می‌کند. + +رفع ضعف‌ها قابل اجرا مجدد در تنظیمات Paper یا تنظیمات Plazma می‌باشد. + +#### `Plazma.vanillaize` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `true` +- **برخورد**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +اولویت اول تنظیمات اولیه را نزدیک به وانیلای تنظیمات می‌کند. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### ویژگی منسوخ‌شده + +ویژگی‌های سیستم زیر از ویژگی‌های منسوخ‌شده است. + +#### `timings.bypassMax` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `false` +- **توجه**: پس از حذف Timings از Plazma + +تعیین می‌کند که آیا می‌توانید حداکثر مقداری را برای ارسال به Timings API Aikar تجاوز کنید یا خیر. + +در صورتی که در API بدون استثنا پردازش نشود، محدودیت نرخ اعمال می‌شود. + +*** + +## آرگومان شروع + +آرگومان شروع باید پس از `-jar *.jar` وارد شود تا Plazma مقدارهای همراه را هنگام مقدماتی‌سازی پردازش کند. + +### راهنمای استفاده + +ویژگی‌های سیستم به عنوان آرگومان دستور برنامه پس از `-jar *.jar` وارد می‌شوند. + +به عنوان مثال، اگر می‌خواهید آرگومان شروع `nogui` را اعمال کنید،\ +به صورت زیر وارد کنید تا Plazma آرگومان `nogui` را در حین مقدماتی‌سازی پردازش کند. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### کل آرگومان‌های شروع + +#### `bukkit-settings` + +- **نام مستعار**: `b` +- **مقدار پیش‌فرض**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **نام مستعار**: `c` +- **مقدار پیش‌فرض**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **نام مستعار**: `c` +- **مقدار پیش‌فرض**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +سرور را با جهت‌دهی به جهان دمو راه‌اندازی می‌کند. + +#### `eraseCache` + +پس از ارتقاء جهان، فایل‌های حافظه نهان باقی‌مانده را حذف می‌کند. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **نام مستعار**: `?` + +تمام آرگومان‌های شروع Plazma و توضیحات آن‌ها را چاپ می‌کند. + +#### `initSettings` + +فقط فایل‌های پیکربندی را ایجاد می‌کند و سرور را خاموش می‌کند. + +#### `jfrProfile` + +پروفایل‌دهی JFR را فعال می‌کند. + +#### `max-players` + +- **نام مستعار**: `s`, `size` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +پنل رابط گرافیکی را غیرفعال می‌کند. + +#### `nojline` + +JLine را غیرفعال می‌کند و از کنسول وانیلایی استفاده می‌کند. + +#### `online-mode` + +- **نام مستعار**: `o` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +تصمیم می‌گیرد که آیا با استفاده از سرور اعتبارسنجی Mojang بازیکنان را تأیید کند یا خیر. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **نام مستعار**: `paper` +- **مقدار پیش‌فرض**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +مکان فایل پیکربندی PaperSpigot که از کار افتاده است را تنظیم می‌کند. + +این برای انتقال تنظیمات قدیمی به یک فایل پیکربندی جدید استفاده می‌شود و بعد از آن استفاده نمی‌شود. + +#### `paper-settings-directory` + +- **نام مستعار**: `paper-dir` +- **مقدار پیش‌فرض**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **نام مستعار**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **نام مستعار**: `p` +- **مقدار پیش‌فرض**: `plugins` + +مکان پوشه پلاگین‌ها را تنظیم می‌کند. + +#### `pufferfish-settings` + +- **نام مستعار**: `pufferfish` +- **مقدار پیش‌فرض**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **نام مستعار**: `purpur` +- **مقدار پیش‌فرض**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +سرور را به حالت وانیلایی کامل راه‌اندازی می‌کند. + +#### `server-ip` + +- **نام مستعار**: `h`, `host` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **نام مستعار**: `p`, `port` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +پورت سرور را تنظیم می‌کند. + +#### `server-name` + +- **مقدار پیش‌فرض**: `A Plazma Server` + +نام سرور را تنظیم می‌کند. + +#### `spigot-settings` + +- **نام مستعار**: `S` +- **مقدار پیش‌فرض**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **نام مستعار**: `v` + +نسخه Plazma را چاپ می‌کند. + +#### `world-dir` + +- **نام مستعار**: `W`, `universe`, `world-container` +- **مقدار پیش‌فرض**: `(پوشه سرور)` + +مکان ذخیره فایل‌های جهان را تنظیم می‌کند. + +#### `world-name` + +- **نام مستعار**: `w`, `world` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +نام فایل جهان را تنظیم می‌کند. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: مکان پردازش آرگومان‌ها تغییر می‌کند بر اساس موقعیت اضافه شده. + +[^3]: به عنوان مثال، اگر می‌خواهید `Plazma.iKnowWhatIAmDoing` را به `true` تنظیم (فعال) کنید، به جای `-DPlazma.iKnowWhatIAmDoing=true` می‌توانید فقط `-DPlazma.iKnowWhatIAmDoing` را وارد کنید تا به همان شکل عمل کند. + +[^4]: به عنوان مثال، `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: دیتکتور رویداد. + +[^6]: دیتکتور رویداد. + +[^7]: مشتری. + +[^8]: نشانه ای که به طور مشابه به ضربان قلب، ارتباط صحیح با سرور را نشان می دهد. + +[^9]: با استفاده از قابلیت اخراجی AFK Purpur، می توانید بازیکنان خالی صندلی را هم اخراج کنید. + +[^10]: سیستم نوشتن چانک هماهنگ، سینک چانک رایت سیستم. + +[^11]: هشدار! پلاسما ممکن است مشکلات غیر منتظره ای ایجاد کند، بنابراین حتماً قبل از استفاده از آن در سرور عمومی آن را به طور کامل تست کنید.\` + +[^12]: در بازی `بهینه سازی جهانی` نیز به همین اصول عمل می کند. + +[^13]: مدیران `سطح 2` به بالا مستثنی می شوند. + +[^14]: پروتکل اینترنت، IP. diff --git a/fa/origin/plazma/administration/reference/commands.md b/fa/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..13f75cd4d --- /dev/null +++ b/fa/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: دستورالعمل‌های قابل استفاده در Plazma را بررسی کنید. +--- + +# 🖥️ دستورالعمل‌ها diff --git a/fa/origin/plazma/administration/reference/configurations/README.md b/fa/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..9f2a2481d --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: پیکربندی، ساده‌ترین روش برای سفارشی‌سازی Plazma می‌باشد. +--- + +# 🧾 구성 + +*** + +## 🪨 ویژگی + +> ویژگی یکی از پایه‌ای‌ترین فایل‌های تنظیماتی است که در Minecraft ارائه می‌شود. استفاده از ویژگی به شما امکان تغییر مکانیزم‌های پایه‌ای بازی را می‌دهد. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 تنظیمات Bukkit + +> تنظیمات Bukkit یکی از پایه‌ای‌ترین فایل‌های تنظیماتی است که توسط Plazma ارائه می‌شود. استفاده از تنظیمات Bukkit به شما امکان تغییر مکانیزم‌های پایه‌ای سرور Minecraft را می‌دهد. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 تنظیمات Spigot + +> تنظیمات Spigot به شما امکان تغییر جزئیات مکانیزم‌ها، پردازش بازیکن‌ها، دستورات و غیره را می‌دهد. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ تنظیمات Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 تنظیمات Pufferfish + +> تنظیمات Pufferfish به شما امکان تغییر پردازش جهان و موجودیت‌ها در Plazma را می‌دهد. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 تنظیمات Purpur + +> ویژگی‌های Purpur به شما امکان تغییر داده‌های پایه‌ای بازی را می‌دهد. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ تنظیمات Plazma + +> تنظیمات Plazma به شما امکان سفارشی‌سازی ویژگی‌های Plazma را می‌دهد. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/fa/origin/plazma/administration/reference/configurations/bukkit.md b/fa/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..8589d3b40 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در bukkit.yml بپرسید که چه معنی دارد. +--- + +# 🪣 Bukkit diff --git a/fa/origin/plazma/administration/reference/configurations/paper/README.md b/fa/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..ee5ed0278 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: به منظور فهمیدن هدف هر فایل در پوشه config بررسی کنید. +--- + +# 🛩️ کاغذ diff --git a/fa/origin/plazma/administration/reference/configurations/paper/global.md b/fa/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..6f4577210 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در paper-global.yml نگاه کنید تا معنی آن را بفهمید. +--- + +# 🌏 전역 구성 diff --git a/fa/origin/plazma/administration/reference/configurations/paper/world.md b/fa/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..06427fdd1 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: با Paper-world.yml معنای هر گره را بیابید. +--- + +# 🏳️ 세계별 구성 + +جهانی diff --git a/fa/origin/plazma/administration/reference/configurations/plazma/README.md b/fa/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..7b910b4dc --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: به منظور فهمیدن هدف هر فایل در پوشه config بررسی کنید. +--- + +# ✨ پلاسما diff --git a/fa/origin/plazma/administration/reference/configurations/plazma/global.md b/fa/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..6228c26ae --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: به هر گره از plazma-global.yml معنی چیست بپرسید. +--- + +# 🌏 전역 구성 diff --git a/fa/origin/plazma/administration/reference/configurations/plazma/world.md b/fa/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..49e6fcfb9 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.ymlی این کاربرد هر نود چکاری چکیده را معنا می کند. +--- + +# 🏳️ 세계별 구성 diff --git a/fa/origin/plazma/administration/reference/configurations/plazma/worlds.md b/fa/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..78c629b92 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.ymlی این کاربرد هر نود چکاری چکیده را معنا می کند. +--- + +# ✨ Plazma (ولد بلد) diff --git a/fa/origin/plazma/administration/reference/configurations/property.md b/fa/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..d419ec6d6 --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در server.properties بپرسید که چه معنی دارد. +--- + +# 🪨 Server.properties diff --git a/fa/origin/plazma/administration/reference/configurations/pufferfish.md b/fa/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..296a44a5d --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در pufferfish.yml بپرسید که چه معنایی دارد. +--- + +# 🐡 ماهی بادبادک diff --git a/fa/origin/plazma/administration/reference/configurations/purpur/README.md b/fa/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..ffaabfbdc --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: به معنای هر گره در purpur.yml بپردازید. +--- + +# 🦑 پورپور diff --git a/fa/origin/plazma/administration/reference/configurations/purpur/global.md b/fa/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..f9705701a --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: به معنای هر گره در purpur.yml بپردازید. +--- + +# 🌏 전역 구성 diff --git a/fa/origin/plazma/administration/reference/configurations/purpur/world.md b/fa/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..c99b3323b --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: به معنای هر گره در purpur.yml بپردازید. +--- + +# 🏳️ 세계별 구성 diff --git a/fa/origin/plazma/administration/reference/configurations/spigot.md b/fa/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..e04a7d57d --- /dev/null +++ b/fa/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: به هر گره از spigot.yml بپرسید که چه معنی دارد. +--- + +# 🚰 اسپیگوت diff --git a/fa/origin/plazma/administration/reference/permissions.md b/fa/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..3e63ee3ca --- /dev/null +++ b/fa/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: درباره مجوزهای پلاسما مطلع شوید. +--- + +# 🛡️ مجوز + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **[در تنظیمات جهان Purpur](configurations/purpur/world.md) تنها زمانی کار می‌کند که `(Entity) > ridable` فعال باشد.** + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **استاندارد**: `مدیر جهان` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +اگر `.other` را پس از نام مجوز وارد کنید، به دیگر بازیکنان اجازه استفاده از آن را می‌دهید. + +#### `bukkit.command.demo` + +- **استاندارد**: `مدیر جهان` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +اگر `.other` را پس از نام مجوز وارد کنید، به دیگر بازیکنان اجازه استفاده از آن را می‌دهید. + +#### `bukkit.command.ping` + +- **استاندارد**: `مدیر جهان` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **استاندارد**: `مدیر جهان` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **استاندارد**: `مدیر جهان` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +اگر `.other` را پس از نام مجوز وارد کنید، به دیگر بازیکنان اجازه استفاده از آن را می‌دهید. + +#### `bukkit.command.restart` + +- **استاندارد**: `مدیر جهان` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **استاندارد**: `مدیر جهان` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **استاندارد**: `مدیر جهان` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +اگر `.other` را پس از نام مجوز وارد کنید، به دیگر بازیکنان اجازه استفاده از آن را می‌دهید. + +#### `bukkit.command.timings` + +- **استاندارد**: `مدیر جهان` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **استاندارد**: `مدیر جهان` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **استاندارد**: `مدیر جهان` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +اگر `.other` را پس از نام مجوز وارد کنید، به دیگر بازیکنان اجازه استفاده از آن را می‌دهید. + +#### `paper.antixray.bypass` + +- **استاندارد**: `بدون` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **استاندارد**: `بدون` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **استاندارد**: `بدون` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **استاندارد**: `بدون` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **استاندارد**: `بدون` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **استاندارد**: `بدون` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **استاندارد**: `مدیر جهان` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **استاندارد**: `بدون` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **استاندارد**: `بدون` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که توتم از مرگ در انبار کار کند. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که بازیکن نادیده گرفتن محدودیت تعداد ورودی را داشته باشد. + +#### `purpur.mending_shift_click` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که با استفاده از `خم شدن و تعامل` با آیتم‌های در دست، آن‌ها را تعمیر کند. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که بازیکنان اسپانرها را نصب کنند. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که بازیکنان هنگام استفاده از دروازه‌های نتر، بلافاصله جابجا شوند. + +#### `purpur.sign.color` + +- **استاندارد**: `بدون` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که از کد رمزگذاری `(&o)` در تابلوها استفاده کنند. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **استاندارد**: `بدون` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که با استفاده از قیچی، از انفجار TNT جلوگیری کنند. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### مجوزهای ارائه شده + +#### `plazma.bypass.ncr-require` + +- **استاندارد**: `بدون` + +اجازه می‌دهد که بازیکنان بدون نصب مود [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) بتوانند وارد شوند. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: اپراتور. + +[^2]: برای مثال: `ender_dragon` diff --git a/fa/origin/plazma/adminstration/README.md b/fa/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..c1f69e098 --- /dev/null +++ b/fa/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: با استفاده از Plazma، سرور خود را ایجاد کنید. +--- + +# ⚒️ راهنمای مدیریت سرور diff --git a/fa/origin/plazma/adminstration/expert/README.md b/fa/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b3473e9d4 --- /dev/null +++ b/fa/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: درباره روش‌های حرفه‌ای کنترل Plazma مطالعه کنید. +--- + +# 🎓 عمیق diff --git a/fa/origin/plazma/adminstration/expert/fix-exploits.md b/fa/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..de3922d37 --- /dev/null +++ b/fa/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: درباره آسیب‌پذیری‌ها و راه‌حل‌های آن‌ها آگاه شوید. +--- + +# ⚠️ آسیب‌پذیری‌های شناخته‌شده و راه‌حل‌های آن diff --git a/fa/origin/plazma/adminstration/expert/optimize.md b/fa/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..337aeb45b --- /dev/null +++ b/fa/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: راه های بهینه سازی Plazma را بیابید. +--- + +# 🧹 بهینه سازی diff --git a/fa/origin/plazma/adminstration/expert/vanillaize.md b/fa/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..9a27c79aa --- /dev/null +++ b/fa/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper و روش بازیابی پچ وانیلایز را بررسی کنید. +--- + +# ↩️ وانیلایز + +{% hint style="warning" %} + +### Paper گزینه‌های بیشتری برای رفع خطاهای وانیلایز ارائه نمی‌دهد. + +در حال حاضر Plazma در حال توسعه امکان غیرفعال کردن این نوع رفع خطاها است. + +بنابراین این راهنما هنوز در حال نوشتن است و همیشه اطلاعات ممکن است تغییر کند. +{% endhint %} diff --git a/fa/origin/plazma/adminstration/faq.md b/fa/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..d16384178 --- /dev/null +++ b/fa/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: درباره سوالات متداول بازدید کنید. +--- + +# ⁉️ سوالات متداول + +{% hint style="info" %} + +### آیا پاسخ مورد نظر خود را پیدا نکردید؟ + +[سرور رسمی Discord](https://discord.gg/MmfC52K8A8) یا [مشکلات GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues) را برای پرسش‌های خود به جامعه ارسال کنید! +{% endhint %} + +### پیامی نمایش داده شده و اجرا نمی شود + +اگر پیام `no main manifest attribute, in plazma-(version).jar` در کنسول نمایش داده شده است،\ +فایلی که دانلود کرده اید یک فایل API توسعه‌یافته است، باید **Reobf Paperweight** را از صفحه GitHub دانلود کنید. + +برای اطلاعات بیشتر به صفحه زیر مراجعه کنید. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### هر بار که سرور راه‌اندازی می‌شود، یک هشدار نمایش داده می شود + +Plazma شامل برخی از پچ‌های ناپایدار است و همیشه احتمال اشتباه وجود دارد، بنابراین این هشدارها را هنگام راه‌اندازی سرور چاپ می‌کند. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +این هشدار با استفاده از ویژگی سیستم [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] قابل غیرفعال سازی است. + +برای اطلاعات بیشتر به صفحه زیر مراجعه کنید. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: قابل دسترس از نسخه 1.20.1 diff --git a/fa/origin/plazma/adminstration/getting-started/README.md b/fa/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..12c531e66 --- /dev/null +++ b/fa/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: روش ساخت سرور با استفاده از Plazma را بیاموزید. +--- + +# 👟 شروع + +برای استفاده پایدار از Plazma، سیستم باید الزامات زیر را برآورده کند. + +| | حداقل | توصیه شده | +| :-------------: | ----: | --------: | +| معماری | x64 | - | +| RAM | 8GB | 16GB | +| فضای ذخیره‌سازی | 1GB | 8GB | +| JRE | 17 | 21 | + +برای ویرایش فایل‌های پلاگین به صورت صحیح، پیشنهاد می‌شود که [ویژوال استودیو کد](https://code.visualstudio.com/download) یا نرم‌افزارهای ویرایشگر دیگر را نصب کنید. + +*** + +## 1. نصب JRE + +همانطور که از نامش پیداست، Minecraft: **"Java"** Edition با استفاده از Java توسعه یافته است و برای اجرا نیازمند JRE[^1] می‌باشد. + +Plazma بر اساس پلتفرم سرور رسمی Mojang Studios [ساخته شده است](#user-content-fn-2)[^2]، بنابراین برای استفاده از Plazma نیز باید JRE را نصب کنید. + +### 1.1 بررسی وجود JRE + +برای بررسی نصب بودن JRE در سیستم، در [پنجره اجرا](#user-content-fn-3)[^3] `cmd /k java --version` را وارد کرده و اجرا کنید. + +اگر خروجی به شکل زیر باشد، به [مرحله 2](setup.md#id-2) بروید. + +{% code title="خروجی صحیح" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +اگر خروجی به شکل زیر نباشد یا به شکل زیر باشد، یعنی JRE موجود نیست یا خیلی قدیمی است، بنابراین باید [مرحله 1.2](setup.md#id-1.2) را انجام دهید. + +{% code title="JRE نصب نشده است" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE가 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +본 가이드에서는 JRE의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](setup.md#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% پایان تب %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% پایان تب %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% پایان تب %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% پایان تب %} +{% پایان تب‌ها %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% پایان تب %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% پایان تب %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% پایان تب %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% پایان تب %} +{% پایان تب‌ها %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [صفحه اصلی Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) را بررسی کنید. + +[^10]: شرکت مایکروسافت. + +[^11]: با توجه به ماده 32 تبصره 1 بند 9 قانون ترویج صنعت بازی کره جنوبی، شرکت **مایکروسافت کره** می‌تواند شکایت قانونی کند. + +[^12]: پلاگین و پخش یونیورسال. با توجه به اینکه Purpur که در Plazma شامل می‌شود، از طریق این تکنولوژی به صورت خودکار با روتر ارتباط برقرار می‌کند و تنها زمانی که سرور در حال اجرا است، پورت‌ها را باز می‌کند، بنابراین نیازی به انجام پورت فورواردینگ مستقیم نیست. + +[^13]: در صورت عدم وجود حساب کاربری، از طریق حساب Google یا GitHub در Ngrok ثبت‌نام کنید. diff --git a/fa/origin/plazma/adminstration/getting-started/customization.md b/fa/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..0c55a775a --- /dev/null +++ b/fa/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: به روش‌های سفارشی‌سازی سرور آشنا شوید. +--- + +# 🎨 سفارشی‌سازی diff --git a/fa/origin/plazma/adminstration/reference/arguments.md b/fa/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..f9b3e6692 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **نوع**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **نوع**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **نوع**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **نوع**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **نوع**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **نوع**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **نوع**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `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` + +{% hint style="warning" %} + +### این ویژگی به عنوان آرگومان شروع از نسخه 1.20.5 منتقل خواهد شد. + +{% endhint %} + +بهینه‌سازی پیکربندی که در ابتدای راه‌اندازی اعمال می‌شود را به صورت دقیق‌تر اعمال می‌کند. + +فعال کردن آن باعث افزایش سرعت و ایمنی سرور می‌شود، اما ممکن است برخی از جزئیات را مسدود کند یا تأثیر زیادی بر بازی‌پردازی بگذارد. + +#### `Plazma.iKnowWhatIAmDoing` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `false` + +پیام هشداری[^11] که هنگام مقدمات Plazma نمایش داده می‌شود را سرکوب می‌کند. + +### ویژگی منسوخ‌شده + +ویژگی‌های سیستم زیر از ویژگی‌های منسوخ‌شده است. + +#### `timings.bypassMax` + +- **نوع**: `Boolean` +- **مقدار پیش‌فرض**: `false` +- **توجه**: پس از حذف Timings از Plazma + +تعیین می‌کند که آیا می‌توانید حداکثر مقداری را برای ارسال به Timings API Aikar تجاوز کنید یا خیر. + +در صورتی که در API بدون استثنا پردازش نشود، محدودیت نرخ اعمال می‌شود. + +*** + +## آرگومان شروع + +آرگومان شروع باید پس از `-jar *.jar` وارد شود تا Plazma مقدارهای همراه را هنگام مقدماتی‌سازی پردازش کند. + +### راهنمای استفاده + +ویژگی‌های سیستم به عنوان آرگومان دستور برنامه پس از `-jar *.jar` وارد می‌شوند. + +به عنوان مثال، اگر می‌خواهید آرگومان شروع `nogui` را اعمال کنید،\ +به صورت زیر وارد کنید تا Plazma آرگومان `nogui` را در حین مقدماتی‌سازی پردازش کند. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### کل آرگومان‌های شروع + +#### `bukkit-settings` + +- **نام مستعار**: `b` +- **مقدار پیش‌فرض**: `bukkit.yml` + +نام و مکان [فایل پیکربندی Bukkit](../reference/configurations/bukkit.md) را تنظیم می‌کند. + +#### `command-settings` + +- **نام مستعار**: `c` +- **مقدار پیش‌فرض**: `commands.yml` + +نام و مکان [فایل پیکربندی دستورات Bukkit](../reference/configurations/bukkit.md) را تنظیم می‌کند. + +#### `config` + +- **نام مستعار**: `c` +- **مقدار پیش‌فرض**: `server.properties` + +نام و مکان [فایل خصوصیات سرور](../reference/configurations/property.md) را تنظیم می‌کند. + +#### `demo` + +سرور را با جهت‌دهی به جهان دمو راه‌اندازی می‌کند. + +#### `eraseCache` + +پس از ارتقاء جهان، فایل‌های حافظه نهان باقی‌مانده را حذف می‌کند. + +#### `forceUpgrade` + +بدون توجه به نسخه، جهان را به‌طور اجباری [ارتقاء](#user-content-fn-12)[^12] می‌دهد. + +#### `help` + +- **نام مستعار**: `?` + +تمام آرگومان‌های شروع Plazma و توضیحات آن‌ها را چاپ می‌کند. + +#### `initSettings` + +فقط فایل‌های پیکربندی را ایجاد می‌کند و سرور را خاموش می‌کند. + +#### `jfrProfile` + +پروفایل‌دهی JFR را فعال می‌کند. + +#### `max-players` + +- **نام مستعار**: `s`, `size` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +حداکثر تعداد [بازیکن](#user-content-fn-14)[^14] مجاز را تنظیم می‌کند. + +#### `nogui` + +پنل رابط گرافیکی را غیرفعال می‌کند. + +#### `nojline` + +JLine را غیرفعال می‌کند و از کنسول وانیلایی استفاده می‌کند. + +#### `online-mode` + +- **نام مستعار**: `o` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +تصمیم می‌گیرد که آیا با استفاده از سرور اعتبارسنجی Mojang بازیکنان را تأیید کند یا خیر. + +**در صورت عدم استفاده از Velocity یا پروکسی‌های دیگر، ممکن است به دلیل نقض [EULA](../getting-started/README.md#id-5) تحریم شوید.** + +#### `paper-settings` + +- **نام مستعار**: `paper` +- **مقدار پیش‌فرض**: `paper.yml` + +{% hint style="warning" %} + +### این آرگومان از نسخه 1.19.4 به بعد از کار افتاده است + +{% endhint %} + +مکان فایل پیکربندی PaperSpigot که از کار افتاده است را تنظیم می‌کند. + +این برای انتقال تنظیمات قدیمی به یک فایل پیکربندی جدید استفاده می‌شود و بعد از آن استفاده نمی‌شود. + +#### `paper-settings-directory` + +- **نام مستعار**: `paper-dir` +- **مقدار پیش‌فرض**: `config` + +نام و مکان پوشه حاوی [فایل پیکربندی Paper](../reference/configurations/paper/README.md) را تنظیم می‌کند. + +#### `plazma-settings-directory` + +- **نام مستعار**: `plazma-dir` + +نام و مکان پوشه حاوی [فایل پیکربندی Plazma](../reference/configurations/plazma/README.md) را تنظیم می‌کند. + +#### `plugins` + +- **نام مستعار**: `p` +- **مقدار پیش‌فرض**: `plugins` + +مکان پوشه پلاگین‌ها را تنظیم می‌کند. + +#### `pufferfish-settings` + +- **نام مستعار**: `pufferfish` +- **مقدار پیش‌فرض**: `pufferfish.yml` + +نام و مکان [فایل پیکربندی Pufferfish](../reference/configurations/pufferfish.md) را تنظیم می‌کند. + +#### `purpur-settings` + +- **نام مستعار**: `purpur` +- **مقدار پیش‌فرض**: `purpur.yml` + +نام و مکان [فایل پیکربندی Purpur](../reference/configurations/purpur/README.md) را تنظیم می‌کند. + +#### `safeMode` + +سرور را به حالت وانیلایی کامل راه‌اندازی می‌کند. + +#### `server-ip` + +- **نام مستعار**: `h`, `host` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +نام میزبان سرور یا آدرس پروتکل [اینترنت](#user-content-fn-13)[^13] را تنظیم می‌کند. + +#### `server-port` + +- **نام مستعار**: `p`, `port` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +پورت سرور را تنظیم می‌کند. + +#### `server-name` + +- **مقدار پیش‌فرض**: `A Plazma Server` + +نام سرور را تنظیم می‌کند. + +#### `spigot-settings` + +- **نام مستعار**: `S` +- **مقدار پیش‌فرض**: `spigot.yml` + +نام و مکان [فایل پیکربندی Spigot](../reference/configurations/spigot.md) را تنظیم می‌کند. + +#### `version` + +- **نام مستعار**: `v` + +نسخه Plazma را چاپ می‌کند. + +#### `world-dir` + +- **نام مستعار**: `W`, `universe`, `world-container` +- **مقدار پیش‌فرض**: `(پوشه سرور)` + +مکان ذخیره فایل‌های جهان را تنظیم می‌کند. + +#### `world-name` + +- **نام مستعار**: `w`, `world` +- **مقدار پیش‌فرض**: `(ویژگی‌های سرور)` + +نام فایل جهان را تنظیم می‌کند. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: مکان پردازش آرگومان‌ها تغییر می‌کند بر اساس موقعیت اضافه شده. + +[^3]: به عنوان مثال، اگر می‌خواهید `Plazma.iKnowWhatIAmDoing` را به `true` تنظیم (فعال) کنید، به جای `-DPlazma.iKnowWhatIAmDoing=true` می‌توانید فقط `-DPlazma.iKnowWhatIAmDoing` را وارد کنید تا به همان شکل عمل کند. + +[^4]: به عنوان مثال، `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: دیتکتور رویداد. + +[^6]: دیتکتور رویداد. + +[^7]: مشتری. + +[^8]: نشانه ای که به طور مشابه به ضربان قلب، ارتباط صحیح با سرور را نشان می دهد. + +[^9]: با استفاده از قابلیت اخراجی AFK Purpur، می توانید بازیکنان خالی صندلی را هم اخراج کنید. + +[^10]: سیستم نوشتن چانک هماهنگ، سینک چانک رایت سیستم. + +[^11]: هشدار! پلاسما ممکن است مشکلات غیر منتظره ای ایجاد کند، بنابراین حتماً قبل از استفاده از آن در سرور عمومی آن را به طور کامل تست کنید.\` + +[^12]: در بازی `بهینه سازی جهانی` نیز به همین اصول عمل می کند. + +[^13]: پروتکل اینترنت، IP. + +[^14]: مدیران `سطح 2` به بالا مستثنی می شوند. diff --git a/fa/origin/plazma/adminstration/reference/commands.md b/fa/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..13f75cd4d --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: دستورالعمل‌های قابل استفاده در Plazma را بررسی کنید. +--- + +# 🖥️ دستورالعمل‌ها diff --git a/fa/origin/plazma/adminstration/reference/configurations/bukkit.md b/fa/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..8589d3b40 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در bukkit.yml بپرسید که چه معنی دارد. +--- + +# 🪣 Bukkit diff --git a/fa/origin/plazma/adminstration/reference/configurations/paper/README.md b/fa/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..ee5ed0278 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: به منظور فهمیدن هدف هر فایل در پوشه config بررسی کنید. +--- + +# 🛩️ کاغذ diff --git a/fa/origin/plazma/adminstration/reference/configurations/paper/global.md b/fa/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..645056c03 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در paper-global.yml نگاه کنید تا معنی آن را بفهمید. +--- + +# 🛩️ Paper (تنظیمات جهانی) diff --git a/fa/origin/plazma/adminstration/reference/configurations/paper/world.md b/fa/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..cee19dcc7 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: با Paper-world.yml معنای هر گره را بیابید. +--- + +# 🛩️ کاغذ (تشکیل دنیا) diff --git a/fa/origin/plazma/adminstration/reference/configurations/plazma/README.md b/fa/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..7b910b4dc --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: به منظور فهمیدن هدف هر فایل در پوشه config بررسی کنید. +--- + +# ✨ پلاسما diff --git a/fa/origin/plazma/adminstration/reference/configurations/plazma/global.md b/fa/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..9f97aca54 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: به هر گره از plazma-global.yml معنی چیست بپرسید. +--- + +# ✨ پلاسما (تنظیمات جهانی) diff --git a/fa/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/fa/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..a57b79413 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ ساختار جهانی diff --git a/fa/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/fa/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..78c629b92 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.ymlی این کاربرد هر نود چکاری چکیده را معنا می کند. +--- + +# ✨ Plazma (ولد بلد) diff --git a/fa/origin/plazma/adminstration/reference/configurations/property.md b/fa/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..d419ec6d6 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در server.properties بپرسید که چه معنی دارد. +--- + +# 🪨 Server.properties diff --git a/fa/origin/plazma/adminstration/reference/configurations/pufferfish.md b/fa/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..296a44a5d --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: به هر گره در pufferfish.yml بپرسید که چه معنایی دارد. +--- + +# 🐡 ماهی بادبادک diff --git a/fa/origin/plazma/adminstration/reference/configurations/purpur/README.md b/fa/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..ffaabfbdc --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: به معنای هر گره در purpur.yml بپردازید. +--- + +# 🦑 پورپور diff --git a/fa/origin/plazma/adminstration/reference/configurations/purpur/global.md b/fa/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..a7686ac12 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: به معنای هر گره در purpur.yml بپردازید. +--- + +# 🦑 پورپور (ساختار کلی) diff --git a/fa/origin/plazma/adminstration/reference/configurations/purpur/world.md b/fa/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..e49930a2b --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: به معنای هر گره در purpur.yml بپردازید. +--- + +# 🦑 پورپور (ترکیب جهانی) diff --git a/fa/origin/plazma/adminstration/reference/configurations/spigot.md b/fa/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..e04a7d57d --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: به هر گره از spigot.yml بپرسید که چه معنی دارد. +--- + +# 🚰 اسپیگوت diff --git a/fa/origin/plazma/adminstration/reference/permissions.md b/fa/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..0f2e578b5 --- /dev/null +++ b/fa/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: درباره مجوزهای پلاسما مطلع شوید. +--- + +# 🛡️ مجوز diff --git a/fa/origin/plazma/developers.md b/fa/origin/plazma/developers.md new file mode 100644 index 000000000..e919d0c9b --- /dev/null +++ b/fa/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: با استفاده از Plazma، پروژه‌های شخص ثالث را توسعه دهید. +--- + +# ⚙️ راهنمای توسعه دهندگان diff --git a/fa/origin/thunderbolt/README.md b/fa/origin/thunderbolt/README.md new file mode 100644 index 000000000..3128903bc --- /dev/null +++ b/fa/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt یک پلتفرم سرور مبتنی بر Plazma است که امکان استفاده مستقیم از پچ‌های آزمایشی را با تقسیم بندی به عنوان Flavor فراهم می کند. +--- + +# راهنمای استفاده از Thunderbolt 🌩️ diff --git a/fa/origin/volt/README.md b/fa/origin/volt/README.md new file mode 100644 index 000000000..dc9b24cf3 --- /dev/null +++ b/fa/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: ولت یک قالب منبع باز است که به کمک آن می‌توانید یک پلتفرم سرور Paperweight خود را بر اساس Plazma توسعه دهید. +--- + +# ⚡ راهنمای توسعه ولت diff --git a/fi/origin/README.md b/fi/origin/README.md new file mode 100644 index 000000000..c28f29d51 --- /dev/null +++ b/fi/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Jos sinulla on kysyttävää, kysy Discordissa tai GitHub-keskusteluissa. +--- + +# 🏠 Tervetuloa Docs-portaaliin + +{% vinkki tyyli="info" %} + +**Plazman asiakirja on tällä hetkellä konekäännetty.** + +[![Käännöksen tila](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Osallistu käännöstyöhön ja paranna asiakirjaa [https://translate.plazmamc.org/](https://translate.plazmamc.org/). + +{% endhint %} + +### Jos sinulla on ongelmia Plazma-käytön aikana, mitä tehdä? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Jos olet kiinnostunut Thunderboltista, tutustu lisää. + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Jos haluat luoda oman palvelin alustan Voltilla, tässä on opas. + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Jos tarvitset lisää tietoa Minecraftista, tutustu tähän. + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/fi/origin/SUMMARY.md b/fi/origin/SUMMARY.md new file mode 100644 index 000000000..dab16aadf --- /dev/null +++ b/fi/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Sisällysluettelo + +- [🏠 Tervetuloa Docs-portaaliin](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Käyttöohjeet](plazma/README.md) +- [❓ Mikä on Plazma?](plazma/about/README.md) + - [⬇️ Lataa](plazma/about/downloads.md) + - [✅ Tuetut versiot](plazma/about/supported-versions.md) +- [⚒️ Palvelimen hallintaopas](plazma/administration/README.md) + - [👟 Aloittaminen](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Viite](plazma/administration/reference/README.md) + - [🖥️ Komennot](plazma/administration/reference/commands.md) + - [🛡️ Käyttöoikeudet](plazma/administration/reference/permissions.md) + - [🎛️ Argumentit ja ominaisuudet](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Ominaisuus](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Yleiset asetukset](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Maailmanlaajuiset kokoonpanot](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Yleiset asetukset](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Maailmanlaajuiset kokoonpanot](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Yleiset asetukset](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Maailmanlaajuiset kokoonpanot](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Syventäminen](plazma/administration/expert/README.md) + - [🧹 Optimointi](plazma/administration/expert/optimize.md) + - [🔀 Välityspalvelin](plazma/administration/expert/proxy.md) + - [↩️ Vanillaksi muuttaminen](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray esto](plazma/administration/expert/xray.md) + - [⚠️ Haavoittuvuudet ja niiden korjaaminen](plazma/administration/expert/fix-exploits.md) + - [⁉️ Usein kysytyt kysymykset](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Kehittäjän opas](plazma/developers.md) + - [✏️ Osallistu](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocit](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Käyttöopas](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Kehitysohje](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Lataa kaikki](plazma/about/downloads-all.md) diff --git a/fi/origin/miscellaneous/README.md b/fi/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/fi/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/fi/origin/plazma/README.md b/fi/origin/plazma/README.md new file mode 100644 index 000000000..fa56421fe --- /dev/null +++ b/fi/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma on avoimen lähdekoodin palvelin alusta Minecraft: Java Editionille, joka sisältää kokeellisen optimoinnin paperipohjaisen ja monien pelimekaniikkojen käyttäjämuokkauksen lisäyksiä." +--- + +# ✨ Plazma Käyttöohjeet + +## 👋 Tervetuloa Plazma-ohjeisiin + +Tervetuloa Plazman käyttöohjeisiin! + +{% vinkki tyyli="info" %} + +**Eikö ongelmaa voi ratkaista ohjeiden avulla?** + +[Virallinen Discord-palvelin](https://discord.gg/MmfC52K8A8) tai [GitHub-keskustelut](https://github.com/PlazmaMC/PlazmaBukkit/discussions) voivat auttaa yhteisön kysymyksissä! + +{% endhint %} + +### Tietoja Plazmasta + +> Tutustu siihen, mikä Plazma-palvelin alusta on. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Ylläpitäjille + +> Luo oma palvelimesi Plazmaa hyödyntäen. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Kehittäjille + +> Kehitä kolmannen osapuolen projekteja Plazmaa hyödyntäen. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/fi/origin/plazma/about/README.md b/fi/origin/plazma/about/README.md new file mode 100644 index 000000000..331a32b6a --- /dev/null +++ b/fi/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Tutustu siihen, mikä Plazma-palvelin alusta on. +--- + +# ❓ Mikä on Plazma? + +- **Plazma** on [Andromedan](https://github.com/EarendelArchived/Andromeda) ja [Fusionin](https://github.com/RuinedTechnologyUnify/Fusion) vahvuuksia yhdistävä [Paper](https://github.com/PaperMC/Paper)-pohjainen palvelin-alusta. +- Pyrimme tarjoamaan aina korkean vakauden ja tehokkaan suorituskyvyn, nopeat päivitykset sekä laajan valikoiman ominaisuuksia. + +## 📋 Plazman tavoitteet + +- Pyrimme olemaan palvelin-alusta, jolla on nopeat päivitykset ja korkea vakaus. +- Pyrimme tarjoamaan laajan valikoiman ominaisuuksia ja tehokasta suorituskykyä, joka ei häviä modi-alustoille. +- Pyrimme luomaan vapaan alustan, jolla voi muokata Vanilla-päivityksiä haluamallaan tavalla. + +## ⚙️ Tärkeimmät ominaisuudet + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Nopeimmat päivitykset**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) pitää Plazman mukana olevat patchit aina ajan tasalla, tarjoten nopeimmat päivitykset Paper-pohjaisista palvelin-alustoista. +6. **Perusmääritystiedoston optimointi**\ + Oletusarvoisesti mukana oleva määritystiedosto on optimoitu, joten sinun ei tarvitse optimoida sitä itse. +7. **Järjestelmällisesti toimiva monisäie**\ + Pelimekaniikkaan liittymättömät järjestelmämekanismit on asynkronisoitu vähentäen [viiveaikaa](#user-content-fn-4)[^4] ja optimoiden palvelimen toimintaa. +8. **Tarpeettoman tilan estäminen**\ + Samankaltaiset arvot on yhdistetty yhdeksi vähentäen muistin käyttöä. + +## ✨ Käyttötarkoitukset + +- **Monimutkainen lisäosa-alusta**\ + Kehittäjä [IPECTER](https://github.com/IPECTER) käyttää Plazmaa palvelimellaan.\ + Oma lisäosa, joka toimii NMS:llä ja heijastuksella, sekä laaja ja monimutkainen datapaketti on laajasti käytössä,\ + ja se pystyy vastaanottamaan yli 100 pelaajaa ilman suorituskyvyn laskua. +- **RPG-palvelimella ylläpidetty nopea suorituskykyalusta**\ + Yksi klusteri pystyi pitämään 100 pelaajaa vakaina ilman TPS-laskua,\ + ja neljässä klusterissa yhteensä 250 pelaajaa pystyi pelaamaan mukavasti. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Monet suoratoistolähetyksiä tekevät ovat valinneet alustan**\ + Monet suoratoistolähetyksiä tekevät ovat valinneet ja käyttävät sitä katsojien osallistumiskorina. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Lataa + +Voit ladata Plazman alla olevasta sivulta. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Haluatko tietää lisää tukemistamme versioista? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot lisäosat ja Paper, Pufferfish, Purpur lisäosat. + +[^2]: Toimii Microsoft Corporation. + +[^3]: Poistamalla chat-ilmoitusjärjestelmän voit käsitellä chat-viestejä vain palvelimella estäen Mojangin chatin seurannan. + +[^4]: Järjestelmämekanismin toiminnan vuoksi peli saattaa pysähtyä hetkeksi. diff --git a/fi/origin/plazma/about/downloads-all.md b/fi/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..2d2e3ca24 --- /dev/null +++ b/fi/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma suoritettavan tiedoston lataus Koko näyttö +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versio | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/fi/origin/plazma/about/downloads.md b/fi/origin/plazma/about/downloads.md new file mode 100644 index 000000000..c7a8dcfc3 --- /dev/null +++ b/fi/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Lataa Plazma nyt ja kokeile sitä itse. +--- + +# ⬇️ Lataa + +#### Haluatko tietää lisää tukemistamme versioista? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% vinkki tyyli="info" %} + +**Alla oleva lataus on tavallisen käyttäjän suoritettava tiedosto.** + +Jos olet kehittäjä ja tarvitset erityyppisen tiedoston, katso alla oleva sivu. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersioLataa
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Lataa +
1.20.1 + Lataa +
1.19.4 + Lataa +
+ +*** diff --git a/fi/origin/plazma/about/patches-list.md b/fi/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..d1ff313b2 --- /dev/null +++ b/fi/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Tutustu kaikkiin Plazmaan lisättyihin toimintoihin. +--- + +# 📑 Sisältyvät korjaukset diff --git a/fi/origin/plazma/about/supported-versions.md b/fi/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..dc2d09f46 --- /dev/null +++ b/fi/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Tutustu Plazman tukemaan Minecraft: Java Edition -versioon." +--- + +# ✅ Version tukema tila + +{% vinkki tyyli="info" %} + +**Plazma on kehitetty versiosta 1.19.4 alkaen, versiota 1.19.4 vanhempia versioita ei enää kehitetä.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: https://badge.plazmamc.org/1/kehityksessä +[atv]: https://badge.plazmamc.org/2/tuetaan +[fse]: https://badge.plazmamc.org/6/toiminnan%20tuki%20pysäytetty +[eol]: https://badge.plazmamc.org/4/tuki%20päättyi +[ukn]: https://badge.plazmamc.org/0/Tietoja%20ei%20ole +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normaali +[100]: https://badge.plazmamc.org/percent/100 + +![odottaa julkaisua][wtr] ![kehityksessä][idv] ![tuetaan][atv] ![toiminnan tuki pysäytetty][fse] ![tuki päättyi][eol] + +| Versio | Vakaus ja toiminnallisuuden tuki | Rakennustila | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![rakennuksen tila](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Rakennustila](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Rakennustila](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/fi/origin/plazma/administration/README.md b/fi/origin/plazma/administration/README.md new file mode 100644 index 000000000..b475ab7e6 --- /dev/null +++ b/fi/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Luo oma palvelimesi Plazmaa hyödyntäen. +--- + +# ⚒️ Palvelimen hallintaopas diff --git a/fi/origin/plazma/administration/diagnosis/README.md b/fi/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..0b89dd78b --- /dev/null +++ b/fi/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Tutustu ongelmatilanteiden käsittelytapoihin. +--- + +# 🧾 진단 diff --git a/fi/origin/plazma/administration/diagnosis/plugins.md b/fi/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..a5fbb51cf --- /dev/null +++ b/fi/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, miten korjata ongelmatilanteet, kun lisäosa ei toimi oikein. +--- + +# 📜 플러그인 diff --git a/fi/origin/plazma/administration/expert/README.md b/fi/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b1ba0b6ac --- /dev/null +++ b/fi/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, miten käsitellä Plazmaa ammattimaisesti. +--- + +# 🎓 Syventävä diff --git a/fi/origin/plazma/administration/expert/fix-exploits.md b/fi/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..e5ad6b5a7 --- /dev/null +++ b/fi/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Selvitä tunnetut haavoittuvuudet ja niiden korjaustavat. +--- + +# ⚠️ Tunnetut haavoittuvuudet ja niiden korjaustavat diff --git a/fi/origin/plazma/administration/expert/optimize.md b/fi/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..eb869b6c5 --- /dev/null +++ b/fi/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, miten optimoida Plazma. +--- + +# 🧹 Optimalisointi diff --git a/fi/origin/plazma/administration/expert/proxy.md b/fi/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..e3f84fa1c --- /dev/null +++ b/fi/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, miten turvallinen "Velocity"-proksialusta konfiguroidaan. +--- + +# 🔀 Proksi diff --git a/fi/origin/plazma/administration/expert/vanillaize.md b/fi/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..ea894d20a --- /dev/null +++ b/fi/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Selvitä, miten palautetaan Paper ja vaniljan korjauspaketti. +--- + +# ↩️ Vaniljoida + +{% hint style="warning" %} + +**Paper ei sisällä vaihtoehtoja useimpiin vaniljan virheiden korjauspaketteihin.** + +Tällä hetkellä Plazma kehittää tapaa poistaa tällaiset virheet asetuksista. + +Siksi tämä opas on vielä kesken ja tiedot voivat muuttua milloin tahansa. + +{% endhint %} diff --git a/fi/origin/plazma/administration/expert/xray.md b/fi/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..d4ddc3021 --- /dev/null +++ b/fi/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Selvitä erilaisia sisäänrakennettuja tapoja estää X-Ray. +--- + +# 🩻 Estä X-Ray diff --git a/fi/origin/plazma/administration/faq.md b/fi/origin/plazma/administration/faq.md new file mode 100644 index 000000000..5854e6497 --- /dev/null +++ b/fi/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Selvitä usein kysytyt kysymykset. +--- + +# ⁉️ Usein kysytyt kysymykset + +{% vinkki tyyli="info" %} + +**Etkö löydä haluamaasi vastausta?** + +[Virallinen Discord-palvelin](https://discord.gg/MmfC52K8A8) tai [GitHub-keskustelut](https://github.com/PlazmaMC/PlazmaBukkit/discussions) voivat auttaa yhteisön kysymyksissä! + +{% endhint %} + +### Plazma ei käynnisty + +Jos konsolissa ilmestyy `no main manifest attribute, in plazma-(version).jar` viesti,\ +ladattu tiedosto on kehitystarkoituksiin tarkoitettu API-tiedosto, ja sinun pitää ladata **Reobf Paperweight** GitHub-sivulta. + +Lisätietoja löytyy seuraavalta sivulta. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Palvelimen käynnistyessä varoitus ilmestyy + +Plazma sisältää joitain epävakaata korjausta ja saattaa aina toimia virheellisesti, joten se näyttää seuraavan varoituksen palvelimen käynnistyessä. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Tämä varoitus voidaan poistaa käytössä [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] järjestelmäominaisuudella. + +Lisätietoja löytyy seuraavalta sivulta. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Saatavilla alkaen 1.20.1 diff --git a/fi/origin/plazma/administration/getting-started/README.md b/fi/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..a399766ce --- /dev/null +++ b/fi/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Selvitä, miten luodaan palvelin Plazma-sovelluksella. +--- + +# 👟 Aloita + +Plazman vakaa käyttö vaatii, että järjestelmä täyttää seuraavat vaatimukset. + +| | Vähimmäisvaatimukset | Suositellut | +| :-----------: | -------------------- | ----------- | +| Arkkitehtuuri | x64 | - | +| RAM-muisti | 8GB | 16GB | +| Tallennustila | 1GB | 8GB | +| JDK | 17 | 21 | + +Sujuvan asetustiedoston muokkauksen varmistamiseksi on hyvä asentaa muokkausohjelma, kuten [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Oikea tuloste" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' on sisäinen tai ulkoinen komento, suoritettava ohjelma tai +erätaulukko. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Tunnistamaton vaihtoehto: --version +Virhe: Java Virtual Machine -ympäristön luominen ei onnistunut. +Virhe: Vakava poikkeus on tapahtunut. Ohjelma sulkeutuu. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Lataa ensin [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) ja asenna **JDK 21** `.msi`-muodossa. +2. Suorita ladattu asennusvelho ja napsauta `Seuraava`. +3. Aktivoi `Aseta JAVA_HOME-muuttuja` vasemman keskellä olevasta valikosta ja napsauta sitten `Seuraava`. +4. Klikkaa `Asenna` JRE:n asentamiseksi ja valitse `Valmis`. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Asenna sitten JRE suorittamalla seuraava komento terminaalissa. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazman lataaminen + +Plazma tarjoaa useita erilaisia suoritustiedostoja. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Lisätietoja + +Suoritustiedoston nimi on `plazma-(versionhallinta)-1.20.4-R0.1-SNAPSHOT-(kartoitusmuoto).jar`. + +- **Kartoitusmuoto**\ + Kartoitus yhdistää Minecraftin todellisen koodin ja käännetyn koodin eräänlaiseksi kartaksi. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojangin määrittämä, vanilja Minecraft -kartoitus. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Versionhallinta**\ + Versionhallinta on palvelimen käynnistämiseen tarvittava kirjasto ja palvelimen tiedostojen korjaaja. + - **Paperclip**\ + PaperMC-tiimi kehitti Paperin ja muut johdetut alustat, jotka lataavat kirjastoja ja soveltavat korjauksia palvelimelle. + - **Bundler**\ + Vanilla Minecraftin versionhallinta. + +
+ +*** + +## 3. Käynnistyskomentosarjan luominen + +Plazman käynnistämiseksi helposti ja palvelimen automaattiseksi uudelleenkäynnistämiseksi sinun on luotava [käynnistyskomentosarja](#user-content-fn-6).[^6] + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Voit ladata käynnistyskomentosarjan napsauttamalla vasemmassa alakulmassa olevaa Lataa-painiketta.\ +**Varmista, että ladattu käynnistyskomentosarja vastaa omaa käyttöjärjestelmääsi.** + +*** + +## 4. Tiedostojen järjestely + +Siirrä nyt ladattu käynnistyskomentosarja ja Plazma uuteen kansioon. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Käynnistä nyt käynnistyskomentosarja. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA:n hyväksyminen + +Kun käynnistyskomentosarja on suoritettu kerran, kansioon luodaan `eula.txt`-tiedosto. + +EULA[^9] on sopimus, joka on hyväksyttävä käyttämällä [Mojang Studiosin](#user-content-fn-10)[^10] palveluita. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Hyväksyäksesi EULA:n muuta `eula.txt`-tiedoston `eula=false` muotoon `eula=true` ja tallenna se. + +*** + +## 6. Ulkoisen yhteyden salliminen (Windows) + +Nykyiset käyttöjärjestelmät estävät oletusarvoisesti vaarallisen ulkoisen pääsyn estääkseen sitä palomuurilla ja reitittimellä. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Jos reititin ei tue UPnP:tä, sinun on etsittävä tietoa erikseen, koska paneelit vaihtelevat reitittäin. + +Voit myös luoda väliaikaisen osoitteen [Ngrok](https://ngrok.com/) kautta. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Portinohjauksen tarpeen tarkistus + +Kirjoita ja suorita seuraava komento Suorita-ikkunassa. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jos tuloste on `True`, voit lopettaa tässä, mutta jos se on `False`, sinun on tehtävä portinohjaus. + +### 6.2 Yhteys palvelimeen + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Palvelimelle yhdistettäessä käytettävä osoite voidaan tarkistaa [täältä](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Tämän jälkeen, jos käynnistät palvelimen uudelleen, Plazma yrittää automaattisesti portinohjausta. + +Alla oleva viesti kertoo UPnP:n onnistumisesta ja konsolissa se näkyy muodossa `[UPnP] (viesti)`. + +| Viesti | Merkitys | +| ---------------------------------------- | ----------------------------------------------------------- | +| `Portti (portti) avattiin onnistuneesti` | Portinohjaus onnistui. | +| `Portti (portti) on jo avoinna` | Toinen palvelu käyttää jo kyseistä porttia. | +| `Portin (portti) avaaminen epäonnistui` | Portinohjaus epäonnistui. | +| `Palvelu ei ole käytettävissä` | Reititin ei tue UPnP:tä. | + +Palvelimen sammuttua Plazma sulkee portin automaattisesti. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Lataa [Ngrokin verkkosivustolta](https://ngrok.com/download) `Windows (64-bit)` ZIP-tiedosto. +2. Sijoita ladattu Ngrok palvelimen kansioon. +3. Luo [autentikointitunnus](https://dashboard.ngrok.com/get-started/your-authtoken) Ngrokin hallintapaneelissa. +4. Suorita palvelimen kansiosta näytettävä komento `Command Line`. +5. Lisää suoritusskriptin ylimpään kohtaan `start /b ngrok tcp --region jp 25565`, alimpaan kohtaan `taskkill /f /t /im ngrok.exe`. +6. Konsolissa näytettävästä `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` osoitteesta `0.tcp.jp.ngrok.io:12345` on palvelimen osoite. +7. Nyt voit yhdistää ulkoisesti kyseiseen osoitteeseen. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Esimerkiksi, kun komento on suoritettu, ja tuloste on seuraavanlainen, + +```log +Windows IP konfiguraatio + +Ethernet-sovitin Ethernet: + + Yhdistetty DNS-etuliite. . . . : + IPv4-osoite. . . . . . . . . : 192.168.3.7 + Aliverkon peite . . . . . . . : 255.255.255.0 + Oletusyhdyskäytävä . . . . . . : 192.168.3.1 + +``` + +Yritä yhdistää paikallisesti palvelimeen käyttämällä `192.168.3.7` IPv4-osoitetta. + +Jos palvelin ja peli toimivat samalla tietokoneella, voit yhdistää käyttäen `localhost` osoitetta. +{% endtab %} +{% endtabs %} + +## 7. Kehittyä + +Kun palvelin on onnistuneesti käynnistetty ja toimii oikein, on aika mukauttaa palvelinta. + +Katso alla olevasta oppaasta, miten voit mukauttaa palvelinta. + +{% content-ref url="seuraava-askel.md" %} +[seuraava-askel.md](seuraava-askel.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paperin perustana toimiva Plazma perustuu Spigotiin, joka puolestaan perustuu viralliseen palvelinplatformiin. + +[^3]: Windows-näppäin + R + +[^4]: Linuxissa voit tarkistaa Java-version komennolla `java --version` + +[^5]: JRE on yksi avoimen lähdekoodin projekteista, jota on erilaisia versioita, kuten Minecraft palvelinplatformilla. + +[^6]: Yleisesti tunnetaan **käynnistäjänä**. + +[^7]: Kun "Auto-restart" on aktivoitu, palvelin käynnistyy automaattisesti uudelleen. Voit sulkea palvelimen syöttämällä `Control + C`. + +[^8]: Suositellaan välttämään yli puolet järjestelmän resursseista. + + Esimerkiksi, jos järjestelmän kokonaismuistin määrä on 8GB, ei suositella asettamaan yli 4GB. + +[^9]: End-User License Agreement, loppukäyttäjän lisenssisopimus. Lisätietoja löytyy [Minecraftin verkkosivuilta](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Korealaisen lainsäädännön mukaan peliteollisuuden edistämisestä annetun lain 32 §:n 1 momentin 9 kohdan mukaan **Korean Microsoft Corporation** voi nostaa oikeudellisen syytteen. + +[^12]: Universal Plug & Play. Plazmaan sisältyvä Purpur kommunikoi automaattisesti reitittimen kanssa tämän tekniikan avulla, joten sinun ei tarvitse tehdä portinohjausta suoraan, koska portti avataan vain silloin, kun palvelin on käynnissä. + +[^13]: Jos sinulla ei ole tiliä, rekisteröidy Ngrokkiin Google- tai GitHub-tilin kautta. diff --git a/fi/origin/plazma/administration/getting-started/customization.md b/fi/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..cce6c1cea --- /dev/null +++ b/fi/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,124 @@ +--- +description: Opi muokkaamaan palvelinta käyttäjän tarpeiden mukaan. +--- + +# 🎨 Käyttäjän mukauttaminen + +Käyttäessäsi muokattua palvelin-alustaa kuten Plazmaa, et käytä Mojang Studiosin virallista palvelin-alustaa. Tämä johtuu siitä, että voit tehdä erittäin vahvaa **käyttäjäkohtaistamista**. + +Alla on useita tapoja muokata ja hyödyntää Plazmaa. + +## Rakenne muokkaus + +Perus tapa käyttäjäkohtaistaa Plazma on muokata rakennetta. + +Plazma tarjoaa vahvoja asetusmahdollisuuksia pelin mekaniikoista hirviöiden ominaisuuksiin. + +Katso lisätietoja Plazman rakenteesta alla olevasta linkistä. + +{% content-ref url="../reference/configurations/" %} +[asetukset](../reference/configurations/) +{% endcontent-ref %} + +## Liitännäisten käyttö + +{% hint style="success" %} + +**Plazma tukee kaikkia Paper-pohjaisia laajennuksia.** + +Spigot-laajennusten osalta 1.20.5:stä alkaen Paperin määritysmuutosten vuoksi jotkut eivät ehkä toimi, mutta Plazman avulla +useimmat Paperiin perustuvat laajennukset, kuten Paper, Pufferfish ja Purpur, toimivat myös Plazmassa +ja jos ne eivät toimi oikein, se johtuu Plazman virheestä, joten [ilmoita siitä välittömästi.](../diagnosis/plugins.md) + +{% endhint %} + +Plazman käyttöä ja personointia varten tämä on tärkein syy ja tehokkain tapa. +Plazman vahva laajennusyhteisö mahdollistaa palvelimen helpon personoinnin. + +Laajennuksen etsimiseen ja lataamiseen on useita tapoja. Jotkut laajennukset ladataan +julkiseen varastopalveluun ja jotkut ladataan GitHubiin tai omaan +verkkosivustoon. + +{% hint style="caution" %} + +**Laajennus voi käyttää järjestelmää suoraan!** + +Käytä aina VirusTotalin kaltaisia palveluita varmistaaksesi, että laajennus on turvallinen ennen sen käyttöönottoa +tai lataa laajennus luotettavasta palvelusta. + +{% endhint %} + +Laajennuksen lataamiseen on useita palveluita. Näistä [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) ja muut palvelut käyvät läpi laajennukset ennen niiden julkaisua varmistaakseen, että vain turvalliset laajennukset jaetaan. + +### Laajennuksen soveltaminen + +Kun olet ladannut laajennuksen, on aika soveltaa sitä. + +1. Laajennus on `.jar`-tai `Java-suoritettava tiedosto`.\ + Jotkut laajennukset ovat pakattuina, joten + purkaessasi huomioi tiedostonimessä olevat `bukkit`, `spigot` tai `paper` sekä + `fat`-tiedoston, jos sellainen on, käytä sitä. +2. Siirrä ladattu tiedosto palvelimen `plugins`-kansioon ja käynnistä palvelin uudelleen. +3. Kun Plazma käynnistyy, konsoliin ilmestyy uutta sisältöä. + Tämä tarkoittaa, että Plazma on ladannut laajennuksen onnistuneesti. +4. Vaikka Plazma on ladannut laajennuksen onnistuneesti, se ei välttämättä ole käynnistänyt sitä. + Käyttämällä komentoa `/plugins` voit tarkistaa ladatut laajennukset palvelimella. + Jos asennettu laajennus ei ole punainen + vaan vihreä, se on ladattu onnistuneesti. + +Jos laajennus ei ole ladattu onnistuneesti, voit löytää ratkaisun ongelmaan alla olevasta linkistä. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Data packien käyttö + +Data packit ovat Minecraftin tarjoamia käyttäjämuokkauksen tapoja, jotka ovat samankaltaisia kuin +[resurssipaketit](#user-content-fn-1)[^1]. + +Data packien avulla voit muokata pelin sisäisiä osia, kuten lisätä uusia olentoja ja haasteita. + +{% hint style="caution" %} + +**Data packit voivat vahingoittaa maailmaa!** + +Jotkut vialliset data packit voivat vahingoittaa maailmaa peruuttamattomasti. + +Siksi ennen data packin soveltamista on suositeltavaa varmuuskopioida maailma. + +{% endhint %} + +Data packit ovat saatavilla useista palveluista, kuten [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) ja muut. + +Kun olet ladannut data packin, voit soveltaa sitä lisäämällä sen palvelimen maailman `datapacks`-kansioon. +Jos kansiota ei ole, voit luoda sen ja lisätä data packin sinne. + +{% hint style="warning" %} + +**Joissakin [data packeissa](#user-content-fn-2)[^2] ensimmäisellä sovelluskerralla niitä ei ehkä sovelleta oikein.** + +Tässä tapauksessa suositellaan palvelimen **2 kertaa** uudelleenkäynnistämistä. + +{% endhint %} + +Data packit voivat helposti vahingoittua, kun Minecraft päivitetään uuteen versioon. + +Erityisesti jos data pack on täysin vioittunut, se voi aiheuttaa palvelimen kaatumisen, +joten ennen päivitystä on tärkeää tehdä riittävästi testejä. + +{% vinkki tyyli="info" %} + +**Voit syöttää `safeMode` palvelimen käynnistyskomentoon poistaaksesi kaikki data packit käytöstä.** + +[Lisätietoja löytyy kohdasta `Viitteet > Argumentit`.](../reference/arguments.md) + +{% endhint %} + +Sovellatut data packit voit tarkistaa komennolla `/datapack list`. + +*** + +[^1]: Tai Minecraft: Bedrock Editionin lisäosat. + +[^2]: Kuten uusia olentoja. diff --git a/fi/origin/plazma/administration/getting-started/next-step.md b/fi/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..fa18a321b --- /dev/null +++ b/fi/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Opi muokkaamaan palvelinta käyttäjän tarpeiden mukaan. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Alla on useita tapoja muokata ja hyödyntää Plazmaa. + +## Rakenne muokkaus + +Perus tapa käyttäjäkohtaistaa Plazma on muokata rakennetta. + +Plazma tarjoaa vahvoja asetusmahdollisuuksia pelin mekaniikoista hirviöiden ominaisuuksiin. + +Katso lisätietoja Plazman rakenteesta alla olevasta linkistä. + +{% content-ref url="../reference/configurations/" %} +[asetukset](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Liitännäisten käyttö + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazman käyttöä ja personointia varten tämä on tärkein syy ja tehokkain tapa. Plazman vahva laajennusyhteisö mahdollistaa palvelimen helpon personoinnin. + +Laajennuksen etsimiseen ja lataamiseen on useita tapoja. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Laajennuksen lataamiseen on useita palveluita. Näistä [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) ja muut palvelut käyvät läpi laajennukset ennen niiden julkaisua varmistaakseen, että vain turvalliset laajennukset jaetaan. + +### Laajennuksen soveltaminen + +Kun olet ladannut laajennuksen, on aika soveltaa sitä. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Siirrä ladattu tiedosto palvelimen `plugins`-kansioon ja käynnistä palvelin uudelleen. +3. Kun Plazma käynnistyy, konsoliin ilmestyy uutta sisältöä. Tämä tarkoittaa, että Plazma on ladannut laajennuksen onnistuneesti. +4. Vaikka Plazma on ladannut laajennuksen onnistuneesti, se ei välttämättä ole käynnistänyt sitä. Käyttämällä komentoa `/plugins` voit tarkistaa ladatut laajennukset palvelimella. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Jos laajennus ei ole ladattu onnistuneesti, voit löytää ratkaisun ongelmaan alla olevasta linkistä. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Data packien käyttö + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Data packien avulla voit muokata pelin sisäisiä osia, kuten lisätä uusia olentoja ja haasteita. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Jotkut vialliset data packit voivat vahingoittaa maailmaa peruuttamattomasti. + +Siksi ennen data packin soveltamista on suositeltavaa varmuuskopioida maailma. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Kun olet ladannut data packin, voit soveltaa sitä lisäämällä sen palvelimen maailman `datapacks`-kansioon. Jos kansiota ei ole, voit luoda sen ja lisätä data packin sinne. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Tässä tapauksessa suositellaan palvelimen **2 kertaa** uudelleenkäynnistämistä. +{% endhint %} + +Data packit voivat helposti vahingoittua, kun Minecraft päivitetään uuteen versioon. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Sovellatut data packit voit tarkistaa komennolla `/datapack list`. + +*** + +## Optimointi + +Plazmassa on paljon optimointipäivityksiä. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Välityspalvelin + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Katso turvalliset ja oikeat välityspalvelinasetukset alla olevasta sivusta. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Turvallisuus + +Minecraftin kehittyessä verkossa on helppo saada [haavoittuvuushyökkäysmoottori](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Käyttöoikeudet + +Joissakin lisäosien hallintakomennoissa voi olla haavoittuvuuksia, jos käyttöoikeudet eivät ole oikein määritetty. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray-esto + +X-Ray on yksi helpoimmin käytettävissä olevista haavoittuvuuksista perusoptimointi asiakkaissa. + +Plazmassa on oletusarvoisesti X-Rayn estämiseen tarvittava rakenne. + +Katso X-Ray-eston menetelmät ja selitykset alla olevasta sivusta. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Käytä `/whitelist query` nähdäksesi sallitut pelaajat. + +*** + +[^1]: Tai Minecraft: Bedrock Editionin lisäosat. + +[^2]: Kuten uusia olentoja. + +[^3]: Yleisesti tunnetaan "hakkeroinnista". + +[^4]: Jos asetukset eivät ole optimaaliset, Plazma on vanhentunut tai uusia haavoittuvuuksia on löydetty, ne eivät välttämättä ole estettyjä. + +[^5]: Pelaajat liittyvät palvelimeen Ngrok-välityspalvelimen kautta, ja jokaisen uudelleenkäynnistyksen yhteydessä annettu Ngrok-osoite vaihtelee. diff --git a/fi/origin/plazma/administration/reference/README.md b/fi/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..bf0d93cb1 --- /dev/null +++ b/fi/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Tutustu Plazman tarjoamiin oletuskäyttäjän mukauttamistapoihin. +--- + +# 📜 리퍼런스 + +Plazmassa on useita erilaisia käyttäjän mukauttamistapoja. + +Neljä alla olevaa tapaa ovat käyttäjän mukauttamistapoja, joita voi käyttää ilman lisätoimenpiteitä. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Virallinen Discord-palvelin](https://discord.gg/MmfC52K8A8) tai [GitHub-keskustelut](https://github.com/PlazmaMC/PlazmaBukkit/discussions) voivat auttaa yhteisön kysymyksissä! +{% endhint %} + +*** + +## 🖥️ Komennot + +> Komennot mahdollistavat tiedon keräämisen pelissä tai peliympäristön mukauttamisen käyttäjän tarpeiden mukaan. + +{% content-ref url="komennot.md" %} +[komennot.md](komennot.md) +{% endcontent-ref %} + +*** + +## 🛡️ Käyttöoikeudet + +> Käyttöoikeudet määrittävät pelaajan vuorovaikutusmahdollisuudet. + +{% content-ref url="kaytto-oikeudet.md" %} +[kaytto-oikeudet.md](kaytto-oikeudet.md) +{% endcontent-ref %} + +*** + +## 🎛️ Parametrit ja ominaisuudet + +> Parametrit ja ominaisuudet vaikuttavat Plazman toimintaan kokonaisuutena. + +{% content-ref url="parametrit.md" %} +[parametrit.md](parametrit.md) +{% endcontent-ref %} + +*** + +## 📋 Asetukset + +> Asetukset ovat perustapa mukauttaa Plazmaa. + +{% content-ref url="asetukset/" %} +[asetukset](asetukset/) +{% endcontent-ref %} + +*** diff --git a/fi/origin/plazma/administration/reference/arguments.md b/fi/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..9c4f71bdf --- /dev/null +++ b/fi/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Tutustu käynnistysparametreihin ja järjestelmäominaisuuksiin. +--- + +# 🎛️ Parametrit ja ominaisuudet + +Aloitusparametrit ja järjestelmäominaisuudet ovat Plazman suorituksessa käytettäviä komentoja täydentäviä arvoja, jotka vaikuttavat Plazman toimintaan kokonaisuutena. + +[Käynnistysparametrit](#user-content-fn-2)[^2] ja **järjestelmäominaisuudet** jaetaan **käynnistysparametreihin** ja **järjestelmäominaisuuksiin**. + +*** + +## Järjestelmäominaisuus + +Järjestelmäominaisuus syötetään `-jar`-parametrin eteen ja sitä käsitellään JVM:ssä ennen Plazman alustamista. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Käyttöohje + +Järjestelmäominaisuudet syötetään Java-käskyparametreina `java` ja `-jar` välissä. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` ilmaisee, että kyseinen parametri ei ole JVM:ssä sisäänrakennettu vaan lisätty Plazmalle erityinen parametri, + +Jos arvoa ei anneta, arvoksi asetetaan [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Kaikki järjestelmäominaisuudet + +#### `convertLegacySigns` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Päivittää käytöstä poistettuja kylttejä. + +#### `debug.entities` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi entiteettitietoihin liittyvät vianmäärityslokit. + +#### `debug.rewriteForIDE` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Deaktivoi NMS-revision oikeanlaisen latauksen IDE:stä ja automaattisesti uudelleenkartoittaa sisäiset versiot. + +#### `disable.watchdog` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä Spigotin vartijan varoitusjärjestelmän. + +#### `letMeReload` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä `/reload`-komentoon liittyvän varmistusviestin. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Jos olet lisäosakehittäjä ja sinun on päivitettävä lisäosaa, käytä `hotswap`-toimintoa `/reload`-käytön sijaan. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä lisäosan, joka käyttää standardia tulo-lähtöjärjestelmää. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Varoittaa, kun vanhentunut muotoilu havaitaan keskustelukomponentissa. + +#### `Paper.bypassHostCheck` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä palvelimeen liittyvä kuviovalidointi, kun pelaaja yrittää liittyä palvelimeen. + +#### `Paper.debugDynamicMissingKeys` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi vianmäärityslokit puuttuvista avaimista NBT-objekteissa. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi vianmäärityslokit päättömien päälohkojen virheellisistä profiileista. + +Tämä kirjaa kaikki virheelliset päälohkot sijainteineen maailmassa. + +#### `Paper.disableChannelLimit` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä lisäosien luokan priorisointijärjestelmän. + +Hyödyllinen ongelmatilanteissa, joissa lisäosan varjostus aiheuttaa ongelmia. + +#### `Paper.disableFlushConsolidate` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä Netty-tiedonsiirron tiivistyksen. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Oletusarvo**: `750` + +Jos entiteettejä on enemmän kuin asetettu arvo, ne lähetetään useampina paketteina. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Oletusarvo**: `8192` + +Asettaa maksimikokoisen paketin, jonka palvelin voi vastaanottaa kerralla. + +#### `Paper.ignoreJavaVersion` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä Java-version tarkistuksen. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Tämä voi aiheuttaa pysyvää vahinkoa maailmoille ja yleisille tiedostoille, ja pelin koko mekaniikka voi hajota. + +Kaikki tämän käytön aiheuttamat ongelmat ovat käyttäjän vastuulla, eikä Plazma tarjoa tukea tähän. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Oletusarvo**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Oletusarvo**: `80` + +Asettaa kyltin yhdellä rivillä näytettävien merkkien enimmäismäärän. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Oletusarvo**: `(maailman versio) + 1` + +Asettaa alustettavien maailman päivitystietojen version ensin. + +Hyödyllinen massiivisten alueiden päivityksissä, mutta muissa tapauksissa tarpeeton. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `True` + +Aktivoi YAML-tiedostojen kommenttien käsittelyn. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Oletusarvo**: `30` + +Kun pelaaja ei ole lähettänyt mitään tietoa annetun ajan (sekunteina), pelaaja poistetaan palvelimelta. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Ohittaa palvelimen ominaisuuksien kommentit. + +#### `Paper.debug-sync-loads` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi synkronisen alueen luonnin vianmäärityslokit. + +#### `Paper.enable-sync-chunk-writes` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi Minecraftin [oletus alueen kirjoitusjärjestelmän](#user-content-fn-10)[^10]. + +Tämä tallentaa jokaisen alueen peräkkäin, mikä aiheuttaa merkittävää suorituskyvyn laskua. + +#### `Paper.explicit-flush` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi verkon kanavan suoran tyhjennyksen. + +#### `Paper.strict-thread-checks` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Kirjaa aina pääsäikeessä tapahtuvat virheet. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Varoittaa, jos aikataulutettu tehtävä kestää liian kauan. + +#### `Paperclip.patchOnly` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Käytettäessä oletustiedostoa, sovellus käynnistetään vain patchia levittämällä ilman palvelimen käynnistämistä. + +#### `Plazma.aggressiveOptimize` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` +- **Yhteentörmäys**: `Plazma.disableConfigOptimization` + +Vahvistaa alkuperäisen kokoonpanon optimointia. + +Sen ollessa käytössä palvelin nopeutuu ja turvallisuus lisääntyy, mutta se voi vaikuttaa merkittävästi pelikokemukseen. + +#### `Plazma.disableConfigOptimization` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` +- **Yhteentörmäys**: `Plazma.aggressiveOptimize` + +Ei optimoi alkuperäistä kokoonpanoa. + +Tämä asettaa käyttöön Paperin oletuskokoonpanon. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` + +Poistaa Plazman brändäyksen käytöstä ja asettaa käytettäväksi vanillan peruspalvelimen faviconin. + +#### `Plazma.useVanillaConfiguration` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` +- **Yhteentörmäys**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Tällä voi olla merkittävä vaikutus palvelimen turvallisuuteen ja suorituskykyyn. + +Kaikki tämän ominaisuuden aiheuttamat ongelmat ovat palvelimen ylläpitäjän vastuulla. +{% endhint %} + +Tuottaa alkuperäisen kokoonpanon Mojangin tarjoamilla oletusarvoilla. + +Tämä poistaa käytöstä kaikki Paperissa sovelletut haavoittuvuuden korjaukset. + +Haavoittuvuuden korjaukset voidaan aktivoida uudelleen Paperin tai Plazman asetuksissa. + +#### `Plazma.vanillaize` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `true` +- **Yhteentörmäys**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Asettaa alkuperäisen kokoonpanon lähemmäksi vaniljaa. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Käytöstä poistettu ominaisuus + +Seuraavat järjestelmän ominaisuudet ovat käytöstä poistettuja ominaisuuksia. + +#### `timings.bypassMax` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` +- **Käytöstä poistettu**: Timings on poistettu käytöstä Plazmasta eteenpäin + +Päätetäänkö arvojen lähettäminen Aikarin Timings API:in ylittääkö maksimin. + +Vaikka näin tehtäisiin, jos API:ssa ei käsitellä poikkeusta, rajoitus asetetaan voimaan. + +*** + +## Aloitusparametri + +Aloitusparametri syötetään `-jar *.jar` jälkeen, kun Plazma on alustettu ja sitä käsitellään samanaikaisesti. + +### Käyttöohje + +Järjestelmän ominaisuudet syötetään ohjelman komentoparametreina `-jar *.jar` jälkeen. + +Esimerkiksi, jos haluat käyttää `nogui` aloitusparametria,\ +seuraavasti syöttämällä Plazma käsittelee `nogui` parametria alustuksen aikana. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Koko aloitusparametri + +#### `bukkit-settings` + +- **Alias**: `b` +- **Oletusarvo**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Oletusarvo**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Oletusarvo**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Käynnistää palvelimen demomaailmassa. + +#### `eraseCache` + +Poistaa jäljellä olevat välimuistitiedostot maailman päivityksen jälkeen. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Tulostaa Plazman koko aloitusparametrit ja niiden kuvaukset. + +#### `initSettings` + +Luo vain asetustiedoston ja sulkee palvelimen. + +#### `jfrProfile` + +Aktivoi JFR-profiloinnin. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Poistaa graafisen käyttöliittymäpaneelin käytöstä. + +#### `nojline` + +Poistaa JLinen käytöstä ja käyttää vaniljan konsolia. + +#### `online-mode` + +- **Alias**: `o` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Valitsee, tarkistetaanko pelaajat Mojangin todennuspalvelimella. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Oletusarvo**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Asettaa käytöstä poistetun PaperSpigotin konfiguraatiotiedoston sijainnin. + +Tätä käytetään siirtämään vanhaa konfiguraatiota uuteen konfiguraatiotiedostoon, eikä sitä käytetä sen jälkeen. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Oletusarvo**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Oletusarvo**: `plugins` + +Asettaa liitännäisten kansion sijainnin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Oletusarvo**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Oletusarvo**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Käynnistää palvelimen täyteen vaniljatilaan. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Asettaa palvelimen portin. + +#### `server-name` + +- **Oletusarvo**: `A Plazma Server` + +Asettaa palvelimen nimen. + +#### `spigot-settings` + +- **Alias**: `S` +- **Oletusarvo**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Tulostaa Plazman version. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Oletusarvo**: `(palvelimen kansio)` + +Asettaa maailmatiedostojen sijainnin. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Asettaa maailmatiedoston nimen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Riippuen lisätyistä sijainneista, sijainti, joka käsittelee parametrit, muuttuu. + +[^3]: Esimerkiksi asettaessa `Plazma.iKnowWhatIAmDoing` arvoon `true` (aktivoituna), voit käyttää `-DPlazma.iKnowWhatIAmDoing` sijaan pelkkää `-DPlazma.iKnowWhatIAmDoing`, ja se toimii samalla tavalla. + +[^4]: Esimerkiksi `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Tapahtumien havaitseminen. + +[^6]: Tapahtumien havaitseminen. + +[^7]: Asiakas. + +[^8]: Signaali, joka ilmoittaa, että palvelin on yhteydessä normaalisti, kuten sydämen syke. + +[^9]: Käyttämällä Purpurin AFK-karkotustoimintoa voit karkottaa myös poissaolevat pelaajat. + +[^10]: Synkronoitu palan luontijärjestelmä, Sync Chunk Write System. + +[^11]: `VAROITUS! Plazma saattaa aiheuttaa odottamattomia ongelmia, joten varmista, että testaat sen perusteellisesti ennen käyttöä julkisella palvelimella.` + +[^12]: Pelissä `maailman optimointi` toimii samalla periaatteella. + +[^13]: `Tason 2` ylläpitäjät on suljettu pois. + +[^14]: Internet-protokolla, IP. diff --git a/fi/origin/plazma/administration/reference/commands.md b/fi/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..a0deb9ab6 --- /dev/null +++ b/fi/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Tutustu Plazmassa käytettävissä oleviin komennoihin. +--- + +# 🖥️ Komennot diff --git a/fi/origin/plazma/administration/reference/configurations/README.md b/fi/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..6159b4932 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Asetukset ovat perustapa mukauttaa Plazmaa. +--- + +# 🧾 구성 + +*** + +## 🪨 Ominaisuudet + +> Ominaisuudet ovat Minecraftissa tarjottava perustiedosto. Ominaisuuksien avulla voit muuttaa pelin perusmekaniikkaa. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkitin rakenne + +> Bukkitin rakenne on Plazman tarjoama perustiedosto. Bukkitin rakenteen avulla voit muuttaa Minecraft-palvelimen perusmekaniikkaa. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigotin rakenne + +> Spigotin rakenne mahdollistaa pelin yksityiskohtien, pelaajien käsittelyn, komentojen jne. muokkaamisen ja viestien muuttamisen. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paperin rakenne + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfishin + +> Pufferfishin rakenne mahdollistaa Plazman maailman ja olentojen käsittelyn muuttamisen. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpurin rakenne + +> Purpurin ominaisuudet mahdollistavat pelin yleisten perustietojen muokkaamisen. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazman rakenne + +> Plazman rakenne mahdollistaa Plazman toimintojen mukauttamisen. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/fi/origin/plazma/administration/reference/configurations/bukkit.md b/fi/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f316f93ff --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kukin bukkit.yml-tiedoston solmu tarkoittaa. +--- + +# 🪣 Bukkit diff --git a/fi/origin/plazma/administration/reference/configurations/paper/README.md b/fi/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..942906979 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mihin tarkoitukseen kunkin config-kansion tiedosto on tarkoitettu. +--- + +# 🛩️ Paper diff --git a/fi/origin/plazma/administration/reference/configurations/paper/global.md b/fi/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..5a3dfcb45 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen solmu paper-global.yml-tiedostossa tarkoittaa. +--- + +# 🌏 전역 구성 diff --git a/fi/origin/plazma/administration/reference/configurations/paper/world.md b/fi/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..d58e5cce1 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Selvitä, mitä jokainen paper-world.yml-tiedoston solmu tarkoittaa. +--- + +# 🏳️ 세계별 구성 + +Maailmanlaajuinen diff --git a/fi/origin/plazma/administration/reference/configurations/plazma/README.md b/fi/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..192fc3e16 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mihin tarkoitukseen kunkin config-kansion tiedosto on tarkoitettu. +--- + +# ✨ Plazma diff --git a/fi/origin/plazma/administration/reference/configurations/plazma/global.md b/fi/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..e7857c173 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen plazma-global.yml-tiedoston solmu tarkoittaa. +--- + +# 🌏 전역 구성 diff --git a/fi/origin/plazma/administration/reference/configurations/plazma/world.md b/fi/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..a70a7052f --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kunkin solmun plazma-world.yml tarkoittaa. +--- + +# 🏳️ 세계별 구성 diff --git a/fi/origin/plazma/administration/reference/configurations/plazma/worlds.md b/fi/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..56b94dd51 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kunkin solmun plazma-world.yml tarkoittaa. +--- + +# ✨ Plazma (maailmojen rakenne) diff --git a/fi/origin/plazma/administration/reference/configurations/property.md b/fi/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..5914df39a --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen server.properties-tiedoston solmu tarkoittaa. +--- + +# 🪨 Server.properties diff --git a/fi/origin/plazma/administration/reference/configurations/pufferfish.md b/fi/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..3449e0066 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen pufferfish.yml-tiedoston solmu tarkoittaa. +--- + +# 🐡 Pallokalat diff --git a/fi/origin/plazma/administration/reference/configurations/purpur/README.md b/fi/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..b91f57b57 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen purpur.yml-tiedoston solmu tarkoittaa. +--- + +# 🦑 Purpur diff --git a/fi/origin/plazma/administration/reference/configurations/purpur/global.md b/fi/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..bbd91442e --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen purpur.yml-tiedoston solmu tarkoittaa. +--- + +# 🌏 전역 구성 diff --git a/fi/origin/plazma/administration/reference/configurations/purpur/world.md b/fi/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..b63ac35a6 --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen purpur.yml-tiedoston solmu tarkoittaa. +--- + +# 🏳️ 세계별 구성 diff --git a/fi/origin/plazma/administration/reference/configurations/spigot.md b/fi/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..5d8dbf59d --- /dev/null +++ b/fi/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kunkin solmun spigot.yml tarkoittaa. +--- + +# 🚰 Spigot diff --git a/fi/origin/plazma/administration/reference/permissions.md b/fi/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..1d2ed1fb4 --- /dev/null +++ b/fi/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Selvitä Plazma-sovelluksen oikeudet. +--- + +# 🛡️ Oikeudet + +Oikeudet ovat yksinkertainen turvallisuustyökalu, joka määrittää, millä tavalla palvelimen pelaajat voivat vuorovaikuttaa keskenään. + +Oikeuksien asianmukaiseen käyttöön ja helpottamiseen tarvitaan lisäosia, kuten [LuckPerms](https://luckperms.net). + +*** + +## Ymmärtääksesi perusoikeusjärjestelmää, katso + +Minecraft tarjoaa perus hallintaoikeusryhmiä. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Pelaaja**\ + Yleinen oikeusryhmä, joka annetaan kaikille pelaajille. +2. **Välittäjä**\ + Voi ohittaa spawn-suojauksen. +3. **Maailmanhallitsija**\ + Voi käyttää kaikkia maailmanhallintaan liittyviä komentoja ja komentolohkoja.\ + Oletusarvoinen oikeusryhmä datapaketeille ja komentolohkoille. +4. **Hallinnoija**\ + Voi käyttää kaikkia pelaajien hallintaan liittyviä komentoja. +5. **Ylimmäinen hallinnoija**\ + Voi käyttää kaikkia palvelimen hallintaan liittyviä komentoja.\ + Oletusarvoinen oikeusryhmä konsolille ja ylläpitäjille. + +*** + +## Oikeuksien määrittäminen + +*** + +## Kaikki oikeudet + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Oletus**: `None` + +Sallii pelaajan kyytiin nousemisen ja vuorovaikutuksen entiteetin kanssa. + +Kun pelaaja nousee kyytiin, hän voi ohjata entiteetin liikettä liikkumisnäppäimillä ja hypätä tai lentää hyppynäppäimellä. + +`(Namespaced Key)` tarkoittaa entiteetin [Namespaced ID](#user-content-fn-2)[^2]. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Oletus**: `None` + +Sallii pelaajan käyttää entiteetin erikoistaitoja, kun pelaaja ratsastaa entiteetillä. + +Kaikki entiteetit eivät välttämättä voi käyttää erikoistaitoja. Kaikki käytettävissä olevat erikoistaidot löytyvät alla olevasta linkistä. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Jaa ideoitasi [Plazma Discordissa](https://plazmamc.org/discord) tai [GitHubin keskusteluissa](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Näytä käytettävissä olevat erikoistaidot + +- **`crepper`**\ + Räjähtää painamalla `hyppy-näppäintä`.\ + Jos pelaajalla on oikeus `allow.powered.creeper`, hän voi ladata räjäytyksen pitämällä `hyppy-näppäintä` pohjassa. +- **`dolphin`**\ + Ryntää painamalla `hyppy-näppäintä`. +- **`phantom`**\ + Ampuu liekkejä painamalla `hyppy-näppäintä`. +- **`wither`**\ + Ampuu wither-päätä painamalla `vuorovaikutus-näppäintä`. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/compass`-komentojen](commands.md#compass) käytön. + +#### `bukkit.command.credits` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/credits (Pelaaja)`-komentojen](commands.md#credits) käytön. + +Lisää `.other` käyttäjänimen perään antaa oikeuden käyttää komentoa muille pelaajille. + +#### `bukkit.command.demo` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/demo (Pelaaja)`-komentojen](commands.md#demo) käytön. + +Lisää `.other` käyttäjänimen perään antaa oikeuden käyttää komentoa muille pelaajille. + +#### `bukkit.command.ping` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/ping (Pelaaja)`-komentojen](commands.md#ping) käytön. + +Lisää `.other` käyttäjänimen perään antaa oikeuden käyttää komentoa muille pelaajille. + +#### `bukkit.command.ram` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/ram`-komentojen](commands.md#ram) käytön. + +#### `bukkit.command.rambar` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/rambar (Pelaaja)`-komentojen](commands.md#rambar) käytön. + +Lisää `.other` käyttäjänimen perään antaa oikeuden käyttää komentoa muille pelaajille. + +#### `bukkit.command.restart` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/restart`-komentojen](commands.md#restart) käytön. + +#### `bukkit.command.tps` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/tps`-komentojen](commands.md#tps) käytön. + +#### `bukkit.command.tpsbar` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/tpsbar (Pelaaja)`-komentojen](commands.md#tpsbar) käytön. + +Lisää `.other` käyttäjänimen perään antaa oikeuden käyttää komentoa muille pelaajille. + +#### `bukkit.command.timings` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/timings`-komentojen](commands.md#timings) käytön. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Katso vastaava komento [Sparkista](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/uptime`-komentojen](commands.md#uptime) käytön. + +#### `minecraft.command.gamemode.(GameMode)` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii [`/gamemode (GameMode) (Pelaaja)`-komentojen](commands.md#gamemode) käytön. + +Lisää `.other` käyttäjänimen perään antaa oikeuden käyttää komentoa muille pelaajille. + +#### `paper.antixray.bypass` + +- **Oletus**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Tämä mahdollistaa suorituskyvyn parantamisen molemmilla osapuolilla. + +> Katso X-Rayn asetukset alla olevasta linkistä. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Oletus**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Oletus**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Oletus**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Oletus**: `None` + +Mahdollistaa MiniMessage-tunnisteiden käytön alasimissa [MiniMessage-tageilla](https://docs.advntr.dev/minimessage/format.html). + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Oletus**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Oletus**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Oletus**: `None` + +Poistaa pelaajan lepotilasta johtuvan poiston uhasta. + +#### `purpur.debug.f3n` + +- **Sisäänrakennettu**: `maailmanhallintaaja` + +Sallii pelaajan vaihtaa pelitilaa painamalla `F3 + N` näppäimiä. + +Toimii vain, jos pelaajalla on kyseiseen pelitilaan oikeus. + +#### `purpur.drop.spawners` + +- **Oletus**: `None` + +Kaivettaessa spawner-lohkolla käytetään asetettuja esineitä, spawner-lohko pudotetaan. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Oletus**: `None` + +Muuttaa enderarkun koon. + +`(NumberString)` voi olla `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Oletus**: `None` + +Sallii kuolemattomuuden toimivan, vaikka totemi olisi inventaariossa. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Oletus**: `None` + +Sallii pelaajan ohittaa liittymisrajoituksen. + +#### `purpur.mending_shift_click` + +- **Oletus**: `None` + +Sallii pelaajan korjata esineitä pitämällä niitä ja kyykistymällä. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Oletus**: `None` + +Sallii pelaajan asentaa kohderyhmät. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Oletus**: `None` + +Sallii pelaajan siirtyä heti Nether-portaalista. + +#### `purpur.sign.color` + +- **Oletus**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Oletus**: `None` + +Sallii kylteissä käsittämättömän koodin `(&o)` käytön. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Oletus**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Oletus**: `None` + +Sallii pelaajan estää TNT:n räjähdyksen vuorovaikutteisesti saksilla. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Suunnitellut oikeudet + +#### `plazma.bypass.ncr-require` + +- **Oletus**: `None` + +Sallii pelaajan liittyä, vaikka [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) -moduulia ei olisi asennettu. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operaattori. + +[^2]: Esimerkiksi: `ender_dragon` diff --git a/fi/origin/plazma/adminstration/README.md b/fi/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..b475ab7e6 --- /dev/null +++ b/fi/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Luo oma palvelimesi Plazmaa hyödyntäen. +--- + +# ⚒️ Palvelimen hallintaopas diff --git a/fi/origin/plazma/adminstration/expert/README.md b/fi/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b1ba0b6ac --- /dev/null +++ b/fi/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, miten käsitellä Plazmaa ammattimaisesti. +--- + +# 🎓 Syventävä diff --git a/fi/origin/plazma/adminstration/expert/fix-exploits.md b/fi/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..e5ad6b5a7 --- /dev/null +++ b/fi/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Selvitä tunnetut haavoittuvuudet ja niiden korjaustavat. +--- + +# ⚠️ Tunnetut haavoittuvuudet ja niiden korjaustavat diff --git a/fi/origin/plazma/adminstration/expert/optimize.md b/fi/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..eb869b6c5 --- /dev/null +++ b/fi/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, miten optimoida Plazma. +--- + +# 🧹 Optimalisointi diff --git a/fi/origin/plazma/adminstration/expert/vanillaize.md b/fi/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..8d3366f61 --- /dev/null +++ b/fi/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Selvitä, miten palautetaan Paper ja vaniljan korjauspaketti. +--- + +# ↩️ Vaniljoida + +{% hint style="warning" %} + +### Paper ei tarjoa vaihtoehtoja suurimmalle osalle vaniljan virheiden korjauksista. + +Tällä hetkellä Plazma kehittää tapaa poistaa tällaiset virheet asetuksista. + +Siksi tämä opas on vielä kesken ja tiedot voivat muuttua milloin tahansa. +{% lopeta vinkki %} diff --git a/fi/origin/plazma/adminstration/faq.md b/fi/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..0c639a8b5 --- /dev/null +++ b/fi/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Selvitä usein kysytyt kysymykset. +--- + +# ⁉️ Usein kysytyt kysymykset + +{% vinkki tyyli="info" %} + +### Et löydä haluamaasi vastausta? + +Kysy yhteisöltä [virallisella Discord-palvelimella](https://discord.gg/MmfC52K8A8) tai [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) -sivustolla! +{% lopeta vinkki %} + +### Suoritus ei onnistu ja näyttää viestin + +Jos konsolissa ilmestyy `no main manifest attribute, in plazma-(version).jar` viesti,\ +ladattu tiedosto on kehitystarkoituksiin tarkoitettu API-tiedosto, ja sinun pitää ladata **Reobf Paperweight** GitHub-sivulta. + +Lisätietoja löytyy seuraavalta sivulta. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Palvelimen käynnistyessä varoitus ilmestyy + +Plazma sisältää joitain epävakaata korjausta ja saattaa aina toimia virheellisesti, joten se näyttää seuraavan varoituksen palvelimen käynnistyessä. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Tämä varoitus voidaan poistaa käytössä [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] järjestelmäominaisuudella. + +Lisätietoja löytyy seuraavalta sivulta. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Saatavilla alkaen 1.20.1 diff --git a/fi/origin/plazma/adminstration/getting-started/README.md b/fi/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..8cd9fc698 --- /dev/null +++ b/fi/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Selvitä, miten luodaan palvelin Plazma-sovelluksella. +--- + +# 👟 Aloita + +Plazman vakaa käyttö vaatii, että järjestelmä täyttää seuraavat vaatimukset. + +| | Vähimmäisvaatimukset | Suositellut | +| :-----------: | -------------------: | ----------: | +| Arkkitehtuuri | x64 | - | +| RAM-muisti | 8GB | 16GB | +| Tallennustila | 1GB | 8GB | +| JRE | 17 | 21 | + +Sujuvan asetustiedoston muokkauksen varmistamiseksi on hyvä asentaa muokkausohjelma, kuten [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE:n asennus + +Kuten nimestä voi päätellä, Minecraft: **"Java"** Edition on kehitetty Javalla, joten sen käyttö edellyttää JRE[^1]. + +Koska Plazma perustuu Mojang Studiosin viralliseen palvelin alustaan \[^(#user-content-fn-2)][^2], JRE:n on oltava asennettuna Plazman käyttöä varten. + +### 1.1 JRE:n läsnäolon tarkistaminen + +Jos haluat tarkistaa, onko JRE asennettu järjestelmään, kirjoita ja suorita komento [`cmd /k java --version`](#user-content-fn-4)[^4] Suorita-ikkunassa. + +Jos näyttöön tulee seuraavaa, siirry [2. vaiheeseen](setup.md#id-2). + +{% code title="Oikea tulos" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Jos näyttöön ei tule vastaavaa tai se näyttää seuraavalta, JRE:tä ei ole asennettu tai se on liian vanha, joten sinun on suoritettava [1.2 vaihe](setup.md#id-1.2). + +{% code title="JRE ei ole asennettu" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE on liian vanha" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE:n asennus + +Tässä oppaassa käytetään yhtenä JRE:n [versioista](#user-content-fn-5)[^5] Azul Zulua. + +Asennuksen jälkeen suorita [1.1 vaihe](setup.md#id-1.1) uudelleen varmistaaksesi, että asennus on suoritettu oikein. + +{% tabs %} +{% tab title="Windows" %} + +1. Lataa ensin [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) ja asenna **JDK 21** `.msi`-muodossa. +2. Suorita ladattu asennusvelho ja napsauta `Seuraava`. +3. Aktivoi `Aseta JAVA_HOME-muuttuja` vasemman keskellä olevasta valikosta ja napsauta sitten `Seuraava`. +4. Klikkaa `Asenna` JRE:n asentamiseksi ja valitse `Valmis`. + {% endtab %} + +{% tab title="macOS" %} +Lataa [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) ja asenna **JDK 21** `.dmg`-muodossa. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Lisää ensin Azul Zulun varasto APT:hen suorittamalla seuraava komento terminaalissa. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Asenna sitten JRE suorittamalla seuraava komento terminaalissa. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Voit asentaa JRE:n suorittamalla seuraavan komennon. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazman lataaminen + +Plazma tarjoaa useita erilaisia suoritustiedostoja. + +{% hint style="warning" %} + +### Useimmiten käytetään `Reobf Paperclip`-tiedostoa. + +Alla olevat tiedot on tarkoitettu kehittäjille tai niille, jotka ovat kiinnostuneita kustakin muodosta.\ +Jos olet tavallinen käyttäjä, voit ohittaa [3. vaiheen](setup.md#id-3) ilman ongelmia. +{% lopeta vinkki %} + +
+ +Lisätietoja + +Suoritustiedoston nimi on `plazma-(versionhallinta)-1.20.4-R0.1-SNAPSHOT-(kartoitusmuoto).jar`. + +- **Kartoitusmuoto**\ + Kartoitus yhdistää Minecraftin todellisen koodin ja käännetyn koodin eräänlaiseksi kartaksi. + - **Reobf**\ + Uudelleenkoodaus, jota kutsutaan myös Spigot-kartoitukseksi ja jota käytetään suurimmassa osassa NMS-liitännäisistä.\ + Sitä ei enää käytetä 1.20.5:stä alkaen. + - **Mojmap**\ + Mojang-kartoitus, joka on Vanilla Minecraftin kartoitus. +- **Versionhallinta**\ + Versionhallinta on palvelimen käynnistämiseen tarvittava kirjasto ja palvelimen tiedostojen korjaaja. + - **Paperclip**\ + PaperMC-tiimi kehitti Paperin ja muut johdetut alustat, jotka lataavat kirjastoja ja soveltavat korjauksia palvelimelle. + - **Bundler**\ + Vanilla Minecraftin versionhallinta. + +
+ +*** + +## 3. Käynnistyskomentosarjan luominen + +Plazman käynnistämiseksi helposti ja palvelimen automaattiseksi uudelleenkäynnistämiseksi sinun on luotava [käynnistyskomentosarja](#user-content-fn-6).[^6] + +Voit luoda käynnistyskomentosarjan [Flags.sh](https://flags.sh) kautta.\ +Syötä vain käytettävä muisti \[^(#user-content-fn-8)][^8], ja komento optimoidaan automaattisesti. + +Voit ladata käynnistyskomentosarjan napsauttamalla vasemmassa alakulmassa olevaa Lataa-painiketta.\ +**Varmista, että ladattu käynnistyskomentosarja vastaa omaa käyttöjärjestelmääsi.** + +*** + +## 4. Tiedostojen järjestely + +Siirrä nyt ladattu käynnistyskomentosarja ja Plazma uuteen kansioon. + +{% hint style="warning" %} + +### Kansion nimen on oltava ilman välilyöntejä ja asetettava englanniksi. + +Muuten Plazma tai JRE eivät ehkä toimi oikein. +{% lopeta vinkki %} + +Käynnistä nyt käynnistyskomentosarja. Windowsissa salli palomuurin valintaikkunassa ehdottomasti **Salli**. + +*** + +## 5. EULA:n hyväksyminen + +Kun käynnistyskomentosarja on suoritettu kerran, kansioon luodaan `eula.txt`-tiedosto. + +EULA[^9] on sopimus, joka on hyväksyttävä käyttämällä [Mojang Studiosin](#user-content-fn-10)[^10] palveluita. + +Jos et hyväksy EULA:a, et voi käynnistää palvelinta, ja jos rikot EULA:a, voit saada rangaistuksia, kuten tilin sulkemisen \[^(#user-content-fn-11)][^11]. + +Hyväksyäksesi EULA:n muuta `eula.txt`-tiedoston `eula=false` muotoon `eula=true` ja tallenna se. + +*** + +## 6. Ulkoisen yhteyden salliminen (Windows) + +Nykyiset käyttöjärjestelmät estävät oletusarvoisesti vaarallisen ulkoisen pääsyn estääkseen sitä palomuurilla ja reitittimellä. + +Windowsissa palomuuri on jo sallittu [3. vaiheessa](setup.md#id-3), joten sinun tarvitsee vain tehdä portinohjaus. + +{% vinkki tyyli="info" %} + +### Tässä oppaassa oletetaan, että käytät Windows-käyttöjärjestelmää ja [**UPnP**](#user-content-fn-12)[^12]-tukea omaavaa reititintä. + +Jos reititin ei tue UPnP:tä, sinun on etsittävä tietoa erikseen, koska paneelit vaihtelevat reitittäin. + +Voit myös luoda väliaikaisen osoitteen [Ngrok](https://ngrok.com/) kautta. +{% lopeta vinkki %} + +{% hint style="warning" %} + +### Linuxissa tai macOS:ssa ja muissa (puoli) UNIX-käyttöjärjestelmissä palomuuripalvelujen asetukset vaihtelevat, joten sinun on etsittävä tietoa erikseen. + +{% lopeta vinkki %} + +### 6.1 Portinohjauksen tarpeen tarkistus + +Kirjoita ja suorita seuraava komento Suorita-ikkunassa. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jos tuloste on `True`, voit lopettaa tässä, mutta jos se on `False`, sinun on tehtävä portinohjaus. + +### 6.2 Yhteys palvelimeen + +{% tabs %} +{% tab title="Ulkoisesti" %} +Jos et tarvitse portinohjausta tai olet jo onnistunut siinä, voit nyt yhdistää palvelimeen. + +Palvelimelle yhdistettäessä käytettävä osoite voidaan tarkistaa [täältä](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Yritetään UPnP-portinohjausta" %} +Palvelimen kansiossa `purpur.yml`, ota `network.upnp-port-forwarding` käyttöön asettamalla se arvoon `true`. + +Tämän jälkeen, jos käynnistät palvelimen uudelleen, Plazma yrittää automaattisesti portinohjausta. + +Alla oleva viesti kertoo UPnP:n onnistumisesta ja konsolissa se näkyy muodossa `[UPnP] (viesti)`. + +| Viesti | Merkitys | +| ---------------------------------------- | ------------------------------------------- | +| `Portti (portti) avattiin onnistuneesti` | Portinohjaus onnistui. | +| `Portti (portti) on jo avoinna` | Toinen palvelu käyttää jo kyseistä porttia. | +| `Portin (portti) avaaminen epäonnistui` | Portinohjaus epäonnistui. | +| `Palvelu ei ole käytettävissä` | Reititin ei tue UPnP:tä. | + +Palvelimen sammuttua Plazma sulkee portin automaattisesti. +{% endtab %} + +{% tab title="Tilapäisen osoitteen luominen Ngrokilla" %} +Ngrokin käyttö on hyödyllistä lyhytaikaiseen testaukseen, yhteistyöhön tai pelaamiseen ystävien kanssa. + +1. Lataa [Ngrokin verkkosivustolta](https://ngrok.com/download) `Windows (64-bit)` ZIP-tiedosto. +2. Sijoita ladattu Ngrok palvelimen kansioon. +3. Luo [autentikointitunnus](https://dashboard.ngrok.com/get-started/your-authtoken) Ngrokin hallintapaneelissa. +4. Suorita palvelimen kansiosta näytettävä komento `Command Line`. +5. Lisää suoritusskriptin ylimpään kohtaan `start /b ngrok tcp --region jp 25565`, alimpaan kohtaan `taskkill /f /t /im ngrok.exe`. +6. Konsolissa näytettävästä `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` osoitteesta `0.tcp.jp.ngrok.io:12345` on palvelimen osoite. +7. Nyt voit yhdistää ulkoisesti kyseiseen osoitteeseen. + {% endtab %} + +{% tab title="Yhdistäminen paikallisesti" %} +Jos yrität yhdistää palvelimeen paikallisesti, voit käyttää `cmd /k ipconfig` komentoa ja yhdistää `IPv4-osoitteeseen`. + +Esimerkiksi, kun komento on suoritettu, ja tuloste on seuraavanlainen, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Yritä yhdistää paikallisesti palvelimeen käyttämällä `192.168.3.7` IPv4-osoitetta. + +Jos palvelin ja peli toimivat samalla tietokoneella, voit yhdistää käyttäen `localhost` osoitetta. +{% endtab %} +{% endtabs %} + +## 7. Kehitysvaihe + +Kun palvelin on onnistuneesti käynnistetty ja toimii oikein, on aika mukauttaa palvelinta. + +Katso ohjeet palvelimen mukauttamiseen. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java-suoritusympäristö. + +[^2]: Paperin perustana toimiva Plazma perustuu Spigotiin, joka puolestaan perustuu viralliseen palvelinplatformiin. + +[^3]: Windows-näppäin + R + +[^4]: Linuxissa voit tarkistaa Java-version komennolla `java --version` + +[^5]: JRE on yksi avoimen lähdekoodin projekteista, jota on erilaisia versioita, kuten Minecraft palvelinplatformilla. + +[^6]: Yleisesti tunnetaan **käynnistäjänä**. + +[^7]: Kun "Auto-restart" on aktivoitu, palvelin käynnistyy automaattisesti uudelleen. Voit sulkea palvelimen syöttämällä `Control + C`. + +[^8]: Suositellaan välttämään yli puolet järjestelmän resursseista. + + Esimerkiksi, jos järjestelmän kokonaismuistin määrä on 8GB, ei suositella asettamaan yli 4GB. + +[^9]: End-User License Agreement, loppukäyttäjän lisenssisopimus. Lisätietoja löytyy [Minecraftin verkkosivuilta](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Korealaisen lainsäädännön mukaan peliteollisuuden edistämisestä annetun lain 32 §:n 1 momentin 9 kohdan mukaan **Korean Microsoft Corporation** voi nostaa oikeudellisen syytteen. + +[^12]: Universal Plug & Play. Plazmaan sisältyvä Purpur kommunikoi automaattisesti reitittimen kanssa tämän tekniikan avulla, joten sinun ei tarvitse tehdä portinohjausta suoraan, koska portti avataan vain silloin, kun palvelin on käynnissä. + +[^13]: Jos sinulla ei ole tiliä, rekisteröidy Ngrokkiin Google- tai GitHub-tilin kautta. diff --git a/fi/origin/plazma/adminstration/getting-started/customization.md b/fi/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..5dce2d38e --- /dev/null +++ b/fi/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Opi muokkaamaan palvelinta käyttäjän tarpeiden mukaan. +--- + +# 🎨 Käyttäjän mukauttaminen diff --git a/fi/origin/plazma/adminstration/reference/arguments.md b/fi/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..ceae9625e --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Tutustu käynnistysparametreihin ja järjestelmäominaisuuksiin. +--- + +# 🎛️ Parametrit ja ominaisuudet + +Käynnistysmuuttujat ja järjestelmäominaisuudet ovat arvoja, jotka lisätään [käytettäviin komentoihin](#user-content-fn-1)[^1] Plazman suorituksen aikana,\ +ja ne mahdollistavat arvojen lisäämisen, jotka eivät ole muutettavissa Plazman suorituksen jälkeen. + +Niiden mukaisesti **käynnistysparametrit** ja **järjestelmäominaisuudet** jaetaan **komentoon liitettävän sijainnin mukaan**. + +*** + +## Järjestelmäominaisuus + +Järjestelmäominaisuus syötetään `-jar`-parametrin eteen ja sitä käsitellään JVM:ssä ennen Plazman alustamista. + +{% hint style="warning" %} + +### Muuttamalla järjestelmäominaisuuksia Plazman ja JVM:n toiminta voi muuttua merkittävästi ja se voi vaikuttaa peliin suuresti! + +Jos et ole varma, mitä kukin järjestelmäominaisuus tekee, **älä missään nimessä käytä niitä!** +{% endhint %} + +### Käyttöohje + +Järjestelmäominaisuudet syötetään Java-käskyparametreina `java` ja `-jar` välissä. + +Esimerkiksi jos haluat käyttää `Plazma.dummyProperty`-järjestelmäominaisuutta,\ +syöttämällä seuraavasti seuraava ominaisuus arvolla `37` lisätään Plazman alustukseen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` ilmaisee, että kyseinen parametri ei ole JVM:ssä sisäänrakennettu vaan lisätty Plazmalle erityinen parametri, + +jos arvoa ei anneta, arvo on [`true` oletusarvoisesti.](#user-content-fn-3)[^3] + +{% vinkki tyyli="info" %} + +### Paperweight-sukuiset palvelin alustat käyttävät ominaisuuden nimen erottamiseksi `.`-merkkiä jokaisen alustan järjestelmäominaisuuden nimen yhteydessä. + +Joissakin Windows Powershell-tyyppisissä terminaaleissa nämä parametrit eivät välttämättä ole sallittuja, joten parametrien molemmin puolin on lisättävä `"`.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Kaikki järjestelmäominaisuudet + +#### `convertLegacySigns` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Päivittää käytöstä poistettuja kylttejä. + +#### `debug.entities` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi entiteettitietoihin liittyvät vianmäärityslokit. + +#### `debug.rewriteForIDE` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Deaktivoi NMS-revision oikeanlaisen latauksen IDE:stä ja automaattisesti uudelleenkartoittaa sisäiset versiot. + +#### `disable.watchdog` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä Spigotin vartijan varoitusjärjestelmän. + +#### `letMeReload` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä `/reload`-komentoon liittyvän varmistusviestin. + +{% hint style="danger" %} + +### Koska `/reload`-komento on erittäin epävakaa, kaikki ongelmat, jotka ilmenevät `/reload`-käytön jälkeen, ovat käyttäjän vastuulla. + +Jos olet lisäosakehittäjä ja sinun on päivitettävä lisäosaa, käytä `hotswap`-toimintoa `/reload`-käytön sijaan. +{% lopeta vinkki %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä lisäosan, joka käyttää standardia tulo-lähtöjärjestelmää. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Varoittaa, kun vanhentunut muotoilu havaitaan keskustelukomponentissa. + +#### `Paper.bypassHostCheck` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä palvelimeen liittyvä kuviovalidointi, kun pelaaja yrittää liittyä palvelimeen. + +#### `Paper.debugDynamicMissingKeys` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi vianmäärityslokit puuttuvista avaimista NBT-objekteissa. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi vianmäärityslokit päättömien päälohkojen virheellisistä profiileista. + +Tämä kirjaa kaikki virheelliset päälohkot sijainteineen maailmassa. + +#### `Paper.disableChannelLimit` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä rajoituksen, joka asettaa 128 lisäosakanavaa pelaajaa kohti.[^5] + +#### `Paper.disableClassPrioritization` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä lisäosien luokan priorisointijärjestelmän. + +Hyödyllinen ongelmatilanteissa, joissa lisäosan varjostus aiheuttaa ongelmia. + +#### `Paper.disableFlushConsolidate` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä Netty-tiedonsiirron tiivistyksen. + +#### `Paper.excessiveTELimit` + +- **Tyyppi**: `Integer` +- **Oletusarvo**: `750` + +Jos entiteettejä on enemmän kuin asetettu arvo, ne lähetetään useampina paketteina. + +#### `Paper.filterThreshold` + +- **Tyyppi**: `Integer` +- **Oletusarvo**: `8192` + +Asettaa maksimikokoisen paketin, jonka palvelin voi vastaanottaa kerralla. + +#### `Paper.ignoreJavaVersion` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Poistaa käytöstä Java-version tarkistuksen. + +{% hint style="danger" %} + +### Tämä mahdollistaa JVM:lle pääsyn koodiin, jota ei ole olemassa! + +Tämä voi aiheuttaa pysyvää vahinkoa maailmoille ja yleisille tiedostoille, ja pelin koko mekaniikka voi hajota. + +Kaikki tämän käytön aiheuttamat ongelmat ovat käyttäjän vastuulla, eikä Plazma tarjoa tukea tähän. +{% lopeta vinkki %} + +#### `Paper.maxCustomChannelName` + +- **Tyyppi**: `Integer` +- **Oletusarvo**: `64` + +Asettaa lisäosakanavan[^6] nimen enimmäisrajan. + +#### `Paper.maxSignLength` + +- **Tyyppi**: `Integer` +- **Oletusarvo**: `80` + +Asettaa kyltin yhdellä rivillä näytettävien merkkien enimmäismäärän. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tyyppi**: `Integer` +- **Oletusarvo**: `(maailman versio) + 1` + +Asettaa alustettavien maailman päivitystietojen version ensin. + +Hyödyllinen massiivisten alueiden päivityksissä, mutta muissa tapauksissa tarpeeton. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `True` + +Aktivoi YAML-tiedostojen kommenttien käsittelyn. + +#### `Paper.playerConnection.keepAlive` + +- **Tyyppi**: `Integer` +- **Oletusarvo**: `30` + +Kun pelaaja ei ole lähettänyt mitään tietoa annetun ajan (sekunteina), pelaaja poistetaan palvelimelta. + +Yleensä peli[^7] lähettää jatkuvasti [sydämenlyöntisignaalia](#user-content-fn-8)[^8] palvelimelle, [joten pelaajaa ei poisteta,](#user-content-fn-9)[^9] mutta jos peli ei vastaa, se katsotaan kaatuneeksi ja pelaaja poistetaan palvelimelta. + +#### `Paper.skipServerPropertiesComments` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Ohittaa palvelimen ominaisuuksien kommentit. + +#### `Paper.debug-sync-loads` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi synkronisen alueen luonnin vianmäärityslokit. + +#### `Paper.enable-sync-chunk-writes` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi Minecraftin [oletus alueen kirjoitusjärjestelmän](#user-content-fn-10)[^10]. + +Tämä tallentaa jokaisen alueen peräkkäin, mikä aiheuttaa merkittävää suorituskyvyn laskua. + +#### `Paper.explicit-flush` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Aktivoi verkon kanavan suoran tyhjennyksen. + +#### `Paper.strict-thread-checks` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Kirjaa aina pääsäikeessä tapahtuvat virheet. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Varoittaa, jos aikataulutettu tehtävä kestää liian kauan. + +#### `Paperclip.patchOnly` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `False` + +Käytettäessä oletustiedostoa, sovellus käynnistetään vain patchia levittämällä ilman palvelimen käynnistämistä. + +#### `Plazma.aggressiveOptimize` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` + +{% hint style="warning" %} + +### Tämä ominaisuus siirretään käynnistysparametriin 1.20.5 jälkeen. + +{% lopeta vinkki %} + +Käynnistyksen alussa sovelletaan tiukempaa kokoonpanon optimointia. + +Kun aktivoidaan, palvelin nopeutuu ja turvallisuus paranee, mutta se voi estää joitain temppuja tai vaikuttaa merkittävästi pelikokemukseen. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` + +Estää varoituksen[^11], joka ilmestyy Plazman alustuksen yhteydessä. + +### Käytöstä poistettu ominaisuus + +Seuraavat järjestelmän ominaisuudet ovat käytöstä poistettuja ominaisuuksia. + +#### `timings.bypassMax` + +- **Tyyppi**: `Boolean` +- **Oletusarvo**: `false` +- **Käytöstä poistettu**: Timings on poistettu käytöstä Plazmasta eteenpäin + +Päätetäänkö arvojen lähettäminen Aikarin Timings API:in ylittääkö maksimin. + +Vaikka näin tehtäisiin, jos API:ssa ei käsitellä poikkeusta, rajoitus asetetaan voimaan. + +*** + +## Aloitusparametri + +Aloitusparametri syötetään `-jar *.jar` jälkeen, kun Plazma on alustettu ja sitä käsitellään samanaikaisesti. + +### Käyttöohje + +Järjestelmän ominaisuudet syötetään ohjelman komentoparametreina `-jar *.jar` jälkeen. + +Esimerkiksi, jos haluat käyttää `nogui` aloitusparametria,\ +seuraavasti syöttämällä Plazma käsittelee `nogui` parametria alustuksen aikana. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Koko aloitusparametri + +#### `bukkit-settings` + +- **Alias**: `b` +- **Oletusarvo**: `bukkit.yml` + +Asettaa Bukkitin [konfiguraatiotiedoston](../reference/configurations/bukkit.md) nimen ja sijainnin. + +#### `command-settings` + +- **Alias**: `c` +- **Oletusarvo**: `commands.yml` + +Asettaa Bukkittiin [komentokonfiguraatiotiedoston](../reference/configurations/bukkit.md) nimen ja sijainnin. + +#### `config` + +- **Alias**: `c` +- **Oletusarvo**: `server.properties` + +Asettaa [palvelimen ominaisuudet](../reference/configurations/property.md) tiedoston nimen ja sijainnin. + +#### `demo` + +Käynnistää palvelimen demomaailmassa. + +#### `eraseCache` + +Poistaa jäljellä olevat välimuistitiedostot maailman päivityksen jälkeen. + +#### `forceUpgrade` + +Ohittaa version ja pakottaa maailman [päivityksen](#user-content-fn-12)[^12]. + +#### `help` + +- **Alias**: `?` + +Tulostaa Plazman koko aloitusparametrit ja niiden kuvaukset. + +#### `initSettings` + +Luo vain asetustiedoston ja sulkee palvelimen. + +#### `jfrProfile` + +Aktivoi JFR-profiloinnin. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Asettaa sallitun maksimi [pelaajien](#user-content-fn-14)[^14] määrän. + +#### `nogui` + +Poistaa graafisen käyttöliittymäpaneelin käytöstä. + +#### `nojline` + +Poistaa JLinen käytöstä ja käyttää vaniljan konsolia. + +#### `online-mode` + +- **Alias**: `o` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Valitsee, tarkistetaanko pelaajat Mojangin todennuspalvelimella. + +**Jos et käytä Velocityä tai muita etuovia, voit rikkoa [EULA:n](../getting-started/README.md#id-5) ja joutua seuraamuksiin.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Oletusarvo**: `paper.yml` + +{% hint style="warning" %} + +### Tämä parametri on poistettu käytöstä 1.19.4 jälkeen + +{% lopeta vinkki %} + +Asettaa käytöstä poistetun PaperSpigotin konfiguraatiotiedoston sijainnin. + +Tätä käytetään siirtämään vanhaa konfiguraatiota uuteen konfiguraatiotiedostoon, eikä sitä käytetä sen jälkeen. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Oletusarvo**: `config` + +Asettaa [Paperin konfiguraatiotiedoston](../reference/configurations/paper/README.md) sijainnin ja nimen. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Asettaa [Plazman konfiguraatiotiedoston](../reference/configurations/plazma/README.md) sijainnin ja nimen. + +#### `plugins` + +- **Alias**: `p` +- **Oletusarvo**: `plugins` + +Asettaa liitännäisten kansion sijainnin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Oletusarvo**: `pufferfish.yml` + +Asettaa [Pufferfishin konfiguraatiotiedoston](../reference/configurations/pufferfish.md) nimen ja sijainnin. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Oletusarvo**: `purpur.yml` + +Asettaa [Purpurin konfiguraatiotiedoston](../reference/configurations/purpur/README.md) nimen ja sijainnin. + +#### `safeMode` + +Käynnistää palvelimen täyteen vaniljatilaan. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Asettaa palvelimen isännän nimen tai [Internet-protokolla](#user-content-fn-13)[^13] osoitteen. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Asettaa palvelimen portin. + +#### `server-name` + +- **Oletusarvo**: `A Plazma Server` + +Asettaa palvelimen nimen. + +#### `spigot-settings` + +- **Alias**: `S` +- **Oletusarvo**: `spigot.yml` + +Asettaa [Spigotin konfiguraatiotiedoston](../reference/configurations/spigot.md) nimen ja sijainnin. + +#### `version` + +- **Alias**: `v` + +Tulostaa Plazman version. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Oletusarvo**: `(palvelimen kansio)` + +Asettaa maailmatiedostojen sijainnin. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Oletusarvo**: `(palvelimen ominaisuus)` + +Asettaa maailmatiedoston nimen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Riippuen lisätyistä sijainneista, sijainti, joka käsittelee parametrit, muuttuu. + +[^3]: Esimerkiksi asettaessa `Plazma.iKnowWhatIAmDoing` arvoon `true` (aktivoituna), voit käyttää `-DPlazma.iKnowWhatIAmDoing` sijaan pelkkää `-DPlazma.iKnowWhatIAmDoing`, ja se toimii samalla tavalla. + +[^4]: Esimerkiksi `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Tapahtumien havaitseminen. + +[^6]: Tapahtumien havaitseminen. + +[^7]: Asiakas. + +[^8]: Signaali, joka ilmoittaa, että palvelin on yhteydessä normaalisti, kuten sydämen syke. + +[^9]: Käyttämällä Purpurin AFK-karkotustoimintoa voit karkottaa myös poissaolevat pelaajat. + +[^10]: Synkronoitu palan luontijärjestelmä, Sync Chunk Write System. + +[^11]: `VAROITUS! Plazma saattaa aiheuttaa odottamattomia ongelmia, joten varmista, että testaat sen perusteellisesti ennen käyttöä julkisella palvelimella.` + +[^12]: Pelissä `maailman optimointi` toimii samalla periaatteella. + +[^13]: Internet-protokolla, IP. + +[^14]: `Tason 2` ylläpitäjät on suljettu pois. diff --git a/fi/origin/plazma/adminstration/reference/commands.md b/fi/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..a0deb9ab6 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Tutustu Plazmassa käytettävissä oleviin komennoihin. +--- + +# 🖥️ Komennot diff --git a/fi/origin/plazma/adminstration/reference/configurations/bukkit.md b/fi/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f316f93ff --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kukin bukkit.yml-tiedoston solmu tarkoittaa. +--- + +# 🪣 Bukkit diff --git a/fi/origin/plazma/adminstration/reference/configurations/paper/README.md b/fi/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..942906979 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mihin tarkoitukseen kunkin config-kansion tiedosto on tarkoitettu. +--- + +# 🛩️ Paper diff --git a/fi/origin/plazma/adminstration/reference/configurations/paper/global.md b/fi/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..45c182c3a --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen solmu paper-global.yml-tiedostossa tarkoittaa. +--- + +# 🛩️ Paper (globaali asetus) diff --git a/fi/origin/plazma/adminstration/reference/configurations/paper/world.md b/fi/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..74f3bf1f6 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen paper-world.yml-tiedoston solmu tarkoittaa. +--- + +# 🛩️ Paper (maailman rakenne) diff --git a/fi/origin/plazma/adminstration/reference/configurations/plazma/README.md b/fi/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..192fc3e16 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mihin tarkoitukseen kunkin config-kansion tiedosto on tarkoitettu. +--- + +# ✨ Plazma diff --git a/fi/origin/plazma/adminstration/reference/configurations/plazma/global.md b/fi/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..8523ec02e --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen plazma-global.yml-tiedoston solmu tarkoittaa. +--- + +# ✨ Plazma (globaali kokoonpano) diff --git a/fi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/fi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..20f9dc46f --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Maailmanlaajuinen rakenne diff --git a/fi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/fi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..56b94dd51 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kunkin solmun plazma-world.yml tarkoittaa. +--- + +# ✨ Plazma (maailmojen rakenne) diff --git a/fi/origin/plazma/adminstration/reference/configurations/property.md b/fi/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..5914df39a --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen server.properties-tiedoston solmu tarkoittaa. +--- + +# 🪨 Server.properties diff --git a/fi/origin/plazma/adminstration/reference/configurations/pufferfish.md b/fi/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..3449e0066 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen pufferfish.yml-tiedoston solmu tarkoittaa. +--- + +# 🐡 Pallokalat diff --git a/fi/origin/plazma/adminstration/reference/configurations/purpur/README.md b/fi/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..b91f57b57 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen purpur.yml-tiedoston solmu tarkoittaa. +--- + +# 🦑 Purpur diff --git a/fi/origin/plazma/adminstration/reference/configurations/purpur/global.md b/fi/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..c2174cb76 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen purpur.yml-tiedoston solmu tarkoittaa. +--- + +# 🦑 Purpur (kokonaisuus) diff --git a/fi/origin/plazma/adminstration/reference/configurations/purpur/world.md b/fi/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..8bdd90fc9 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä jokainen purpur.yml-tiedoston solmu tarkoittaa. +--- + +# 🦑 Purpur (maailman rakenne) diff --git a/fi/origin/plazma/adminstration/reference/configurations/spigot.md b/fi/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..5d8dbf59d --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Selvitä, mitä kunkin solmun spigot.yml tarkoittaa. +--- + +# 🚰 Spigot diff --git a/fi/origin/plazma/adminstration/reference/permissions.md b/fi/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..dae52a236 --- /dev/null +++ b/fi/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Selvitä Plazma-sovelluksen oikeudet. +--- + +# 🛡️ Oikeudet diff --git a/fi/origin/plazma/developers.md b/fi/origin/plazma/developers.md new file mode 100644 index 000000000..2893e6899 --- /dev/null +++ b/fi/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Kehitä kolmannen osapuolen projekteja Plazmaa hyödyntäen. +--- + +# ⚙️ Kehittäjän opas diff --git a/fi/origin/thunderbolt/README.md b/fi/origin/thunderbolt/README.md new file mode 100644 index 000000000..630c0f8a5 --- /dev/null +++ b/fi/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt on Plasma-pohjainen palvelin alusta, joka mahdollistaa kokeellisten korjausten erottelun Flavorin avulla suoraan käytettäväksi. +--- + +# 🌩️ Thunderbolt Käyttöopas diff --git a/fi/origin/volt/README.md b/fi/origin/volt/README.md new file mode 100644 index 000000000..2ac718ddc --- /dev/null +++ b/fi/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt on avoin lähdekoodipohjainen malli, jonka avulla voit kehittää oman Paperweight-palvelin alustasi Plazmaan perustuen. +--- + +# ⚡ Voltin kehitysohje diff --git a/fr/origin/README.md b/fr/origin/README.md new file mode 100644 index 000000000..50efa2aeb --- /dev/null +++ b/fr/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Si vous avez des questions, veuillez les poser sur Discord ou GitHub Discussions. +--- + +# 🏠 Bienvenue sur le portail de la documentation + +{% hint style="info" %} + +**Les documents de Plazma sont actuellement dans un état de traduction automatique.** + +[![Statut de traduction](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Participez à la traduction des documents sur [https://translate.plazmamc.org/](https://translate.plazmamc.org/) pour améliorer les documents. + +{% endhint %} + +### Si vous rencontrez un problème lors de l'utilisation de Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Si vous êtes intéressé par Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Si vous souhaitez créer votre propre plateforme de serveur avec Volt, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Si vous avez besoin de plus d'informations sur Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/fr/origin/SUMMARY.md b/fr/origin/SUMMARY.md new file mode 100644 index 000000000..9eec0b214 --- /dev/null +++ b/fr/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Table des matières + +- [🏠 Bienvenue sur le portail de la documentation](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documentation d'utilisation de Plazma](plazma/README.md) +- [❓ Qu'est-ce que Plazma?](plazma/about/README.md) + - [⬇️ Télécharger](plazma/about/downloads.md) + - [✅ État de support des versions](plazma/about/supported-versions.md) +- [⚒️ Guide de gestion du serveur](plazma/administration/README.md) + - [👟 Commencer](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Référence](plazma/administration/reference/README.md) + - [🖥️ Commandes](plazma/administration/reference/commands.md) + - [🛡️ Autorisations](plazma/administration/reference/permissions.md) + - [🎛️ Arguments et propriétés](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configuration globale](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configuration globale](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configuration globale](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avancé](plazma/administration/expert/README.md) + - [🧹 Optimisation](plazma/administration/expert/optimize.md) + - [🔀 프록시](plazma/administration/expert/proxy.md) + - [↩️ Vanilla](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray 차단](plazma/administration/expert/xray.md) + - [⚠️ Vulnérabilités et correctifs](plazma/administration/expert/fix-exploits.md) + - [⁉️ Foire aux questions](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Guide du développeur](plazma/developers.md) + - [✏️ Contribuer](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Guide d'utilisation de Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Guide de développement de Volt](volt/README.md) + +## Divers + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Télécharger tout](plazma/about/downloads-all.md) diff --git a/fr/origin/miscellaneous/README.md b/fr/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/fr/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/fr/origin/plazma/README.md b/fr/origin/plazma/README.md new file mode 100644 index 000000000..a9efc5580 --- /dev/null +++ b/fr/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma est une plateforme de serveur open source pour Minecraft: Java Edition qui ajoute une optimisation expérimentale basée sur du papier et des fonctionnalités de personnalisation de plusieurs mécanismes de jeu." +--- + +# ✨ Documentation d'utilisation de Plazma + +## 👋 Bienvenue dans la documentation de Plazma + +Bienvenue dans le guide d'utilisation de Plazma! + +{% hint style="info" %} + +**Impossible de résoudre le problème via le manuel d'instructions?** + +[Serveur Discord officiel](https://discord.gg/MmfC52K8A8) ou [Discussions GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) pour poser des questions à la communauté ! + +{% endhint %} + +### À propos de Plazma + +> Découvrez ce qu'est Plazma en tant que plateforme de serveur. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Pour les administrateurs + +> Créez votre propre serveur en utilisant Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Pour les développeurs + +> Développez des projets tiers en utilisant Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/fr/origin/plazma/about/README.md b/fr/origin/plazma/about/README.md new file mode 100644 index 000000000..0d8098c65 --- /dev/null +++ b/fr/origin/plazma/about/README.md @@ -0,0 +1,71 @@ +--- +description: Découvrez ce qu'est Plazma en tant que plateforme de serveur. +--- + +# ❓ Qu'est-ce que Plazma? + +- **Plazma** est une plateforme de serveur basée sur [Paper](https://github.com/PaperMC/Paper) qui ne prend que les avantages d'[Andromeda](https://github.com/EarendelArchived/Andromeda) et de [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Nous nous efforçons de fournir une stabilité élevée, des performances puissantes, des mises à jour rapides et une multitude de fonctionnalités. + +## 📋 Objectifs de Plazma + +- Nous nous efforçons de devenir une plateforme de serveur avec des mises à jour rapides et une grande stabilité. +- Nous nous efforçons de fournir une multitude de fonctionnalités et des performances puissantes, tout comme une plateforme de mod. +- Nous nous efforçons de créer une plateforme libre permettant de personnaliser même les correctifs de Vanilla. + +## ⚙️ Caractéristiques principales + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Mises à jour les plus rapides**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) maintient les correctifs inclus dans Plazma toujours à jour, offrant ainsi les mises à jour les plus rapides parmi les plateformes de serveur basées sur Paper. +6. **Optimisation des fichiers de configuration par défaut**\ + Les fichiers de configuration par défaut sont optimisés, vous n'avez pas besoin de les optimiser vous-même. +7. **Fonctionnement multithread systématique**\ + En asynchronisant les mécanismes système non liés au jeu, nous réduisons les temps de latence pour optimiser le serveur. +8. **Blocage de l'utilisation d'espace inutile**\ + Nous fusionnons toutes les données similaires en une seule pour réduire la consommation de mémoire. + +## ✨ Cas d'utilisation + +- **Une plateforme traitant également les plugins complexes correctement**\ + Utilisé sur le serveur du développeur [IPECTER](https://github.com/IPECTER), Plazma fonctionne avec NMS et la réflexion. Malgré l'application de nombreux plugins complexes et de vastes datapacks, il peut accueillir plus de 100 joueurs sans perte de performances. +- **Une plateforme maintenant des performances rapides même sur des serveurs RPG**\ + Il a maintenu 100 joueurs sur un seul cluster sans baisse de TPS, et jusqu'à 250 joueurs sur 4 clusters peuvent jouer confortablement sans problème. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **La plateforme choisie par de nombreux streamers**\ + Utilisée comme un seau pour l'engagement des spectateurs de nombreux streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Téléchargement + +Vous pouvez télécharger Plazma sur la page ci-dessous. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Vous voulez plus d'informations sur la prise en charge des versions? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plugins Bukkit, CraftBukkit, Spigot et Paper, Pufferfish, Purpur. + +[^2]: Propriété de Microsoft Corporation. + +[^3]: En désactivant le système de signalement de discussion, le chat est traité uniquement sur le serveur, ce qui empêche le suivi des discussions par Mojang. + +[^4]: Temps pendant lequel le jeu se fige pour permettre au mécanisme système de fonctionner. diff --git a/fr/origin/plazma/about/downloads-all.md b/fr/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..a6612637c --- /dev/null +++ b/fr/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Télécharger le fichier d'exécution de Plazma en totalité +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Réobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/fr/origin/plazma/about/downloads.md b/fr/origin/plazma/about/downloads.md new file mode 100644 index 000000000..2073abd00 --- /dev/null +++ b/fr/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Téléchargez dès maintenant Plazma et essayez-le vous-même. +--- + +# ⬇️ Téléchargement + +#### Vous voulez plus d'informations sur la prise en charge des versions? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Le téléchargement ci-dessous est un fichier exécutable pour une utilisation générale.** + +Si vous êtes un développeur et avez besoin d'un autre type de fichier, veuillez consulter la page ci-dessous. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionTélécharger
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + Télécharger +
1.19.4 + Télécharger +
+ +*** diff --git a/fr/origin/plazma/about/patches-list.md b/fr/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..9b3486f61 --- /dev/null +++ b/fr/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Découvrez toutes les fonctionnalités ajoutées à Plazma. +--- + +# 📑 Patchs inclus diff --git a/fr/origin/plazma/about/supported-versions.md b/fr/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..a6878b400 --- /dev/null +++ b/fr/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Découvrez les versions prises en charge de Minecraft: Java Edition par Plazma." +--- + +# ✅ État de prise en charge de la version + +{% hint style="info" %} + +**Plazma est développé à partir de la version 1.19.4, les versions antérieures à 1.19.4 ne sont pas prises en charge.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/En%20attente%20de%20publication +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Aucune%20information +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![En attente de sortie][wtr] ![En développement][idv] ![En soutien][atv] ![Soutien de fonctionnalités interrompu][fse] ![Support terminé][eol] + +| Version | Stabilité et support fonctionnel | État de la construction | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![État de construction](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![État de construction](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![État de construction](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/fr/origin/plazma/administration/README.md b/fr/origin/plazma/administration/README.md new file mode 100644 index 000000000..a98680060 --- /dev/null +++ b/fr/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Créez votre propre serveur en utilisant Plazma. +--- + +# ⚒️ Guide de gestion du serveur diff --git a/fr/origin/plazma/administration/diagnosis/README.md b/fr/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..059299a52 --- /dev/null +++ b/fr/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment gérer les problèmes qui surviennent. +--- + +# 🧾 진단 diff --git a/fr/origin/plazma/administration/diagnosis/plugins.md b/fr/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..4856ae9ca --- /dev/null +++ b/fr/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment résoudre les problèmes lorsque le plug-in ne fonctionne pas correctement. +--- + +# 📜 플러그인 diff --git a/fr/origin/plazma/administration/expert/README.md b/fr/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..f22b8c0fd --- /dev/null +++ b/fr/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment traiter professionnellement le Plazma. +--- + +# 🎓 Approfondissement diff --git a/fr/origin/plazma/administration/expert/fix-exploits.md b/fr/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..6c88a808a --- /dev/null +++ b/fr/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Découvrez les vulnérabilités connues et comment les résoudre. +--- + +# ⚠️ Vulnérabilités connues et méthodes de résolution diff --git a/fr/origin/plazma/administration/expert/optimize.md b/fr/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..d4459dc38 --- /dev/null +++ b/fr/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment optimiser Plazma. +--- + +# 🧹 Optimisation diff --git a/fr/origin/plazma/administration/expert/proxy.md b/fr/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..7fce2fbf4 --- /dev/null +++ b/fr/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment sécuriser la plateforme de proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/fr/origin/plazma/administration/expert/vanillaize.md b/fr/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..1d3d7069d --- /dev/null +++ b/fr/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Découvrez comment restaurer les patchs de Paper et de vanille. +--- + +# ↩️ Vanilliser + +{% hint style="warning" %} + +**Paper ne propose pas d'options dans la plupart des correctifs de Vanilla pour résoudre les erreurs.** + +Plazma est en train de développer une configuration pour désactiver ces corrections d'erreur. + +Par conséquent, ce guide est encore en cours d'élaboration et les informations sont susceptibles de changer à tout moment. + +{% endhint %} diff --git a/fr/origin/plazma/administration/expert/xray.md b/fr/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..72fd6bc6b --- /dev/null +++ b/fr/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Découvrez les différentes méthodes intégrées pour bloquer les rayons X. +--- + +# 🩻 Blocage des rayons X diff --git a/fr/origin/plazma/administration/faq.md b/fr/origin/plazma/administration/faq.md new file mode 100644 index 000000000..915bac84c --- /dev/null +++ b/fr/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Découvrez les questions fréquemment posées. +--- + +# ⁉️ Questions fréquemment posées + +{% hint style="info" %} + +**Vous ne trouvez pas la réponse que vous cherchez?** + +[Serveur Discord officiel](https://discord.gg/MmfC52K8A8) ou [Discussions GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) pour poser des questions à la communauté ! + +{% endhint %} + +### Plazma ne démarre pas + +Si vous voyez `no main manifest attribute, in plazma-(version).jar` dans la console,\ +le fichier que vous avez téléchargé est destiné à l'API de développement, vous devez télécharger **Reobf Paperweight** depuis la page GitHub. + +Consultez la page suivante pour plus de détails. + +{% content-ref url="getting-started/" %} +[démarrage](getting-started#id-2) +{% endcontent-ref %} + +### Un avertissement s'affiche à chaque démarrage du serveur + +Plazma contient quelques correctifs instables et peut toujours présenter des dysfonctionnements, c'est pourquoi ces avertissements s'affichent lors du démarrage du serveur. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Cet avertissement peut être désactivé en utilisant la propriété système [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Consultez la page suivante pour plus de détails. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponible à partir de la version 1.20.1 diff --git a/fr/origin/plazma/administration/getting-started/README.md b/fr/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..9892a80a6 --- /dev/null +++ b/fr/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Découvrez comment créer un serveur avec Plazma. +--- + +# 👟 Commencer + +Pour utiliser Plazma de manière stable, le système doit répondre aux exigences suivantes. + +| | Minimum | Recommandé | +| :----------------: | ------- | ---------- | +| Architecture | x64 | - | +| RAM | 8 Go | 16 Go | +| Espace de stockage | 1 Go | 8 Go | +| JDK | 17 | 21 | + +Pour une modification de fichier fluide, il est recommandé d'installer un éditeur tel que [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Sortie correcte" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Environnement d'exécution Zulu21.32+17-CA (version 21.0.2+13-LTS) +OpenJDK 64 bits Server VM Zulu21.32+17-CA (version 21.0.2+13-LTS, mode mixte, partage) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' n'est pas reconnu en tant que commande interne ou externe, programme exécutable ou fichier de commandes. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Option non reconnue : --version +Erreur : Impossible de créer la machine virtuelle Java. +Erreur : Une exception fatale s'est produite. Le programme va se fermer. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Téléchargez d'abord **JDK 21** en format `.msi` depuis [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Exécutez l'assistant d'installation téléchargé et cliquez sur `Suivant`. +3. **Activez `Set JAVA_HOME variable` dans le menu affiché au centre gauche de la fenêtre**, puis cliquez sur `Suivant`. +4. Cliquez sur `Installer` pour terminer l'installation de JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Ensuite, installez JRE en exécutant la commande suivante dans le terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Téléchargement de Plazma + +Plazma propose différents types de fichiers exécutables. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +En savoir plus + +Le nom du fichier exécutable est défini comme suit : `plazma-(version du gestionnaire)-1.20.4-R0.1-SNAPSHOT-(type de mappage).jar`. + +- **Type de mappage**\ + Le mappage est une sorte de carte reliant le code réel de Minecraft au code obfusqué. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version du gestionnaire**\ + Le gestionnaire de version est essentiel pour le fonctionnement du serveur, car il fournit les bibliothèques nécessaires et patche les fichiers du serveur. + - **Paperclip**\ + Développé par l'équipe PaperMC pour Paper et d'autres plates-formes dérivées, il télécharge les bibliothèques et applique les correctifs au serveur. + - **Bundler**\ + Le gestionnaire de version de Minecraft vanilla. + +
+ +*** + +## 3. Création du script de démarrage + +Pour démarrer Plazma facilement et redémarrer automatiquement le serveur, vous devez créer un [script de démarrage](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Vous pouvez télécharger le script de démarrage en bas à gauche.\ +**Assurez-vous que le script téléchargé correspond à votre système d'exploitation.** + +*** + +## 4. Nettoyage des fichiers + +Déplacez maintenant le script de démarrage téléchargé et Plazma dans un nouveau dossier. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Exécutez maintenant le script de démarrage. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Acceptation de l'EULA + +Après avoir exécuté le script de démarrage une fois, un fichier `eula.txt` sera créé dans le dossier. + +L'EULA[^9] est un contrat de licence que vous devez accepter en utilisant les services de [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Pour accepter l'EULA, modifiez `eula=false` en `eula=true` dans le fichier `eula.txt` et enregistrez les modifications. + +*** + +## 6. Autorisation d'accès externe (Windows) + +Les systèmes d'exploitation modernes bloquent généralement l'accès externe par défaut à des fins de sécurité à l'aide du **pare-feu** et du **routeur**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Si votre routeur ne prend pas en charge l'UPnP, vous devrez rechercher comment configurer le transfert de port spécifiquement pour votre routeur. + +Vous pouvez également utiliser [Ngrok](https://ngrok.com/) pour générer une adresse temporaire. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Vérification de la nécessité du transfert de port + +Saisissez la commande suivante dans la fenêtre d'exécution et exécutez-la. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Si la sortie est `True`, vous avez terminé ici, sinon vous devrez configurer le transfert de port. + +### 6.2 Connexion au serveur + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +L'adresse utilisée pour se connecter au serveur peut être vérifiée [ici](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Ensuite, après avoir redémarré le serveur, Plazma tentera automatiquement de rediriger les ports. + +Le succès du UPnP est déterminé par le message affiché dans la console, qui sera affiché comme `[UPnP] (message)`. + +| Message | Signification | +| ------------------------------------- | ------------------------------------------------------- | +| `Port (port) ouvert avec succès` | Redirection de port réussie. | +| `Le port (port) est déjà ouvert` | Un autre service utilise déjà ce port. | +| `Échec de l'ouverture du port (port)` | Échec de la redirection de port. | +| `Le service est indisponible` | Le routeur ne prend pas en charge UPnP. | + +Lorsque le serveur est arrêté, Plazma ferme automatiquement le port. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Téléchargez le fichier ZIP `Windows (64-bit)` depuis le site [Ngrok](https://ngrok.com/download). +2. Placez le Ngrok téléchargé dans le dossier du serveur. +3. Sur le [tableau de bord Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), créez un [jeton d'authentification](#user-content-fn-13)[^13]. +4. Exécutez la commande affichée dans la `Ligne de commande` du dossier du serveur. +5. Ajoutez `start /b ngrok tcp --region jp 25565` en haut du script d'exécution, et `taskkill /f /t /im ngrok.exe` en bas. +6. Dans la console, l'adresse `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` devient l'adresse du serveur `0.tcp.jp.ngrok.io:12345`. +7. Vous pouvez maintenant vous connecter depuis l'extérieur via cette adresse. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Par exemple, lorsque vous obtenez la sortie suivante après l'exécution de la commande, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +En essayant de vous connecter avec l'adresse IPv4 `192.168.3.7` affichée ici, vous pouvez accéder au serveur en local. + +Si le serveur et le jeu sont exécutés sur le même PC, vous pouvez vous connecter via `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Évoluer + +Après avoir démarré avec succès le serveur et qu'il fonctionne correctement, il est temps de le personnaliser. + +Découvrez comment personnaliser le serveur à travers le guide ci-dessous. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, la base de Plazma, est basé sur Spigot, qui est la plateforme officielle du serveur. + +[^3]: Touches Windows + R + +[^4]: Pour Linux, utilisez `java --version` dans le terminal. + +[^5]: JRE est un projet open source avec plusieurs variantes comme les plateformes de serveurs Minecraft. + +[^6]: Il est généralement appelé **launcher**. + +[^7]: Activer l'option "Redémarrage automatique" permet au serveur de redémarrer automatiquement. Vous pouvez arrêter en entrant `Control + C`. + +[^8]: Il n'est pas recommandé de dépasser la moitié de la capacité du système. + + Par exemple, si la capacité totale de mémoire du système est de 8 Go, il n'est pas recommandé de dépasser 4 Go. + +[^9]: Contrat de licence utilisateur final, contrat de licence utilisateur final. Consultez le site [Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) pour plus d'informations. + +[^10]: Microsoft Corporation. + +[^11]: En vertu de l'article 32, paragraphe 1, point 9 de la loi sur la promotion de l'industrie du jeu en Corée, **Korea Microsoft Corporation** peut intenter une action en justice. + +[^12]: Universal Plug & Play. Le Purpur inclus dans Plazma communique automatiquement avec le routeur via cette technologie, ouvrant les ports uniquement lorsque le serveur est en cours d'exécution, donc il n'est pas nécessaire de configurer le transfert de port manuellement. + +[^13]: Si vous n'avez pas de compte, inscrivez-vous sur Ngrok via un compte Google ou GitHub. diff --git a/fr/origin/plazma/administration/getting-started/customization.md b/fr/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..2c3f0b588 --- /dev/null +++ b/fr/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Découvrez comment personnaliser le serveur. +--- + +# 🎨 Personnalisation + +La raison pour laquelle nous utilisons une plateforme de serveur modifiée comme Plazma au lieu de la plateforme officielle fournie par Mojang Studios est la possibilité de personnalisation forte. + +Voici plusieurs façons de personnaliser et utiliser Plazma. + +## Modification de la configuration + +La méthode la plus fondamentale pour personnaliser Plazma est de modifier la configuration. + +Plazma offre des paramètres de configuration puissants, allant des mécanismes de jeu aux attributs des monstres. + +Consultez la page suivante pour plus d'informations sur la configuration de Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Utilisation de plugins + +{% hint style="success" %} + +**Plazma prend en charge tous les plugins basés sur Paper.** + +Pour les plugins Spigot, certains peuvent ne pas fonctionner en raison des changements de mappage de Paper à partir de 1.20.5, mais la plupart des plugins basés sur Paper tels que Paper, Pufferfish et Purpur fonctionnent tous sur Plazma. Si un plugin ne fonctionne pas correctement, veuillez le signaler immédiatement [ici.](../diagnosis/plugins.md) + +{% endhint %} + +C'est la principale raison d'utiliser Plazma et le moyen le plus puissant de personnaliser Plazma. +L'écosystème puissant des plugins de Plazma permet de personnaliser facilement le serveur. + +Il existe plusieurs façons de trouver et télécharger des plugins. Certains plugins sont téléchargés sur des services de dépôt publics, tandis que d'autres sont téléchargés sur GitHub ou leurs propres sites Web. + +{% hint style="caution" %} + +**Les plugins peuvent accéder directement au système !** + +Avant d'appliquer un plugin, assurez-vous toujours de sa sécurité en utilisant des services tels que VirusTotal, ou téléchargez le plugin à partir de services fiables. + +{% endhint %} + +Il existe plusieurs services pour télécharger des plugins. Parmi eux, des services tels que [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hangar](https://hangar.papermc.io/) examinent les plugins avant de les distribuer pour garantir la sécurité. + +### Application des plugins + +Une fois le plugin téléchargé, il est temps de l'appliquer. + +1. Les plugins sont au format `.jar` ou `Java Executable File`. Certains sont compressés, dans ce cas, extrayez le fichier contenant `bukkit`, `spigot` ou `paper` et utilisez le fichier `fat` s'il est présent. +2. Placez le fichier téléchargé dans le dossier `plugins` du serveur et redémarrez-le. +3. Lorsque Plazma démarre, de nouveaux messages s'afficheront dans la console, indiquant que les plugins ont été chargés correctement. + Cela signifie que les plugins ont été chargés correctement par Plazma. +4. Même si les plugins ont été chargés correctement par Plazma, ils peuvent ne pas démarrer. + La commande `/plugins` permet de lister les plugins actuellement chargés sur le serveur. + Si le nom du plugin est en rouge et non en vert, cela signifie que le plugin n'a pas été chargé correctement. + +Si un plugin n'a pas été chargé correctement, vous pouvez trouver des solutions sur la page suivante. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Utilisation de datapacks + +Les datapacks sont une méthode de personnalisation fournie par Minecraft, similaire aux packs de ressources. + +Les datapacks permettent de modifier certains aspects du jeu, comme ajouter de nouvelles entités et défis. + +{% hint style="caution" %} + +**Les datapacks peuvent endommager le monde !** + +Certains datapacks défectueux peuvent endommager le monde de manière irréversible. + +Il est donc recommandé de sauvegarder le monde avant d'appliquer un datapack. + +{% endhint %} + +Les datapacks peuvent être téléchargés depuis plusieurs services tels que [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/). + +Une fois le datapack téléchargé, placez-le dans le dossier `datapacks` du monde du serveur. +Créez le dossier s'il n'existe pas. + +{% hint style="warning" %} + +**Certains [datapacks](#user-content-fn-2) peuvent ne pas s'appliquer correctement lors de la première utilisation.** + +Il est recommandé de redémarrer le serveur **2 fois** en cas de problème d'application d'un datapack. + +{% endhint %} + +Les datapacks peuvent facilement être endommagés à chaque mise à jour de Minecraft. + +En cas de corruption totale d'un datapack, il est important de tester suffisamment avant de mettre à jour le serveur pour éviter les crashes. + +{% hint style="info" %} + +**Après la commande de démarrage du serveur, saisissez `safeMode` pour désactiver tous les datapacks avant de redémarrer le serveur.** + +[Consultez `Référence > Arguments` pour plus d'informations détaillées.](../reference/arguments.md) + +{% endhint %} + +Les datapacks appliqués peuvent être vérifiés en utilisant la commande `/datapack list`. + +*** + +[^1]: Ou des add-ons pour Minecraft: Bedrock Edition. + +[^2]: Ajout d'entités et plus encore. diff --git a/fr/origin/plazma/administration/getting-started/next-step.md b/fr/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..c21126b6a --- /dev/null +++ b/fr/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Découvrez comment personnaliser le serveur. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Voici plusieurs façons de personnaliser et utiliser Plazma. + +## Modification de la configuration + +La méthode la plus fondamentale pour personnaliser Plazma est de modifier la configuration. + +Plazma offre des paramètres de configuration puissants, allant des mécanismes de jeu aux attributs des monstres. + +Consultez la page suivante pour plus d'informations sur la configuration de Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Utilisation de plugins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +C'est la principale raison d'utiliser Plazma et le moyen le plus puissant de personnaliser Plazma. L'écosystème puissant des plugins de Plazma permet de personnaliser facilement le serveur. + +Il existe plusieurs façons de trouver et télécharger des plugins. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Il existe plusieurs services pour télécharger des plugins. Parmi eux, des services tels que [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hangar](https://hangar.papermc.io/) examinent les plugins avant de les distribuer pour garantir la sécurité. + +### Application des plugins + +Une fois le plugin téléchargé, il est temps de l'appliquer. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Placez le fichier téléchargé dans le dossier `plugins` du serveur et redémarrez-le. +3. Lorsque Plazma démarre, de nouveaux messages s'afficheront dans la console, indiquant que les plugins ont été chargés correctement. Cela signifie que les plugins ont été chargés correctement par Plazma. +4. Même si les plugins ont été chargés correctement par Plazma, ils peuvent ne pas démarrer. La commande `/plugins` permet de lister les plugins actuellement chargés sur le serveur. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Si un plugin n'a pas été chargé correctement, vous pouvez trouver des solutions sur la page suivante. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Utilisation de datapacks + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Les datapacks permettent de modifier certains aspects du jeu, comme ajouter de nouvelles entités et défis. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Certains datapacks défectueux peuvent endommager le monde de manière irréversible. + +Il est donc recommandé de sauvegarder le monde avant d'appliquer un datapack. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Une fois le datapack téléchargé, placez-le dans le dossier `datapacks` du monde du serveur. Créez le dossier s'il n'existe pas. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Il est recommandé de redémarrer le serveur **2 fois** en cas de problème d'application d'un datapack. +{% endhint %} + +Les datapacks peuvent facilement être endommagés à chaque mise à jour de Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Les datapacks appliqués peuvent être vérifiés en utilisant la commande `/datapack list`. + +*** + +## Optimisation + +Plazma a subi de nombreux correctifs d'optimisation. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Pour des informations sur la configuration sécurisée et correcte du proxy, veuillez consulter la page ci-dessous. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Sécurité + +Avec l'évolution des mods, il est facile de trouver des [moteurs d'attaque de vulnérabilités](#user-content-fn-3)[^3] en ligne pour Minecraft. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Configuration des autorisations + +Certains commandes administratives de plugins peuvent présenter des vulnérabilités si les autorisations ne sont pas correctement définies. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blocage X-Ray + +X-Ray est l'une des vulnérabilités facilement exploitables même avec un client d'optimisation de base. + +Plazma propose une configuration par défaut pour bloquer X-Ray. + +Veuillez consulter la page ci-dessous pour des informations sur la manière de bloquer X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Liste blanche + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Pour voir les joueurs autorisés à accéder, utilisez `/whitelist query`. + +*** + +[^1]: Ou des add-ons pour Minecraft: Bedrock Edition. + +[^2]: Ajout d'entités et plus encore. + +[^3]: Généralement appelé "cheat". + +[^4]: Si la configuration n'est pas optimisée, si Plazma est obsolète ou si de nouvelles vulnérabilités sont découvertes, elles peuvent ne pas être bloquées. + +[^5]: Les joueurs se connectent au serveur via le serveur proxy Ngrok, et l'adresse Ngrok émise à chaque redémarrage est différente. diff --git a/fr/origin/plazma/administration/reference/README.md b/fr/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..a335fe152 --- /dev/null +++ b/fr/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Découvrez les méthodes de personnalisation de base fournies par Plazma. +--- + +# 📜 리퍼런스 + +Plazma propose diverses méthodes de personnalisation. + +Parmi celles-ci, ces 4 méthodes de personnalisation peuvent être utilisées immédiatement sans travaux supplémentaires. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Serveur Discord officiel](https://discord.gg/MmfC52K8A8) ou [Discussions GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) pour poser des questions à la communauté ! +{% endhint %} + +*** + +## 🖥️ Commandes + +> Les commandes permettent de collecter des informations dans le jeu ou de personnaliser l'environnement de jeu. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Autorisations + +> Les autorisations définissent la portée des interactions possibles pour les joueurs. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Arguments et propriétés + +> Les arguments et les propriétés ont un impact global sur le fonctionnement de Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurations + +> Les configurations sont la méthode la plus fondamentale pour personnaliser Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/fr/origin/plazma/administration/reference/arguments.md b/fr/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..05b64e154 --- /dev/null +++ b/fr/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Découvrez les arguments de démarrage et les propriétés du système. +--- + +# 🎛️ Arguments de démarrage et propriétés + +Le début de l'acquisition et les propriétés du système sont des valeurs ajoutées à la commande utilisée pour l'exécution de Plazma, qui ont un impact global sur le fonctionnement de Plazma. + +Selon la **argument de démarrage** et les **propriétés système** ajoutés à l'emplacement de la commande[^2], ils seront divisés. + +*** + +## Propriétés du système + +Les propriétés du système sont des valeurs traitées par la JVM avant l'initialisation de Plazma et placées avant `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Mode d'emploi + +Les propriétés du système sont ajoutées en tant qu'arguments de commande Java entre `java` et `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indique que cet argument n'est pas intégré à la JVM mais est un argument personnalisé pour Plazma, + +Si aucune valeur n'est saisie pour les propriétés, la valeur sera fixée à [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Liste complète des propriétés du système + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Met à jour le format des panneaux obsolètes utilisés. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage des informations sur les entités. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la révision NMS pour permettre une récupération correcte des informations de débogage dans l'IDE et remappe automatiquement les informations de version interne. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le système d'alerte Watchdog de Spigot. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le message de confirmation de la commande `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Si vous êtes un développeur de plugin et devez mettre à jour un plugin, utilisez le hotswap au lieu de la commande `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive les plugins utilisant le système d'entrée/sortie standard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Affiche un avertissement en cas de détection de formatage obsolète dans les composants de chat. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la vérification de motif du serveur lorsqu'un joueur se connecte. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage pour les clés manquantes dans les objets NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage pour les profils de crâne incorrects. + +Cela enregistre tous les blocs de crâne incorrects dans le monde avec leur position. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le système de priorisation des classes de plugin. + +Utile en cas de problème avec les ombres des plugins. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le système de consolidation des envois Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valeur par défaut**: `750` + +Divise les entités en paquets multiples pour l'envoi si elles dépassent cette valeur. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valeur par défaut**: `8192` + +Définit la taille maximale des paquets que le serveur peut recevoir à la fois. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la vérification de version de Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Cela peut entraîner des dommages permanents aux fichiers du monde et causer des dysfonctionnements dans le jeu. + +Tout problème résultant de cette action est de la responsabilité de l'utilisateur, Plamza ne fournissant aucun support à cet égard. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valeur par défaut**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valeur par défaut**: `80` + +Définit la longueur maximale des lignes des panneaux. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valeur par défaut**: `(version du monde) + 1` + +Définit la version des informations de mise à jour du monde à initialiser en premier. + +Utile pour les mises à jour massives de chunks mais rarement utilisé autrement. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Valeur par défaut**: `True` + +Active le traitement des commentaires YAML. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valeur par défaut**: `30` + +Expulse un joueur s'il n'a reçu aucune donnée pendant le temps spécifié (en secondes). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Ignore les commentaires des propriétés du serveur. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage de la création synchrone des chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active le système de création synchrone des chunks de base de Minecraft. + +Cela entraîne un ralentissement considérable car chaque chunk est sauvegardé séquentiellement. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active le vidage explicite des canaux réseau. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Journalise toujours les erreurs qui ne se produisent pas sur le thread principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Affiche un avertissement en cas de délai excessif des tâches planifiées. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Applique uniquement les correctifs sans démarrer le serveur lorsque vous utilisez le fichier exécutable par défaut. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` +- **Collision**: `Plazma.disableConfigOptimization` + +Optimisez la configuration initiale de manière plus forte. + +L'activation rendra le serveur plus rapide et plus sécurisé, mais peut avoir un impact majeur sur le gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` +- **Collision**: `Plazma.aggressiveOptimize` + +Ne pas optimiser la configuration initiale. + +Cela utilisera la configuration de base de Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` + +Désactivez le branding Plazma et utilisez la favicon de serveur par défaut en mode basic. + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` +- **Collision**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Cela peut avoir un impact significatif sur la sécurité et les performances du serveur. + +Tous les problèmes découlant de l'utilisation de cette propriété relèvent de la responsabilité de l'administrateur du serveur. +{% endhint %} + +Fournit la configuration initiale avec les valeurs par défaut fournies par Mojang. + +Cela désactive tous les correctifs de vulnérabilité appliqués par Paper. + +Les correctifs de vulnérabilité peuvent être réactivés dans la configuration Paper ou Plazma. + +#### `Plazma.vanillaize` + +- **Type**: `Boolean` +- **Valeur par défaut**: `true` +- **Collision**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Configure la configuration initiale pour être plus proche du mode basic. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Propriété obsolète + +Les propriétés système ci-dessous sont obsolètes. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` +- **Obsolète**: Depuis la suppression complète de Timings de Plazma + +Détermine si une valeur peut dépasser la limite maximale pouvant être envoyée à l'API Timings d'Aikar. + +Même si cela est fait, si aucune exception n'est gérée dans l'API, une limitation de débit s'applique. + +*** + +## Argument de démarrage + +L'argument de démarrage est saisi après `-jar *.jar` pour initialiser Plazma et est traité conjointement. + +### Mode d'emploi + +Les propriétés système sont saisies en tant qu'arguments de commande de programme après `-jar *.jar`. + +Par exemple, si vous souhaitez appliquer l'argument de démarrage `nogui`,\ +entrez comme suit pour que Plazma traite l'argument `nogui` pendant l'initialisation. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argument de démarrage complet + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valeur par défaut**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Valeur par défaut**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Valeur par défaut**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Démarre le serveur en mode démo. + +#### `eraseCache` + +Supprime les fichiers de cache restants après la mise à niveau du monde. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Affiche tous les arguments de démarrage de Plazma et leur description. + +#### `initSettings` + +Crée uniquement les fichiers de configuration et arrête le serveur. + +#### `jfrProfile` + +Active le profilage JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valeur par défaut**: `(propriété du serveur)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Désactive le panneau d'interface graphique. + +#### `nojline` + +Désactive JLine et utilise la console de base. + +#### `mode en ligne` + +- **Alias**: `o` +- **Valeur par défaut**: `(propriété du serveur)` + +Choisit si les joueurs doivent être vérifiés par le serveur d'authentification Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paramètres-paper` + +- **Alias**: `papier` +- **Valeur par défaut**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Définit l'emplacement des fichiers de configuration PaperSpigot désactivés. + +Il est utilisé pour migrer les anciennes configurations vers de nouveaux fichiers de configuration, mais n'est plus utilisé par la suite. + +#### `répertoire-paramètres-paper` + +- **Alias**: `papier-dir` +- **Valeur par défaut**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `répertoire-paramètres-plazma` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Valeur par défaut**: `plugins` + +Définit l'emplacement du dossier des plugins. + +#### `paramètres-pufferfish` + +- **Alias**: `pufferfish` +- **Valeur par défaut**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `paramètres-purpur` + +- **Alias**: `purpur` +- **Valeur par défaut**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `mode sécurisé` + +Démarre le serveur en mode totalement vanilla. + +#### `ip-serveur` + +- **Alias**: `h`, `hôte` +- **Valeur par défaut**: `(propriété du serveur)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `port-serveur` + +- **Alias**: `p`, `port` +- **Valeur par défaut**: `(propriété du serveur)` + +Définit le port du serveur. + +#### `nom-serveur` + +- **Valeur par défaut**: `Un serveur Plazma` + +Définit le nom du serveur. + +#### `paramètres-spigot` + +- **Alias**: `S` +- **Valeur par défaut**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Affiche la version de Plazma. + +#### `répertoire-monde` + +- **Alias**: `W`, `univers`, `conteneur-monde` +- **Valeur par défaut**: `(dossier du serveur)` + +Définit l'emplacement où les fichiers de monde sont stockés. + +#### `nom-monde` + +- **Alias**: `w`, `monde` +- **Valeur par défaut**: `(propriété du serveur)` + +Définit le nom du fichier de monde. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Le traitement des arguments varie en fonction de l'emplacement auquel ils sont ajoutés. + +[^3]: Par exemple, pour activer `Plazma.iKnowWhatIAmDoing` à `true`, il suffit de saisir `-DPlazma.iKnowWhatIAmDoing` au lieu de `-DPlazma.iKnowWhatIAmDoing=true`, cela fonctionnera de la même manière. + +[^4]: Par exemple, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Détecteur d'événements. + +[^6]: Détecteur d'événements. + +[^7]: Client. + +[^8]: Signal indiquant une connexion réussie au serveur, similaire aux battements de cœur. + +[^9]: Avec la fonction d'expulsion AFK de Purpur, même les joueurs absents peuvent être expulsés. + +[^10]: Système d'écriture de chunk synchronisé, Sync Chunk Write System. + +[^11]: `ATTENTION! Plazma peut causer des problèmes inattendus, assurez-vous de bien le tester avant de l'utiliser sur un serveur public.` + +[^12]: La `optimisation du monde` fonctionne sur le même principe en jeu. + +[^13]: Les administrateurs de `niveau 2` ou supérieur sont exclus. + +[^14]: Protocole Internet, IP. diff --git a/fr/origin/plazma/administration/reference/commands.md b/fr/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..582c4c942 --- /dev/null +++ b/fr/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Découvrez les commandes disponibles sur Plazma. +--- + +# 🖥️ Commandes diff --git a/fr/origin/plazma/administration/reference/configurations/README.md b/fr/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..f0468db0c --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Les configurations sont la méthode la plus fondamentale pour personnaliser Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Propriété + +> Les propriétés sont les fichiers de configuration les plus élémentaires fournis par Minecraft. En utilisant les propriétés, vous pouvez modifier les mécanismes de base du jeu. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configuration Bukkit + +> La configuration Bukkit est le fichier de configuration le plus élémentaire fourni par Plazma. En utilisant la configuration Bukkit, vous pouvez modifier les mécanismes de base du serveur Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configuration Spigot + +> La configuration Spigot permet de modifier les mécanismes détaillés du jeu, le traitement des joueurs, le fonctionnement des commandes, etc. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configuration Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configuration Pufferfish + +> La configuration Pufferfish permet de modifier le traitement des mondes et entités de Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configuration Purpur + +> Les propriétés Purpur permettent de modifier les données de base globales du jeu. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configuration Plazma + +> La configuration Plazma permet de personnaliser les fonctionnalités de Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/fr/origin/plazma/administration/reference/configurations/bukkit.md b/fr/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..2a2937a85 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de bukkit.yml signifie. +--- + +# 🪣 Bukkit diff --git a/fr/origin/plazma/administration/reference/configurations/paper/README.md b/fr/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..3301fda92 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez l'objectif de chaque fichier dans le dossier config. +--- + +# 🛩️ Papier diff --git a/fr/origin/plazma/administration/reference/configurations/paper/global.md b/fr/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a4e60c45a --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de paper-global.yml signifie. +--- + +# 🌏 전역 구성 diff --git a/fr/origin/plazma/administration/reference/configurations/paper/world.md b/fr/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..541f4e278 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Découvrez ce que chaque nœud de paper-world.yml signifie. +--- + +# 🏳️ 세계별 구성 + +Monde diff --git a/fr/origin/plazma/administration/reference/configurations/plazma/README.md b/fr/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..97f989fab --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez l'objectif de chaque fichier dans le dossier config. +--- + +# ✨ Plazma diff --git a/fr/origin/plazma/administration/reference/configurations/plazma/global.md b/fr/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..15759792f --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de plazma-global.yml signifie. +--- + +# 🌏 전역 구성 diff --git a/fr/origin/plazma/administration/reference/configurations/plazma/world.md b/fr/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..bc1b880a5 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud dans plazma-world.yml signifie. +--- + +# 🏳️ 세계별 구성 diff --git a/fr/origin/plazma/administration/reference/configurations/plazma/worlds.md b/fr/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d0543db46 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud dans plazma-world.yml signifie. +--- + +# ✨ Plazma (Composition du monde) diff --git a/fr/origin/plazma/administration/reference/configurations/property.md b/fr/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..784ffab5c --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de server.properties signifie. +--- + +# 🪨 Server.properties diff --git a/fr/origin/plazma/administration/reference/configurations/pufferfish.md b/fr/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..4a9c1ba8e --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud dans pufferfish.yml signifie. +--- + +# 🐡 Poisson-globe diff --git a/fr/origin/plazma/administration/reference/configurations/purpur/README.md b/fr/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..aeceb37df --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de purpur.yml signifie. +--- + +# 🦑 Purpur diff --git a/fr/origin/plazma/administration/reference/configurations/purpur/global.md b/fr/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..79ead5dea --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de purpur.yml signifie. +--- + +# 🌏 전역 구성 diff --git a/fr/origin/plazma/administration/reference/configurations/purpur/world.md b/fr/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..14694dde9 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de purpur.yml signifie. +--- + +# 🏳️ 세계별 구성 diff --git a/fr/origin/plazma/administration/reference/configurations/spigot.md b/fr/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..b14545005 --- /dev/null +++ b/fr/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de spigot.yml signifie. +--- + +# 🚰 Spigot diff --git a/fr/origin/plazma/administration/reference/permissions.md b/fr/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..d858ef526 --- /dev/null +++ b/fr/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Découvrez les autorisations de Plazma. +--- + +# 🛡️ Autorisations + +Les autorisations sont des outils de sécurité simples qui définissent la portée d'interaction des joueurs sur le serveur. + +Pour bien utiliser et modifier les autorisations, vous devez utiliser des plugins tels que [LuckPerms](https://luckperms.net). + +*** + +## Comprendre le système d'autorisations de base + +Minecraft propose des groupes de permissions de gestion de base. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Joueur**\ + Groupe de permissions généralement attribué à tous les joueurs. +2. **Médiateur**\ + Peut ignorer la protection du spawn. +3. **Administrateur de monde**\ + Peut utiliser toutes les commandes et blocs de commande liés à la gestion du monde.\ + Groupe de permissions appliqué par défaut aux datapacks et blocs de commande. +4. **Administrateur**\ + Peut utiliser toutes les commandes liées à la gestion des joueurs. +5. **Super administrateur**\ + Peut utiliser toutes les commandes, y compris celles liées à la gestion du serveur.\ + Groupe de permissions appliqué par défaut à la console et aux opérateurs. + +*** + +## Définir des autorisations + +*** + +## Autorisations globales + +*** + +#### `allow.ride.(Clé namespace)` + +- **Par défaut**: `Aucun` + +Permet aux joueurs de monter sur une entité en s'accroupissant et en interagissant avec elle. + +En montant sur une entité, vous pouvez contrôler son déplacement avec les touches de déplacement et sauter ou voler avec la touche de saut. + +La [clé namespace](#user-content-fn-2)[^2] de l'entité est saisie dans `(Clé namespace)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Clé en espace de noms)` + +- **Par défaut**: `Aucun` + +Permet au joueur d'utiliser les compétences spéciales de l'entité lorsqu'il est monté sur celle-ci. + +Toutes les entités n'ont pas accès aux compétences spéciales. Consultez ci-dessous toutes les compétences spéciales disponibles. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Veuillez publier vos idées sur [Plazma Discord](https://plazmamc.org/discord) ou [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Voir toutes les compétences spéciales disponibles actuellement + +- **`creeper`**\ + Explose lorsqu'on appuie sur la touche `sauter`.\ + Si le joueur a la permission `allow.powered.creeper`, il peut charger en maintenant la touche `sauter`. +- **`dauphin`**\ + Charge en appuyant sur la touche `sauter`. +- **`phantom`**\ + Tire des flammes en appuyant sur la touche `sauter`. +- **`wither`**\ + Lance la tête de Wither en interagissant. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/credits (Joueur)`](commands.md#credits). + +En ajoutant `.autre` après le nom de la permission, permet de l'utiliser pour d'autres joueurs. + +#### `bukkit.command.demo` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/demo (Joueur)`](commands.md#demo). + +En ajoutant `.autre` après le nom de la permission, permet de l'utiliser pour d'autres joueurs. + +#### `bukkit.command.ping` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/ping (Joueur)`](commands.md#ping). + +En ajoutant `.autre` après le nom de la permission, permet de l'utiliser pour d'autres joueurs. + +#### `bukkit.command.ram` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/rambar (Joueur)`](commands.md#rambar). + +En ajoutant `.autre` après le nom de la permission, permet de l'utiliser pour d'autres joueurs. + +#### `bukkit.command.restart` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/tpsbar (Joueur)`](commands.md#tpsbar). + +En ajoutant `.autre` après le nom de la permission, permet de l'utiliser pour d'autres joueurs. + +#### `bukkit.command.timings` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Consultez [Spark](https://spark.lucko.me/docs/Command-Usage) pour des commandes similaires. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(Mode de jeu)` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise l'utilisation de la commande `/gamemode (Mode de jeu) (Joueur)`. + +En ajoutant `.autre` après le nom de la permission, permet de l'utiliser pour d'autres joueurs. + +#### `paper.antixray.bypass` + +- **Par défaut**: `Aucun` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Cela améliore les performances des deux côtés. + +> Consultez la page ci-dessous pour plus d'informations sur la configuration X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Par défaut**: `Aucun` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Par défaut**: `Aucun` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Par défaut**: `Aucun` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Par défaut**: `Aucun` + +Permet l'utilisation des [balises MiniMessage](https://docs.advntr.dev/minimessage/format.html) sur l'enclume. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Par défaut**: `Aucun` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Par défaut**: `Aucun` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Par défaut**: `Aucun` + +Exclut le joueur de l'expulsion pour inactivité. + +#### `purpur.debug.f3n` + +- **Fourni par défaut**: `Administrateur de monde` + +Autorise le joueur à changer de mode de jeu en appuyant sur `F3 + N`. + +Cela ne fonctionne que si le joueur a la permission pour ce mode de jeu. + +#### `purpur.drop.spawners` + +- **Par défaut**: `Aucun` + +Lorsque vous minez un bloc de spawner avec l'objet configuré, il fait tomber le bloc de spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NombreTexte)` + +- **Par défaut**: `Aucun` + +Modifie la taille du coffre de l'End. + +Vous pouvez saisir `one`, `two`, `three`, `four`, `five`, `six` pour `(NombreTexte)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Par défaut**: `Aucun` + +Permet au totem d'immortalité de fonctionner même s'il est dans l'inventaire. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Par défaut**: `Aucun` + +Permet au joueur d'ignorer la limite de joueurs connectés. + +#### `purpur.mending_shift_click` + +- **Par défaut**: `Aucun` + +Permet au joueur de réparer un objet en le tenant et en **s'accroupissant et en interagissant**. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Par défaut**: `Aucun` + +Permet au joueur d'installer des générateurs. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Par défaut**: `Aucun` + +Permet au joueur de se téléporter immédiatement lorsqu'il utilise un portail de l'End. + +#### `purpur.sign.color` + +- **Par défaut**: `Aucun` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Par défaut**: `Aucun` + +Permet d'utiliser le code d'illusion `(&o)` sur les panneaux. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Par défaut**: `Aucun` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Par défaut**: `Aucun` + +Permet au joueur d'empêcher l'explosion du TNT en interagissant avec des ciseaux. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permission prévue + +#### `plazma.bypass.ncr-require` + +- **Par défaut**: `Aucun` + +Permet au joueur de se connecter même sans avoir installé le mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Opérateur. + +[^2]: Par exemple : `ender_dragon` diff --git a/fr/origin/plazma/adminstration/README.md b/fr/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..a98680060 --- /dev/null +++ b/fr/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Créez votre propre serveur en utilisant Plazma. +--- + +# ⚒️ Guide de gestion du serveur diff --git a/fr/origin/plazma/adminstration/expert/README.md b/fr/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..f22b8c0fd --- /dev/null +++ b/fr/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment traiter professionnellement le Plazma. +--- + +# 🎓 Approfondissement diff --git a/fr/origin/plazma/adminstration/expert/fix-exploits.md b/fr/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..6c88a808a --- /dev/null +++ b/fr/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Découvrez les vulnérabilités connues et comment les résoudre. +--- + +# ⚠️ Vulnérabilités connues et méthodes de résolution diff --git a/fr/origin/plazma/adminstration/expert/optimize.md b/fr/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..d4459dc38 --- /dev/null +++ b/fr/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment optimiser Plazma. +--- + +# 🧹 Optimisation diff --git a/fr/origin/plazma/adminstration/expert/vanillaize.md b/fr/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..80bda5f31 --- /dev/null +++ b/fr/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Découvrez comment restaurer les patchs de Paper et de vanille. +--- + +# ↩️ Vanilliser + +{% hint style="warning" %} + +### Paper n'offre pas d'options pour résoudre la plupart des patchs d'erreur de vanille. + +Plazma est en train de développer une configuration pour désactiver ces corrections d'erreur. + +Par conséquent, ce guide est encore en cours d'élaboration et les informations sont susceptibles de changer à tout moment. +{% endhint %} diff --git a/fr/origin/plazma/adminstration/faq.md b/fr/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..98cbef7f4 --- /dev/null +++ b/fr/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Découvrez les questions fréquemment posées. +--- + +# ⁉️ Questions fréquemment posées + +{% hint style="info" %} + +### Vous ne trouvez pas la réponse que vous cherchez? + +Posez vos questions à la communauté via le [serveur Discord officiel](https://discord.gg/MmfC52K8A8) ou les [problèmes GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Le message s'affiche mais l'exécution ne se fait pas + +Si vous voyez `no main manifest attribute, in plazma-(version).jar` dans la console,\ +le fichier que vous avez téléchargé est destiné à l'API de développement, vous devez télécharger **Reobf Paperweight** depuis la page GitHub. + +Consultez la page suivante pour plus de détails. + +{% content-ref url="getting-started/" %} +[démarrage](getting-started#id-2) +{% endcontent-ref %} + +### Un avertissement s'affiche à chaque démarrage du serveur + +Plazma contient quelques correctifs instables et peut toujours présenter des dysfonctionnements, c'est pourquoi ces avertissements s'affichent lors du démarrage du serveur. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Cet avertissement peut être désactivé en utilisant la propriété système [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Consultez la page suivante pour plus de détails. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponible à partir de la version 1.20.1 diff --git a/fr/origin/plazma/adminstration/getting-started/README.md b/fr/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..51c4a5b06 --- /dev/null +++ b/fr/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Découvrez comment créer un serveur avec Plazma. +--- + +# 👟 Commencer + +Pour utiliser Plazma de manière stable, le système doit répondre aux exigences suivantes. + +| | Minimum | Recommandé | +| :----------------: | ------: | ---------: | +| Architecture | x64 | - | +| RAM | 8 Go | 16 Go | +| Espace de stockage | 1 Go | 8 Go | +| JRE | 17 | 21 | + +Pour une modification de fichier fluide, il est recommandé d'installer un éditeur tel que [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Installation de JRE + +Comme son nom l'indique, Minecraft: **"Java"** Edition est développé en Java et nécessite JRE[^1] pour s'exécuter. + +Plazma étant basé sur la plateforme officielle de serveurs de Mojang Studios, l'installation de JRE est également nécessaire pour utiliser Plazma. + +### 1.1 Vérification de la présence de JRE + +Pour vérifier si JRE est installé sur le système, saisissez [`cmd /k java --version`](#user-content-fn-4)[^4] dans la fenêtre d'exécution et exécutez. + +Si vous obtenez la sortie suivante, passez à l'étape 2. + +{% code title="Sortie correcte" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Si la sortie est différente ou ressemble à ce qui suit, cela signifie que JRE est absent ou trop ancien, vous devez alors effectuer l'étape 1.2. + +{% code title="JRE non installé" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE trop ancien" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Installation de JRE + +Dans ce guide, nous utilisons Azul Zulu comme l'une des versions de JRE[^5]. + +Une fois l'installation terminée, refaites l'étape 1.1 pour vérifier que l'installation s'est correctement déroulée. + +{% tabs %} +{% tab title="Windows" %} + +1. Téléchargez d'abord **JDK 21** en format `.msi` depuis [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Exécutez l'assistant d'installation téléchargé et cliquez sur `Suivant`. +3. **Activez `Set JAVA_HOME variable` dans le menu affiché au centre gauche de la fenêtre**, puis cliquez sur `Suivant`. +4. Cliquez sur `Installer` pour terminer l'installation de JRE. + {% endtab %} + +{% tab title="macOS" %} +Téléchargez le fichier d'installation de **JDK 21** en format `.dmg` depuis [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) et exécutez-le pour installer JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Ajoutez d'abord le référentiel Azul Zulu à APT en exécutant la commande suivante dans le terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Ensuite, installez JRE en exécutant la commande suivante dans le terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Vous pouvez installer JRE en saisissant la commande suivante. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Téléchargement de Plazma + +Plazma propose différents types de fichiers exécutables. + +{% hint style="warning" %} + +### Dans la plupart des cas, utilisez `Reobf Paperclip`. + +Les informations ci-dessous sont destinées aux développeurs ou à ceux qui s'intéressent aux caractéristiques de chaque type.\ +Si vous êtes un utilisateur standard, vous pouvez passer directement à l'étape 3 sans problème. +{% endhint %} + +
+ +En savoir plus + +Le nom du fichier exécutable est défini comme suit : `plazma-(version du gestionnaire)-1.20.4-R0.1-SNAPSHOT-(type de mappage).jar`. + +- **Type de mappage**\ + Le mappage est une sorte de carte reliant le code réel de Minecraft au code obfusqué. + - **Reobf**\ + Reobfuscation, également appelé mappage Spigot, est largement utilisé dans la plupart des plugins NMS.\ + Son utilisation sera interrompue à partir de la version 1.20.5. + - **Mojmap**\ + Mappage de Mojang, c'est le mappage de Minecraft vanilla. +- **Version du gestionnaire**\ + Le gestionnaire de version est essentiel pour le fonctionnement du serveur, car il fournit les bibliothèques nécessaires et patche les fichiers du serveur. + - **Paperclip**\ + Développé par l'équipe PaperMC pour Paper et d'autres plates-formes dérivées, il télécharge les bibliothèques et applique les correctifs au serveur. + - **Bundler**\ + Le gestionnaire de version de Minecraft vanilla. + +
+ +*** + +## 3. Création du script de démarrage + +Pour démarrer Plazma facilement et redémarrer automatiquement le serveur, vous devez créer un [script de démarrage](#user-content-fn-6)[^6]. + +Vous pouvez créer le script de démarrage via [Flags.sh](https://flags.sh). En entrant simplement la [mémoire à utiliser](#user-content-fn-8)[^8] pour Plazma, la commande sera automatiquement optimisée. + +Vous pouvez télécharger le script de démarrage en bas à gauche.\ +**Assurez-vous que le script téléchargé correspond à votre système d'exploitation.** + +*** + +## 4. Nettoyage des fichiers + +Déplacez maintenant le script de démarrage téléchargé et Plazma dans un nouveau dossier. + +{% hint style="warning" %} + +### Le nom du dossier ne doit contenir aucun espace et doit être en anglais. + +Sinon, Plazma ou JRE risquent de ne pas fonctionner correctement. +{% endhint %} + +Exécutez maintenant le script de démarrage. Pour Windows, lorsque la fenêtre de sélection d'autorisation du pare-feu apparaît, assurez-vous de sélectionner **Autoriser**. + +*** + +## 5. Acceptation de l'EULA + +Après avoir exécuté le script de démarrage une fois, un fichier `eula.txt` sera créé dans le dossier. + +L'EULA[^9] est un contrat de licence que vous devez accepter en utilisant les services de [Mojang Studios](#user-content-fn-10)[^10]. + +Si vous refusez l'EULA, vous ne pourrez pas démarrer le serveur et pourrez être sanctionné en cas de violation, comme la suspension de votre compte, etc. [Voir les sanctions](#user-content-fn-11)[^11]. + +Pour accepter l'EULA, modifiez `eula=false` en `eula=true` dans le fichier `eula.txt` et enregistrez les modifications. + +*** + +## 6. Autorisation d'accès externe (Windows) + +Les systèmes d'exploitation modernes bloquent généralement l'accès externe par défaut à des fins de sécurité à l'aide du **pare-feu** et du **routeur**. + +Pour Windows, puisque vous avez autorisé le pare-feu à l'étape 3, il vous suffit de configurer le transfert de port. + +{% hint style="info" %} + +### Ce guide suppose que vous utilisez un système d'exploitation Windows et un routeur prenant en charge [**UPnP**](#user-content-fn-12)[^12]. + +Si votre routeur ne prend pas en charge l'UPnP, vous devrez rechercher comment configurer le transfert de port spécifiquement pour votre routeur. + +Vous pouvez également utiliser [Ngrok](https://ngrok.com/) pour générer une adresse temporaire. +{% endhint %} + +{% hint style="warning" %} + +### Pour les systèmes d'exploitation basés sur UNIX, tels que Linux ou macOS, les instructions de configuration du pare-feu varient en fonction du service, vous devrez donc effectuer des recherches. + +{% endhint %} + +### 6.1 Vérification de la nécessité du transfert de port + +Saisissez la commande suivante dans la fenêtre d'exécution et exécutez-la. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Si la sortie est `True`, vous avez terminé ici, sinon vous devrez configurer le transfert de port. + +### 6.2 Connexion au serveur + +{% tabs %} +{% tab title="Connexion externe" %} +Si le transfert de port n'est pas nécessaire ou si vous l'avez déjà configuré avec succès, vous pouvez maintenant vous connecter au serveur. + +L'adresse utilisée pour se connecter au serveur peut être vérifiée [ici](https://ip.pe.kr/) +{% endtab %} + +{% tab title="Tentative de redirection de port via UPnP" %} +Dans le fichier `purpur.yml` du dossier du serveur, activez `network.upnp-port-forwarding` sur `true`. + +Ensuite, après avoir redémarré le serveur, Plazma tentera automatiquement de rediriger les ports. + +Le succès du UPnP est déterminé par le message affiché dans la console, qui sera affiché comme `[UPnP] (message)`. + +| Message | Signification | +| ------------------------------------- | --------------------------------------- | +| `Port (port) ouvert avec succès` | Redirection de port réussie. | +| `Le port (port) est déjà ouvert` | Un autre service utilise déjà ce port. | +| `Échec de l'ouverture du port (port)` | Échec de la redirection de port. | +| `Le service est indisponible` | Le routeur ne prend pas en charge UPnP. | + +Lorsque le serveur est arrêté, Plazma ferme automatiquement le port. +{% endtab %} + +{% tab title="Créer une adresse temporaire avec Ngrok" %} +La méthode utilisant Ngrok est utile pour des tests temporaires, des jeux en coopération ou jouer avec des amis. + +1. Téléchargez le fichier ZIP `Windows (64-bit)` depuis le site [Ngrok](https://ngrok.com/download). +2. Placez le Ngrok téléchargé dans le dossier du serveur. +3. Sur le [tableau de bord Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), créez un [jeton d'authentification](#user-content-fn-13)[^13]. +4. Exécutez la commande affichée dans la `Ligne de commande` du dossier du serveur. +5. Ajoutez `start /b ngrok tcp --region jp 25565` en haut du script d'exécution, et `taskkill /f /t /im ngrok.exe` en bas. +6. Dans la console, l'adresse `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` devient l'adresse du serveur `0.tcp.jp.ngrok.io:12345`. +7. Vous pouvez maintenant vous connecter depuis l'extérieur via cette adresse. + {% endtab %} + +{% tab title="Connexion locale" %} +Si vous souhaitez vous connecter au serveur en local, exécutez `cmd /k ipconfig` dans la fenêtre d'exécution pour utiliser l'`adresse IPv4` affichée. + +Par exemple, lorsque vous obtenez la sortie suivante après l'exécution de la commande, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +En essayant de vous connecter avec l'adresse IPv4 `192.168.3.7` affichée ici, vous pouvez accéder au serveur en local. + +Si le serveur et le jeu sont exécutés sur le même PC, vous pouvez vous connecter via `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Phase de développement + +Après avoir démarré avec succès le serveur et qu'il fonctionne correctement, il est temps de le personnaliser. + +Découvrez comment personnaliser le serveur en suivant le guide ci-dessous. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Environnement d'exécution Java, environnement d'exécution Java. + +[^2]: Paper, la base de Plazma, est basé sur Spigot, qui est la plateforme officielle du serveur. + +[^3]: Touches Windows + R + +[^4]: Pour Linux, utilisez `java --version` dans le terminal. + +[^5]: JRE est un projet open source avec plusieurs variantes comme les plateformes de serveurs Minecraft. + +[^6]: Il est généralement appelé **launcher**. + +[^7]: Activer l'option "Redémarrage automatique" permet au serveur de redémarrer automatiquement. Vous pouvez arrêter en entrant `Control + C`. + +[^8]: Il n'est pas recommandé de dépasser la moitié de la capacité du système. + + Par exemple, si la capacité totale de mémoire du système est de 8 Go, il n'est pas recommandé de dépasser 4 Go. + +[^9]: Contrat de licence utilisateur final, contrat de licence utilisateur final. Consultez le site [Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) pour plus d'informations. + +[^10]: Microsoft Corporation. + +[^11]: En vertu de l'article 32, paragraphe 1, point 9 de la loi sur la promotion de l'industrie du jeu en Corée, **Korea Microsoft Corporation** peut intenter une action en justice. + +[^12]: Universal Plug & Play. Le Purpur inclus dans Plazma communique automatiquement avec le routeur via cette technologie, ouvrant les ports uniquement lorsque le serveur est en cours d'exécution, donc il n'est pas nécessaire de configurer le transfert de port manuellement. + +[^13]: Si vous n'avez pas de compte, inscrivez-vous sur Ngrok via un compte Google ou GitHub. diff --git a/fr/origin/plazma/adminstration/getting-started/customization.md b/fr/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..7ab95ddcd --- /dev/null +++ b/fr/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Découvrez comment personnaliser le serveur. +--- + +# 🎨 Personnalisation diff --git a/fr/origin/plazma/adminstration/reference/arguments.md b/fr/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..f7407956b --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Découvrez les arguments de démarrage et les propriétés du système. +--- + +# 🎛️ Arguments de démarrage et propriétés + +Les variables de démarrage et les propriétés du système sont des valeurs ajoutées aux [commandes utilisées](#user-content-fn-1)[^1] pour l'exécution de Plazma, permettant de modifier des valeurs qui ne peuvent être modifiées après l'exécution de Plazma. + +Selon l'**emplacement des ajouts aux commandes**,[^2] ils sont divisés en **arguments de démarrage** et **propriétés du système**. + +*** + +## Propriétés du système + +Les propriétés du système sont des valeurs traitées par la JVM avant l'initialisation de Plazma et placées avant `-jar`. + +{% hint style="warning" %} + +### Modifier les propriétés du système peut modifier le fonctionnement de Plazma et de la JVM, et cela peut avoir un impact significatif sur le jeu ! + +Si vous n'êtes pas sûr du rôle de chaque propriété du système, **ne les utilisez jamais !** +{% endhint %} + +### Mode d'emploi + +Les propriétés du système sont ajoutées en tant qu'arguments de commande Java entre `java` et `-jar`. + +Par exemple, pour appliquer la propriété du système `Plazma.dummyProperty`, saisir comme suit ajoutera la valeur `37` à la propriété suivante pour l'initialisation de Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indique que cet argument n'est pas intégré à la JVM mais est un argument personnalisé pour Plazma, + +et si aucune valeur n'est spécifiée, la valeur est fixée à [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Les plateformes serveur de la gamme Paperweight incluent un point `.` dans le nom de la propriété pour distinguer les propriétés du système par plateforme. + +Dans certains terminaux comme Windows Powershell, ces arguments peuvent ne pas être autorisés et doivent être entourés de `"`[.](#user-content-fn-4)[^4] +{% endhint %} + +### Liste complète des propriétés du système + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Met à jour le format des panneaux obsolètes utilisés. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage des informations sur les entités. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la révision NMS pour permettre une récupération correcte des informations de débogage dans l'IDE et remappe automatiquement les informations de version interne. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le système d'alerte Watchdog de Spigot. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le message de confirmation de la commande `/reload`. + +{% hint style="danger" %} + +### La commande `/reload` est très instable, donc toute anomalie survenue après son utilisation relève de la responsabilité de l'utilisateur. + +Si vous êtes un développeur de plugin et devez mettre à jour un plugin, utilisez le hotswap au lieu de la commande `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive les plugins utilisant le système d'entrée/sortie standard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Affiche un avertissement en cas de détection de formatage obsolète dans les composants de chat. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la vérification de motif du serveur lorsqu'un joueur se connecte. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage pour les clés manquantes dans les objets NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage pour les profils de crâne incorrects. + +Cela enregistre tous les blocs de crâne incorrects dans le monde avec leur position. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la limite de 128 canaux de plugin par joueur[^5]. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le système de priorisation des classes de plugin. + +Utile en cas de problème avec les ombres des plugins. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive le système de consolidation des envois Netty. + +#### `Paper.excessiveTELimit` + +- **Type**: `Integer` +- **Valeur par défaut**: `750` + +Divise les entités en paquets multiples pour l'envoi si elles dépassent cette valeur. + +#### `Paper.filterThreshold` + +- **Type**: `Integer` +- **Valeur par défaut**: `8192` + +Définit la taille maximale des paquets que le serveur peut recevoir à la fois. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Désactive la vérification de version de Java. + +{% hint style="danger" %} + +### Cela peut permettre à la JVM d'accéder à du code inexistant ! + +Cela peut entraîner des dommages permanents aux fichiers du monde et causer des dysfonctionnements dans le jeu. + +Tout problème résultant de cette action est de la responsabilité de l'utilisateur, Plamza ne fournissant aucun support à cet égard. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Integer` +- **Valeur par défaut**: `64` + +Définit la limite de caractères pour les noms de canaux de plugin. + +#### `Paper.maxSignLength` + +- **Type**: `Integer` +- **Valeur par défaut**: `80` + +Définit la longueur maximale des lignes des panneaux. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Integer` +- **Valeur par défaut**: `(version du monde) + 1` + +Définit la version des informations de mise à jour du monde à initialiser en premier. + +Utile pour les mises à jour massives de chunks mais rarement utilisé autrement. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Valeur par défaut**: `True` + +Active le traitement des commentaires YAML. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Integer` +- **Valeur par défaut**: `30` + +Expulse un joueur s'il n'a reçu aucune donnée pendant le temps spécifié (en secondes). + +Normalement, le jeu[^7] envoie continuellement des [signaux de battement](#user-content-fn-8)[^8] au serveur, donc le joueur n'est pas expulsé, mais s'il ne reçoit aucune réponse du jeu, il est considéré comme planté et est expulsé. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Ignore les commentaires des propriétés du serveur. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active les journaux de débogage de la création synchrone des chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active le système de création synchrone des chunks de base de Minecraft. + +Cela entraîne un ralentissement considérable car chaque chunk est sauvegardé séquentiellement. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Active le vidage explicite des canaux réseau. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Journalise toujours les erreurs qui ne se produisent pas sur le thread principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Affiche un avertissement en cas de délai excessif des tâches planifiées. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Valeur par défaut**: `False` + +Applique uniquement les correctifs sans démarrer le serveur lorsque vous utilisez le fichier exécutable par défaut. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` + +{% hint style="warning" %} + +### Cette propriété sera déplacée en argument de démarrage après la version 1.20.5. + +{% endhint %} + +Applique une optimisation de configuration plus stricte au démarrage initial. + +L'activation rend le serveur plus rapide et plus sûr, mais peut bloquer certaines fonctionnalités ou avoir un impact majeur sur le jeu. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` + +Supprime l'avertissement[^11] affiché lors de l'initialisation de Plazma. + +### Propriété obsolète + +Les propriétés système ci-dessous sont obsolètes. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Valeur par défaut**: `false` +- **Obsolète**: Depuis la suppression complète de Timings de Plazma + +Détermine si une valeur peut dépasser la limite maximale pouvant être envoyée à l'API Timings d'Aikar. + +Même si cela est fait, si aucune exception n'est gérée dans l'API, une limitation de débit s'applique. + +*** + +## Argument de démarrage + +L'argument de démarrage est saisi après `-jar *.jar` pour initialiser Plazma et est traité conjointement. + +### Mode d'emploi + +Les propriétés système sont saisies en tant qu'arguments de commande de programme après `-jar *.jar`. + +Par exemple, si vous souhaitez appliquer l'argument de démarrage `nogui`,\ +entrez comme suit pour que Plazma traite l'argument `nogui` pendant l'initialisation. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argument de démarrage complet + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valeur par défaut**: `bukkit.yml` + +Définit le nom et l'emplacement du [fichier de configuration Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Valeur par défaut**: `commands.yml` + +Définit le nom et l'emplacement du [fichier de configuration des commandes Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Valeur par défaut**: `server.properties` + +Définit le nom et l'emplacement du fichier de [propriétés du serveur](../reference/configurations/property.md). + +#### `demo` + +Démarre le serveur en mode démo. + +#### `eraseCache` + +Supprime les fichiers de cache restants après la mise à niveau du monde. + +#### `forceUpgrade` + +Met à niveau de force le monde en ignorant la version. [^12] + +#### `help` + +- **Alias**: `?` + +Affiche tous les arguments de démarrage de Plazma et leur description. + +#### `initSettings` + +Crée uniquement les fichiers de configuration et arrête le serveur. + +#### `jfrProfile` + +Active le profilage JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valeur par défaut**: `(propriété du serveur)` + +Définit le nombre maximum de [joueurs](#user-content-fn-14). + +#### `nogui` + +Désactive le panneau d'interface graphique. + +#### `nojline` + +Désactive JLine et utilise la console de base. + +#### `mode en ligne` + +- **Alias**: `o` +- **Valeur par défaut**: `(propriété du serveur)` + +Choisit si les joueurs doivent être vérifiés par le serveur d'authentification Mojang. + +**Si vous n'utilisez pas Velocity ou d'autres proxies, vous risquez des sanctions pour violation de l'[EULA](../getting-started/README.md#id-5).** + +#### `paramètres-paper` + +- **Alias**: `papier` +- **Valeur par défaut**: `paper.yml` + +{% hint style="warning" %} + +### Cet argument n'est plus utilisé après la version 1.19.4 + +{% endhint %} + +Définit l'emplacement des fichiers de configuration PaperSpigot désactivés. + +Il est utilisé pour migrer les anciennes configurations vers de nouveaux fichiers de configuration, mais n'est plus utilisé par la suite. + +#### `répertoire-paramètres-paper` + +- **Alias**: `papier-dir` +- **Valeur par défaut**: `config` + +Définit le nom et l'emplacement du dossier contenant les [fichiers de configuration Paper](../reference/configurations/paper/README.md). + +#### `répertoire-paramètres-plazma` + +- **Alias**: `plazma-dir` + +Définit le nom et l'emplacement du dossier contenant les [fichiers de configuration Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Valeur par défaut**: `plugins` + +Définit l'emplacement du dossier des plugins. + +#### `paramètres-pufferfish` + +- **Alias**: `pufferfish` +- **Valeur par défaut**: `pufferfish.yml` + +Définit le nom et l'emplacement du [fichier de configuration Pufferfish](../reference/configurations/pufferfish.md). + +#### `paramètres-purpur` + +- **Alias**: `purpur` +- **Valeur par défaut**: `purpur.yml` + +Définit le nom et l'emplacement du [fichier de configuration Purpur](../reference/configurations/purpur/README.md). + +#### `mode sécurisé` + +Démarre le serveur en mode totalement vanilla. + +#### `ip-serveur` + +- **Alias**: `h`, `hôte` +- **Valeur par défaut**: `(propriété du serveur)` + +Définit le nom d'hôte du serveur ou l'adresse [protocole Internet](#user-content-fn-13)[^13]. + +#### `port-serveur` + +- **Alias**: `p`, `port` +- **Valeur par défaut**: `(propriété du serveur)` + +Définit le port du serveur. + +#### `nom-serveur` + +- **Valeur par défaut**: `Un serveur Plazma` + +Définit le nom du serveur. + +#### `paramètres-spigot` + +- **Alias**: `S` +- **Valeur par défaut**: `spigot.yml` + +Définit le nom et l'emplacement du [fichier de configuration Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Affiche la version de Plazma. + +#### `répertoire-monde` + +- **Alias**: `W`, `univers`, `conteneur-monde` +- **Valeur par défaut**: `(dossier du serveur)` + +Définit l'emplacement où les fichiers de monde sont stockés. + +#### `nom-monde` + +- **Alias**: `w`, `monde` +- **Valeur par défaut**: `(propriété du serveur)` + +Définit le nom du fichier de monde. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Le traitement des arguments varie en fonction de l'emplacement auquel ils sont ajoutés. + +[^3]: Par exemple, pour activer `Plazma.iKnowWhatIAmDoing` à `true`, il suffit de saisir `-DPlazma.iKnowWhatIAmDoing` au lieu de `-DPlazma.iKnowWhatIAmDoing=true`, cela fonctionnera de la même manière. + +[^4]: Par exemple, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Détecteur d'événements. + +[^6]: Détecteur d'événements. + +[^7]: Client. + +[^8]: Signal indiquant une connexion réussie au serveur, similaire aux battements de cœur. + +[^9]: Avec la fonction d'expulsion AFK de Purpur, même les joueurs absents peuvent être expulsés. + +[^10]: Système d'écriture de chunk synchronisé, Sync Chunk Write System. + +[^11]: `ATTENTION! Plazma peut causer des problèmes inattendus, assurez-vous de bien le tester avant de l'utiliser sur un serveur public.` + +[^12]: La `optimisation du monde` fonctionne sur le même principe en jeu. + +[^13]: Protocole Internet, IP. + +[^14]: Les administrateurs de `niveau 2` ou supérieur sont exclus. diff --git a/fr/origin/plazma/adminstration/reference/commands.md b/fr/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..582c4c942 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Découvrez les commandes disponibles sur Plazma. +--- + +# 🖥️ Commandes diff --git a/fr/origin/plazma/adminstration/reference/configurations/bukkit.md b/fr/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..2a2937a85 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de bukkit.yml signifie. +--- + +# 🪣 Bukkit diff --git a/fr/origin/plazma/adminstration/reference/configurations/paper/README.md b/fr/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..3301fda92 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez l'objectif de chaque fichier dans le dossier config. +--- + +# 🛩️ Papier diff --git a/fr/origin/plazma/adminstration/reference/configurations/paper/global.md b/fr/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..56a4191f3 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de paper-global.yml signifie. +--- + +# 🛩️ Paper (Configuration globale) diff --git a/fr/origin/plazma/adminstration/reference/configurations/paper/world.md b/fr/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..7ecfbbd9e --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de paper-world.yml signifie. +--- + +# 🛩️ Papier (Composition des mondes) diff --git a/fr/origin/plazma/adminstration/reference/configurations/plazma/README.md b/fr/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..97f989fab --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez l'objectif de chaque fichier dans le dossier config. +--- + +# ✨ Plazma diff --git a/fr/origin/plazma/adminstration/reference/configurations/plazma/global.md b/fr/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..6ea4b5c64 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de plazma-global.yml signifie. +--- + +# ✨ Plazma (Configuration globale) diff --git a/fr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/fr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..2aa63011d --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Mondial Composition diff --git a/fr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/fr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d0543db46 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud dans plazma-world.yml signifie. +--- + +# ✨ Plazma (Composition du monde) diff --git a/fr/origin/plazma/adminstration/reference/configurations/property.md b/fr/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..784ffab5c --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de server.properties signifie. +--- + +# 🪨 Server.properties diff --git a/fr/origin/plazma/adminstration/reference/configurations/pufferfish.md b/fr/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..4a9c1ba8e --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud dans pufferfish.yml signifie. +--- + +# 🐡 Poisson-globe diff --git a/fr/origin/plazma/adminstration/reference/configurations/purpur/README.md b/fr/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..aeceb37df --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de purpur.yml signifie. +--- + +# 🦑 Purpur diff --git a/fr/origin/plazma/adminstration/reference/configurations/purpur/global.md b/fr/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..234aa6528 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de purpur.yml signifie. +--- + +# 🦑 Pourpre (composition globale) diff --git a/fr/origin/plazma/adminstration/reference/configurations/purpur/world.md b/fr/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..838329254 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de purpur.yml signifie. +--- + +# 🦑 Poulpe (Composition mondiale) diff --git a/fr/origin/plazma/adminstration/reference/configurations/spigot.md b/fr/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..b14545005 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Découvrez ce que chaque nœud de spigot.yml signifie. +--- + +# 🚰 Spigot diff --git a/fr/origin/plazma/adminstration/reference/permissions.md b/fr/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..bd67fbae8 --- /dev/null +++ b/fr/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Découvrez les autorisations de Plazma. +--- + +# 🛡️ Autorisations diff --git a/fr/origin/plazma/developers.md b/fr/origin/plazma/developers.md new file mode 100644 index 000000000..07aaeee2f --- /dev/null +++ b/fr/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Développez des projets tiers en utilisant Plazma. +--- + +# ⚙️ Guide du développeur diff --git a/fr/origin/thunderbolt/README.md b/fr/origin/thunderbolt/README.md new file mode 100644 index 000000000..b7d57c3ed --- /dev/null +++ b/fr/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 패치를 Flavor로 구분하여 직접 사용해볼 수 있도록 하는 Plazma 기반 서버 플랫폼입니다. +--- + +# 🌩️ Guide d'utilisation de Thunderbolt diff --git a/fr/origin/volt/README.md b/fr/origin/volt/README.md new file mode 100644 index 000000000..2db5ecba6 --- /dev/null +++ b/fr/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Plateforme de serveur Paperweight를 개발할 수 있는 오픈 소스 템플릿입니다. +--- + +# ⚡ Guide de développement de Volt diff --git a/he/origin/README.md b/he/origin/README.md new file mode 100644 index 000000000..d4753c2c7 --- /dev/null +++ b/he/origin/README.md @@ -0,0 +1,41 @@ +--- +description: אם יש לך שאלות, אנא שאל ב-Discord או בדיונים של GitHub. +--- + +# 🏠 ברוכים הבאים לפורטל המסמכים + +{% hint style="info" %} + +**מסמך Plazma כרגע מתורגם באופן אוטומטי.** + +[![מצב תרגום](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) בעזרת התרגום שלי השתתפו בתרגום המסמך כדי לשפר את המסמך. + +{% endhint %} + +### אם יש בעיה בשימוש ב-Plazma, מה לעשות? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### יש לך עניין ב-Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### רוצה ליצור פלטפורמת שרת משלך בעזרת Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `ספונסור` צריך עוד מידע קשור ל-Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/he/origin/SUMMARY.md b/he/origin/SUMMARY.md new file mode 100644 index 000000000..63e48737d --- /dev/null +++ b/he/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# סיכום התוכן + +- [🏠 ברוך הבא לפורטל המסמכים](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ מדריך שימוש ב-Plazma](plazma/README.md) +- [❓ מה זה Plazma?](plazma/about/README.md) + - [⬇️ הורדה](plazma/about/downloads.md) + - [✅ מצב תמיכת גרסאות](plazma/about/supported-versions.md) +- [מדריך ניהול שרתים ⚒️](plazma/administration/README.md) + - [התחלה 👟](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [מקורות 📜](plazma/administration/reference/README.md) + - [פקודות 🖥️](plazma/administration/reference/commands.md) + - [הרשאות 🛡️](plazma/administration/reference/permissions.md) + - [ארגומנטים ומאפיינים 🎛️](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 תכונה](plazma/administration/reference/configurations/property.md) + - [בוקיט 🪣](plazma/administration/reference/configurations/bukkit.md) + - [ספיגוט 🚰](plazma/administration/reference/configurations/spigot.md) + - [פייפר 🛩️](plazma/administration/reference/configurations/paper/README.md) + - [הגדרות גלובליות 🌏](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ הגדרת עולם](plazma/administration/reference/configurations/paper/world.md) + - [פופרפיש 🐡](plazma/administration/reference/configurations/pufferfish.md) + - [פורפור 🦑](plazma/administration/reference/configurations/purpur/README.md) + - [הגדרות גלובליות 🌏](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ הגדרת עולם](plazma/administration/reference/configurations/purpur/world.md) + - [פלזמה ✨](plazma/administration/reference/configurations/plazma/README.md) + - [הגדרות גלובליות 🌏](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ הגדרת עולם](plazma/administration/reference/configurations/plazma/world.md) + - [מומחה 🎓](plazma/administration/expert/README.md) + - [אופטימיזציה 🧹](plazma/administration/expert/optimize.md) + - [🔀 פרוקסי](plazma/administration/expert/proxy.md) + - [החזר לוונילה ↩️](plazma/administration/expert/vanillaize.md) + - [🩻 חסימת X-Ray](plazma/administration/expert/xray.md) + - [פתיחת חולשות ותיקונם ⚠️](plazma/administration/expert/fix-exploits.md) + - [שאלות נפוצות ⁉️](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ מדריך למפתחים](plazma/developers.md) + - [✏️ תרומה](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ מדריך שימוש ב-Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ מדריך פיתוח ל-Volt](volt/README.md) + +## שונות + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [הורדת כל הקבצים ⬇️](plazma/about/downloads-all.md) diff --git a/he/origin/miscellaneous/README.md b/he/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/he/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/he/origin/plazma/README.md b/he/origin/plazma/README.md new file mode 100644 index 000000000..fa25d6501 --- /dev/null +++ b/he/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "פלזמה היא פלטפורמת שרת קוד פתוח ל-Minecraft: Java Edition שמשתמשת ביישום ניסיוני מבוסס נייר ותכני משחק מותאמים אישית מרובים." +--- + +# ✨ מסמכי השימוש בפלזמה + +## 👋 ברוך הבא למסמכי פלזמה + +ברוכים הבאים למדריך השימוש בפלזמה! + +{% hint style="info" %} + +**האם אי אפשר לפתור את הבעיה דרך המדריך?** + +[שרת Discord רשמי](https://discord.gg/MmfC52K8A8) או [דיונים ב-GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - נסה לשאול שאלות בקהילה דרך זה! + +{% endhint %} + +### על Plazma + +> גלו מהו פלזמה כפלטפורמת שרת. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### למנהלים + +> השתמשו בפלזמה כדי ליצור שרת משלכם. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### למפתחים + +> השתמשו בפלזמה כדי לפתח פרויקטים של צד שלישי. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/he/origin/plazma/about/README.md b/he/origin/plazma/about/README.md new file mode 100644 index 000000000..d0d64769b --- /dev/null +++ b/he/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: גלו מהו פלזמה כפלטפורמת שרת. +--- + +# ❓ מה זה Plazma? + +- **Plazma** היא פלטפורמת שרתים בסיסית על בסיס [Paper](https://github.com/PaperMC/Paper) שלוקחת רק את היתרונות מ [Andromeda](https://github.com/EarendelArchived/Andromeda) ו-[Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- אנו עושים מאמץ לספק יציבות גבוהה וביצועים חזקים תמיד, עדכונים מהירים ותכונות נרחבות. + +## 📋 מטרת Plazma + +- אנו עושים מאמץ להיות פלטפורמת שרתים עם עדכונים מהירים ויציבות גבוהה. +- אנו עושים מאמץ לספק תכונות נרחבות וביצועים חזקים כמו בפלטפורמת מודים. +- אנו עושים מאמץ ליצירת פלטפורמת חופשית שניתן להתאים אישית את תיקוני הואנילה. + +## ⚙️ תכונות מרכזיות + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **עדכונים מהירים ביותר**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) מאפשר לשמור תמיד על תיקוני הפלטפורמה עדכניים, מספק עדכונים מהירים ביותר בין כל פלטפורמות השרת המבוססות על Paper. +6. **אופטימיזציה של קבצי התצורה הבסיסיים**\ + הגדרות התצורה שמופעלות באופן ברירת המחדל מותאמות לביצועים מיטביים, ולא נדרשת אופטימיזציה ידנית של קבצי התצורה. +7. **פעולת מרוץ מרובת תהליכים מאורגנת**\ + מסננת תהליכי מערכת אסינכרוניים ללא קשר למכניקה של המשחק כדי להפחית את [זמן האיחוד](#user-content-fn-4)[^4] ולאופטימיזציה של השרת. +8. **חסימת שימוש במרחב לא נחוץ**\ + מקפיאה נתונים עם ערכים דומים לערך אחד כדי להפחית את שימוש הזיכרון. + +## ✨ דוגמאות לשימוש + +- **פלטפורמה המטפלת גם בתוספות מורכבות**\ + השרת של [IPECTER](https://github.com/IPECTER) משתמש ב-Plazma.\ + תוספים משלו המתפקדים ב-NMS וברפלקשיין, ועשויים ממאגרי נתונים גדולים ומורכבים,\ + ועדיין מסוגל לקבל מעל 100 שחקנים ללא ירידה בביצועים. +- **פלטפורמה ששומרת על ביצועים מהירים גם בשרתי RPG**\ + הפלטפורמה ששמרה על 100 שחקנים ב-TPS יציב ללא ירידה,\ + וב-4 קלאסטרים הצליחה לאכוף משחק נעים ל-250 שחקנים ביחד. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **פלטפורמה שנבחרה על ידי הרבה סטרימרים**\ + היא משמשת כסל בו נבחר על ידי המסתטרים הרבים ומשמשת להשתתפות הצופים שלהם. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ הורדה + +ניתן להוריד את Plazma מהדף הבא. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### רוצים לקבל מידע מפורט על תמיכת גרסאות? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot תוספים וגם Paper, Pufferfish, Purpur תוספים. + +[^2]: נמענה Microsoft Corporation. + +[^3]: השבתת מערכת הדיווחים בצ'אט תוביל לעיבוד הצ'אט רק בשרת מבלי לאפשר ל-Mojang לעקוב אחריו. + +[^4]: זמן עצירת המשחק לכמה רגעים כדי שהמערכת תוכל לפעול. diff --git a/he/origin/plazma/about/downloads-all.md b/he/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..6d156b2d9 --- /dev/null +++ b/he/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: הורדת קובץ ההרצה של Plazma - צפיה מלאה +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| גרסה | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/he/origin/plazma/about/downloads.md b/he/origin/plazma/about/downloads.md new file mode 100644 index 000000000..0f834caea --- /dev/null +++ b/he/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: הורד את Plazma עכשיו ונסה להשתמש בו ישירות. +--- + +# ⬇️ הורדה + +#### רוצים לקבל מידע מפורט על תמיכת גרסאות? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**ההורדה לקובץ הנפתח היא קובץ הרצה למשתמש הרגיל.** + +אם אתה מפתח ואתה זקוק לסוג אחר של קובץ, עיין בדף הבא. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
גרסההורדה
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + הורדה +
1.20.1 + הורדה +
1.19.4 + הורדה +
+ +*** diff --git a/he/origin/plazma/about/patches-list.md b/he/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..630bcdf84 --- /dev/null +++ b/he/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: גלה את כל התכונות שנוספו ל-Plazma. +--- + +# 📑 תיקולים כלולים diff --git a/he/origin/plazma/about/supported-versions.md b/he/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..2c8770afa --- /dev/null +++ b/he/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "גלה את הגרסה של Minecraft: Java Edition שתומך ב-Plazma." +--- + +# ✅ מצב תמיכת גרסה + +{% hint style="info" %} + +**Plazma נפתח מאז 1.19.4 והלאה, גרסאות של 1.19.4 ומתחת אינן פותחות.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: https://badge.plazmamc.org/1/בפיתוח +[atv]: https://badge.plazmamc.org/2/תמיכה +[fse]: https://badge.plazmamc.org/6/תמיכה%20בפונקציות%20מופסקת +[eol]: https://badge.plazmamc.org/4/סיום%20תמיכה +[ukn]: https://badge.plazmamc.org/0/אין%20מידע +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/רגיל +[100]: https://badge.plazmamc.org/percent/100 + +![ממתין לשחרור][wtr] ![בפיתוח][idv] ![תמיכה][atv] ![תמיכה בפונקציות מופסקת][fse] ![סיום תמיכה][eol] + +| גרסה | איכות ותמיכה בפונקציונליות | מצב בנייה | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![מצב בנייה](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![מצב בנייה](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![מצב בנייה](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/he/origin/plazma/administration/README.md b/he/origin/plazma/administration/README.md new file mode 100644 index 000000000..ca8e3ff61 --- /dev/null +++ b/he/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: השתמשו בפלזמה כדי ליצור שרת משלכם. +--- + +# מדריך לניהול שרת ⚒️ diff --git a/he/origin/plazma/administration/diagnosis/README.md b/he/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..3862dbb5b --- /dev/null +++ b/he/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: למצוא דרך להתמודד כאשר מתעוררת בעיה. +--- + +# 🧾 진단 diff --git a/he/origin/plazma/administration/diagnosis/plugins.md b/he/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..d62a814c2 --- /dev/null +++ b/he/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: לגלות כיצד לפתור את הבעיה כאשר התוסף אינו פועל כראוי. +--- + +# 📜 플러그인 diff --git a/he/origin/plazma/administration/expert/README.md b/he/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..a8d014d2a --- /dev/null +++ b/he/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: למדו כיצד לעסוק ב-Plazma בצורה מקצועית. +--- + +# 🎓 עמוק diff --git a/he/origin/plazma/administration/expert/fix-exploits.md b/he/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..174e18824 --- /dev/null +++ b/he/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: גלו על נקודות החולשה הידועות וכיצד לטפל בהן. +--- + +# ⚠️ נקודות חולשה ידועות וכיצד לטפל בהן diff --git a/he/origin/plazma/administration/expert/optimize.md b/he/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..8e42da366 --- /dev/null +++ b/he/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: גלו כיצד לאופטימז את Plazma. +--- + +# 🧹 אופטימיזציה diff --git a/he/origin/plazma/administration/expert/proxy.md b/he/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..b3a6d3b38 --- /dev/null +++ b/he/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: לגלות כיצד להגן על פלטפורמת הפרוקסי 'Velocity' בצורה בטוחה. +--- + +# 🔀 פרוקסי diff --git a/he/origin/plazma/administration/expert/vanillaize.md b/he/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..d8a41874d --- /dev/null +++ b/he/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: למדו כיצד לשחזר את תיקון הנייר והונילה. +--- + +# ↩️ המרת להיות כמו הונילה + +{% hint style="warning" %} + +**Paperאינו מוסיף אפשרות לרוב התיקונים של השגיאה של ונילה.** + +Plazma כרגע מפתחת אפשרות להשבתת תיקוני שגיאות כאלה. + +לכן, המדריך עדיין בתהליך כתיבה והמידע עשוי להשתנות בכל עת. + +{% endhint %} diff --git a/he/origin/plazma/administration/expert/xray.md b/he/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..d46b2f21e --- /dev/null +++ b/he/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: גלו על דרכים מוטבעות שונות לחסום את ה-X-Ray. +--- + +# 🩻 חסימת X-Ray diff --git a/he/origin/plazma/administration/faq.md b/he/origin/plazma/administration/faq.md new file mode 100644 index 000000000..5cb8f526d --- /dev/null +++ b/he/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: למענה על שאלות נפוצות, בדוק כאן. +--- + +# ⁉️ שאלות נפוצות + +{% hint style="info" %} + +**לא מוצאים את התשובה שחיפשתם?** + +[שרת Discord רשמי](https://discord.gg/MmfC52K8A8) או [דיונים ב-GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - נסה לשאול שאלות בקהילה דרך זה! + +{% endhint %} + +### Plazma לא מתחיל + +אם מופיע בקונסולה `no main manifest attribute, in plazma-(version).jar`,\ +אז הקובץ שהורדתם הוא קובץ API לצורכי פיתוח, עליכם להוריד את **Reobf Paperweight** מעמוד ה-GitHub. + +למידע נוסף, ראו את הדף הבא. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### אזהרה מופיעה בכל פעם שהשרת מתחיל לרוץ + +Plazma מכיל תיקונים לא יציבים חלקים ולכן יש תמיד סיכוי לתקלות, על כן השרת מדפיס אזהרות כאלו בזמן הפעלתו. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +ניתן להשבית את ההודעות האלו באמצעות השימוש במאפיין המערכת [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +למידע נוסף, ראו את הדף הבא. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: זמין מגרסה 1.20.1 ומעלה diff --git a/he/origin/plazma/administration/getting-started/README.md b/he/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..126154241 --- /dev/null +++ b/he/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: למדו כיצד ליצור שרת באמצעות Plazma. +--- + +# 👟 התחלה + +כדי להשתמש ב-Plazma באופן יציב, המערכת צריכה לעמוד בדרישות הבאות: + +| | מינימום | מומלץ | +| :--------: | ------- | ----- | +| ארכיטקטורה | x64 | - | +| RAM | 8GB | 16GB | +| שטח אחסון | 1GB | 8GB | +| JDK | 17 | 21 | + +כדי לערוך קבצי תצורה בצורה חלקה, כדאי להתקין עורך כגון [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="הפלט הנכון" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +סביבת הרצה OpenJDK Zulu21.32+17-CA (בנייה 21.0.2+13-LTS) +OpenJDK 64-Bit שרת VM Zulu21.32+17-CA (בנייה 21.0.2+13-LTS, מצב מעורב, שיתוף) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' הוא פקודה פנימית או חיצונית, תוכנית הניתנת לביצוע, או +קובץ batch אינו זמין. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +אפשרות לא מוכרת: --version +שגיאה: לא ניתן היה ליצור את מכונת ה-Java הווירטואלית. +שגיאה: שגיאה חמורה אירעה. התוכנית תיצא. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. התחל על ידי הורדת **JDK 21** בפורמט `.msi` מ-[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. הרץ את אשף ההתקנה שהורדת ולחץ על 'הבא'. +3. בתפריט המוצג במרכז השמאלי של החלון, הפעל את 'Set JAVA_HOME variable' ולאחר מכן לחץ על 'הבא'. +4. לחץ על 'התקן' כדי להשלים את התהליך של התקנת JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + מופת Mojang, מפת Minecraft הוונילית. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows תצורת IP + +מתאם Ethernet Ethernet: + + סיומת DNS מחוברת. . . . : + כתובת IPv4. . . . . . . . . : 192.168.3.7 + מסכת תת-רשת . . . . . . . : 255.255.255.0 + שער ברירת מחדל . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. להתפתח + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +קרא את המדריך הבא כדי ללמוד כיצד להתאים אישית את השרת. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: חברת מיקרוסופט. + +[^11]: במקרה של קוריאה, ניתן להגיש תביעה משפטית מצד **חברת מיקרוסופט של קוריאה** על פי סעיף 9, סעיף 1, סעיף 32 של חוק הקידום התעשייתי של תעשיית המשחקים בקוריאה. + +[^12]: כניסה ויציאה אוניברסלית. פורפור הכלול בפלאזמה מתקשר אוטומטית עם הראוטר דרך טכנולוגיה זו ומאפשר פתיחת פורטים רק כאשר השרת פועל, ולכן אין צורך לבצע הפניה ישירה של פורטים. + +[^13]: במקרה שאין לך חשבון, נרשמים ל-Ngrok דרך חשבון Google או GitHub. diff --git a/he/origin/plazma/administration/getting-started/customization.md b/he/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..733e93654 --- /dev/null +++ b/he/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,116 @@ +--- +description: ללמוד כיצד להתאים אישית את השרת. +--- + +# 🎨 התאמה אישית + +הסיבה לשימוש בפלטפורמת השרת המותאמת כמו Plazma במקום בפלטפורמת השרת הרשמית שסופקה על ידי Mojang Studios היא היכולת החזקה להתאמה אישית שהיא מציעה. + +להלן מספר דרכים להתאמה אישית ושימוש ב-Plazma. + +## שינויי ההגדרות + +הדרך הבסיסית ביותר להתאמה אישית של Plazma היא לשנות את ההגדרות. + +Plazma מספקת הגדרות חזקות למשחק, כולל מנגנונים ותכונות של יצורים. + +למידע נוסף על ההגדרות של Plazma ראה את הדף הבא. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## שימוש בתוספים + +{% hint style="success" %} + +**Plazma תומך בכל התוספים המבוססים על נייר.** + +במקרה של תוסף Spigot, עקב שינויי המיפוי של Paper מגרסה 1.20.5, יתכן שחלקם לא יפעלו, אך רוב התוספים המבוססים על Paper כגון Paper, Pufferfish ו-Purpur יפעלו ב-Plazma, ואם הם לא פועלים כראוי זה תקלה ב-Plazma ויש לדווח [מיידית.](../diagnosis/plugins.md) + +{% endhint %} + +זהו הסיבה העיקרית לשימוש ב-Plazma והדרך החזקה ביותר להתאמה אישית של Plazma. +האקוסיסטם החזק של Plazma מאפשר לשרת להתאמה אישית בקלות. + +ישנם מספר דרכים למציאת והורדת תוספים. קיימות מספר שיטות להורדת התוספים, כמה מתקיים בשירותי מאגרים פומביים וכמה עלולים להעלות את התוספים ל-GitHub או לאתרים משלהם. + +{% hint style="caution" %} + +**תוסף יכול לגשת למערכת ישירות!** + +נא לוודא את ביטחונך תמיד לפני שמתקין תוסף, על ידי שימוש בשירותים כמו VirusTotal או הורדת התוסף משירותים אמינים. + +{% endhint %} + +ישנם מספר שירותים להורדת התוספים. ביניהם, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) ועוד, שירותים אלו עוברים תהליך שיקול והעלאת התוספים לפני שהם מוצעים להורדה, כך שרק התוספים הבטוחים מוצעים לשימוש. + +### התקנת תוסף + +לאחר הורדת התוסף, כעת תהיה ההזדמנות להתקין את התוסף. + +1. התוסף מורכב מקובץ `.jar` או `Java Executable File`.\ + חלק מהתוספים מגיעים בתוך קובץ דחיסה, ובמקרים כאלו + יש לפתוח את הדחיסה ולחפש אחר קובץ המכיל את `bukkit`, `spigot` או `paper` בשמו, ובמידה ויש קובץ המכיל `fat` יש להשתמש בקובץ זה. +2. יש להעביר את הקובץ שהורדת לתיקיית `plugins` שבתיקיית השרת ולאחר מכן לאתחל את השרת. +3. בהתחלת Plazma, יוצג תוכן חדש בקונסולה. + זה מעיד על טעינה תקינה של התוספים על ידי Plazma. +4. אף אם Plazma טענה את התוספים בצורה תקינה, יתכן שהם לא הופעלו. + ניתן לקרוא את רשימת התוספים שטענו על ידי השרת באמצעות הפקודה `/plugins`. + אם שמות התוספים שהותקנו אינם בצבע אדום + אלא בצבע ירוק, זה אומר שהתוספים נטענו בהצלחה. + +אם התוספים לא נטענו בהצלחה, ניתן למצוא פתרונות בדף הבא. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## שימוש בחבילת מידע + +חבילת המידע היא אמצעי התאמה אישית במיינקראפט, דומה לחבילות משאבים. + +באמצעות חבילת מידע ניתן להוסיף קבוצות חייקים חדשות ואתגרים למשחק ולשנות חלקים במשחק. + +{% hint style="caution" %} + +**חבילת המידע עשויה לפגוע בעולם!** + +חלק מחבילות המידע הקרוחות עשויות לפגוע בעולם ולא ניתן לשחזר את הנזק. + +לכן, מומלץ לגבות את העולם לפני החלפת חבילת המידע. + +{% endhint %} + +ניתן להוריד חבילות מידע ממספר שירותים כגון [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) ועוד. + +לאחר הורדת חבילת המידע, ניתן להכניס אותה לתיקיית `datapacks` בתיקיית העולם של השרת. +במקרה שאין תיקייה זו, ניתן ליצור אותה ולהוסיף את החבילה. + +{% hint style="warning" %} + +**לחלק [חבילות המידע](#user-content-fn-2) ייתכן שלא תתקבל התקנה תקינה בפעם הראשונה.** + +למקרים כאלה מומלץ לאתחל את השרת **2 פעמים**. + +{% endhint %} + +חבילות המידע עשויות להיפגע בכל עדכון של Minecraft. + +במיוחד, במקרה שהחבילה נפגעה לחלוטין, יש לבצע בדיקות מספיקות לפני העדכון כדי למנוע התנגשות בשרת. + +{% hint style="info" %} + +**ניתן להפעיל את השרת עם `safeMode` אחרי הפקודת ההפעלה כדי להשבית את כל חבילות המידע.** + +[לפרטים נוספים ראו `רפרנס > ארגומנטים ומאפיינים`.](../reference/arguments.md) + +{% endhint %} + +ניתן לוודא את רשימת חבילות המידע שהופעלו בשרת על ידי הפקודה `/datapack list`. + +*** + +[^1]: או על ידי Minecraft: Bedrock Edition's add-ons. + +[^2]: הוספת קבוצות חייקים ועוד. diff --git a/he/origin/plazma/administration/getting-started/next-step.md b/he/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..b7be9cd6a --- /dev/null +++ b/he/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: ללמוד כיצד להתאים אישית את השרת. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +להלן מספר דרכים להתאמה אישית ושימוש ב-Plazma. + +## שינויי ההגדרות + +הדרך הבסיסית ביותר להתאמה אישית של Plazma היא לשנות את ההגדרות. + +Plazma מספקת הגדרות חזקות למשחק, כולל מנגנונים ותכונות של יצורים. + +למידע נוסף על ההגדרות של Plazma ראה את הדף הבא. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## שימוש בתוספים + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +זהו הסיבה העיקרית לשימוש ב-Plazma והדרך החזקה ביותר להתאמה אישית של Plazma. האקוסיסטם החזק של Plazma מאפשר לשרת להתאמה אישית בקלות. + +ישנם מספר דרכים למציאת והורדת תוספים. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +ישנם מספר שירותים להורדת התוספים. ביניהם, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) ועוד, שירותים אלו עוברים תהליך שיקול והעלאת התוספים לפני שהם מוצעים להורדה, כך שרק התוספים הבטוחים מוצעים לשימוש. + +### התקנת תוסף + +לאחר הורדת התוסף, כעת תהיה ההזדמנות להתקין את התוסף. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. יש להעביר את הקובץ שהורדת לתיקיית `plugins` שבתיקיית השרת ולאחר מכן לאתחל את השרת. +3. בהתחלת Plazma, יוצג תוכן חדש בקונסולה. זה מעיד על טעינה תקינה של התוספים על ידי Plazma. +4. אף אם Plazma טענה את התוספים בצורה תקינה, יתכן שהם לא הופעלו. ניתן לקרוא את רשימת התוספים שטענו על ידי השרת באמצעות הפקודה `/plugins`. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +אם התוספים לא נטענו בהצלחה, ניתן למצוא פתרונות בדף הבא. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## שימוש בחבילת מידע + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +באמצעות חבילת מידע ניתן להוסיף קבוצות חייקים חדשות ואתגרים למשחק ולשנות חלקים במשחק. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +חלק מחבילות המידע הקרוחות עשויות לפגוע בעולם ולא ניתן לשחזר את הנזק. + +לכן, מומלץ לגבות את העולם לפני החלפת חבילת המידע. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +לאחר הורדת חבילת המידע, ניתן להכניס אותה לתיקיית `datapacks` בתיקיית העולם של השרת. במקרה שאין תיקייה זו, ניתן ליצור אותה ולהוסיף את החבילה. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +למקרים כאלה מומלץ לאתחל את השרת **2 פעמים**. +{% endhint %} + +חבילות המידע עשויות להיפגע בכל עדכון של Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +ניתן לוודא את רשימת חבילות המידע שהופעלו בשרת על ידי הפקודה `/datapack list`. + +*** + +## אופטימיזציה + +ב-Plazma יש הרבה תיקוני אופטימיזציה שהתקבלו. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## פרוקסי + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +למידע בטוח ונכון על הגדרות פרוקסי ראה את העמוד הבא. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## בטיחות + +Minecraft משתמשת במודים שפותחו ולכן ניתן למצוא בקלות במציאות הוירטואלית [מנועי התקפה](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### הגדרת הרשאות + +פקודות מנהל של חלק מהתוספים יכולות להיות חסרות הרשאות נכונות. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### חסימת X-Ray + +X-Ray הוא אחד ממנועי התקפה המופצים בקלות בתוך לקוחות אופטימיזציה בסיסיים. + +Plazma מציעה תצורה שמאפשרת לחסום בקלות את X-Ray. + +למידע נוסף על אופן חסימת X-Ray ראה את העמוד הבא. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### רשימה לבנה + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +כדי לראות אילו שחקנים זכאים לגישה, ניתן להשתמש ב-`/whitelist query`. + +*** + +[^1]: או על ידי Minecraft: Bedrock Edition's add-ons. + +[^2]: הוספת קבוצות חייקים ועוד. + +[^3]: בדרך כלל נקראים "האקרים". + +[^4]: במקרים שבהם התצורה לא מותאמת, או ש-Plazma ישנה או יש חדשות במנועי התקפה, ייתכן שהם לא חסומים. + +[^5]: כאשר שחקן נכנס לשרת, הוא נכנס דרך שרת פרוקסי Ngrok, וכל פעם שהשרת מתאתחל ניתן לקבל כתובת Ngrok שונה. diff --git a/he/origin/plazma/administration/reference/README.md b/he/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..89e485d25 --- /dev/null +++ b/he/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: גלו כיצד להתאים אישית את Plazma המובנה. +--- + +# 📜 리퍼런스 + +Plazma מציעה מספר שיטות להתאמה אישית. + +מתוך אלו, ישנן 4 שיטות שניתן להשתמש בהן מיידית ללא צורך בפעולות נוספות. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[שרת Discord רשמי](https://discord.gg/MmfC52K8A8) או [דיונים ב-GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - נסה לשאול שאלות בקהילה דרך זה! +{% endhint %} + +*** + +## 🖥️ פקודות + +> פקודות מאפשרות לאסוף מידע בתוך המשחק או להתאים אישית את סביבת המשחק. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ הרשאות + +> הרשאות קובעות את הטווח שבו השחקן יכול להתקשר. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ פרמטרים ותכונות + +> פרמטרים ותכונות משפיעים על פעולתו של Plazma באופן כללי. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 תצורה + +> תצורה היא הדרך הבסיסית ביותר להתאמה אישית של Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/he/origin/plazma/administration/reference/arguments.md b/he/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..a4bbb1f6d --- /dev/null +++ b/he/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: למדו על ארגומנטי ההתחלה והמאפיינים של המערכת. +--- + +# 🎛️ ארגומנטים ומאפיינים + +הפרמטרים ההתחלתיים והתכונות של המערכת הם ערכים המוסיפים לפעולת ההרצה של Plazma, ומשפיעים באופן כללי על פעולתה של Plazma. + +[מיקום שנוסף לפקודה](#user-content-fn-2)[^2] יחלק את זה ל**פרמטרי התחלה** ו**מאפייני המערכת**. + +*** + +## מאפייני המערכת + +מאפייני המערכת מתווספים לפני ה `-jar` ומעוברים על ידי הJVM לפני שPlazma מאתחלת. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### שימוש + +מאפייני המערכת מתווספים כארגומנטי פקודה בין `java` ל `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +ה `-D` מציין שהארגומנט הזה הוסף לPlazma ולא מובנה בJVM, + +אם לא הוזן שום ערך למאפיינים, הערך ייקבע ל־[`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### מאפייני מערכת מלאים + +#### `convertLegacySigns` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מעדכן את הפורמט של לוחות השיט. + +#### `debug.entities` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל ייחודי לנתונים הקשורים ליחידות. + +#### `debug.rewriteForIDE` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את הNMS revision כדי לאפשר לIDE לקרוא נכון את המידע,\ +ומפעיל אוטומטית מיפוי מחדש של מידע פנימי. + +#### `disable.watchdog` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את מערכת האזהרות של Watchdog ב־Spigot. + +#### `letMeReload` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את ההודעה לאימות מחדש של פקודת `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +אם אתה מפתח תוסף וצריך לעדכן, השתמש בהחלפה חמה במקום `/reload`. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את מערכת קדימות המחלקות בתוספים. + +שימושי כאשר יש בעיות בשדרוג תוסף. + +#### `Paper.disableFlushConsolidate` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את מערכת האיחוד של Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **ערך ברירת מחדל**: `750` + +אם יש יותר ישויות מהערך המוגדר, הם ייחלקו לחבילות לשליחה. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **ערך ברירת מחדל**: `8192` + +מגדיר את גודל החבילה המקסימלית שהשרת יכול לקבל בפעם אחת. + +#### `Paper.ignoreJavaVersion` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את בדיקת גרסת ה-Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +כך ייתכן שהקבצים בעולם ייפגעו בצורה קבועה והמערכת כולה של המשחק תיפגע. + +כל בעיה שתתרחש עקב השימוש בזה תהיה באחריותך בלבד, וPlamza לא תסייע בכך. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **ערך ברירת מחדל**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **ערך ברירת מחדל**: `80` + +מגביל את אורך הטקסט המרבי שניתן להכניס בלוח שלט. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **ערך ברירת מחדל**: `(גרסת העולם) + 1` + +מגדיר את גרסת העולם הראשונית שיש לאתחל את המידע לעדכון. + +שימושי במקרים שבהם יש צורך לעדכן כמות גדולה של חתיכות, אך לא במקרים אחרים. + +#### `Paper.parseYamlCommentsByDefault` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `True` + +מפעיל עיבוד של ההערות בקובץ YAML. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **ערך ברירת מחדל**: `30` + +כאשר לא קיבלנו נתונים מהשחקן (בשניות), נבעיר את השחקן. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מתעלם מהערות במאפייני השרת. + +#### `Paper.debug-sync-loads` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל יומן דיבאג ליצירת צ'אנקים סינכרוניים. + +#### `Paper.enable-sync-chunk-writes` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל את [מערכת כתיבת הצ'אנקים הבסיסית](#user-content-fn-10) של Minecraft. + +זה גורם לשמירה סדרתית של כל צ'אנק, מה שגורם להפרעה חמורה בביצועים. + +#### `Paper.explicit-flush` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל פלישינג מפורש בערוץ הרשת. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `false` + +מבטל את סימון המותג של Plazma ומשתמש בסמל ברירת מחדל של השרת. + +#### `Plazma.useVanillaConfiguration` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `false` +- **קונפליקט**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +פעולה זאת עשויה להשפיע מאוד על בטיחות השרת ועל ביצועיו. + +כל בעיה שעשויה להתגלות בשימוש במאפיין זה מתוחת לאחריות המנהל של השרת. +{% endhint %} + +מציע את ההגדרה ההתחלתית בערכים מוגדרים על ידי Mojang. + +פעולה זו מבטלת את כל תיקוני נקודות השחרור שהוחלו על ידי Paper. + +ניתן להפעיל מחדש את תיקוני נקודות השחרור בהגדרת Paper או Plazma. + +#### `Plazma.vanillaize` + +- **סוג**: `Boolean` +- **ברירת מחדל**: `true` +- **קונפליקט**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +מגדיר את ההגדרה ההתחלתית לקרובה יותר לבנילה. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### תכונה שהופסקה + +התכונות הבאות של המערכת הן תכונות שהופסקו. + +#### `timings.bypassMax` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `false` +- **הופסק בשימוש**: Timings הוסרה מ-Plazma מהגרסה 1.20.5 והלאה + +האם ניתן לחרוג מהגבול של ערך שנשלח ל- Timings API של Aikar. + +אם זה נעשה ולא נתפס בכלל ב- API, יחול הגבלת קצב. + +*** + +## פרמטר פתיחה + +פרמטר פתיחה הוא ערך שמתווסף לאחר `-jar *.jar` ומאתחל את Plazma יחד עם הערך המתואר. + +### שימוש + +תכונת המערכת מתווספת כארגומנט לתוך התוכנית לאחר `-jar *.jar`. + +לדוגמא, אם אתה רוצה להוסיף את הארגומנט `nogui`,\ +תכתוב את זה כך כדי ש-Plazma יאתחל עם הארגומנט `nogui` בתהליך האתחול. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### פרמטר פתיחה מלא + +#### `bukkit-settings` + +- **כינוי**: `b` +- **ערך ברירת מחדל**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **כינוי**: `c` +- **ערך ברירת מחדל**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **כינוי**: `c` +- **ערך ברירת מחדל**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +מתחיל את השרת בעולם הדמו. + +#### `eraseCache` + +מסיר את קבצי המטמון שנותרו אחרי שדרגת העולם. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **כינוי**: `?` + +מציג את כל פרמטרי הפתיחה של Plazma והסבר עליהם. + +#### `initSettings` + +יוצר רק את קובץ ההגדרות ומסיים את השרת. + +#### `jfrProfile` + +מפעיל פרופיל JFR. + +#### `max-players` + +- **כינוי**: `s`, `size` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +מנטרל את החלון הגרפי של הממשק. + +#### `nojline` + +השבת את JLine והשתמש בקונסולת וניל. + +#### `מצב-מקוון` + +- **כינוי**: `o` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +בחר אם לאמת את השחקנים דרך שרתי האימות של Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `הגדרות-נייר` + +- **כינוי**: `נייר` +- **ערך ברירת מחדל**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +מגדיר את מיקום קובץ ההגדרות של PaperSpigot שהופסק בשימוש. + +משמש להעברת הגדרות קובץ ההגדרות המופסק של Paper לקובץ הגדרות חדש, ואינו משמש לאחר מכן. + +#### `תיקיית-הגדרות-נייר` + +- **כינוי**: `תיקיית-נייר` +- **ערך ברירת מחדל**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `תיקיית-הגדרות-פלזמה` + +- **כינוי**: `תיקיית-פלזמה` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `תוספים` + +- **כינוי**: `ת` +- **ערך ברירת מחדל**: `תוספים` + +מגדיר את מיקום התיקייה של התוספים. + +#### `הגדרות-פופרפיש` + +- **כינוי**: `פופרפיש` +- **ערך ברירת מחדל**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `הגדרות-פורפור` + +- **כינוי**: `פורפור` +- **ערך ברירת מחדל**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `מצב-בטיחות` + +(מצב בטיחות) מתחיל את השרת במצב וניל מלא. + +#### `כתובת-שרת` + +- **כינוי**: `h`, `מארח` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `יציאת-שרת` + +- **כינוי**: `p`, `יציאה` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +מגדיר את היציאה של השרת. + +#### `שם-שרת` + +- **ערך ברירת מחדל**: `שרת Plazma` + +מגדיר את שם השרת. + +#### `הגדרות-ספיגוט` + +- **כינוי**: `S` +- **ערך ברירת מחדל**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `גרסה` + +- **כינוי**: `v` + +מדפיס את גרסת Plazma. + +#### `תיקיית-עולם` + +- **כינוי**: `W`, `יקום`, `מיכל-עולם` +- **ערך ברירת מחדל**: `(תיקיית השרת)` + +מגדיר את המיקום שבו מתבצעת שמירת קבצי העולם. + +#### `שם-עולם` + +- **כינוי**: `w`, `עולם` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +מגדיר את שם קובץ העולם. + +*** + +[^1]: `ג'אווה (...) -jar server.jar (...)` + +[^2]: המיקום תוך כדי טיפול בארגומנטים ישתנה בהתאם למיקום הניתן לו. + +[^3]: לדוגמא, כאשר ברצונך להפעיל את `Plazma.iKnowWhatIAmDoing` כ- `true`, ייתכן שיהיה מספיק להזין רק `-DPlazma.iKnowWhatIAmDoing` במקום `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: לדוגמא, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: מגדיר את גופי האירוע. + +[^6]: מגדיר את גופי האירוע. + +[^7]: מגדיר את הלקוח. + +[^8]: סיגנון הודעה המעיד על התחברות תקינה של השרת ושל הלקוח כמו דופקי הלב. + +[^9]: על ידי השימוש בפונקציית הגירוש AFK של Purpur, ניתן לגרש גם שחקנים שעזבו את המשחק. + +[^10]: מערכת כתיבת צ'אנקים מסונכרנית, Sync Chunk Write System. + +[^11]: `אזהרה! Plazma עשויה לגרום לבעיות בלתי צפויות, יש לבדוק אותה בקפידה לפני השימוש בה בשרת ציבורי.` + +[^12]: במשחק `אופטימיזצית עולם` עובדת על פי אותו העקרון. + +[^13]: מנהלים ברמה 2 ומעלה אינם כלולים. + +[^14]: פרוטוקול האינטרנט, IP. diff --git a/he/origin/plazma/administration/reference/commands.md b/he/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..b71aac8bc --- /dev/null +++ b/he/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: למדו על הפקודות הזמינות ב- Plazma. +--- + +# 🖥️ פקודות diff --git a/he/origin/plazma/administration/reference/configurations/README.md b/he/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..715d1bf85 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: תצורה היא הדרך הבסיסית ביותר להתאמה אישית של Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 מאפיינים + +> מאפיינים הם קובץ מבנה בסיסי שמסופק ב-Minecraft. באמצעות שימוש במאפיינים ניתן לשנות את המנגנונים הבסיסיים של המשחק. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 מבנה Bukkit + +> מבנה Bukkit הוא קובץ מבנה בסיסי שמסופק ב-Plazma. באמצעות שימוש במבנה Bukkit ניתן לשנות את המנגנונים הבסיסיים של שרת Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 מבנה Spigot + +> מבנה Spigot מאפשר לשנות את המנגנונים המפורטים של המשחק, עיבוד השחקנים, תפקוד הפקודות וההודעות. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ מבנה Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 מבנה Pufferfish + +> מבנה Pufferfish מאפשר לשנות את עיבוד העולמות והישויות של Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 מבנה Purpur + +> מאפייני Purpur מאפשרים לשנות את הנתונים הבסיסיים של המשחק. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ מבנה Plazma + +> מבנה Plazma מאפשר להתאים אישית את תכונות Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/he/origin/plazma/administration/reference/configurations/bukkit.md b/he/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..175a18228 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: לְהַבְהִיר מַה כָּל צָמָד בּוּקִיט בְּ־yml מַשְׁמִיע. +--- + +# 🪣 בֻּקִיט diff --git a/he/origin/plazma/administration/reference/configurations/paper/README.md b/he/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..a9daf78cf --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: לגלות מהו המטרה של כל קובץ בתיקיית התצורה. +--- + +# 🛩️ נייר diff --git a/he/origin/plazma/administration/reference/configurations/paper/global.md b/he/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..907f072e0 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: אנא לקבל על עצמך להבין מה משמעות כל צומת ב-paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/he/origin/plazma/administration/reference/configurations/paper/world.md b/he/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..05aab519e --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: לְגַלוֹת מַה מַּשְׁמִיע כָּל צֵמֶח בְּpaper-world.yml. +--- + +# 🏳️ 세계별 구성 + +עולמי diff --git a/he/origin/plazma/administration/reference/configurations/plazma/README.md b/he/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..841cb8361 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: לגלות מהו המטרה של כל קובץ בתיקיית התצורה. +--- + +# ✨ פלזמה diff --git a/he/origin/plazma/administration/reference/configurations/plazma/global.md b/he/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a8548bd29 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: לְחַקֵר מַה כָּל צָמָד בְּ plazma-global.yml מַצְיַין. +--- + +# 🌏 전역 구성 diff --git a/he/origin/plazma/administration/reference/configurations/plazma/world.md b/he/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..0d1111543 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: בדוק מה מהו כל צומת בקובץ plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/he/origin/plazma/administration/reference/configurations/plazma/worlds.md b/he/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d4fcd9174 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: בדוק מה מהו כל צומת בקובץ plazma-world.yml. +--- + +# ✨ Plazma (מבנה לפי עולם) diff --git a/he/origin/plazma/administration/reference/configurations/property.md b/he/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..2b69c7e91 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: לְהָבִין מַה כָּל צָמִיחַ בִּשְׁם server.properties אוֹמֵר. +--- + +# 🪨 Server.properties diff --git a/he/origin/plazma/administration/reference/configurations/pufferfish.md b/he/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..c23dd829b --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: לגלות מה מהו כל צומת ב-pufferfish.yml. +--- + +# 🐡 דג פופר diff --git a/he/origin/plazma/administration/reference/configurations/purpur/README.md b/he/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..84fe69f33 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: גלו מה מהו כל צומת ב-purpur.yml. +--- + +# 🦑 Purpur diff --git a/he/origin/plazma/administration/reference/configurations/purpur/global.md b/he/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..367cc1dbc --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: גלו מה מהו כל צומת ב-purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/he/origin/plazma/administration/reference/configurations/purpur/world.md b/he/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..ff070c559 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: גלו מה מהו כל צומת ב-purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/he/origin/plazma/administration/reference/configurations/spigot.md b/he/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..32dc73076 --- /dev/null +++ b/he/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: גלה מה מהו כל צומת ב spigot.yml. +--- + +# 🚰 Spigot diff --git a/he/origin/plazma/administration/reference/permissions.md b/he/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..7b0b4f19e --- /dev/null +++ b/he/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: לקבלת מידע על הרשאות ה-Plazma. +--- + +# 🛡️ הרשאה + +הרשאה היא כלי אבטחה פשוט שמגדיר את הטווח שבו ניתן לשחקן בשרת לפעול ביחס לשחקן אחר. + +כדי להשתמש בהרשאות כראוי ולערוך אותן בקלות, יש להשתמש בתוסף כגון [LuckPerms](https://luckperms.net). + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **[הגדרות העולם של Purpur](configurations/purpur/world.md)**: פעולה זו תתקיים רק אם הופעלה האפשרות `(Entity) > ניתן לרכוב`. + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **ברירת המחדל**: `מנהל עולם` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +כאשר מזינים `.other` אחרי שם ההרשאה, מאפשרים לשחקן אחר להשתמש בה. + +#### `bukkit.command.demo` + +- **ברירת המחדל**: `מנהל עולם` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +כאשר מזינים `.other` אחרי שם ההרשאה, מאפשרים לשחקן אחר להשתמש בה. + +#### `bukkit.command.ping` + +- **ברירת המחדל**: `מנהל עולם` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **ברירת המחדל**: `מנהל עולם` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **ברירת המחדל**: `מנהל עולם` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +כאשר מזינים `.other` אחרי שם ההרשאה, מאפשרים לשחקן אחר להשתמש בה. + +#### `bukkit.command.restart` + +- **ברירת המחדל**: `מנהל עולם` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **ברירת המחדל**: `מנהל עולם` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **ברירת המחדל**: `מנהל עולם` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +כאשר מזינים `.other` אחרי שם ההרשאה, מאפשרים לשחקן אחר להשתמש בה. + +#### `bukkit.command.timings` + +- **ברירת המחדל**: `מנהל עולם` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **ברירת המחדל**: `מנהל עולם` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **ברירת המחדל**: `מנהל עולם` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +כאשר מזינים `.other` אחרי שם ההרשאה, מאפשרים לשחקן אחר להשתמש בה. + +#### `paper.antixray.bypass` + +- **ברירת המחדל**: `אין` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **ברירת המחדל**: `אין` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **ברירת המחדל**: `אין` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **ברירת המחדל**: `אין` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **ברירת המחדל**: `אין` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **ברירת המחדל**: `אין` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **ברירת המחדל**: `מנהל עולם` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **ברירת המחדל**: `אין` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **ברירת המחדל**: `אין` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **ברירת המחדל**: `אין` + +אפשר תותם של אין-מוות גם כאשר הוא נמצא בתיק האביזרים. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **ברירת המחדל**: `אין` + +להתיר לשחקן להתעלם ממגבלת מספר המשתתפים. + +#### `purpur.mending_shift_click` + +- **ברירת המחדל**: `אין` + +לאפשר לשחקן לתקן פריט שהוא נשא עליו כאשר הוא מתעקש. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **ברירת המחדל**: `אין` + +להתיר לשחקן להתקין ספאוונרים. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **ברירת המחדל**: `אין` + +לאפשר לשחקן להעביר באופן מיידי כאשר הוא משתמש בשערי נדר. + +#### `purpur.sign.color` + +- **ברירת המחדל**: `אין` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **ברירת המחדל**: `אין` + +לאפשר שימוש בקודי מטען `(&o)` בלוחות. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **ברירת המחדל**: `אין` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **ברירת המחדל**: `אין` + +להתיר לשחקן למנוע פיצוץ של TNT על ידי שימוש במספרים. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### הרשאות מוצעות + +#### `plazma.bypass.ncr-require` + +- **ברירת המחדל**: `אין` + +להתיר לשחקן להתחבר גם בלעדי התקנת המוד [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: אופרטור. + +[^2]: למשל: `ender_dragon` diff --git a/he/origin/plazma/adminstration/README.md b/he/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..ca8e3ff61 --- /dev/null +++ b/he/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: השתמשו בפלזמה כדי ליצור שרת משלכם. +--- + +# מדריך לניהול שרת ⚒️ diff --git a/he/origin/plazma/adminstration/expert/README.md b/he/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..a8d014d2a --- /dev/null +++ b/he/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: למדו כיצד לעסוק ב-Plazma בצורה מקצועית. +--- + +# 🎓 עמוק diff --git a/he/origin/plazma/adminstration/expert/fix-exploits.md b/he/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..174e18824 --- /dev/null +++ b/he/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: גלו על נקודות החולשה הידועות וכיצד לטפל בהן. +--- + +# ⚠️ נקודות חולשה ידועות וכיצד לטפל בהן diff --git a/he/origin/plazma/adminstration/expert/optimize.md b/he/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..8e42da366 --- /dev/null +++ b/he/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: גלו כיצד לאופטימז את Plazma. +--- + +# 🧹 אופטימיזציה diff --git a/he/origin/plazma/adminstration/expert/vanillaize.md b/he/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..fb62ace9a --- /dev/null +++ b/he/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: למדו כיצד לשחזר את תיקון הנייר והונילה. +--- + +# ↩️ המרת להיות כמו הונילה + +{% hint style="warning" %} + +### הנייר לא מציע אפשרויות רבות לתיקון שגיאות הונילה. + +Plazma כרגע מפתחת אפשרות להשבתת תיקוני שגיאות כאלה. + +לכן, המדריך עדיין בתהליך כתיבה והמידע עשוי להשתנות בכל עת. +{% endhint %} diff --git a/he/origin/plazma/adminstration/faq.md b/he/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..8e1a3162d --- /dev/null +++ b/he/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: למענה על שאלות נפוצות, בדוק כאן. +--- + +# ⁉️ שאלות נפוצות + +{% hint style="info" %} + +### לא מוצאים את התשובה שחיפשתם? + +[שרת Discord רשמי](https://discord.gg/MmfC52K8A8) או [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) לשאול שאלות בקהילה! +{% endhint %} + +### הודעת שגיאה מופיעה והרצת התוכנית לא מתבצעת + +אם מופיע בקונסולה `no main manifest attribute, in plazma-(version).jar`,\ +אז הקובץ שהורדתם הוא קובץ API לצורכי פיתוח, עליכם להוריד את **Reobf Paperweight** מעמוד ה-GitHub. + +למידע נוסף, ראו את הדף הבא. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### אזהרה מופיעה בכל פעם שהשרת מתחיל לרוץ + +Plazma מכיל תיקונים לא יציבים חלקים ולכן יש תמיד סיכוי לתקלות, על כן השרת מדפיס אזהרות כאלו בזמן הפעלתו. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +ניתן להשבית את ההודעות האלו באמצעות השימוש במאפיין המערכת [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +למידע נוסף, ראו את הדף הבא. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: זמין מגרסה 1.20.1 ומעלה diff --git a/he/origin/plazma/adminstration/getting-started/README.md b/he/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..0bfb1b145 --- /dev/null +++ b/he/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: למדו כיצד ליצור שרת באמצעות Plazma. +--- + +# 👟 התחלה + +כדי להשתמש ב-Plazma באופן יציב, המערכת צריכה לעמוד בדרישות הבאות: + +| | מינימום | מומלץ | +| :--------: | ------: | ----: | +| ארכיטקטורה | x64 | - | +| RAM | 8GB | 16GB | +| שטח אחסון | 1GB | 8GB | +| JRE | 17 | 21 | + +כדי לערוך קבצי תצורה בצורה חלקה, כדאי להתקין עורך כגון [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. התקנת JRE + +כפי שניתן להבין מהשם, Minecraft: **"Java"** Edition פותח ב-Java, ולהריץ אותו נדרש JRE[^1]. + +Plazma מבוסס על פלטפורמת השרת הרשמית של Mojang Studios, ולכן על מנת להשתמש ב-Plazma יש להתקין גם JRE. + +### 1.1 בדיקת התקנת JRE + +כדי לוודא ש-JRE מותקן במערכת, יש להזין [`cmd /k java --version`](#user-content-fn-4) בחלון הפעולה ולהפעיל אותו. + +אם יש פלט כזה, עבור ל[שלב 2](setup.md#id-2). + +{% code title="פלט תקין" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +אם לא נמצא פלט כזה או אם נמצא פלט כזה, עליך לבדוק את ההתקנה ב[שלב 1.2](setup.md#id-1.2). + +{% code title="JRE לא מותקן" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE ישן מדי" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 התקנת JRE + +במדריך זה, נשתמש ב-Azul Zulu כ[אחד מסוגי ה-JRE](#user-content-fn-5). + +לאחר ההתקנה, נדאג לבדוק שההתקנה הסתיימה בהצלחה על ידי ביצוע [שלב 1.1](setup.md#id-1.1) שוב. + +{% tabs %} +{% tab title="Windows" %} + +1. התחל על ידי הורדת **JDK 21** בפורמט `.msi` מ-[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. הרץ את אשף ההתקנה שהורדת ולחץ על 'הבא'. +3. בתפריט המוצג במרכז השמאלי של החלון, הפעל את 'Set JAVA_HOME variable' ולאחר מכן לחץ על 'הבא'. +4. לחץ על 'התקן' כדי להשלים את התהליך של התקנת JRE. + {% endtab %} + +{% tab title="macOS" %} +מ-[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) הורד את **JDK 21** בפורמט `.dmg` והרץ את אשף ההתקנה כדי להתקין את JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: חברת מיקרוסופט. + +[^11]: במקרה של קוריאה, ניתן להגיש תביעה משפטית מצד **חברת מיקרוסופט של קוריאה** על פי סעיף 9, סעיף 1, סעיף 32 של חוק הקידום התעשייתי של תעשיית המשחקים בקוריאה. + +[^12]: כניסה ויציאה אוניברסלית. פורפור הכלול בפלאזמה מתקשר אוטומטית עם הראוטר דרך טכנולוגיה זו ומאפשר פתיחת פורטים רק כאשר השרת פועל, ולכן אין צורך לבצע הפניה ישירה של פורטים. + +[^13]: במקרה שאין לך חשבון, נרשמים ל-Ngrok דרך חשבון Google או GitHub. diff --git a/he/origin/plazma/adminstration/getting-started/customization.md b/he/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..b1216512d --- /dev/null +++ b/he/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: ללמוד כיצד להתאים אישית את השרת. +--- + +# 🎨 התאמה אישית diff --git a/he/origin/plazma/adminstration/reference/arguments.md b/he/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..b64cfbc6c --- /dev/null +++ b/he/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: למדו על ארגומנטי ההתחלה והמאפיינים של המערכת. +--- + +# 🎛️ ארגומנטים ומאפיינים + +ארגומנטי ההתחלה והמאפיינים מאפשרים לשנות ערכים שאי אפשר לשנות לאחר הרצת Plazma. + +בהתאם למיקום שבו [נוסף לפקודה](#user-content-fn-1)\[^1] נחברת, הם נחלקים ל**ארגומנטי ההתחלה** ול**מאפייני המערכת**. + +*** + +## מאפייני המערכת + +מאפייני המערכת מתווספים לפני ה `-jar` ומעוברים על ידי הJVM לפני שPlazma מאתחלת. + +{% hint style="warning" %} + +### שינוי במאפייני המערכת עשוי לשנות את הפעולה של Plazma והJVM, ולגרום לשינויים גדולים במשחק! + +אם לא ברור לך איזה תפקיד יש לכל מאפיין מערכת, **אל תשתמש בהם!** +{% endhint %} + +### שימוש + +מאפייני המערכת מתווספים כארגומנטי פקודה בין `java` ל `-jar`. + +לדוגמה, אם ברצונך להוסיף את מאפיין המערכת `Plazma.dummyProperty`,\ +תכניס `37` לאחריו וכך תאתחל את Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +ה `-D` מציין שהארגומנט הזה הוסף לPlazma ולא מובנה בJVM, + +אם לא תכניס ערך, הערך ייקבע ל־[`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### פלטפורמת השרתים בסדרת Paperweight מפרידה בין מאפייני מערכת באמצעות הכלול של `.` בשם המאפיין. + +בחלק מהטרמינלים כמו ב־Windows Powershell ייתכן שלא יאפשרו כניסה של ארגומנטים כאלו, ולכן עליך להוסיף `"` בקצוות הארגומנט. [^4] +{% endhint %} + +### מאפייני מערכת מלאים + +#### `convertLegacySigns` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מעדכן את הפורמט של לוחות השיט. + +#### `debug.entities` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל ייחודי לנתונים הקשורים ליחידות. + +#### `debug.rewriteForIDE` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את הNMS revision כדי לאפשר לIDE לקרוא נכון את המידע,\ +ומפעיל אוטומטית מיפוי מחדש של מידע פנימי. + +#### `disable.watchdog` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את מערכת האזהרות של Watchdog ב־Spigot. + +#### `letMeReload` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את ההודעה לאימות מחדש של פקודת `/reload`. + +{% hint style="danger" %} + +### מחדש הוא פקודה לא יציבה מאוד, לכן כל בעיה שתתרחש אחרי השימוש בה תהיה באחריות המשתמש בלבד. + +אם אתה מפתח תוסף וצריך לעדכן, השתמש בהחלפה חמה במקום `/reload`. +{% endhint %} + +#### `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 ערוצי תוספים לכל שחקן[^5]. + +#### `Paper.disableClassPrioritization` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את מערכת קדימות המחלקות בתוספים. + +שימושי כאשר יש בעיות בשדרוג תוסף. + +#### `Paper.disableFlushConsolidate` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את מערכת האיחוד של Netty. + +#### `Paper.excessiveTELimit` + +- **סוג**: `Integer` +- **ערך ברירת מחדל**: `750` + +אם יש יותר ישויות מהערך המוגדר, הם ייחלקו לחבילות לשליחה. + +#### `Paper.filterThreshold` + +- **סוג**: `Integer` +- **ערך ברירת מחדל**: `8192` + +מגדיר את גודל החבילה המקסימלית שהשרת יכול לקבל בפעם אחת. + +#### `Paper.ignoreJavaVersion` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מבטל את בדיקת גרסת ה-Java. + +{% hint style="danger" %} + +### כך תאפשר גישה של JVM לקוד שאינו קיים! + +כך ייתכן שהקבצים בעולם ייפגעו בצורה קבועה והמערכת כולה של המשחק תיפגע. + +כל בעיה שתתרחש עקב השימוש בזה תהיה באחריותך בלבד, וPlamza לא תסייע בכך. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **סוג**: `Integer` +- **ערך ברירת מחדל**: `64` + +מגביל את שם הערוץ של התוסף[^6]. + +#### `Paper.maxSignLength` + +- **סוג**: `Integer` +- **ערך ברירת מחדל**: `80` + +מגביל את אורך הטקסט המרבי שניתן להכניס בלוח שלט. + +#### `Paper.minPrecachedDatafixVersion` + +- **סוג**: `Integer` +- **ערך ברירת מחדל**: `(גרסת העולם) + 1` + +מגדיר את גרסת העולם הראשונית שיש לאתחל את המידע לעדכון. + +שימושי במקרים שבהם יש צורך לעדכן כמות גדולה של חתיכות, אך לא במקרים אחרים. + +#### `Paper.parseYamlCommentsByDefault` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `True` + +מפעיל עיבוד של ההערות בקובץ YAML. + +#### `Paper.playerConnection.keepAlive` + +- **סוג**: `Integer` +- **ערך ברירת מחדל**: `30` + +כאשר לא קיבלנו נתונים מהשחקן (בשניות), נבעיר את השחקן. + +בדרך כלל, המשחק[^7] ממשיך לשלוח [אותיות לב](#user-content-fn-8)[^8] לשרת, לא ייגרר, אך אם המשחק לא עונה, נחשב שהמשחק קרס והשרת יפטר את השחקן. + +#### `Paper.skipServerPropertiesComments` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מתעלם מהערות במאפייני השרת. + +#### `Paper.debug-sync-loads` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל יומן דיבאג ליצירת צ'אנקים סינכרוניים. + +#### `Paper.enable-sync-chunk-writes` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל את [מערכת כתיבת הצ'אנקים הבסיסית](#user-content-fn-10) של Minecraft. + +זה גורם לשמירה סדרתית של כל צ'אנק, מה שגורם להפרעה חמורה בביצועים. + +#### `Paper.explicit-flush` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מפעיל פלישינג מפורש בערוץ הרשת. + +#### `Paper.strict-thread-checks` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מקבל תמיד דיווחים על שגיאות שאינן נוצרות בתהליך הראשי. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +מדפיס אזהרה כאשר משימה מתוזמנת עם זמן המתנה יתר. + +#### `Paperclip.patchOnly` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `False` + +כאשר משתמשים בקובץ הרצה שמסופק, מחיל את הפאץ' בלבד מבלי להתחיל את השרת. + +#### `Plazma.aggressiveOptimize` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `false` + +{% hint style="warning" %} + +### תכונה זו תועבר לפרמטר פתיחה מתחילת גרסה 1.20.5. + +{% endhint %} + +מחיל אופטימיזציה קונפיגורציה המתחילה בהפעלת התוכנה. + +כאשר מופעל, השרת מתנהר ומתייצב, אך עשוי לחסום חלק מהמכאניקה או להשפיע על פעולת המשחק באופן משמעותי. + +#### `Plazma.iKnowWhatIAmDoing` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `false` + +מונע את הופעת האזהרות שמופיעות בהפעלת Plazma. + +### תכונה שהופסקה + +התכונות הבאות של המערכת הן תכונות שהופסקו. + +#### `timings.bypassMax` + +- **סוג**: `Boolean` +- **ערך ברירת מחדל**: `false` +- **הופסק בשימוש**: Timings הוסרה מ-Plazma מהגרסה 1.20.5 והלאה + +האם ניתן לחרוג מהגבול של ערך שנשלח ל- Timings API של Aikar. + +אם זה נעשה ולא נתפס בכלל ב- API, יחול הגבלת קצב. + +*** + +## פרמטר פתיחה + +פרמטר פתיחה הוא ערך שמתווסף לאחר `-jar *.jar` ומאתחל את Plazma יחד עם הערך המתואר. + +### שימוש + +תכונת המערכת מתווספת כארגומנט לתוך התוכנית לאחר `-jar *.jar`. + +לדוגמא, אם אתה רוצה להוסיף את הארגומנט `nogui`,\ +תכתוב את זה כך כדי ש-Plazma יאתחל עם הארגומנט `nogui` בתהליך האתחול. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### פרמטר פתיחה מלא + +#### `bukkit-settings` + +- **כינוי**: `b` +- **ערך ברירת מחדל**: `bukkit.yml` + +מגדיר את שם ומיקום קובץ התצורה של [Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **כינוי**: `c` +- **ערך ברירת מחדל**: `commands.yml` + +מגדיר את שם ומיקום קובץ ההגדרות של פקודות [Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **כינוי**: `c` +- **ערך ברירת מחדל**: `server.properties` + +מגדיר את שם ומיקום קובץ ההגדרות של השרת. + +#### `demo` + +מתחיל את השרת בעולם הדמו. + +#### `eraseCache` + +מסיר את קבצי המטמון שנותרו אחרי שדרגת העולם. + +#### `forceUpgrade` + +מתעלם מהגרסה ומשדרג את העולם באופן כפוי [^12]. + +#### `help` + +- **כינוי**: `?` + +מציג את כל פרמטרי הפתיחה של Plazma והסבר עליהם. + +#### `initSettings` + +יוצר רק את קובץ ההגדרות ומסיים את השרת. + +#### `jfrProfile` + +מפעיל פרופיל JFR. + +#### `max-players` + +- **כינוי**: `s`, `size` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +מגדיר את מספר ה[שחקנים](#user-content-fn-14) המרבי שמותר. + +#### `nogui` + +מנטרל את החלון הגרפי של הממשק. + +#### `nojline` + +השבת את JLine והשתמש בקונסולת וניל. + +#### `מצב-מקוון` + +- **כינוי**: `o` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +בחר אם לאמת את השחקנים דרך שרתי האימות של Mojang. + +**במידה ולא נעשה שימוש ב- [EULA](../getting-started/README.md#id-5) עלול להוטיל עונשים אם לא משתמשים ב-Velocity או פרוקסי.** + +#### `הגדרות-נייר` + +- **כינוי**: `נייר` +- **ערך ברירת מחדל**: `paper.yml` + +{% hint style="warning" %} + +### ארגומנט זה הופסק לשימוש מאז 1.19.4 + +{% endhint %} + +מגדיר את מיקום קובץ ההגדרות של PaperSpigot שהופסק בשימוש. + +משמש להעברת הגדרות קובץ ההגדרות המופסק של Paper לקובץ הגדרות חדש, ואינו משמש לאחר מכן. + +#### `תיקיית-הגדרות-נייר` + +- **כינוי**: `תיקיית-נייר` +- **ערך ברירת מחדל**: `config` + +מגדיר את שם התיקייה והמיקום שבו ממוקמות קבצי ההגדרות של Paper. + +#### `תיקיית-הגדרות-פלזמה` + +- **כינוי**: `תיקיית-פלזמה` + +מגדיר את שם התיקייה והמיקום שבו ממוקמות קבצי ההגדרות של Plazma. + +#### `תוספים` + +- **כינוי**: `ת` +- **ערך ברירת מחדל**: `תוספים` + +מגדיר את מיקום התיקייה של התוספים. + +#### `הגדרות-פופרפיש` + +- **כינוי**: `פופרפיש` +- **ערך ברירת מחדל**: `pufferfish.yml` + +מגדיר את שם והמיקום של קובץ ההגדרות של Pufferfish. + +#### `הגדרות-פורפור` + +- **כינוי**: `פורפור` +- **ערך ברירת מחדל**: `purpur.yml` + +מגדיר את שם והמיקום של קובץ ההגדרות של Purpur. + +#### `מצב-בטיחות` + +(מצב בטיחות) מתחיל את השרת במצב וניל מלא. + +#### `כתובת-שרת` + +- **כינוי**: `h`, `מארח` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +מגדיר את שם המארח של השרת או כתובת ה- [פרוטוקול האינטרנט](#user-content-fn-13)[^13]. + +#### `יציאת-שרת` + +- **כינוי**: `p`, `יציאה` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +מגדיר את היציאה של השרת. + +#### `שם-שרת` + +- **ערך ברירת מחדל**: `שרת Plazma` + +מגדיר את שם השרת. + +#### `הגדרות-ספיגוט` + +- **כינוי**: `S` +- **ערך ברירת מחדל**: `spigot.yml` + +מגדיר את שם והמיקום של קובץ ההגדרות של Spigot. + +#### `גרסה` + +- **כינוי**: `v` + +מדפיס את גרסת Plazma. + +#### `תיקיית-עולם` + +- **כינוי**: `W`, `יקום`, `מיכל-עולם` +- **ערך ברירת מחדל**: `(תיקיית השרת)` + +מגדיר את המיקום שבו מתבצעת שמירת קבצי העולם. + +#### `שם-עולם` + +- **כינוי**: `w`, `עולם` +- **ערך ברירת מחדל**: `(מאפייני השרת)` + +מגדיר את שם קובץ העולם. + +*** + +[^1]: `ג'אווה (...) -jar server.jar (...)` + +[^2]: המיקום תוך כדי טיפול בארגומנטים ישתנה בהתאם למיקום הניתן לו. + +[^3]: לדוגמא, כאשר ברצונך להפעיל את `Plazma.iKnowWhatIAmDoing` כ- `true`, ייתכן שיהיה מספיק להזין רק `-DPlazma.iKnowWhatIAmDoing` במקום `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: לדוגמא, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: מגדיר את גופי האירוע. + +[^6]: מגדיר את גופי האירוע. + +[^7]: מגדיר את הלקוח. + +[^8]: סיגנון הודעה המעיד על התחברות תקינה של השרת ושל הלקוח כמו דופקי הלב. + +[^9]: על ידי השימוש בפונקציית הגירוש AFK של Purpur, ניתן לגרש גם שחקנים שעזבו את המשחק. + +[^10]: מערכת כתיבת צ'אנקים מסונכרנית, Sync Chunk Write System. + +[^11]: `אזהרה! Plazma עשויה לגרום לבעיות בלתי צפויות, יש לבדוק אותה בקפידה לפני השימוש בה בשרת ציבורי.` + +[^12]: במשחק `אופטימיזצית עולם` עובדת על פי אותו העקרון. + +[^13]: פרוטוקול האינטרנט, IP. + +[^14]: מנהלים ברמה 2 ומעלה אינם כלולים. diff --git a/he/origin/plazma/adminstration/reference/commands.md b/he/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..b71aac8bc --- /dev/null +++ b/he/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: למדו על הפקודות הזמינות ב- Plazma. +--- + +# 🖥️ פקודות diff --git a/he/origin/plazma/adminstration/reference/configurations/bukkit.md b/he/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..175a18228 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: לְהַבְהִיר מַה כָּל צָמָד בּוּקִיט בְּ־yml מַשְׁמִיע. +--- + +# 🪣 בֻּקִיט diff --git a/he/origin/plazma/adminstration/reference/configurations/paper/README.md b/he/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..a9daf78cf --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: לגלות מהו המטרה של כל קובץ בתיקיית התצורה. +--- + +# 🛩️ נייר diff --git a/he/origin/plazma/adminstration/reference/configurations/paper/global.md b/he/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..2f12e52fb --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: אנא לקבל על עצמך להבין מה משמעות כל צומת ב-paper-global.yml. +--- + +# 🛩️ נייר (קונפיגורציה גלובלית) diff --git a/he/origin/plazma/adminstration/reference/configurations/paper/world.md b/he/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..c0f268bbc --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: לְגַלוֹת מַה מַּשְׁמִיע כָּל צֵמֶח בְּpaper-world.yml. +--- + +# 🛩️ נייר (מַעֲרָכָת עוֹלָם) diff --git a/he/origin/plazma/adminstration/reference/configurations/plazma/README.md b/he/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..841cb8361 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: לגלות מהו המטרה של כל קובץ בתיקיית התצורה. +--- + +# ✨ פלזמה diff --git a/he/origin/plazma/adminstration/reference/configurations/plazma/global.md b/he/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..fa5e77be8 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: לְחַקֵר מַה כָּל צָמָד בְּ plazma-global.yml מַצְיַין. +--- + +# ✨ Plazma (הגדרה גלובלית) diff --git a/he/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/he/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..a4083cc7d --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ קומפוזיציה לפי עולם diff --git a/he/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/he/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d4fcd9174 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: בדוק מה מהו כל צומת בקובץ plazma-world.yml. +--- + +# ✨ Plazma (מבנה לפי עולם) diff --git a/he/origin/plazma/adminstration/reference/configurations/property.md b/he/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..2b69c7e91 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: לְהָבִין מַה כָּל צָמִיחַ בִּשְׁם server.properties אוֹמֵר. +--- + +# 🪨 Server.properties diff --git a/he/origin/plazma/adminstration/reference/configurations/pufferfish.md b/he/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..c23dd829b --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: לגלות מה מהו כל צומת ב-pufferfish.yml. +--- + +# 🐡 דג פופר diff --git a/he/origin/plazma/adminstration/reference/configurations/purpur/README.md b/he/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..84fe69f33 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: גלו מה מהו כל צומת ב-purpur.yml. +--- + +# 🦑 Purpur diff --git a/he/origin/plazma/adminstration/reference/configurations/purpur/global.md b/he/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..fd63474a7 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: גלו מה מהו כל צומת ב-purpur.yml. +--- + +# פורפור (מבנה גלובלי) diff --git a/he/origin/plazma/adminstration/reference/configurations/purpur/world.md b/he/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..e5e511095 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: גלו מה מהו כל צומת ב-purpur.yml. +--- + +# 🦑 פורפור (הרכב של עולם) diff --git a/he/origin/plazma/adminstration/reference/configurations/spigot.md b/he/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..32dc73076 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: גלה מה מהו כל צומת ב spigot.yml. +--- + +# 🚰 Spigot diff --git a/he/origin/plazma/adminstration/reference/permissions.md b/he/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..d9363b2d0 --- /dev/null +++ b/he/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: לקבלת מידע על הרשאות ה-Plazma. +--- + +# 🛡️ הרשאה diff --git a/he/origin/plazma/developers.md b/he/origin/plazma/developers.md new file mode 100644 index 000000000..a7b6cf433 --- /dev/null +++ b/he/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: השתמשו בפלזמה כדי לפתח פרויקטים של צד שלישי. +--- + +# ⚙️ מדריך למפתחים diff --git a/he/origin/thunderbolt/README.md b/he/origin/thunderbolt/README.md new file mode 100644 index 000000000..1ac8029ae --- /dev/null +++ b/he/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt הוא פלטפורמת שרתים מבוססת Plazma שמאפשרת לך להשתמש בפאצ'ים ניסיוניים באמצעות Flavor כדי לנסות באופן ישיר. +--- + +# 🌩️ מדריך שימוש ב-Thunderbolt diff --git a/he/origin/volt/README.md b/he/origin/volt/README.md new file mode 100644 index 000000000..7e4915752 --- /dev/null +++ b/he/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt הוא תבנית קוד פתוח שמבוססת על Plazma ומספקת אפשרות לפיתוח של שרת Paperweight משלו. +--- + +# ⚡ מדריך פיתוח Volt diff --git a/hi/origin/README.md b/hi/origin/README.md new file mode 100644 index 000000000..497f0f644 --- /dev/null +++ b/hi/origin/README.md @@ -0,0 +1,41 @@ +--- +description: यदि आपके पास कोई सवाल है तो कृपया Discord या GitHub चर्चाओं के माध्यम से पूछें। +--- + +# 🏠 Docs Portal में आपका स्वागत है + +{% hint style="info" %} + +**Plazma के दस्तावेज़ मशीन अनुवादित हैं।** + +[![अनुवाद स्थिति](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) से दस्तावेज़ अनुवाद में भाग लें और दस्तावेज़ को सुधारें। + +{% endhint %} + +### Plazma का उपयोग करते समय कोई समस्या हो तो? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderbolt에 대해 관심이 있다면? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` अगर आपको अधिक Minecraft संबंधित जानकारी चाहिए? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/hi/origin/SUMMARY.md b/hi/origin/SUMMARY.md new file mode 100644 index 000000000..1a4d279ac --- /dev/null +++ b/hi/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# सारांश की तालिका + +- [🏠 Docs पोर्टल में आपका स्वागत है](README.md) + - [⚛️ गिटहब](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 डिस्कॉर्ड](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## प्लाज्मा + +- [✨ प्लाज्मा उपयोग दस्तावेज़](plazma/README.md) +- [❓ प्लाज्मा क्या है?](plazma/about/README.md) + - [⬇️ डाउनलोड](plazma/about/downloads.md) + - [✅ समर्थित संस्करण स्थिति](plazma/about/supported-versions.md) +- [⚒️ सर्वर प्रबंधन गाइड](plazma/administration/README.md) + - [👟 शुरू हो जाओ](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 रेफरेंस](plazma/administration/reference/README.md) + - [🖥️ कमांड्स](plazma/administration/reference/commands.md) + - [🛡️ अनुमतियाँ](plazma/administration/reference/permissions.md) + - [🎛️ आर्ग्यूमेंट्स और प्रॉपर्टी](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 गुणवत्ता](plazma/administration/reference/configurations/property.md) + - [🪣 बुकिट](plazma/administration/reference/configurations/bukkit.md) + - [🚰 स्पिगॉट](plazma/administration/reference/configurations/spigot.md) + - [🛩️ पेपर](plazma/administration/reference/configurations/paper/README.md) + - [🌏 ग्लोबल कॉन्फ़िगरेशन](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ विश्व विन्यास](plazma/administration/reference/configurations/paper/world.md) + - [🐡 पफरफिश](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 पुरपुर](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 ग्लोबल कॉन्फ़िगरेशन](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ विश्व विन्यास](plazma/administration/reference/configurations/purpur/world.md) + - [✨ प्लाज़मा](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 ग्लोबल कॉन्फ़िगरेशन](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ विश्व विन्यास](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 विशेषज्ञ](plazma/administration/expert/README.md) + - [🧹 ऑप्टिमाइज़े](plazma/administration/expert/optimize.md) + - [🔀 프록시](plazma/administration/expert/proxy.md) + - [↩️ वनिलाइज़](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray ब्लॉक](plazma/administration/expert/xray.md) + - [⚠️ सुरक्षा गड़बड़ी और समाधान](plazma/administration/expert/fix-exploits.md) + - [⁉️ अक्सर पूछे जाने वाले सवाल](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ डेवलपर गाइड](plazma/developers.md) + - [✏️ योगदान करें](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ जावाडॉक्स](https://jd.plazmamc.org/) + +## थंडरबोल्ट + +- [🌩️ थंडरबोल्ट उपयोग मार्गदर्शिका](thunderbolt/README.md) + +## वोल्ट + +- [⚡ वोल्ट विकास मार्गदर्शिका](volt/README.md) + +## विविध + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ सभी डाउनलोड देखें](plazma/about/downloads-all.md) diff --git a/hi/origin/miscellaneous/README.md b/hi/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/hi/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/hi/origin/plazma/README.md b/hi/origin/plazma/README.md new file mode 100644 index 000000000..626ab1b2b --- /dev/null +++ b/hi/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma는 Paper 기반의 실험적 최적화와 여러 게임 메커니즘 사용자화 기능을 추가한 Minecraft: Java Edition용 오픈 소스 서버 플랫폼입니다." +--- + +# ✨ Plazma Usage Docs + +## 👋 Plazma Docs में आपका स्वागत है + +Plazma 사용 설명서에 방문하신 것을 환영합니다! + +{% hint style="info" %} + +**क्या आप विवरण पुस्तिका के माध्यम से समस्या को हल नहीं कर सकते?** + +[공식 Discord सर्वर](https://discord.gg/MmfC52K8A8) या [GitHub चर्चाएँ](https://github.com/PlazmaMC/PlazmaBukkit/discussions) के माध्यम से समुदाय से सवाल पूछें! + +{% endhint %} + +### Plazma के बारे में + +> Plazma क्या है, एक सर्वर प्लेटफ़ॉर्म के बारे में जानें। + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### प्रशासकों के लिए + +> Plazma का उपयोग करके अपनी खुद की सर्वर बनाएं। + +{% content-ref url="administration/" %} +[प्रशासन](administration/) +{% endcontent-ref %} + +### डेवलपर्स के लिए + +> Plazma का उपयोग करके थर्ड पार्टी परियोजनाओं का विकास करें। + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/hi/origin/plazma/about/README.md b/hi/origin/plazma/about/README.md new file mode 100644 index 000000000..5d99be133 --- /dev/null +++ b/hi/origin/plazma/about/README.md @@ -0,0 +1,71 @@ +--- +description: Plazma क्या है, एक सर्वर प्लेटफ़ॉर्म के बारे में जानें। +--- + +# ❓ Plazmaक्या है? + +- **Plazma** [Andromeda](https://github.com/EarendelArchived/Andromeda) और [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) से लाभ लेते हुए [Paper](https://github.com/PaperMC/Paper) पर आधारित सर्वर प्लेटफ़ॉर्म है। +- हम हमेशा उच्च स्थिरता और शक्तिशाली प्रदर्शन, तेज अपडेट, और विस्तृत सुविधाएँ प्रदान करने के लिए प्रयासरत हैं। + +## 📋 Plazma का लक्ष्य + +- तेज अपडेट, उच्च स्थिरता वाला सर्वर प्लेटफ़ॉर्म बनाने के लिए हम प्रयासरत हैं। +- मोड प्लेटफ़ॉर्म की तुलना में विस्तृत सुविधाएँ और शक्तिशाली प्रदर्शन प्रदान करने के लिए हम प्रयासरत हैं। +- वनिला के पैच को उपयोगकर्ता अनुकूलित करने के लिए हम स्वतंत्र प्लेटफ़ॉर्म बनाने के लिए प्रयासरत हैं। + +## ⚙️ मुख्य विशेषताएँ + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **सबसे तेज अपडेट**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) Plazma के शामिल पैच को हमेशा नवीन रखने के लिए है जिससे, Paper पर आधारित सर्वर प्लेटफ़ॉर्म में सबसे तेज अपडेट प्रदान किया जा रहा है। +6. **मूल संरचना फ़ाइल की अनुकूलन**\ + मूल लागू संरचना फ़ाइल को अनुकूलित किया गया है, इसे सीधे अनुकूलित करने की आवश्यकता नहीं है। +7. **संगठित रूप से काम करने वाला मल्टीथ्रेड**\ + खेल के मेकेनिज़्म और संबंधित नहीं सिस्टम मेकेनिज़्म को असिंक्रोनाइज़ करके, [देरी समय](#user-content-fn-4)[^4] को कम करके सर्वर को ऑप्टिमाइज़ किया जाता है। +8. **अनावश्यक जगह का उपयोग रोकना**\ + एक समान मान वाले डेटा को एक साथ मिलाकर मेमोरी उपयोग को कम करता है। + +## ✨ उपयोग मामले + +- **जटिल प्लगइनों को सही ढंग से संबोधित करने वाला प्लेटफ़ॉर्म**\ + डेवलपर [IPECTER](https://github.com/IPECTER) के सर्वर पर Plazma का उपयोग किया जा रहा है। NMS और रिफ्लेक्शन के साथ काम करने वाले स्व-प्लगइन, जटिल और विशाल आकार के डेटा पैक के बावजूद, 100 से अधिक खिलाड़ियों को उपभोक्ता नुकसान के बिना स्वीकार कर रहा है। +- **RPG सर्वर पर भी तेज प्रदर्शन बनाए रखने वाला प्लेटफ़ॉर्म**\ + एकल क्लस्टर में 100 खिलाड़ियों को टीपीएस गिरावट के बिना स्थिर रूप से बनाए रखा गया था, 4 क्लस्टरों में कुल 250 खिलाड़ियों ने सुखद रूप से खेलने की सुविधा प्राप्त की। +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **बहुत से स्ट्रीमरों द्वारा चयनित प्लेटफ़ॉर्म**\ + बहुत से स्ट्रीमरों के दर्शकों के भाग्य योग्य बाल्टी के रूप में चयनित और उपयोग किया जा रहा है। + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ डाउनलोड + +नीचे दिए गए पृष्ठ से Plazma को डाउनलोड किया जा सकता है। + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### 버전 지원에 대한 자세한 정보를 जानना चाहते हैं? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot प्लगइन और Paper, Pufferfish, Purpur प्लगइन। + +[^2]: नीचे Microsoft Corporation। + +[^3]: चैट रिपोर्ट सिस्टम को निष्क्रिय करने पर चैट केवल सर्वर पर ही संसाधित होती है और Mojang की चैट ट्रैकिंग को रोका जा सकता है। + +[^4]: सिस्टम मेकेनिज़्म को काम करने के लिए कुछ समय तक खेल रुक जाता है। diff --git a/hi/origin/plazma/about/downloads-all.md b/hi/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..5ebc76b8a --- /dev/null +++ b/hi/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: प्लाज्मा एक्जीक्यूशन फ़ाइल डाउनलोड पूर्ण देखें +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| संस्करण | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap पेपरक्लिप। [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf पेपरक्लिप। [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap पेपरक्लिप। [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/hi/origin/plazma/about/downloads.md b/hi/origin/plazma/about/downloads.md new file mode 100644 index 000000000..cca61239d --- /dev/null +++ b/hi/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: अब Plazma को डाउनलोड करें और स्वयं प्रयोग करें। +--- + +# ⬇️ डाउनलोड + +#### 버전 지원에 대한 자세한 정보를 जानना चाहते हैं? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**नीचे डाउनलोड एक साधारण उपयोगकर्ता के लिए एक्ज़ीक्यूटेबल फ़ाइल है।** + +अगर आप एक डेवलपर हैं और एक अन्य प्रकार की फ़ाइल की आवश्यकता है, तो कृपया नीचे दी गई पेज का संदर्भ लें। + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
संस्करणडाउनलोड करें
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + डाउनलोड +
1.20.1 + डाउनलोड +
1.19.4 + डाउनलोड +
+ +*** diff --git a/hi/origin/plazma/about/patches-list.md b/hi/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..40b779f0b --- /dev/null +++ b/hi/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Plazma में जोड़े गए सभी सुविधाओं के बारे में जानें। +--- + +# 📑 शामिल पैच diff --git a/hi/origin/plazma/about/supported-versions.md b/hi/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..d88d9b28a --- /dev/null +++ b/hi/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Plazma से समर्थित Minecraft: Java Edition संस्करण का पता लगाएं।" +--- + +# ✅ संस्करण समर्थन स्थिति + +{% hint style="info" %} + +**Plazma 1.19.4 के बाद से विकसित किया गया है, 1.19.4 से कम के संस्करण विकसित नहीं किए गए हैं।** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/रिलीज़%20प्रतीक्षा%20में +[idv]: https://badge.plazmamc.org/1/विकास-के-दौर-में +[atv]: https://badge.plazmamc.org/2/समर्थित +[fse]: https://badge.plazmamc.org/6/सुविधा-समर्थन-बंद +[eol]: https://badge.plazmamc.org/4/समर्थन-समाप्त +[ukn]: https://badge.plazmamc.org/0/정보%20없음 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/सामान्य +[100]: https://badge.plazmamc.org/percent/100 + +![रिलीज़ के लिए प्रतीक्षा में][wtr] ![विकास-के-दौर-में][idv] ![समर्थित][atv] ![सुविधा समर्थन बंद][fse] ![समर्थन समाप्त][eol] + +| संस्करण | स्थिरता और कार्यक्षमता समर्थन | निर्माण स्थिति | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![निर्माण स्थिति](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![निर्माण स्थिति](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![निर्माण स्थिति](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/hi/origin/plazma/administration/README.md b/hi/origin/plazma/administration/README.md new file mode 100644 index 000000000..01254694b --- /dev/null +++ b/hi/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma का उपयोग करके अपनी खुद की सर्वर बनाएं। +--- + +# ⚒️ सर्वर प्रबंधन गाइड diff --git a/hi/origin/plazma/administration/diagnosis/README.md b/hi/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..88578fafd --- /dev/null +++ b/hi/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: 문제가 발생했을 때 대처하는 방법을 जानें। +--- + +# 🧾 진단 diff --git a/hi/origin/plazma/administration/diagnosis/plugins.md b/hi/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..6309cfea5 --- /dev/null +++ b/hi/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: 플러그인이 सही ढंग से काम नहीं कर रहा है तो समस्या को कैसे ठीक करें के बारे में जानें। +--- + +# 📜 플러그인 diff --git a/hi/origin/plazma/administration/expert/README.md b/hi/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..0f99f01c9 --- /dev/null +++ b/hi/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma को व्यावसायिक ढंग से संभालने के तरीके के बारे में जानें। +--- + +# 🎓 गहन diff --git a/hi/origin/plazma/administration/expert/fix-exploits.md b/hi/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..9ca3374fb --- /dev/null +++ b/hi/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: जानिए विशिष्ट सुरक्षा गड़बड़ और उसका समाधान कैसे करें। +--- + +# ⚠️ जानी गई सुरक्षा गड़बड़ और समाधान का तरीका diff --git a/hi/origin/plazma/administration/expert/optimize.md b/hi/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..aa6ee2f4d --- /dev/null +++ b/hi/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma को अपने अवसर के लिए अनुकूलित करने के तरीके को जानें। +--- + +# 🧹 अनुकूलन diff --git a/hi/origin/plazma/administration/expert/proxy.md b/hi/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..119f6ae59 --- /dev/null +++ b/hi/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: 프록시 प्लेटफ़ॉर्म "वेलोसिटी" को सुरक्षित ढंग से कैसे सेटअप करें, इसके बारे में जानें। +--- + +# 🔀 프록시 diff --git a/hi/origin/plazma/administration/expert/vanillaize.md b/hi/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..07014d94d --- /dev/null +++ b/hi/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper और वेनिला के पैच को कैसे पुनर्स्थापित किया जाए इसके बारे में जानें। +--- + +# ↩️ वेनिलाईज़ + +{% hint style="warning" %} + +**पेपर은 वैनिला की त्रुटियों को हल करने के लिए अक्सर पैच में एक विकल्प नहीं जोड़ता है।** + +वर्तमान में, प्लाज़मा इस प्रकार की त्रुटियों को निष्क्रिय करने के लिए एक विन्यास विकसित कर रहा है। + +इसलिए यहाँ तक कि यह गाइड अभी लिखा जा रहा है और हमेशा जानकारी में परिवर्तन हो सकता है। + +{% endhint %} diff --git a/hi/origin/plazma/administration/expert/xray.md b/hi/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..da6f4391f --- /dev/null +++ b/hi/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray를 अवरुद्ध करने के कई आंतरिक तरीके जानें। +--- + +# 🩻 X-Ray अवरोध diff --git a/hi/origin/plazma/administration/faq.md b/hi/origin/plazma/administration/faq.md new file mode 100644 index 000000000..318f755f1 --- /dev/null +++ b/hi/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: 자주 묻는 질문에 대해 जानें। +--- + +# ⁉️ 자주 묻는 질문 + +{% hint style="info" %} + +**क्या आप चाहते हैं कि जवाब न मिला?** + +[공식 Discord सर्वर](https://discord.gg/MmfC52K8A8) या [GitHub चर्चाएँ](https://github.com/PlazmaMC/PlazmaBukkit/discussions) के माध्यम से समुदाय से सवाल पूछें! + +{% endhint %} + +### प्लाज़मा शुरू नहीं हो रहा है + +कंसोल में `no main manifest attribute, in plazma-(version).jar` दिखाई दे रहा है,\ +डाउनलोड किया गया फ़ाइल विकास संबंधी एपीआई फ़ाइल है, GitHub पेज से **Reobf Paperweight** को डाउनलोड करना चाहिए। + +अधिक जानने के लिए निम्नलिखित पेज का संदर्भ देखें। + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### सर्वर शुरू होते समय चेतावनी प्रदर्शित होती है + +Plazma में कुछ अस्थिर पैच शामिल हैं और हमेशा गड़बड़ी होने की संभावना है, इसलिए सर्वर शुरू होते समय यह चेतावनी संदेश प्रदर्शित कर रहा है। + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +इस चेतावनी संदेश को [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] सिस्टम गुण का उपयोग करके निषेधित किया जा सकता है। + +अधिक जानने के लिए निम्नलिखित पेज का संदर्भ देखें। + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1 से उपलब्ध diff --git a/hi/origin/plazma/administration/getting-started/README.md b/hi/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..ccbf8c480 --- /dev/null +++ b/hi/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Plazma सर्वर बनाने का तरीका जानें। +--- + +# 👟 शुरू करें + +Plazma का स्थिर उपयोग करने के लिए, सिस्टम को निम्नलिखित आवश्यकताओं को पूरा करना होगा। + +| | न्यूनतम | अनुशंसित | +| :-----------: | ------- | -------- | +| आर्किटेक्चर | x64 | - | +| रैम | 8GB | 16GB | +| स्टोरेज स्थान | 1GB | 8GB | +| JDK | 17 | 21 | + +सुविधाजनक संरचना फ़ाइल संशोधन के लिए, [Visual Studio Code](https://code.visualstudio.com/download) जैसे संपादक स्थापित करना भी उपयुक्त है। + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="सही आउटपुट" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. विकास + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +निम्नलिखित गाइड के माध्यम से सर्वर को व्यक्तिगत बनाने के तरीके पता लगाएं। + +{% content-ref url="अगला-कदम.md" %} +[अगला-कदम.md](अगला-कदम.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Microsoft Corporation. + +[^11]: 대한민국의 경우 게임산업진흥에 관한 법률 제32조 제1항 제9호에 따라 **한국 마이크로스프트 주식회사**에서 법적 고소를 할 수 있습니다. + +[^12]: Universal Plug & Play. Plazma में शामिल Purpur इस तकनीक के माध्यम से राउटर के साथ स्वत: संचार करता है और सर्वर केवल चल रहा है जब पोर्ट खोलने की आवश्यकता नहीं है, इसलिए, पोर्ट फॉरवर्डिंग की सीधी आवश्यकता नहीं है। + +[^13]: अकाउंट न होने की स्थिति में Google या GitHub अकाउंट का उपयोग करके Ngrok में साइन अप करें। diff --git a/hi/origin/plazma/administration/getting-started/customization.md b/hi/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..d06b20b67 --- /dev/null +++ b/hi/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: सर्वर को उपयोगकर्ता अनुकूलित करने के तरीके को जानें। +--- + +# 🎨 उपयोगकर्ता अनुकूलन + +Mojang Studios से प्रदान किए गए आधिकारिक सर्वर प्लेटफ़ॉर्म का उपयोग न करके +Plazma और वैसे ही संशोधित सर्वर प्लेटफ़ॉर्म का उपयोग करने का कारण है कि मजबूत +**उपयोगकर्ता अनुकूलन** संभव है। + +नीचे Plazma को उपयोगकर्ता अनुकूलित करने और उपयोग करने के कई तरीके हैं। + +## विन्यास संशोधन + +Plazma को उपयोगकर्ता अनुकूलित करने का सबसे मौलिक तरीका सीधे विन्यास को संशोधित करना है। + +Plazma गेम की मैकेनिक्स से लेकर मॉब की गुणवत्ता आदि तक मजबूत विन्यास सेटिंग प्रदान करता है। + +Plazma के विन्यास के बारे में विवरण के लिए नीचे पृष्ठ का संदर्भ देखें। + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## प्लगइन उपयोग + +{% hint style="success" %} + +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, +Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 +모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. +Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 +공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 +사이트에 업로드하기도 합니다. + +{% hint style="caution" %} + +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, +신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. + +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 + 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, + `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. + 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. + `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. + 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, +[리소스팩](#user-content-fn-1)[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="caution" %} + +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. + +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. +폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} + +**일부 [데이터팩](#user-content-fn-2)[^2]의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. + +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, +서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} + +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md) + +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. diff --git a/hi/origin/plazma/administration/getting-started/next-step.md b/hi/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..9f9bd6d16 --- /dev/null +++ b/hi/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: सर्वर को उपयोगकर्ता अनुकूलित करने के तरीके को जानें। +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +नीचे Plazma को उपयोगकर्ता अनुकूलित करने और उपयोग करने के कई तरीके हैं। + +## विन्यास संशोधन + +Plazma को उपयोगकर्ता अनुकूलित करने का सबसे मौलिक तरीका सीधे विन्यास को संशोधित करना है। + +Plazma गेम की मैकेनिक्स से लेकर मॉब की गुणवत्ता आदि तक मजबूत विन्यास सेटिंग प्रदान करता है। + +Plazma के विन्यास के बारे में विवरण के लिए नीचे पृष्ठ का संदर्भ देखें। + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## प्लगइन उपयोग + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. 폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +## 최적화 + +Plazma에는 많은 최적화 패치가 적용되어 있습니다. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 프록시 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +안전하고 올바른 프록시 설정에 대한 정보는 아래 페이지를 참고하세요. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 안전 + +Minecraft는 모드가 발달하여 온라인에서도 쉽게 [취약점 공격 엔진](#user-content-fn-3)[^3]을 구할 수 있습니다. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 권한 설정 + +일부 플러그인의 관리자 명령어는 권한이 제대로 설정되지 않은 취약점이 존재하기도 합니다. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray 차단 + +X-Ray는 기본적인 최적화 클라이언트에서도 쉽게 사용 가능한 취약점 중 하나입니다. + +Plazma에는 X-Ray를 기본적으로 차단할 수 있는 구성을 제공하고 있습니다. + +X-Ray 차단 방법과 설명은 아래 페이지를 참고하시기 바랍니다. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 화이트리스트 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +접속이 허용된 플레이어를 보려면 `/whitelist query` 를 사용합니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. + +[^3]: 일반적으로 "핵" 으로 불립니다. + +[^4]: 구성이 최적화되지 않았거나, Plazma가 오래되었거나, 새로 발견된 취약점의 경우 차단되어 있지 않을 수 있습니다. + +[^5]: 플레이어가 서버에 접속할 때 Ngrok 프록시 서버를 통해 접속되며, 매 재시작마다 발급되는 Ngrok 주소는 달라집니다. diff --git a/hi/origin/plazma/administration/reference/README.md b/hi/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..2257174cb --- /dev/null +++ b/hi/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Plazma में प्रदान किए गए उपयोगकर्ता समायोजन के तरीके का पता लगाएं। +--- + +# 📜 리퍼런스 + +Plazma में कई उपयोगकर्ता समायोजन तरीके उपलब्ध हैं। + +उनमें से, नीचे दिए गए 4 तरीके बिना किसी अतिरिक्त काम के सीधे उपयोग के लिए उपयोगकर्ता समायोजन तरीके हैं। + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[공식 Discord सर्वर](https://discord.gg/MmfC52K8A8) या [GitHub चर्चाएँ](https://github.com/PlazmaMC/PlazmaBukkit/discussions) के माध्यम से समुदाय से सवाल पूछें! +{% endhint %} + +*** + +## 🖥️ कमांड + +> कमांड गेम में जानकारी एकत्र करने या खेल वातावरण को उपयोगकर्ता समायोजित करने की अनुमति देता है। + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ अनुमति + +> अनुमति खिलाड़ी की संवादात्मक सीमा को निर्धारित करती है। + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ पैरामीटर और गुण + +> पैरामीटर और गुण Plazma के काम को समग्र रूप से प्रभावित करते हैं। + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 विन्यास + +> विन्यास Plazma को समायोजित करने का सबसे मौलिक तरीका है। + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/hi/origin/plazma/administration/reference/arguments.md b/hi/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..cd8f93f90 --- /dev/null +++ b/hi/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +शुरू एन्ट्री और सिस्टम विशेषताएँ Plazma एक्सीक्यूशन में [उपयोग किया जाने वाले कमांड](#user-content-fn-1)[^1] के साथ जोड़ी गई मान हैं, जो Plazma के परिचालन पर सामान्य प्रभाव डालती हैं। + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 आधारित है और **प्रारंभ विन्यास** और **सिस्टम गुण** में विभाजित हो जाता है। + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +यदि कोई मान नहीं दिया गया है तो मान [`true` के रूप में निर्धारित](#user-content-fn-3)[^3] होगा। + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **형태**: `Boolean` +- **기본값**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **형태**: `Boolean` +- **기본값**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **형태**: `Boolean` +- **기본값**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **형태**: `Boolean` +- **기본값**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **형태**: `Boolean` +- **기본값**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **형태**: `Boolean` +- **기본값**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **형태**: `Boolean` +- **기본값**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **형태**: `Boolean` +- **기본값**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **형태**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **형태**: `Boolean` +- **기본값**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **형태**: `Boolean` +- **기본값**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **형태**: `Boolean` +- **기본값**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **형태**: `Boolean` +- **기본값**: `False` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **형태**: `Boolean` +- **기본값**: `False` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` +- **संघर्ष**: `Plazma.disableConfigOptimization` + +प्रारंभिक विन्यास को अधिक महत्वपूर्ण बनाता है। + +यह सक्षम करने से सर्वर और सुरक्षित हो जाता है, लेकिन खेलने पर बड़ा प्रभाव पड़ सकता है। + +#### `Plazma.disableConfigOptimization` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` +- **संघर्ष**: `Plazma.aggressiveOptimize` + +प्रारंभिक विन्यास को अधिक महत्वपूर्ण नहीं बनाता। + +यह Paper का डिफ़ॉल्ट विन्यास प्रयोग करता है। + +#### `Plazma.iKnowWhatIAmDoing` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **प्रपत्र**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +Plazma ब्रांडिंग को निष्क्रिय कर देता है और वनिला डिफ़ॉल्ट सर्वर फ़ेविकॉन का प्रयोग करता है। + +#### `Plazma.useVanillaConfiguration` + +- **प्रपत्र**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` +- **संघर्ष**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +यह सर्वर सुरक्षा और प्रदर्शन पर बड़ा प्रभाव डाल सकती है। + +इस गुणवत्ता से होने वाली सभी समस्याएँ सर्वर प्रबंधक के पास हैं। +{% endhint %} + +प्रारंभिक विन्यास को मोजैंग द्वारा प्रदान की गई मूल्यों के रूप में प्रदान करता है। + +यह Paper द्वारा लागू किए गए सभी सुरक्षा दोषों को निष्क्रिय करता है। + +सुरक्षा दोषों को सक्रिय करने के लिए Paper विन्यास या Plazma विन्यास से समर्थन किया जा सकता है। + +#### `Plazma.vanillaize` + +- **प्रपत्र**: `बूलियन` +- **डिफ़ॉल्ट**: `true` +- **संघर्ष**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +प्रारंभिक विन्यास को वनिला के करीब सेट करता है। + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **प्रपत्र**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **उपनाम**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **उपनाम**: `c` +- **기본값**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(अद्यतन मोड) पूर्ण वनिला स्थिति में सर्वर शुरू करें। + +#### `server-ip` + +- **उपनाम**: `h`, `host` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **उपनाम**: `p`, `port` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +सर्वर का पोर्ट सेट करें। + +#### `server-name` + +- **डिफ़ॉल्ट**: `A Plazma Server` + +सर्वर का नाम सेट करें। + +#### `spigot-settings` + +- **उपनाम**: `S` +- **डिफ़ॉल्ट**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **उपनाम**: `v` + +Plazma संस्करण को प्रिंट करें। + +#### `world-dir` + +- **उपनाम**: `W`, `ब्रह्मांड`, `विश्व-कंटेनर` +- **डिफ़ॉल्ट**: `(सर्वर फ़ोल्डर)` + +जहां वर्ल्ड फ़ाइल सहेजी जाती है, उस स्थान को सेट करता है। + +#### `विश्व-नाम` + +- **उपनाम**: `w`, `विश्व` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +वर्ल्ड फ़ाइल का नाम सेट करता है। + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: अनुसार जोड़ने के स्थान पर प्राप्त आव्यूह को प्रोसेस करने के स्थान में परिवर्तित हो जाता है। + +[^3]: उदाहरण के लिए, `Plazma.iKnowWhatIAmDoing` को सच करने (सक्रिय) के लिए, `-DPlazma.iKnowWhatIAmDoing=true` की बजाय `-DPlazma.iKnowWhatIAmDoing` केवल इनपुट करने से भी वैसे ही काम करेगा। + +[^4]: उदाहरण के लिए, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: घटना डिटेक्टर। + +[^6]: घटना डिटेक्टर। + +[^7]: ग्राहक। + +[^8]: सर्वर के साथ सही रूप से कनेक्ट होने की संकेत देने वाला धड़कने जैसा संकेत। + +[^9]: Purpur की AFK बाहर निकालने की क्षमता के उपयोग से गैर-हाजिर खिलाड़ी को भी बाहर निकाला जा सकता है। + +[^10]: सिंक चंक राइट प्रणाली, सिंक चंक लेखन प्रणाली। + +[^11]: \`चेतावनी! प्लाज्मा अप्रत्याशित समस्याएं पैदा कर सकता है, इसलिए सार्वजनिक सर्वर पर उसका उपयोग करने से पहले इसे ठीक से जांच लें। + +[^12]: गेम में `वर्ल्ड ऑप्टिमाइजेशन` इसी तरह से काम करता है। + +[^13]: `स्तर 2` से ऊपर के प्रबंधकों को छोड़कर। + +[^14]: इंटरनेट प्रोटोकॉल, आईपी। diff --git a/hi/origin/plazma/administration/reference/commands.md b/hi/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..90bfe5eb7 --- /dev/null +++ b/hi/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma में उपयोग के लिए उपलब्ध कमांडों के बारे में जानें। +--- + +# 🖥️ कमांड diff --git a/hi/origin/plazma/administration/reference/configurations/README.md b/hi/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..bf809b311 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: विन्यास Plazma को समायोजित करने का सबसे मौलिक तरीका है। +--- + +# 🧾 구성 + +*** + +## 🪨 गुणधर्म + +> गुणधर्म Minecraft में प्रदान की जाने वाली सबसे मौलिक व्यवस्था फ़ाइल है। गुणधर्म का उपयोग करके आप गेम की मौलिक मेकेनिज़्म को बदल सकते हैं। + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit व्यवस्था + +> Bukkit व्यवस्था Plazma द्वारा प्रदान की जाने वाली सबसे मौलिक व्यवस्था फ़ाइल है। Bukkit व्यवस्था का उपयोग करके आप Minecraft सर्वर की मौलिक मेकेनिज़्म को बदल सकते हैं। + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot व्यवस्था + +> Spigot व्यवस्था गेम के विस्तृत मेकेनिज़्म, खिलाड़ी प्रोसेसिंग, कमांड्स आदि को संशोधित करने की अनुमति देती है। + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper व्यवस्था + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish व्यवस्था Plazma के वर्ल्ड और एंटिटी की प्रोसेसिंग को बदलने की अनुमति देती है। + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur व्यवस्था + +> Purpur गुणधर्म गेम के सार्वभौमिक मूल डेटा को संशोधित करने की अनुमति देता है। + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma व्यवस्था + +> Plazma व्यवस्था Plazma की सुविधाओं को व्यक्तिगत बनाने की अनुमति देती है। + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/hi/origin/plazma/administration/reference/configurations/bukkit.md b/hi/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f6bfe5cb0 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🪣 Bukkit diff --git a/hi/origin/plazma/administration/reference/configurations/paper/README.md b/hi/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..39e7b7a45 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: कॉन्फ़िग फ़ोल्डर में प्रत्येक फ़ाइल का उद्देश्य क्या है, इसे जांचें। +--- + +# 🛩️ कागज diff --git a/hi/origin/plazma/administration/reference/configurations/paper/global.md b/hi/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..2a8616caa --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: पेपर-ग्लोबल.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🌏 전역 구성 diff --git a/hi/origin/plazma/administration/reference/configurations/paper/world.md b/hi/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f65aff19b --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: paper-world.yml के प्रत्येक नोड का क्या मतलब है, इसे जांचें। +--- + +# 🏳️ 세계별 구성 + +विश्वभर diff --git a/hi/origin/plazma/administration/reference/configurations/plazma/README.md b/hi/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..53b80f920 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: कॉन्फ़िग फ़ोल्डर में प्रत्येक फ़ाइल का उद्देश्य क्या है, इसे जांचें। +--- + +# ✨ प्लाज्मा diff --git a/hi/origin/plazma/administration/reference/configurations/plazma/global.md b/hi/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f6f641fec --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🌏 전역 구성 diff --git a/hi/origin/plazma/administration/reference/configurations/plazma/world.md b/hi/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..78a0d4334 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🏳️ 세계별 구성 diff --git a/hi/origin/plazma/administration/reference/configurations/plazma/worlds.md b/hi/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..93d421fe4 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# ✨ Plazma (वर्ल्ड वाइज़ संरचना) diff --git a/hi/origin/plazma/administration/reference/configurations/property.md b/hi/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..caf3d3bd9 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🪨 Server.properties diff --git a/hi/origin/plazma/administration/reference/configurations/pufferfish.md b/hi/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..6a4123a65 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🐡 पफरफिश diff --git a/hi/origin/plazma/administration/reference/configurations/purpur/README.md b/hi/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..60c35c099 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: पुरपुर.yml के प्रत्येक नोड का क्या मतलब है, यह जानें। +--- + +# 🦑 पुरपुर diff --git a/hi/origin/plazma/administration/reference/configurations/purpur/global.md b/hi/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..7992b614c --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: पुरपुर.yml के प्रत्येक नोड का क्या मतलब है, यह जानें। +--- + +# 🌏 전역 구성 diff --git a/hi/origin/plazma/administration/reference/configurations/purpur/world.md b/hi/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..3bcbefa07 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: पुरपुर.yml के प्रत्येक नोड का क्या मतलब है, यह जानें। +--- + +# 🏳️ 세계별 구성 diff --git a/hi/origin/plazma/administration/reference/configurations/spigot.md b/hi/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..d62629417 --- /dev/null +++ b/hi/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🚰 स्पिगॉट diff --git a/hi/origin/plazma/administration/reference/permissions.md b/hi/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..b62bf75a2 --- /dev/null +++ b/hi/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Plazma की अनुमतियों के बारे में जानें। +--- + +# 🛡️ अनुमति + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **[Purpur विश्वव्यापी कॉन्फ़िगरेशन](configurations/purpur/world.md) में `(Entity) > ridable` को सक्षम किया गया है तो काम करेगा।** + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +अनुमति नाम के पीछे `.अन्य` लिखने से अन्य खिलाड़ियों को उपयोग करने की अनुमति दी जाती है। + +#### `bukkit.command.demo` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +अनुमति नाम के पीछे `.अन्य` लिखने से अन्य खिलाड़ियों को उपयोग करने की अनुमति दी जाती है। + +#### `bukkit.command.ping` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +अनुमति नाम के पीछे `.अन्य` लिखने से अन्य खिलाड़ियों को उपयोग करने की अनुमति दी जाती है। + +#### `bukkit.command.restart` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +अनुमति नाम के पीछे `.अन्य` लिखने से अन्य खिलाड़ियों को उपयोग करने की अनुमति दी जाती है। + +#### `bukkit.command.timings` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +अनुमति नाम के पीछे `.अन्य` लिखने से अन्य खिलाड़ियों को उपयोग करने की अनुमति दी जाती है। + +#### `paper.antixray.bypass` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **डिफ़ॉल्ट प्रदान**: `विश्व प्रबंधक` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +इन्वेंटरी में अंडाइंग का टोटेम होने पर उसके काम करने की अनुमति देता है। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +खिलाड़ी को जुड़े खिलाड़ियों की सीमा को नजरअंदाज करने की अनुमति देता है। + +#### `purpur.mending_shift_click` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +खिलाड़ी को `झुककर संवाद` करने पर उसके पास रखे गए आइटम को मरम्मत करने की अनुमति देता है। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +खिलाड़ी को स्पॉनर स्थापित करने की अनुमति देता है। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +खिलाड़ी को नेदर पोर्टल का उपयोग करते समय सीधे तत्काल टेलीपोर्ट करने की अनुमति देता है। + +#### `purpur.sign.color` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +साइनबोर्ड पर जादूगर कोड`(&o)` का उपयोग करने की अनुमति देता है। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +खिलाड़ी को कैंची से `संवाद` करके टीएनटी विस्फोट को रोकने की अनुमति देता है। + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### प्रदान की जाने वाली अनुमति + +#### `plazma.bypass.ncr-require` + +- **डिफ़ॉल्ट प्रदान**: `अभाव` + +खिलाड़ी को [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) मोड स्थापित न होने पर भी जुड़ने की अनुमति देता है। + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: ऑपरेटर। + +[^2]: उदाहरण: `ender_dragon` diff --git a/hi/origin/plazma/adminstration/README.md b/hi/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..01254694b --- /dev/null +++ b/hi/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma का उपयोग करके अपनी खुद की सर्वर बनाएं। +--- + +# ⚒️ सर्वर प्रबंधन गाइड diff --git a/hi/origin/plazma/adminstration/expert/README.md b/hi/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..0f99f01c9 --- /dev/null +++ b/hi/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma को व्यावसायिक ढंग से संभालने के तरीके के बारे में जानें। +--- + +# 🎓 गहन diff --git a/hi/origin/plazma/adminstration/expert/fix-exploits.md b/hi/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..9ca3374fb --- /dev/null +++ b/hi/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: जानिए विशिष्ट सुरक्षा गड़बड़ और उसका समाधान कैसे करें। +--- + +# ⚠️ जानी गई सुरक्षा गड़बड़ और समाधान का तरीका diff --git a/hi/origin/plazma/adminstration/expert/optimize.md b/hi/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..aa6ee2f4d --- /dev/null +++ b/hi/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma को अपने अवसर के लिए अनुकूलित करने के तरीके को जानें। +--- + +# 🧹 अनुकूलन diff --git a/hi/origin/plazma/adminstration/expert/vanillaize.md b/hi/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..3fb847174 --- /dev/null +++ b/hi/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper और वेनिला के पैच को कैसे पुनर्स्थापित किया जाए इसके बारे में जानें। +--- + +# ↩️ वेनिलाईज़ + +{% hint style="warning" %} + +### पेपर वेनिला की त्रुटियों को हल करने के लिए अधिकांश पैच में एक विकल्प नहीं जोड़ता है। + +वर्तमान में, प्लाज़मा इस प्रकार की त्रुटियों को निष्क्रिय करने के लिए एक विन्यास विकसित कर रहा है। + +इसलिए यहाँ तक कि यह गाइड अभी लिखा जा रहा है और हमेशा जानकारी में परिवर्तन हो सकता है। +{% endhint %} diff --git a/hi/origin/plazma/adminstration/faq.md b/hi/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..427d2d8d8 --- /dev/null +++ b/hi/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: 자주 묻는 질문에 대해 जानें। +--- + +# ⁉️ 자주 묻는 질문 + +{% hint style="info" %} + +### वांछित उत्तर नहीं मिल रहा है? + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) या [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) के माध्यम से समुदाय से प्रश्न पूछें! +{% endhint %} + +### मैसेज दिखा कर कार्रवाई नहीं हो रही है + +कंसोल में `no main manifest attribute, in plazma-(version).jar` दिखाई दे रहा है,\ +डाउनलोड किया गया फ़ाइल विकास संबंधी एपीआई फ़ाइल है, GitHub पेज से **Reobf Paperweight** को डाउनलोड करना चाहिए। + +अधिक जानने के लिए निम्नलिखित पेज का संदर्भ देखें। + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### सर्वर शुरू होते समय चेतावनी प्रदर्शित होती है + +Plazma में कुछ अस्थिर पैच शामिल हैं और हमेशा गड़बड़ी होने की संभावना है, इसलिए सर्वर शुरू होते समय यह चेतावनी संदेश प्रदर्शित कर रहा है। + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +इस चेतावनी संदेश को [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] सिस्टम गुण का उपयोग करके निषेधित किया जा सकता है। + +अधिक जानने के लिए निम्नलिखित पेज का संदर्भ देखें। + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1 से उपलब्ध diff --git a/hi/origin/plazma/adminstration/getting-started/README.md b/hi/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..42bcb0a3d --- /dev/null +++ b/hi/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Plazma सर्वर बनाने का तरीका जानें। +--- + +# 👟 शुरू करें + +Plazma का स्थिर उपयोग करने के लिए, सिस्टम को निम्नलिखित आवश्यकताओं को पूरा करना होगा। + +| | न्यूनतम | अनुशंसित | +| :-----------: | ------: | -------: | +| आर्किटेक्चर | x64 | - | +| रैम | 8GB | 16GB | +| स्टोरेज स्थान | 1GB | 8GB | +| JRE | 17 | 21 | + +सुविधाजनक संरचना फ़ाइल संशोधन के लिए, [Visual Studio Code](https://code.visualstudio.com/download) जैसे संपादक स्थापित करना भी उपयुक्त है। + +*** + +## 1. JRE स्थापित करें + +नाम से ही पता चलता है कि Minecraft: **"Java"** Edition Java में विकसित है, और इसे चलाने के लिए JRE[^1] की आवश्यकता है। + +Plazma Mojang Studios के आधिकारिक सर्वर प्लेटफ़ॉर्म पर [आधारित हैं](#user-content-fn-2)[^2], इसलिए Plazma का उपयोग करने के लिए JRE की स्थापना आवश्यक है। + +### 1.1 JRE की उपस्थिति की जांच + +यदि JRE सिस्टम में स्थापित है, तो [चलाएं](#user-content-fn-3) [`cmd /k java --version`](#user-content-fn-4)[^4] और चलाएं। + +यदि निम्नलिखित प्रकार से प्रिंट होता है, तो [2 चरण](setup.md#id-2) पर जाएं। + +{% code title="सही प्रिंट" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +यदि ऐसा प्रिंट नहीं होता है, या नीचे दिए गए प्रकार से प्रिंट होता है, तो JRE उपलब्ध नहीं है या बहुत पुराना है, तो [1.2 चरण](setup.md#id-1.2) का पालन करें। + +{% code title="JRE स्थापित नहीं है" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE가 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +본 가이드에서는 JRE의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](setup.md#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Microsoft Corporation. + +[^11]: 대한민국의 경우 게임산업진흥에 관한 법률 제32조 제1항 제9호에 따라 **한국 마이크로스프트 주식회사**에서 법적 고소를 할 수 있습니다. + +[^12]: Universal Plug & Play. Plazma में शामिल Purpur इस तकनीक के माध्यम से राउटर के साथ स्वत: संचार करता है और सर्वर केवल चल रहा है जब पोर्ट खोलने की आवश्यकता नहीं है, इसलिए, पोर्ट फॉरवर्डिंग की सीधी आवश्यकता नहीं है। + +[^13]: अकाउंट न होने की स्थिति में Google या GitHub अकाउंट का उपयोग करके Ngrok में साइन अप करें। diff --git a/hi/origin/plazma/adminstration/getting-started/customization.md b/hi/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..f208851a2 --- /dev/null +++ b/hi/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: सर्वर को उपयोगकर्ता अनुकूलित करने के तरीके को जानें। +--- + +# 🎨 उपयोगकर्ता अनुकूलन diff --git a/hi/origin/plazma/adminstration/reference/arguments.md b/hi/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..a3ffe5adb --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **형태**: `Boolean` +- **기본값**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **형태**: `Boolean` +- **기본값**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **형태**: `Boolean` +- **기본값**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **형태**: `Boolean` +- **기본값**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **형태**: `Boolean` +- **기본값**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **형태**: `Boolean` +- **기본값**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **형태**: `Boolean` +- **기본값**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **형태**: `Boolean` +- **기본값**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **형태**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **형태**: `Boolean` +- **기본값**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **형태**: `Boolean` +- **기본값**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **형태**: `Boolean` +- **기본값**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **형태**: `Boolean` +- **기본값**: `False` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **형태**: `Boolean` +- **기본값**: `False` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +{% hint style="warning" %} + +### 해당 속성은 1.20.5 이후 시작 인수로 이동 될 예정입니다. + +{% endhint %} + +처음 시작시 적용되는 구성 최적화를 더 엄격하게 적용합니다. + +활성화 하면 서버가 더욱 빨라지고 안전해지지만, 일부 기믹을 차단하거나 게임 플레이에 큰 영향을 줄 수 있습니다. + +#### `Plazma.iKnowWhatIAmDoing` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **रूप**: `बूलियन` +- **डिफ़ॉल्ट**: `झूठ` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **उपनाम**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **उपनाम**: `c` +- **기본값**: `server.properties` + +[서버 속성](../reference/configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 [업그레이드](#user-content-fn-12)[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +허용되는 최대 [플레이어](#user-content-fn-14)[^14] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우 [EULA](../getting-started/README.md#id-5) 위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용이 중지되었습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(अद्यतन मोड) पूर्ण वनिला स्थिति में सर्वर शुरू करें। + +#### `server-ip` + +- **उपनाम**: `h`, `host` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +सर्वर के होस्ट नाम या [इंटरनेट प्रोटोकॉल](#user-content-fn-13)[^13] पता सेट करें। + +#### `server-port` + +- **उपनाम**: `p`, `port` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +सर्वर का पोर्ट सेट करें। + +#### `server-name` + +- **डिफ़ॉल्ट**: `A Plazma Server` + +सर्वर का नाम सेट करें। + +#### `spigot-settings` + +- **उपनाम**: `S` +- **डिफ़ॉल्ट**: `spigot.yml` + +[Spigot विन्यास फ़ाइल](../reference/configurations/spigot.md) का नाम और स्थान सेट करें। + +#### `version` + +- **उपनाम**: `v` + +Plazma संस्करण को प्रिंट करें। + +#### `world-dir` + +- **उपनाम**: `W`, `ब्रह्मांड`, `विश्व-कंटेनर` +- **डिफ़ॉल्ट**: `(सर्वर फ़ोल्डर)` + +जहां वर्ल्ड फ़ाइल सहेजी जाती है, उस स्थान को सेट करता है। + +#### `विश्व-नाम` + +- **उपनाम**: `w`, `विश्व` +- **डिफ़ॉल्ट**: `(सर्वर गुणवत्ता)` + +वर्ल्ड फ़ाइल का नाम सेट करता है। + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: अनुसार जोड़ने के स्थान पर प्राप्त आव्यूह को प्रोसेस करने के स्थान में परिवर्तित हो जाता है। + +[^3]: उदाहरण के लिए, `Plazma.iKnowWhatIAmDoing` को सच करने (सक्रिय) के लिए, `-DPlazma.iKnowWhatIAmDoing=true` की बजाय `-DPlazma.iKnowWhatIAmDoing` केवल इनपुट करने से भी वैसे ही काम करेगा। + +[^4]: उदाहरण के लिए, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: घटना डिटेक्टर। + +[^6]: घटना डिटेक्टर। + +[^7]: ग्राहक। + +[^8]: सर्वर के साथ सही रूप से कनेक्ट होने की संकेत देने वाला धड़कने जैसा संकेत। + +[^9]: Purpur की AFK बाहर निकालने की क्षमता के उपयोग से गैर-हाजिर खिलाड़ी को भी बाहर निकाला जा सकता है। + +[^10]: सिंक चंक राइट प्रणाली, सिंक चंक लेखन प्रणाली। + +[^11]: \`चेतावनी! प्लाज्मा अप्रत्याशित समस्याएं पैदा कर सकता है, इसलिए सार्वजनिक सर्वर पर उसका उपयोग करने से पहले इसे ठीक से जांच लें। + +[^12]: गेम में `वर्ल्ड ऑप्टिमाइजेशन` इसी तरह से काम करता है। + +[^13]: इंटरनेट प्रोटोकॉल, आईपी। + +[^14]: `स्तर 2` से ऊपर के प्रबंधकों को छोड़कर। diff --git a/hi/origin/plazma/adminstration/reference/commands.md b/hi/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..90bfe5eb7 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma में उपयोग के लिए उपलब्ध कमांडों के बारे में जानें। +--- + +# 🖥️ कमांड diff --git a/hi/origin/plazma/adminstration/reference/configurations/bukkit.md b/hi/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f6bfe5cb0 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🪣 Bukkit diff --git a/hi/origin/plazma/adminstration/reference/configurations/paper/README.md b/hi/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..39e7b7a45 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: कॉन्फ़िग फ़ोल्डर में प्रत्येक फ़ाइल का उद्देश्य क्या है, इसे जांचें। +--- + +# 🛩️ कागज diff --git a/hi/origin/plazma/adminstration/reference/configurations/paper/global.md b/hi/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..d3917bc7f --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: पेपर-ग्लोबल.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🛩️ पेपर (ग्लोबल कॉन्फ़िगरेशन) diff --git a/hi/origin/plazma/adminstration/reference/configurations/paper/world.md b/hi/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..eb877bfad --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: paper-world.yml के प्रत्येक नोड का क्या मतलब है, इसे जांचें। +--- + +# 🛩️ कागज (वर्ल्ड वाइस संरचना) diff --git a/hi/origin/plazma/adminstration/reference/configurations/plazma/README.md b/hi/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..53b80f920 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: कॉन्फ़िग फ़ोल्डर में प्रत्येक फ़ाइल का उद्देश्य क्या है, इसे जांचें। +--- + +# ✨ प्लाज्मा diff --git a/hi/origin/plazma/adminstration/reference/configurations/plazma/global.md b/hi/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..07180ce1f --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# ✨ Plazma (ग्लोबल कॉन्फ़िगरेशन) diff --git a/hi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/hi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..baed8622c --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ वर्ल्ड वाइड कॉम्पोज़िशन diff --git a/hi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/hi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..93d421fe4 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# ✨ Plazma (वर्ल्ड वाइज़ संरचना) diff --git a/hi/origin/plazma/adminstration/reference/configurations/property.md b/hi/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..caf3d3bd9 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🪨 Server.properties diff --git a/hi/origin/plazma/adminstration/reference/configurations/pufferfish.md b/hi/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..6a4123a65 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🐡 पफरफिश diff --git a/hi/origin/plazma/adminstration/reference/configurations/purpur/README.md b/hi/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..60c35c099 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: पुरपुर.yml के प्रत्येक नोड का क्या मतलब है, यह जानें। +--- + +# 🦑 पुरपुर diff --git a/hi/origin/plazma/adminstration/reference/configurations/purpur/global.md b/hi/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..d2390d809 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: पुरपुर.yml के प्रत्येक नोड का क्या मतलब है, यह जानें। +--- + +# 🦑 पर्पल (ग्लोबल संरचना) diff --git a/hi/origin/plazma/adminstration/reference/configurations/purpur/world.md b/hi/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..9889298a2 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: पुरपुर.yml के प्रत्येक नोड का क्या मतलब है, यह जानें। +--- + +# 🦑 पर्पर (वर्ल्ड वायरल कंपोजिशन) diff --git a/hi/origin/plazma/adminstration/reference/configurations/spigot.md b/hi/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..d62629417 --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml के प्रत्येक नोड का क्या मतलब है, उसे जांचें। +--- + +# 🚰 स्पिगॉट diff --git a/hi/origin/plazma/adminstration/reference/permissions.md b/hi/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..baa742c6d --- /dev/null +++ b/hi/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Plazma की अनुमतियों के बारे में जानें। +--- + +# 🛡️ अनुमति diff --git a/hi/origin/plazma/developers.md b/hi/origin/plazma/developers.md new file mode 100644 index 000000000..0af7145ff --- /dev/null +++ b/hi/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Plazma का उपयोग करके थर्ड पार्टी परियोजनाओं का विकास करें। +--- + +# ⚙️ डेवलपर गाइड diff --git a/hi/origin/thunderbolt/README.md b/hi/origin/thunderbolt/README.md new file mode 100644 index 000000000..6a8614170 --- /dev/null +++ b/hi/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 패치를 Flavor로 구분하여 직접 사용해볼 수 있도록 하는 Plazma के आधार पर सर्वर प्लेटफ़ॉर्म है। +--- + +# 🌩️ Thunderbolt Usage Guide diff --git a/hi/origin/volt/README.md b/hi/origin/volt/README.md new file mode 100644 index 000000000..c2b825353 --- /dev/null +++ b/hi/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Paperweight सर्वर प्लेटफ़ॉर्म विकसित करने के लिए ओपन सोर्स टेम्पलेट है। +--- + +# ⚡ Volt Development Guide diff --git a/hr/origin/README.md b/hr/origin/README.md new file mode 100644 index 000000000..8e77dd36e --- /dev/null +++ b/hr/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Ako imate pitanja, slobodno postavite pitanje putem Discorda ili GitHub rasprava. +--- + +# 🏠 Dobrodošli na portal za dokumentaciju + +{% hint style="info" %} + +**Dokumentacija Plazme trenutno je prevedena strojno.** + +[![Status prijevoda](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Uključite se u prevođenje dokumenata na [https://translate.plazmamc.org/](https://translate.plazmamc.org/) i poboljšajte dokumente. + +{% endhint %} + +### Ako imate problema tijekom korištenja Plazme? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Jeste li zainteresirani za Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Želite li stvoriti vlastitu serversku platformu pomoću Volta? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONZOR` Trebate li više informacija o Minecraftu? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/hr/origin/SUMMARY.md b/hr/origin/SUMMARY.md new file mode 100644 index 000000000..27eb27361 --- /dev/null +++ b/hr/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Sadržaj + +- [🏠 Dobrodošli u portal za dokumentaciju](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Dokumentacija o korištenju](plazma/README.md) +- [❓ Što je Plazma?](plazma/about/README.md) + - [⬇️ Preuzimanje](plazma/about/downloads.md) + - [✅ Podržane verzije](plazma/about/supported-versions.md) +- [⚒️ Uputstvo za upravljanje serverom](plazma/administration/README.md) + - [👟 Početak](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referenca](plazma/administration/reference/README.md) + - [🖥️ Naredbe](plazma/administration/reference/commands.md) + - [🛡️ Dozvole](plazma/administration/reference/permissions.md) + - [🎛️ Argumenti i svojstva](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Svojstvo](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globalna konfiguracija](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfiguracije po svijetima](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globalna konfiguracija](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfiguracije po svijetima](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globalna konfiguracija](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfiguracije po svijetima](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Napredno](plazma/administration/expert/README.md) + - [🧹 Optimizacija](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanilizacija](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray blokada](plazma/administration/expert/xray.md) + - [⚠️ Ranjivosti i rješenja](plazma/administration/expert/fix-exploits.md) + - [⁉️ Često postavljana pitanja](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Vodič za razvojne programere](plazma/developers.md) + - [✏️ Doprinijeti](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Vodič za korištenje Thunderbolta](thunderbolt/README.md) + +## Volt + +- [⚡ Vodič za razvoj Volta](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Preuzmi sve](plazma/about/downloads-all.md) diff --git a/hr/origin/miscellaneous/README.md b/hr/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/hr/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/hr/origin/plazma/README.md b/hr/origin/plazma/README.md new file mode 100644 index 000000000..1ec9bd26f --- /dev/null +++ b/hr/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma je otvorena platforma za poslužitelje za Minecraft: Java Edition koja kombinira eksperimentalnu optimizaciju temeljenu na papiru i prilagodljive mehanike igara." +--- + +# ✨ Plazma Upute za Korištenje + +## 👋 Dobrodošli u Plazma Upute + +Dobrodošli u Plazma Upute za Korištenje! + +{% hint style="info" %} + +**Možete li riješiti problem putem uputa?** + +[Službeni Discord poslužitelj](https://discord.gg/MmfC52K8A8) ili pitajte zajednicu putem [GitHub rasprava](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### O Plazmi + +> Saznajte više o platformi Plazma za poslužitelje. + +{% content-ref url="about/" %} +[o nama](about/) +{% endcontent-ref %} + +### Za Administratora + +> Iskoristite Plazmu za stvaranje vlastitog poslužitelja. + +{% content-ref url="administration/" %} +[administracija](administration/) +{% endcontent-ref %} + +### Za Developeri + +> Iskoristite Plazmu za razvoj projekata trećih strana. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/hr/origin/plazma/about/README.md b/hr/origin/plazma/about/README.md new file mode 100644 index 000000000..991b19dbf --- /dev/null +++ b/hr/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Saznajte više o platformi Plazma za poslužitelje. +--- + +# ❓ Što je Plazma? + +- **Plazma** je server platforma temeljena na [Paper](https://github.com/PaperMC/Paper) koja samo uzima prednosti iz [Andromeda](https://github.com/EarendelArchived/Andromeda) i [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Uvijek se trudimo pružiti visoku stabilnost, snažne performanse, brze nadogradnje i obilje značajki. + +## 📋 Ciljevi Plazme + +- Trudimo se postati server platforma s brzim nadogradnjama i visokom stabilnošću. +- Trudimo se pružiti obilje značajki i snažne performanse poput platforme za modove. +- Trudimo se stvoriti slobodnu platformu koja omogućava prilagodbu i patcheve vanilije. + +## ⚙️ Glavne značajke + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Najbrže nadogradnje**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) osigurava da zakrpe uključene u Plazmu uvijek budu ažurirane, pružajući tako najbrže nadogradnje među svim server platformama temeljenim na Paperu. +6. **Optimizirane osnovne konfiguracijske datoteke**\ + Osnovne konfiguracijske datoteke su optimizirane, stoga nije potrebno ručno optimizirati konfiguraciju. +7. **Sistematski rad višenitnosti**\ + Asinkronizirajući sustavski mehanizmi koji nisu povezani s mehanizmima igre smanjuju [vrijeme kašnjenja](#user-content-fn-4)[^4] kako bi optimizirali server. +8. **Sprječavanje nepotrebnog korištenja prostora**\ + Spaja sve podatke slične vrijednosti u jednu kako bi smanjio korištenje memorije. + +## ✨ Primjeri korištenja + +- **Platforma koja ispravno obrađuje složene dodatke**\ + Plazma se koristi na poslužitelju [IPECTER](https://github.com/IPECTER).\ + Vlastiti dodaci koji rade s NMS-om i refleksijom, veliki i složeni paketi podataka su obilno primijenjeni,\ + Bez smanjenja performansi može primiti više od 100 igrača. +- **Platforma koja održava brze performanse čak i na RPG poslužitelju**\ + U jednom klasteru održava stabilnih 100 igrača bez pada TPS-a,\ + Na 4 klastera ukupno 250 igrača moglo je ugodno igrati. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Mnogi streameri su odabrali platformu**\ + Koristi se kao kanta za gledateljsko sudjelovanje mnogih streamera. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Preuzimanje + +Na donjoj stranici možete preuzeti Plazmu. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Želite li saznati više o podržanim verzijama? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot dodaci i Paper, Pufferfish, Purpur dodaci. + +[^2]: Podržava Microsoft Corporation. + +[^3]: Onemogućavanjem sustava za prijavu chata možete spriječiti praćenje chata od strane Mojanga. + +[^4]: Vrijeme potrebno za rad sustava mehanizama kako bi se igra zaustavila na trenutak. diff --git a/hr/origin/plazma/about/downloads-all.md b/hr/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..93368ffe7 --- /dev/null +++ b/hr/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma izvršna datoteka preuzimanje cijelog sadržaja +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Verzija | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/hr/origin/plazma/about/downloads.md b/hr/origin/plazma/about/downloads.md new file mode 100644 index 000000000..b18aa5abb --- /dev/null +++ b/hr/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Preuzmite Plazmu odmah i isprobajte je sami. +--- + +# ⬇️ Preuzimanje + +#### Želite li saznati više o podržanim verzijama? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Preuzimanje u nastavku je izvršna datoteka za obične korisnike.** + +Ako ste programer i trebate drugačiji oblik datoteke, pogledajte donju stranicu. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VerzijaPreuzimanje
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/hr/origin/plazma/about/patches-list.md b/hr/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..3fe0733f9 --- /dev/null +++ b/hr/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Saznajte o svim značajkama dodanim u Plazmu. +--- + +# 📑 Uključeni zakrpe diff --git a/hr/origin/plazma/about/supported-versions.md b/hr/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..4ad2962fb --- /dev/null +++ b/hr/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Saznajte koje verzije Minecraft: Java Edition podržava Plazma." +--- + +# ✅ Status podrške za verziju + +{% hint style="info" %} + +**Plazma je razvijana od verzije 1.19.4 nadalje, verzije ispod 1.19.4 nisu razvijane.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/정보%20없음 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| Verzija | Stabilnost i podrška funkcionalnosti | Status izgradnje | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Status izgradnje](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Status izgradnje](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/hr/origin/plazma/administration/README.md b/hr/origin/plazma/administration/README.md new file mode 100644 index 000000000..05619dbaa --- /dev/null +++ b/hr/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Iskoristite Plazmu za stvaranje vlastitog poslužitelja. +--- + +# ⚒️ Vodič za upravljanje poslužiteljem diff --git a/hr/origin/plazma/administration/diagnosis/README.md b/hr/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..c42293dea --- /dev/null +++ b/hr/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Proučite kako se nositi s problemima kada dođe do njih. +--- + +# 🧾 진단 diff --git a/hr/origin/plazma/administration/diagnosis/plugins.md b/hr/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..b6609c8ab --- /dev/null +++ b/hr/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Saznajte kako riješiti problem kada dodatak ne radi ispravno. +--- + +# 📜 플러그인 diff --git a/hr/origin/plazma/administration/expert/README.md b/hr/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..0b4027dd9 --- /dev/null +++ b/hr/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Saznajte više o profesionalnom rukovanju s Plazmom. +--- + +# 🎓 Napredno diff --git a/hr/origin/plazma/administration/expert/fix-exploits.md b/hr/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..8c16ca71e --- /dev/null +++ b/hr/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Saznajte o poznatim ranjivostima i načinima njihovog rješavanja. +--- + +# ⚠️ Poznate ranjivosti i načini rješavanja diff --git a/hr/origin/plazma/administration/expert/optimize.md b/hr/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..47d86a321 --- /dev/null +++ b/hr/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Saznajte kako optimizirati Plazmu. +--- + +# 🧹 Optimizacija diff --git a/hr/origin/plazma/administration/expert/proxy.md b/hr/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..a0fdecb5e --- /dev/null +++ b/hr/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Saznajte kako sigurno konfigurirati platformu za proksije "Velocity". +--- + +# 🔀 Proksiji diff --git a/hr/origin/plazma/administration/expert/vanillaize.md b/hr/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..acb803ab5 --- /dev/null +++ b/hr/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Saznajte kako vratiti zakrpe za Paper i vanilu. +--- + +# ↩️ Vanilizacija + +{% hint style="warning" %} + +**Paper ne dodaje opcije u većini zakrpa za ispravljanje pogrešaka u vaniliji.** + +Plazma trenutno radi na omogućavanju deaktivacije takvih popravaka. + +Stoga je ovaj vodič još uvijek u izradi i informacije se mogu promijeniti u bilo kojem trenutku. + +{% endhint %} diff --git a/hr/origin/plazma/administration/expert/xray.md b/hr/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..d2dae8636 --- /dev/null +++ b/hr/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Saznajte više o različitim ugrađenim metodama za blokiranje X-zraka. +--- + +# 🩻 Blokiranje X-zraka diff --git a/hr/origin/plazma/administration/faq.md b/hr/origin/plazma/administration/faq.md new file mode 100644 index 000000000..89cbc26e3 --- /dev/null +++ b/hr/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Saznajte više o često postavljanim pitanjima. +--- + +# ⁉️ Često postavljana pitanja + +{% hint style="info" %} + +**Ne možete pronaći željeni odgovor?** + +[Službeni Discord poslužitelj](https://discord.gg/MmfC52K8A8) ili pitajte zajednicu putem [GitHub rasprava](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma ne pokreće + +Ako se u konzoli prikaže `no main manifest attribute, in plazma-(version).jar`,\ +znači da je preuzeta datoteka razvojna datoteka API-ja i trebate preuzeti **Reobf Paperweight** sa GitHub stranice. + +Za više informacija pogledajte sljedeću stranicu. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Upozorenje se prikazuje svaki put kad se poslužitelj pokrene + +Plazma sadrži neke nestabilne zakrpe i uvijek postoji mogućnost pogrešnog rada, stoga prilikom pokretanja poslužitelja prikazuje sljedeću upozoravajuću poruku. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ova upozoravajuća poruka se može onemogućiti korištenjem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1) sistemskog svojstva. + +Za više informacija pogledajte sljedeću stranicu. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostupno od verzije 1.20.1 diff --git a/hr/origin/plazma/administration/getting-started/README.md b/hr/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..1bf971b9a --- /dev/null +++ b/hr/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Saznajte kako stvoriti poslužitelj s Plazmom. +--- + +# 👟 Početak + +Da biste pouzdano koristili Plazmu, sustav mora zadovoljiti sljedeće zahtjeve. + +| | Minimalno | Preporučeno | +| :-----------------: | --------- | ----------- | +| Arhitektura | x64 | - | +| RAM | 8GB | 16GB | +| Prostorni kapacitet | 1GB | 8GB | +| JDK | 17 | 21 | + +Za glatku izmjenu konfiguracijskih datoteka, preporučuje se instalacija uređivača poput [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Ispravan ispis" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' je unutarnja ili vanjska naredba, izvršivi program, ili +skripta datoteka. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Prvo, preuzmite **JDK 21** u `.msi` formatu s [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Pokrenite preuzeti instalacijski čarobnjak i kliknite `Next`. +3. Nakon što se prikaže meni s lijeve strane prozora, aktivirajte `Set JAVA_HOME variable` i kliknite `Next`. +4. Kliknite `Install` kako biste dovršili instalaciju JRE-a. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Zatim, izvršite sljedeću naredbu u terminalu kako biste instalirali JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Preuzimanje Plazme + +Plazma pruža različite vrste izvršnih datoteka. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Saznajte više + +Naziv izvršne datoteke je `plazma-(verzija upravitelja)-1.20.4-R0.1-SNAPSHOT-(oblik mapiranja).jar`. + +- **Oblik mapiranja**\ + Mapiranje je vrsta karte koja povezuje stvarni kod Minecrafta s obfuskiranim kodom. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang mapiranje, mapiranje za Vanilla Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Upravitelj verzijama**\ + Upravitelj verzijama je vrsta pokretača potrebnog za pokretanje poslužitelja koji služi kao biblioteka i primjenjuje zakrpe na datoteke poslužitelja. + - **Paperclip**\ + Upravitelj razvijen od strane PaperMC tima za Paper i druge izvedene platforme, preuzima biblioteke i primjenjuje zakrpe na poslužitelj. + - **Bundler**\ + Upravitelj verzijama za Vanilla Minecraft. + +
+ +*** + +## 3. Izrada skripte za pokretanje + +Da biste jednostavno pokrenuli Plazmu i omogućili automatsko ponovno pokretanje poslužitelja, morate napraviti [skriptu za pokretanje](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Možete preuzeti skriptu za pokretanje klikom na donji desni gumb za preuzimanje.\ +**Provjerite je li preuzeta skripta za pokretanje kompatibilna s vašim operativnim sustavom.** + +*** + +## 4. Organiziranje datoteka + +Sada premjestite preuzetu skriptu za pokretanje i Plazmu u novi mapu. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Sada pokrenite skriptu za pokretanje. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA suglasnost + +Nakon što jednom pokrenete skriptu za pokretanje, u mapi će se stvoriti `eula.txt` datoteka. + +EULA[^9] je ugovor o licenciranju koji morate prihvatiti koristeći usluge [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Za prihvaćanje EULA-e, promijenite `eula=false` u `eula=true` u datoteci `eula.txt` i spremite promjene. + +*** + +## 6. Dozvoljavanje vanjskih veza (Windows) + +Moderne operativne sustave osiguravaju blokiranje vanjskih pristupa putem **firewalla** i **rutera**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Ako vaš router ne podržava UPnP, svaki router ima različite postavke pa ih morate istražiti sami. + +Također, možete koristiti [Ngrok](https://ngrok.com/) za privremenu adresu. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Provjera potrebe za port forwardingom + +Unesite i pokrenite sljedeću naredbu u naredbenom retku. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ako rezultat bude `True`, možete završiti ovdje, inače morate postaviti port forwarding. + +### 6.2 Povezivanje na poslužitelj + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Adresu za povezivanje na poslužitelj možete pronaći [ovdje](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Nakon toga, ponovno pokrenite poslužitelj i Plazma će automatski pokušati postaviti port forwarding. + +Uspješnost UPnP-a ovisi o porukama koje se prikazuju u konzoli, a izgledaju kao `[UPnP] (poruka)`. + +| Poruka | Značenje | +| ----------------------------------- | --------------------------------------------------------- | +| `Uspješno otvoren port (port)` | Uspješno postavljanje port forwardinga. | +| `Port (port) je već otvoren` | Druga usluga već koristi taj port. | +| `Neuspješno otvaranje porta (port)` | Neuspješno postavljanje port forwardinga. | +| `Usluga nije dostupna` | Router ne podržava UPnP. | + +Kada se poslužitelj zaustavi, Plazma automatski zatvara portove. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Preuzmite ZIP datoteku `Windows (64-bit)` s [Ngrok web stranice](https://ngrok.com/download). +2. Stavite preuzetu Ngrok datoteku u mapu poslužitelja. +3. Generirajte autentifikacijski token na [Ngrok nadzornoj ploči](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Izvršite naredbu prikazanu u `Command Line` na mapi poslužitelja. +5. Na vrhu izvršne skripte dodajte `start /b ngrok tcp --region jp 25565`, a na dnu dodajte `taskkill /f /t /im ngrok.exe`. +6. Adresa poslužitelja bit će `0.tcp.jp.ngrok.io:12345` prema poruci `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` koja se prikazuje u konzoli. +7. Sada možete pristupiti putem vanjske adrese. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Na primjer, nakon izvršavanja naredbe, + +```log +Windows IP konfiguracija + +Ethernet adapter Ethernet: + + Povezani DNS sufiks. . . . : + IPv4 adresa. . . . . . . . . : 192.168.3.7 + Mrežna maska . . . . . . . : 255.255.255.0 + Zadani prolaz. . . . . . . : 192.168.3.1 + +``` + +Pokušajte se povezati na server s `192.168.3.7` koji je prikazan kao IPv4 adresa kako biste pristupili serveru s lokalnog računala. + +Ako se server i igra izvršavaju na istom PC-ju, možete se povezati putem `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Rast + +Ako je server uspješno pokrenut i ispravno funkcionira, sada je vrijeme da prilagodite server prema svojim potrebama. + +Pročitajte dolje navedeni priručnik kako biste saznali kako prilagoditi poslužitelj. + +{% content-ref url="sljedeci-korak.md" %} +[sljedeci-korak.md](sljedeci-korak.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, temeljen na Plazmi, temelji se na Spigotu, koji je službeni server platforma. + +[^3]: Windows tipka + R + +[^4]: Za Linux korisnike, u terminalu upišite `java --version` + +[^5]: JRE je jedan od open source projekata, slično kao Minecraft server platforme, postoji nekoliko vrsta. + +[^6]: Općenito se naziva **launcher**. + +[^7]: Aktiviranjem "Auto-restart" opcije server će se automatski ponovno pokrenuti. Možete završiti unosom `Control + C`. + +[^8]: Nije preporučljivo premašiti više od polovice resursa sustava. + + Na primjer, ako je ukupni kapacitet memorije sustava 8GB, nije preporučljivo postaviti ga na više od 4GB. + +[^9]: Ugovor o licenciranju za krajnjeg korisnika, EULA. Za više informacija posjetite [Minecraft web stranicu](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Prema članku 32. stavku 1. točki 9. Zakona o poticanju industrije igara u Republici Koreji, moguće je pokrenuti sudski postupak protiv **Korejske Microsoft korporacije**. + +[^12]: Universal Plug & Play. Purpur uključen u Plazmu automatski komunicira s usmjerivačem putem ovog tehnološkog rješenja, otvarajući vrata samo kada je poslužitelj pokrenut, stoga nije potrebno ručno postavljati prosljeđivanje vrata. + +[^13]: U slučaju da nemate račun, registrirajte se na Ngrok putem Google ili GitHub računa. diff --git a/hr/origin/plazma/administration/getting-started/customization.md b/hr/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..b10e39509 --- /dev/null +++ b/hr/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: Saznajte kako prilagoditi poslužitelj. +--- + +# 🎨 Prilagodba korisnika + +Razlog za korištenje modificirane serverske platforme poput Plazme umjesto službene serverske platforme koju pruža Mojang Studios je što omogućuje snažnu **prilagodbu**. + +U nastavku su navedeni različiti načini prilagodbe i korištenja Plazme. + +## Uređivanje konfiguracije + +Najosnovniji način prilagodbe Plazme je uređivanje konfiguracije. + +Plazma pruža snažne postavke konfiguracije poput mehanike igre i karakteristika čudovišta. + +Za više informacija o konfiguraciji Plazme pogledajte donju stranicu. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Korištenje dodataka + +{% hint style="success" %} + +**Plazma podržava sve dodatke na papirnatoj osnovi.** + +Za Spigot dodatke, zbog promjene mapiranja od verzije 1.20.5 Papera, neki možda neće raditi, +No, većina dodataka koji se temelje na Paperu kao što su Paper, Pufferfish i Purpur će raditi na Plazmi, +Ako se dodatak ne pokreće ispravno, to je vjerojatno greška u Plazmi, stoga odmah [prijavite](../diagnosis/plugins.md). + +{% endhint %} + +To je glavni razlog za korištenje Plazme i najmoćniji način prilagodbe Plazme korisnicima. +Snažan ekosustav dodataka Plazme omogućuje jednostavnu prilagodbu poslužitelja. + +Postoje razni načini za pronalazak i preuzimanje dodataka. Neki dodaci se +preuzimaju na javne repozitorije, dok se neki preuzimaju na GitHub ili vlastite +web stranice. + +{% hint style="caution" %} + +**Dodaci mogu izravno pristupiti sustavu!** + +Prije primjene dodataka uvijek provjerite jesu li sigurni pomoću usluga poput VirusTotala ili +preuzmite dodatak s pouzdane usluge. + +{% endhint %} + +Postoje razne usluge za preuzimanje dodataka. Među njima su [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) i druge usluge koje dodatke ocjenjuju prije objave kako bi osigurale sigurnost. + +### Primjena dodataka + +Nakon preuzimanja dodatka, vrijeme je za primjenu dodatka. + +1. Dodaci su u obliku `.jar` datoteka ili izvršnih Java datoteka.\ + Neke datoteke s dodacima mogu biti u obliku arhiva, u tom slučaju + izvucite arhivu i koristite datoteku koja sadrži `bukkit`, `spigot` ili `paper` u imenu te + datoteku s oznakom `fat` ako je prisutna. +2. Stavite preuzetu datoteku u mapu `plugins` unutar mape poslužitelja i ponovno pokrenite poslužitelj. +3. Kada se Plazma pokrene, na konzoli će se prikazati nova poruka. + To znači da je Plazma uspješno učitala dodatke. +4. Iako je Plazma uspješno učitala dodatke, možda ih nije uspjela pokrenuti. + Korištenjem naredbe `/plugins` možete vidjeti koji su dodaci trenutno učitani na poslužitelju. + Ako ime dodatka nije označeno crvenom + bojom, već + zelenom, znači da je dodatak uspješno učitan. + +Ako dodatak nije uspješno učitan, možete pronaći rješenja na sljedećoj stranici. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Korištenje paketa podataka + +Paketi podataka su način prilagodbe Minecrafta koji je sličan +[resursnim paketima](#user-content-fn-1)[^1]. + +Korištenjem paketa podataka možete dodati nove skupine entiteta i izazova u igri i mijenjati neke unutarnje dijelove igre. + +{% hint style="caution" %} + +**Paketi podataka mogu oštetiti svijet!** + +Neispravni paketi podataka mogu trajno oštetiti svijet i to se ne može poništiti. + +Stoga je preporučljivo napraviti sigurnosnu kopiju svijeta prije primjene paketa podataka. + +{% endhint %} + +Pakete podataka možete preuzeti s raznih usluga poput [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) i drugih. + +Nakon preuzimanja paketa podataka, stavite ih u mapu `datapacks` unutar svjetske mape poslužitelja. +Ako mapa ne postoji, možete je stvoriti i dodati pakete podataka. + +{% hint style="warning" %} + +**Neki [paketi podataka](#user-content-fn-2)[^2] možda neće se pravilno primijeniti prilikom prvog pokušaja.** + +U tom slučaju se preporučuje **2 puta** ponovno pokrenuti poslužitelj. + +{% endhint %} + +Paketi podataka mogu lako biti oštećeni svakom nadogradnjom Minecrafta. + +Posebno kada su paketi podataka potpuno oštećeni, mogu uzrokovati rušenje poslužitelja, +stoga je važno dobro testirati prije nadogradnje poslužitelja. + +{% hint style="info" %} + +**Nakon pokretanja naredbe za pokretanje poslužitelja, možete unijeti `safeMode` iza naredbe kako biste onemogućili sve pakete podataka i zatim pokrenuli poslužitelj.** + +[Za više informacija pogledajte `Referenca > Argumenti`.](../reference/arguments.md) + +{% endhint %} + +Primijenjeni paketi podataka mogu se provjeriti pomoću naredbe `/datapack list`. + +*** + +[^1]: Ili Minecraft: Bedrock Edition dodatak. + +[^2]: Dodavanje novih skupina entiteta itd. diff --git a/hr/origin/plazma/administration/getting-started/next-step.md b/hr/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..a76601642 --- /dev/null +++ b/hr/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Saznajte kako prilagoditi poslužitelj. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +U nastavku su navedeni različiti načini prilagodbe i korištenja Plazme. + +## Uređivanje konfiguracije + +Najosnovniji način prilagodbe Plazme je uređivanje konfiguracije. + +Plazma pruža snažne postavke konfiguracije poput mehanike igre i karakteristika čudovišta. + +Za više informacija o konfiguraciji Plazme pogledajte donju stranicu. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Korištenje dodataka + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +To je glavni razlog za korištenje Plazme i najmoćniji način prilagodbe Plazme korisnicima. Snažan ekosustav dodataka Plazme omogućuje jednostavnu prilagodbu poslužitelja. + +Postoje razni načini za pronalazak i preuzimanje dodataka. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Postoje razne usluge za preuzimanje dodataka. Među njima su [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) i druge usluge koje dodatke ocjenjuju prije objave kako bi osigurale sigurnost. + +### Primjena dodataka + +Nakon preuzimanja dodatka, vrijeme je za primjenu dodatka. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Stavite preuzetu datoteku u mapu `plugins` unutar mape poslužitelja i ponovno pokrenite poslužitelj. +3. Kada se Plazma pokrene, na konzoli će se prikazati nova poruka. To znači da je Plazma uspješno učitala dodatke. +4. Iako je Plazma uspješno učitala dodatke, možda ih nije uspjela pokrenuti. Korištenjem naredbe `/plugins` možete vidjeti koji su dodaci trenutno učitani na poslužitelju. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Ako dodatak nije uspješno učitan, možete pronaći rješenja na sljedećoj stranici. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Korištenje paketa podataka + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Korištenjem paketa podataka možete dodati nove skupine entiteta i izazova u igri i mijenjati neke unutarnje dijelove igre. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Neispravni paketi podataka mogu trajno oštetiti svijet i to se ne može poništiti. + +Stoga je preporučljivo napraviti sigurnosnu kopiju svijeta prije primjene paketa podataka. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Nakon preuzimanja paketa podataka, stavite ih u mapu `datapacks` unutar svjetske mape poslužitelja. Ako mapa ne postoji, možete je stvoriti i dodati pakete podataka. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +U tom slučaju se preporučuje **2 puta** ponovno pokrenuti poslužitelj. +{% endhint %} + +Paketi podataka mogu lako biti oštećeni svakom nadogradnjom Minecrafta. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Primijenjeni paketi podataka mogu se provjeriti pomoću naredbe `/datapack list`. + +*** + +## Optimizacija + +Plazma ima mnogo optimizacijskih zakrpa. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Posrednik + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Za informacije o sigurnim i ispravnim postavkama posrednika pogledajte niže navedenu stranicu. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Sigurnost + +Minecraft je razvio modove koji omogućuju lako pronalaženje [alata za napade ranjivosti](#user-content-fn-3)[^3] čak i online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Postavke dozvola + +Neke upravljačke naredbe dodataka imaju ranjivosti zbog nepravilnih postavki dozvola. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokiranje + +X-Ray je jedna od ranjivosti koja je lako dostupna čak i u osnovnim optimizacijskim klijentima. + +Plazma pruža konfiguraciju koja omogućuje blokiranje X-Raya po zadanom. + +Za informacije o načinima blokiranja X-Raya pogledajte niže navedenu stranicu. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Za pregled igrača kojima je dozvoljen pristup koristite `/whitelist query`. + +*** + +[^1]: Ili Minecraft: Bedrock Edition dodatak. + +[^2]: Dodavanje novih skupina entiteta itd. + +[^3]: Općenito se naziva "hacking". + +[^4]: Ako konfiguracija nije optimizirana, Plazma je zastarjela ili postoje nove ranjivosti, možda nisu blokirane. + +[^5]: Kada se igrač poveže na server, to se događa preko Ngrok posredničkog poslužitelja, a adresa Ngrok koja se dodjeljuje svaki put prilikom ponovnog pokretanja je različita. diff --git a/hr/origin/plazma/administration/reference/README.md b/hr/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..3c87562df --- /dev/null +++ b/hr/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Saznajte osnovne metode prilagodbe koje Plazma nudi. +--- + +# 📜 리퍼런스 + +Plazma nudi različite metode prilagodbe. + +Među njima, četiri metode prilagodbe mogu se odmah koristiti bez dodatnih radnji. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Službeni Discord poslužitelj](https://discord.gg/MmfC52K8A8) ili pitajte zajednicu putem [GitHub rasprava](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Naredbe + +> Naredbe omogućuju prikupljanje informacija unutar igre ili prilagodbu igračkog okruženja. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Dozvole + +> Dozvole određuju opseg interakcije igrača. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenti i atributi + +> Argumenti i atributi imaju opći utjecaj na rad Plazme. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguracije + +> Konfiguracije su osnovni način prilagodbe Plazme. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/hr/origin/plazma/administration/reference/arguments.md b/hr/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..4dbbc203c --- /dev/null +++ b/hr/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Saznajte o početnim argumentima i svojstvima sustava. +--- + +# 🎛️ Argumenti i svojstva + +Početna vrijednost i svojstva sustava su vrijednosti koje se dodaju [naredbi koja se koristi](#user-content-fn-1)[^1] za izvođenje Plazma, što ima opći utjecaj na rad Plazme. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## Svojstva sustava + +Svojstva sustava su vrijednosti koje se unose ispred `-jar` i obrađuju se od strane JVM-a prije inicijalizacije Plazme. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Način korištenja + +Svojstva sustava se unose kao Java argumenti između `java` i `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` označava da taj argument nije ugrađen u JVM već je dodan Plazmi kao poseban argument, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Sva svojstva sustava + +#### `convertLegacySigns` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Ažurira oblikovanje znakova koje više nije podržano. + +#### `debug.entities` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje aktiviranje debug logova vezanih uz informacije o entitetima. + +#### `debug.rewriteForIDE` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje NMS reviziju za ispravno učitavanje debug informacija u IDE-u i automatski remapira interne verzije. + +#### `disable.watchdog` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje Watchdog upozorbeni sustav u Spigotu. + +#### `letMeReload` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje potvrdu `/reload` naredbe. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Ako ste razvojni programer i trebate ažurirati dodatak, koristite hotswap umjesto `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje pluginove koji koriste standardni unos/izlaz. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Upozorava kada se otkrije zastarjelo oblikovanje u chat komponentama. + +#### `Paper.bypassHostCheck` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje provjeru podudarnosti uzorka poslužitelja prilikom povezivanja igrača. + +#### `Paper.debugDynamicMissingKeys` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje debug logove za ključeve koji nedostaju u NBT objektima. + +#### `Paper.debugInvalidSkullProfiles` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje debug logove za nevaljane profile glava blokova. + +Ovo logira sve nevaljane glave blokova u svijetu zajedno s njihovim položajem. + +#### `Paper.disableChannelLimit` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje prioritetizaciju klasa pluginova. + +Koristan je u slučaju problema s pluginovima u sjeni. + +#### `Paper.disableFlushConsolidate` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje Netty sustav za spajanje podataka. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Zadano**: `750` + +Ako entiteta ima više od postavljene vrijednosti, dijeli se u više paketa za prijenos. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Zadano**: `8192` + +Postavlja maksimalnu veličinu paketa koje poslužitelj može primiti odjednom. + +#### `Paper.ignoreJavaVersion` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje provjeru verzije Java-e. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +To može trajno oštetiti datoteke poput svijeta i uzrokovati potpuni kvar igre. + +Svi problemi koji proizlaze iz toga isključivo su vaša odgovornost, a Plazma ne pruža nikakvu podršku za to. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Zadano**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Zadano**: `80` + +Postavlja maksimalnu duljinu teksta na jednom redu ploče. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Zadano**: `(verzija svijeta) + 1` + +Postavlja verziju inicijalizacije podataka koje treba predmemorirati. + +Koristan je kad treba ažurirati veliki broj blokova, ali inače se rijetko koristi. + +#### `Paper.parseYamlCommentsByDefault` + +- **Vrsta**: `Boolean` +- **Zadano**: `True` + +Omogućuje obradu komentara u YAML datotekama. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Zadano**: `30` + +Igrač će biti izbačen ako ne primi nikakve podatke od igrača u određenom vremenskom razdoblju (u sekundama). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Ignorira komentare u postavkama poslužitelja. + +#### `Paper.debug-sync-loads` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje debug logove za sinkronizirano stvaranje dijelova. + +#### `Paper.enable-sync-chunk-writes` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje Minecraftov [zadani sustav stvaranja dijelova](#user-content-fn-10)[^10]. + +Ovo uzrokuje da se svaki dio pohranjuje redoslijedom, što dovodi do značajnog smanjenja performansi. + +#### `Paper.explicit-flush` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje eksplicitno ispiranje mrežnih kanala. + +#### `Paper.strict-thread-checks` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Uvijek zapisuje pogreške koje nisu nastale na glavnom dretvu. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Upozorava ako rezervirani zadaci imaju preveliko kašnjenje. + +#### `Paperclip.patchOnly` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Ako koristite zadani izvršni datoteku, primjenjuje se samo zakrpa, a poslužitelj se ne pokreće. + +#### `Plazma.aggressiveOptimize` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` +- **Sukob**: `Plazma.disableConfigOptimization` + +Pojačava pocetnu konfiguraciju. + +Aktivacija će ubrzati i učiniti server sigurnijim, ali može imati veliki utjecaj na igru. + +#### `Plazma.disableConfigOptimization` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` +- **Sukob**: `Plazma.aggressiveOptimize` + +Neće optimizirati pocetnu konfiguraciju. + +Ovo koristi osnovnu konfiguraciju Paper-a. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` + +Isključuje Plazmin brendiranje i koristi vanilski osnovni favicon servera. + +#### `Plazma.useVanillaConfiguration` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` +- **Sukob**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +To može značajno utjecati na sigurnost i performanse servera. + +Sve probleme uzrokovane ovom osobinom rješava server administrator. +{% endhint %} + +Postavlja pocetnu konfiguraciju na zadane vrijednosti koje pruža Mojang. + +To isključuje sve patch-e za ranjivosti koje primjenjuje Paper. + +Patch-ovi za ranjivosti se mogu ponovno aktivirati u postavkama Paper-a ili Plazme. + +#### `Plazma.vanillaize` + +- **Vrsta**: `Boolean` +- **Default**: `true` +- **Sukob**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Postavlja pocetnu konfiguraciju bliže vanili. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 svojstvo + +Ispod sustav svojstvo su onemogućeni svojstvo. + +#### `timings.bypassMax` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` +- **ZASTARJELO**: Nakon uklanjanja Timingsa iz Plazme + +Odlučuje može li se premašiti maksimalna vrijednost koja se može poslati Aikarovom Timings API-ju. + +Čak i ako se to dogodi, primjenjuje se ograničenje brzine ako se iznimka ne obradi u API-ju. + +*** + +## Početni argument + +Početni argument se unosi nakon `-jar *.jar` kako bi se Plazma inicijalizirala i obrađivala zajedno s njim. + +### Upute za korištenje + +Svojstva sustava unose se kao programski argument iza `-jar *.jar`. + +Na primjer, ako želite primijeniti početni argument `nogui`,\ +unosom kako slijedi, Plazma će tijekom inicijalizacije obraditi argument `nogui`. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Cjelokupni početni argument + +#### `bukkit-settings` + +- **Nadimak**: `b` +- **Zadana vrijednost**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Nadimak**: `c` +- **Zadana vrijednost**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Nadimak**: `c` +- **Zadana vrijednost**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Pokreće server u demo svijetu. + +#### `eraseCache` + +Briše preostale keš datoteke nakon nadogradnje svijeta. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Nadimak**: `?` + +Ispisuje sve početne argumente i opise Plazme. + +#### `initSettings` + +Samo stvara konfiguracijsku datoteku i gasi server. + +#### `jfrProfile` + +Omogućuje JFR profiliranje. + +#### `max-players` + +- **Nadimak**: `s`, `size` +- **Zadana vrijednost**: `(svojstvo servera)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Onemogućuje grafički sučelje Plazme. + +#### `nojline` + +Onemogućuje JLine i koristi običnu konzolu. + +#### `online-mode` + +- **Nadimak**: `o` +- **Zadana vrijednost**: `(svojstvo servera)` + +Odabire hoće li se igrači provjeravati preko Mojangovih autentikacijskih poslužitelja. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Nadimak**: `paper` +- **Zadana vrijednost**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Postavlja lokaciju [PaperSpigot konfiguracijske datoteke](../reference/configurations/paper/README.md) koja je ukinuta. + +Ovo se koristi za prebacivanje postojeće konfiguracije u novu datoteku i više se ne koristi nakon toga. + +#### `paper-settings-directory` + +- **Nadimak**: `paper-dir` +- **Zadana vrijednost**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Nadimak**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Nadimak**: `p` +- **Zadana vrijednost**: `plugins` + +Postavlja lokaciju mape dodatka. + +#### `pufferfish-settings` + +- **Nadimak**: `pufferfish` +- **Zadana vrijednost**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Nadimak**: `purpur` +- **Zadana vrijednost**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Pokreće server u potpunoj vanilla stanju. + +#### `server-ip` + +- **Nadimak**: `h`, `host` +- **Zadana vrijednost**: `(svojstvo servera)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Nadimak**: `p`, `port` +- **Zadana vrijednost**: `(svojstvo servera)` + +Postavlja port servera. + +#### `server-name` + +- **Zadana vrijednost**: `A Plazma Server` + +Postavlja ime servera. + +#### `spigot-settings` + +- **Nadimak**: `S` +- **Zadana vrijednost**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Nadimak**: `v` + +Ispisuje verziju Plazme. + +#### `world-dir` + +- **Nadimak**: `W`, `universe`, `world-container` +- **Zadana vrijednost**: `(mapa servera)` + +Postavlja lokaciju gdje se sprema datoteka svijeta. + +#### `world-name` + +- **Nadimak**: `w`, `world` +- **Zadana vrijednost**: `(svojstvo servera)` + +Postavlja ime datoteke svijeta. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Mjesto na kojem se argumenti obrađuju ovisi o dodatku na kraju. + +[^3]: Na primjer, ako želite postaviti `Plazma.iKnowWhatIAmDoing` na `true`, umjesto `-DPlazma.iKnowWhatIAmDoing=true`, dovoljno je unijeti `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: Na primjer, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor događaja. + +[^6]: Detektor događaja. + +[^7]: Klijent. + +[^8]: Signal koji signalizira da je server uspješno povezan poput otkucaja srca. + +[^9]: Korištenjem Purpur AFK izbacivanja, možete izbaciti igrače koji su odsutni. + +[^10]: Sustav pisanja sinkroniziranog chunka, Sync Chunk Write System. + +[^11]: `UPOZORENJE! Plazma može uzrokovati neočekivane probleme, stoga budite sigurni da je temeljito testirate prije nego je koristite na javnom poslužitelju.` + +[^12]: U igri `svjetska optimizacija` također radi prema tom principu. + +[^13]: `Administratori razina 2` ili više su isključeni. + +[^14]: Internet protokol, IP. diff --git a/hr/origin/plazma/administration/reference/commands.md b/hr/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..92a23aeb8 --- /dev/null +++ b/hr/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Saznajte o naredbama koje možete koristiti na Plazmi. +--- + +# 🖥️ Naredbe diff --git a/hr/origin/plazma/administration/reference/configurations/README.md b/hr/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..869914a3c --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfiguracije su osnovni način prilagodbe Plazme. +--- + +# 🧾 구성 + +*** + +## 🪨 Svojstva + +> Svojstva su osnovna konfiguracijska datoteka koju pruža Minecraft. Korištenjem svojstava možete promijeniti osnovne mehanizme igre. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit konfiguracija + +> Bukkit konfiguracija je osnovna konfiguracijska datoteka koju pruža Plazma. Korištenjem Bukkita konfiguracije možete promijeniti osnovne mehanizme Minecraft poslužitelja. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot konfiguracija + +> Spigot konfiguracija omogućuje uređivanje detaljnih mehanizama igre, obradu igrača, funkcioniranje naredbi i poruka. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper konfiguracija + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish konfiguracija omogućuje promjenu obrade svijeta i entiteta Plazme. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur konfiguracija + +> Purpur svojstva omogućuju uređivanje osnovnih podataka igre. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfiguracija + +> Plazma konfiguracija omogućuje prilagodbu funkcija Plazme. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/hr/origin/plazma/administration/reference/configurations/bukkit.md b/hr/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..a39e2b59e --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Provjerite što svaki čvor u bukkit.yml znači. +--- + +# 🪣 Bukkit diff --git a/hr/origin/plazma/administration/reference/configurations/paper/README.md b/hr/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..863a9c655 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Pronađite svrhu svake datoteke u mapi config. +--- + +# 🛩️ Papir diff --git a/hr/origin/plazma/administration/reference/configurations/paper/global.md b/hr/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..4b94edbe7 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u paper-global.yml znači. +--- + +# 🌏 전역 구성 diff --git a/hr/origin/plazma/administration/reference/configurations/paper/world.md b/hr/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..cd7f6762e --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Pronađite što svaki čvor u paper-world.yml znači. +--- + +# 🏳️ 세계별 구성 + +svjetski diff --git a/hr/origin/plazma/administration/reference/configurations/plazma/README.md b/hr/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..0ffd203cf --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Pronađite svrhu svake datoteke u mapi config. +--- + +# ✨ Plazma diff --git a/hr/origin/plazma/administration/reference/configurations/plazma/global.md b/hr/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..4879c7b7e --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u plazma-global.yml znači. +--- + +# 🌏 전역 구성 diff --git a/hr/origin/plazma/administration/reference/configurations/plazma/world.md b/hr/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..eaf55fe0f --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Pronađite što svaki čvor u plazma-world.yml znači. +--- + +# 🏳️ 세계별 구성 diff --git a/hr/origin/plazma/administration/reference/configurations/plazma/worlds.md b/hr/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..1a9edba2d --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Pronađite što svaki čvor u plazma-world.yml znači. +--- + +# ✨ Plazma (sastav svijeta) diff --git a/hr/origin/plazma/administration/reference/configurations/property.md b/hr/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..89d946bc0 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Pronađite što svaki čvor u server.properties znači. +--- + +# 🪨 Server.properties diff --git a/hr/origin/plazma/administration/reference/configurations/pufferfish.md b/hr/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..27b6c3742 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Provjerite što svaki čvor u pufferfish.yml znači. +--- + +# 🐡 Pufferfish diff --git a/hr/origin/plazma/administration/reference/configurations/purpur/README.md b/hr/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..0ede60b78 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u purpur.yml znači. +--- + +# 🦑 Purpur diff --git a/hr/origin/plazma/administration/reference/configurations/purpur/global.md b/hr/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..30aab6cb1 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u purpur.yml znači. +--- + +# 🌏 전역 구성 diff --git a/hr/origin/plazma/administration/reference/configurations/purpur/world.md b/hr/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..97d3df3f6 --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u purpur.yml znači. +--- + +# 🏳️ 세계별 구성 diff --git a/hr/origin/plazma/administration/reference/configurations/spigot.md b/hr/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..85d0ff90a --- /dev/null +++ b/hr/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u spigot.yml znači. +--- + +# 🚰 Spigot diff --git a/hr/origin/plazma/administration/reference/permissions.md b/hr/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..06e39a261 --- /dev/null +++ b/hr/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Saznajte više o ovlastima Plazme. +--- + +# 🛡️ Ovlasti + +Dozvole su jednostavni sigurnosni alat koji omogućuje igračima na poslužitelju međusobno djelovanje. + +Za pravilno korištenje i jednostavno uređivanje dozvola, trebate koristiti dodatke poput [LuckPerms](https://luckperms.net). + +*** + +## Razumijevanje osnovnog sustava dozvola + +Minecraft pruža osnovne administratorske skupine dozvola. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Igrač**\ + Ovo je osnovna skupina dozvola koja se dodjeljuje svim igračima. +2. **Posrednik**\ + Može ignorirati zaštitu od spawnanja. +3. **Administrator svijeta**\ + Može koristiti sve naredbe i naredbene blokove povezane s upravljanjem svijetom.\ + Ovo je osnovna skupina dozvola koja se primjenjuje na pakete podataka i naredbene blokove. +4. **Administrator**\ + Može koristiti sve naredbe povezane s upravljanjem igračima. +5. **Glavni administrator**\ + Može koristiti sve naredbe uključujući upravljanje poslužiteljem.\ + Ovo je osnovna skupina dozvola koja se primjenjuje na konzolu i administratore. + +*** + +## Postavljanje dozvola + +*** + +## Sve dozvole + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Osnovno**: `Nijedan` + +Dopušta igračima da se sagnu i međudjeluju s entitetom kako bi se mogli voziti na entitetu. + +Kada se voze entitetom, mogu upravljati kretanjem entiteta pomoću `tipki za kretanje` i skakati ili letjeti pomoću `tipke za skok`. + +U `(Namespaced Key)` upisuje se [Namespaced ID](#user-content-fn-2)[^2] entiteta. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Osnovno**: `Nijedan` + +Dopušta igračima da koriste posebne sposobnosti entiteta dok su na njima. + +Nisu sve posebne sposobnosti svih entiteta dostupne. Pogledajte sve dostupne posebne sposobnosti u nastavku. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Molimo podijelite svoje ideje na [Plazma Discord](https://plazmamc.org/discord) ili [GitHub raspravama](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Pogledajte trenutno dostupne posebne sposobnosti + +- **`crepper`**\ + Prilikom pritiska `tipke za skok` eksplodira.\ + Ako igrač ima dozvolu `allow.powered.creeper`, može držati `tipku za skok` za punjenje. +- **`dolphin`**\ + Prilikom pritiska `tipke za skok` napada brzinom. +- **`phantom`**\ + Prilikom pritiska `tipke za skok` ispaljuje plamen. +- **`wither`**\ + Kada se `međudjeluje`, ispaljuje glavu Withera. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/compass` naredbe](commands.md#compass). + +#### `bukkit.command.credits` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/credits (Igrač)` naredbe](commands.md#credits). + +Dodavanjem `.other` iza imena dozvole omogućuje se korištenje drugim igračima. + +#### `bukkit.command.demo` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/demo (Igrač)` naredbe](commands.md#demo). + +Dodavanjem `.other` iza imena dozvole omogućuje se korištenje drugim igračima. + +#### `bukkit.command.ping` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/ping (Igrač)` naredbe](commands.md#ping). + +Dodavanjem `.other` iza imena dozvole omogućuje se korištenje drugim igračima. + +#### `bukkit.command.ram` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/ram` naredbe](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/rambar (Igrač)` naredbe](commands.md#rambar). + +Dodavanjem `.other` iza imena dozvole omogućuje se korištenje drugim igračima. + +#### `bukkit.command.restart` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/restart` naredbe](commands.md#restart). + +#### `bukkit.command.tps` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/tps` naredbe](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/tpsbar (Igrač)` naredbe](commands.md#tpsbar). + +Dodavanjem `.other` iza imena dozvole omogućuje se korištenje drugim igračima. + +#### `bukkit.command.timings` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/timings` naredbe](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Za slične funkcionalnosti pogledajte [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/uptime` naredbe](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Osnovno**: `Administrator svijeta` + +Dopušta korištenje [`/gamemode (GameMode) (Igrač)` naredbe](commands.md#gamemode). + +Dodavanjem `.other` iza imena dozvole omogućuje se korištenje drugim igračima. + +#### `paper.antixray.bypass` + +- **Osnovno**: `Nijedan` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +To omogućuje poboljšanje performansi za obje strane. + +> Za upute o postavljanju X-Ray-a pogledajte dolje navedenu stranicu. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Osnovno**: `Nijedan` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Osnovno**: `Nijedan` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Osnovno**: `Nijedan` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Osnovno**: `Nijedan` + +Omogućuje korištenje [MiniMessage oznaka](https://docs.advntr.dev/minimessage/format.html) na kovčegu. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Osnovno**: `Nijedan` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Osnovno**: `Nijedan` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Osnovno**: `Nijedan` + +Igrači se izuzimaju iz izbacivanja zbog neaktivnosti. + +#### `purpur.debug.f3n` + +- **Osnovno**: `Administrator svijeta` + +Omogućuje igračima promjenu načina igre pomoću tipki `F3 + N`. + +Nije moguće raditi ako nemate dozvolu za taj način igre. + +#### `purpur.drop.spawners` + +- **Osnovno**: `Nijedan` + +Kada iskopate spawner blok s postavkama iz konfiguracije, spawner će pasti na tlo. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Osnovno**: `Nijedan` + +Mijenja veličinu ender kovčega. + +U `(NumberString)` možete unijeti `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Osnovno**: `Nijedan` + +Omogućuje funkcioniranje Totema besmrtnosti čak i ako je u inventaru. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Osnovno**: `Nijedan` + +Dopustite igraču da ignorira ograničenje broja posjetitelja. + +#### `purpur.mending_shift_click` + +- **Osnovno**: `Nijedan` + +Dopustite igraču da popravi predmet koji drži kada se `poklekne i interagira`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Osnovno**: `Nijedan` + +Dopustite igraču da postavi spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Osnovno**: `Nijedan` + +Omogućite igraču trenutno teleportiranje kada koristi Nether portal. + +#### `purpur.sign.color` + +- **Osnovno**: `Nijedan` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Osnovno**: `Nijedan` + +Prijenosnici mogu koristiti kod za otežavanje čitanja `(&o)` na znakovima. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Osnovno**: `Nijedan` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Osnovno**: `Nijedan` + +Dopušta igračima da `međusobno djeluju` škarama kako bi spriječili TNT eksploziju. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Planirana dozvola + +#### `plazma.bypass.ncr-require` + +- **Osnovno**: `Nijedan` + +Dopušta igračima da se priključe čak i ako nemaju instaliran mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Primjer: `ender_dragon` diff --git a/hr/origin/plazma/adminstration/README.md b/hr/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..05619dbaa --- /dev/null +++ b/hr/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Iskoristite Plazmu za stvaranje vlastitog poslužitelja. +--- + +# ⚒️ Vodič za upravljanje poslužiteljem diff --git a/hr/origin/plazma/adminstration/expert/README.md b/hr/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..0b4027dd9 --- /dev/null +++ b/hr/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Saznajte više o profesionalnom rukovanju s Plazmom. +--- + +# 🎓 Napredno diff --git a/hr/origin/plazma/adminstration/expert/fix-exploits.md b/hr/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..8c16ca71e --- /dev/null +++ b/hr/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Saznajte o poznatim ranjivostima i načinima njihovog rješavanja. +--- + +# ⚠️ Poznate ranjivosti i načini rješavanja diff --git a/hr/origin/plazma/adminstration/expert/optimize.md b/hr/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..47d86a321 --- /dev/null +++ b/hr/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Saznajte kako optimizirati Plazmu. +--- + +# 🧹 Optimizacija diff --git a/hr/origin/plazma/adminstration/expert/vanillaize.md b/hr/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..7189d358e --- /dev/null +++ b/hr/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Saznajte kako vratiti zakrpe za Paper i vanilu. +--- + +# ↩️ Vanilizacija + +{% hint style="warning" %} + +### Paper ne nudi opcije za većinu zakrpi za vanilu. + +Plazma trenutno radi na omogućavanju deaktivacije takvih popravaka. + +Stoga je ovaj vodič još uvijek u izradi i informacije se mogu promijeniti u bilo kojem trenutku. +{% endhint %} diff --git a/hr/origin/plazma/adminstration/faq.md b/hr/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..fe80a4dc7 --- /dev/null +++ b/hr/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Saznajte više o često postavljanim pitanjima. +--- + +# ⁉️ Često postavljana pitanja + +{% hint style="info" %} + +### Ne možete pronaći željeni odgovor? + +Pitajte zajednicu putem [Službenog Discord poslužitelja](https://discord.gg/MmfC52K8A8) ili [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Poruka se prikazuje ali se ne izvršava + +Ako se u konzoli prikaže `no main manifest attribute, in plazma-(version).jar`,\ +znači da je preuzeta datoteka razvojna datoteka API-ja i trebate preuzeti **Reobf Paperweight** sa GitHub stranice. + +Za više informacija pogledajte sljedeću stranicu. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Upozorenje se prikazuje svaki put kad se poslužitelj pokrene + +Plazma sadrži neke nestabilne zakrpe i uvijek postoji mogućnost pogrešnog rada, stoga prilikom pokretanja poslužitelja prikazuje sljedeću upozoravajuću poruku. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ova upozoravajuća poruka se može onemogućiti korištenjem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1) sistemskog svojstva. + +Za više informacija pogledajte sljedeću stranicu. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostupno od verzije 1.20.1 diff --git a/hr/origin/plazma/adminstration/getting-started/README.md b/hr/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..b59332a26 --- /dev/null +++ b/hr/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Saznajte kako stvoriti poslužitelj s Plazmom. +--- + +# 👟 Početak + +Da biste pouzdano koristili Plazmu, sustav mora zadovoljiti sljedeće zahtjeve. + +| | Minimalno | Preporučeno | +| :-----------------: | --------: | ----------: | +| Arhitektura | x64 | - | +| RAM | 8GB | 16GB | +| Prostorni kapacitet | 1GB | 8GB | +| JRE | 17 | 21 | + +Za glatku izmjenu konfiguracijskih datoteka, preporučuje se instalacija uređivača poput [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalacija JRE-a + +Kao što ime sugerira, Minecraft: **"Java"** Edition je razvijen u Javi te za pokretanje zahtijeva JRE[^1]. + +Budući da je Plazma temeljena na službenoj platformi za poslužitelje Mojang Studiosa \[^(#user-content-fn-2)], za korištenje Plazme također je potrebna instalacija JRE-a. + +### 1.1 Provjera JRE-a + +Za provjeru je li JRE instaliran na sustavu, unesite [`cmd /k java --version`](#user-content-fn-4) u [prozor za pokretanje](#user-content-fn-3) i pokrenite naredbu. + +Ako se prikaže sljedeći rezultat, preskočite na [2. korak](setup.md#id-2). + +{% code title="Ispravan rezultat" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Ako se rezultat ne podudara ili se prikaže sljedeće, JRE nije instaliran ili je zastario te je potrebno izvršiti [1.2 korak](setup.md#id-1.2). + +{% code title="JRE nije instaliran" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE je predugo star" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalacija JRE + +U ovom vodiču koristimo Azul Zulu kao [jednu od vrsta](#user-content-fn-5)[^5] JRE-a. + +Nakon instalacije, ponovno izvršite [korak 1.1](setup.md#id-1.1) kako biste provjerili je li instalacija uspješno dovršena. + +{% tabs %} +{% tab title="Windows" %} + +1. Prvo, preuzmite **JDK 21** u `.msi` formatu s [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Pokrenite preuzeti instalacijski čarobnjak i kliknite `Next`. +3. Nakon što se prikaže meni s lijeve strane prozora, aktivirajte `Set JAVA_HOME variable` i kliknite `Next`. +4. Kliknite `Install` kako biste dovršili instalaciju JRE-a. + {% endtab %} + +{% tab title="macOS" %} +Preuzmite **JDK 21** u `.dmg` formatu s [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) i izvršite instalaciju JRE-a. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Prvo, izvršite sljedeću naredbu u terminalu kako biste dodali Azul Zulu repozitorij APT-u. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Zatim, izvršite sljedeću naredbu u terminalu kako biste instalirali JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Možete instalirati JRE izvršavanjem sljedeće naredbe. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Preuzimanje Plazme + +Plazma pruža različite vrste izvršnih datoteka. + +{% hint style="warning" %} + +### U većini slučajeva koristite `Reobf Paperclip`. + +Sljedeći sadržaj je namijenjen developerima ili onima koji su zainteresirani za karakteristike svake vrste.\ +Ako ste obični korisnik, možete preskočiti na [korak 3](setup.md#id-3) bez problema. +{% endhint %} + +
+ +Saznajte više + +Naziv izvršne datoteke je `plazma-(verzija upravitelja)-1.20.4-R0.1-SNAPSHOT-(oblik mapiranja).jar`. + +- **Oblik mapiranja**\ + Mapiranje je vrsta karte koja povezuje stvarni kod Minecrafta s obfuskiranim kodom. + - **Reobf**\ + Reobfuscation, također poznato kao Spigot mapiranje, često se koristi u većini NMS dodataka.\ + Planira se prestanak upotrebe od verzije 1.20.5. + - **Mojmap**\ + Mojang mapiranje, mapiranje za Vanilla Minecraft. +- **Upravitelj verzijama**\ + Upravitelj verzijama je vrsta pokretača potrebnog za pokretanje poslužitelja koji služi kao biblioteka i primjenjuje zakrpe na datoteke poslužitelja. + - **Paperclip**\ + Upravitelj razvijen od strane PaperMC tima za Paper i druge izvedene platforme, preuzima biblioteke i primjenjuje zakrpe na poslužitelj. + - **Bundler**\ + Upravitelj verzijama za Vanilla Minecraft. + +
+ +*** + +## 3. Izrada skripte za pokretanje + +Da biste jednostavno pokrenuli Plazmu i omogućili automatsko ponovno pokretanje poslužitelja, morate napraviti [skriptu za pokretanje](#user-content-fn-6)[^6]. + +Možete generirati skriptu za pokretanje putem [Flags.sh](https://flags.sh).\ +Samo unesite količinu memorije koju želite koristiti za Plazmu i naredba će se automatski optimizirati. + +Možete preuzeti skriptu za pokretanje klikom na donji desni gumb za preuzimanje.\ +**Provjerite je li preuzeta skripta za pokretanje kompatibilna s vašim operativnim sustavom.** + +*** + +## 4. Organiziranje datoteka + +Sada premjestite preuzetu skriptu za pokretanje i Plazmu u novi mapu. + +{% hint style="warning" %} + +### Naziv mape mora biti bez razmaka i postavljen na engleski jezik. + +Inače, Plazma ili JRE možda neće ispravno raditi. +{% endhint %} + +Sada pokrenite skriptu za pokretanje. Za Windows, obavezno odaberite **Allow** prilikom odabira prozora za odobrenje firewalla. + +*** + +## 5. EULA suglasnost + +Nakon što jednom pokrenete skriptu za pokretanje, u mapi će se stvoriti `eula.txt` datoteka. + +EULA[^9] je ugovor o licenciranju koji morate prihvatiti koristeći usluge [Mojang Studios](#user-content-fn-10)[^10]. + +Ako ne prihvatite EULA-u, nećete moći pokrenuti poslužitelj, a kršenje EULA-e može rezultirati sankcijama poput suspenzije računa i sličnoj [kazni.](#user-content-fn-11)[^11] + +Za prihvaćanje EULA-e, promijenite `eula=false` u `eula=true` u datoteci `eula.txt` i spremite promjene. + +*** + +## 6. Dozvoljavanje vanjskih veza (Windows) + +Moderne operativne sustave osiguravaju blokiranje vanjskih pristupa putem **firewalla** i **rutera**. + +Za Windows, budući da ste omogućili portove u [koraku 3](setup.md#id-3), samo trebate postaviti port forwarding. + +{% hint style="info" %} + +### U ovom vodiču pretpostavljamo da koristite Windows operativni sustav i [**UPnP**](#user-content-fn-12)[^12] kompatibilni router. + +Ako vaš router ne podržava UPnP, svaki router ima različite postavke pa ih morate istražiti sami. + +Također, možete koristiti [Ngrok](https://ngrok.com/) za privremenu adresu. +{% endhint %} + +{% hint style="warning" %} + +### Za Linux ili macOS i ostale (polu) UNIX operativne sustave, postupci postavljanja firewalla ovise o usluzi pa ih morate istražiti sami. + +{% endhint %} + +### 6.1 Provjera potrebe za port forwardingom + +Unesite i pokrenite sljedeću naredbu u naredbenom retku. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ako rezultat bude `True`, možete završiti ovdje, inače morate postaviti port forwarding. + +### 6.2 Povezivanje na poslužitelj + +{% tabs %} +{% tab title="Vanjski pristup" %} +Ako ne trebate port forwarding ili ste već uspješno postavili port forwarding, možete se povezati na poslužitelj. + +Adresu za povezivanje na poslužitelj možete pronaći [ovdje](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Pokušaj UPnP port forwardinga" %} +U datoteci `purpur.yml` poslužitelja, omogućite `network.upnp-port-forwarding` postavljanjem na `true`. + +Nakon toga, ponovno pokrenite poslužitelj i Plazma će automatski pokušati postaviti port forwarding. + +Uspješnost UPnP-a ovisi o porukama koje se prikazuju u konzoli, a izgledaju kao `[UPnP] (poruka)`. + +| Poruka | Značenje | +| ----------------------------------- | ----------------------------------------- | +| `Uspješno otvoren port (port)` | Uspješno postavljanje port forwardinga. | +| `Port (port) je već otvoren` | Druga usluga već koristi taj port. | +| `Neuspješno otvaranje porta (port)` | Neuspješno postavljanje port forwardinga. | +| `Usluga nije dostupna` | Router ne podržava UPnP. | + +Kada se poslužitelj zaustavi, Plazma automatski zatvara portove. +{% endtab %} + +{% tab title="Generiranje privremene adrese putem Ngroka" %} +Korištenje Ngroka je korisno za privremene testove, zajedničko igranje ili igranje s prijateljima. + +1. Preuzmite ZIP datoteku `Windows (64-bit)` s [Ngrok web stranice](https://ngrok.com/download). +2. Stavite preuzetu Ngrok datoteku u mapu poslužitelja. +3. Generirajte autentifikacijski token na [Ngrok nadzornoj ploči](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Izvršite naredbu prikazanu u `Command Line` na mapi poslužitelja. +5. Na vrhu izvršne skripte dodajte `start /b ngrok tcp --region jp 25565`, a na dnu dodajte `taskkill /f /t /im ngrok.exe`. +6. Adresa poslužitelja bit će `0.tcp.jp.ngrok.io:12345` prema poruci `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` koja se prikazuje u konzoli. +7. Sada možete pristupiti putem vanjske adrese. + {% endtab %} + +{% tab title="Pristup s lokalnog računala" %} +Ako pokušavate pristupiti serveru s lokalnog računala, možete se povezati putem `IPv4 adrese` koju ste dobili izvršavanjem `cmd /k ipconfig` u naredbenom retku. + +Na primjer, nakon izvršavanja naredbe, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Pokušajte se povezati na server s `192.168.3.7` koji je prikazan kao IPv4 adresa kako biste pristupili serveru s lokalnog računala. + +Ako se server i igra izvršavaju na istom PC-ju, možete se povezati putem `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Stadij razvoja + +Ako je server uspješno pokrenut i ispravno funkcionira, sada je vrijeme da prilagodite server prema svojim potrebama. + +Saznajte kako prilagoditi server putem donjeg vodiča. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java izvršno okruženje. + +[^2]: Paper, temeljen na Plazmi, temelji se na Spigotu, koji je službeni server platforma. + +[^3]: Windows tipka + R + +[^4]: Za Linux korisnike, u terminalu upišite `java --version` + +[^5]: JRE je jedan od open source projekata, slično kao Minecraft server platforme, postoji nekoliko vrsta. + +[^6]: Općenito se naziva **launcher**. + +[^7]: Aktiviranjem "Auto-restart" opcije server će se automatski ponovno pokrenuti. Možete završiti unosom `Control + C`. + +[^8]: Nije preporučljivo premašiti više od polovice resursa sustava. + + Na primjer, ako je ukupni kapacitet memorije sustava 8GB, nije preporučljivo postaviti ga na više od 4GB. + +[^9]: Ugovor o licenciranju za krajnjeg korisnika, EULA. Za više informacija posjetite [Minecraft web stranicu](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Prema članku 32. stavku 1. točki 9. Zakona o poticanju industrije igara u Republici Koreji, moguće je pokrenuti sudski postupak protiv **Korejske Microsoft korporacije**. + +[^12]: Universal Plug & Play. Purpur uključen u Plazmu automatski komunicira s usmjerivačem putem ovog tehnološkog rješenja, otvarajući vrata samo kada je poslužitelj pokrenut, stoga nije potrebno ručno postavljati prosljeđivanje vrata. + +[^13]: U slučaju da nemate račun, registrirajte se na Ngrok putem Google ili GitHub računa. diff --git a/hr/origin/plazma/adminstration/getting-started/customization.md b/hr/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..0e3015727 --- /dev/null +++ b/hr/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Saznajte kako prilagoditi poslužitelj. +--- + +# 🎨 Prilagodba korisnika diff --git a/hr/origin/plazma/adminstration/reference/arguments.md b/hr/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..107f2692c --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Saznajte o početnim argumentima i svojstvima sustava. +--- + +# 🎛️ Argumenti i svojstva + +Početni argumenti i svojstva sustava su vrijednosti dodane naredbi koja se koristi za izvođenje Plazme, koje omogućuju promjenu vrijednosti koje se ne mogu promijeniti nakon što se Plazma pokrene. + +Ovisno o [mjestu dodavanja naredbi](#user-content-fn-2)[^2], početni argumenti i svojstva sustava se dijele na **početne argumente** i **svojstva sustava**. + +*** + +## Svojstva sustava + +Svojstva sustava su vrijednosti koje se unose ispred `-jar` i obrađuju se od strane JVM-a prije inicijalizacije Plazme. + +{% hint style="warning" %} + +### Izmjena svojstava sustava može promijeniti način rada Plazme i JVM-a te može imati veliki utjecaj na igru! + +Ako niste sigurni koji je uloga svakog svojstva sustava, **nikada ih nemojte koristiti!** +{% endhint %} + +### Način korištenja + +Svojstva sustava se unose kao Java argumenti između `java` i `-jar`. + +Na primjer, ako želite primijeniti svojstvo sustava `Plazma.dummyProperty`, +unosom sljedećeg, sljedeće svojstvo će biti postavljeno na `37` pri inicijalizaciji Plazme. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` označava da taj argument nije ugrađen u JVM već je dodan Plazmi kao poseban argument, + +ako ne unesete nikakvu vrijednost, vrijednost će biti [`true` po zadanom.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platforme slične Paperweightu sadrže točku u imenu svojstva kako bi razlikovale svojstva sustava po platformama. + +U nekim terminalima poput Windows Powershella, ovi argumenti možda nisu dopušteni, stoga morate dodati `"` na početak i kraj argumenta.[^4] +{% endhint %} + +### Sva svojstva sustava + +#### `convertLegacySigns` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Ažurira oblikovanje znakova koje više nije podržano. + +#### `debug.entities` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje aktiviranje debug logova vezanih uz informacije o entitetima. + +#### `debug.rewriteForIDE` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje NMS reviziju za ispravno učitavanje debug informacija u IDE-u i automatski remapira interne verzije. + +#### `disable.watchdog` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje Watchdog upozorbeni sustav u Spigotu. + +#### `letMeReload` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje potvrdu `/reload` naredbe. + +{% hint style="danger" %} + +### Budući da je `/reload` naredba vrlo nestabilna, svi problemi koji se pojave nakon `/reload` naredbe su isključivo odgovornost korisnika. + +Ako ste razvojni programer i trebate ažurirati dodatak, koristite hotswap umjesto `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje pluginove koji koriste standardni unos/izlaz. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Upozorava kada se otkrije zastarjelo oblikovanje u chat komponentama. + +#### `Paper.bypassHostCheck` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje provjeru podudarnosti uzorka poslužitelja prilikom povezivanja igrača. + +#### `Paper.debugDynamicMissingKeys` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje debug logove za ključeve koji nedostaju u NBT objektima. + +#### `Paper.debugInvalidSkullProfiles` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje debug logove za nevaljane profile glava blokova. + +Ovo logira sve nevaljane glave blokova u svijetu zajedno s njihovim položajem. + +#### `Paper.disableChannelLimit` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje ograničenje od 128 plugin kanala po igraču.[^5] + +#### `Paper.disableClassPrioritization` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje prioritetizaciju klasa pluginova. + +Koristan je u slučaju problema s pluginovima u sjeni. + +#### `Paper.disableFlushConsolidate` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje Netty sustav za spajanje podataka. + +#### `Paper.excessiveTELimit` + +- **Vrsta**: `Integer` +- **Zadano**: `750` + +Ako entiteta ima više od postavljene vrijednosti, dijeli se u više paketa za prijenos. + +#### `Paper.filterThreshold` + +- **Vrsta**: `Integer` +- **Zadano**: `8192` + +Postavlja maksimalnu veličinu paketa koje poslužitelj može primiti odjednom. + +#### `Paper.ignoreJavaVersion` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Onemogućuje provjeru verzije Java-e. + +{% hint style="danger" %} + +### To omogućuje JVM-u da pokuša pristupiti nepostojećem kodu! + +To može trajno oštetiti datoteke poput svijeta i uzrokovati potpuni kvar igre. + +Svi problemi koji proizlaze iz toga isključivo su vaša odgovornost, a Plazma ne pruža nikakvu podršku za to. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Vrsta**: `Integer` +- **Zadano**: `64` + +Postavlja ograničenje imena kanala pluginova.[^6] + +#### `Paper.maxSignLength` + +- **Vrsta**: `Integer` +- **Zadano**: `80` + +Postavlja maksimalnu duljinu teksta na jednom redu ploče. + +#### `Paper.minPrecachedDatafixVersion` + +- **Vrsta**: `Integer` +- **Zadano**: `(verzija svijeta) + 1` + +Postavlja verziju inicijalizacije podataka koje treba predmemorirati. + +Koristan je kad treba ažurirati veliki broj blokova, ali inače se rijetko koristi. + +#### `Paper.parseYamlCommentsByDefault` + +- **Vrsta**: `Boolean` +- **Zadano**: `True` + +Omogućuje obradu komentara u YAML datotekama. + +#### `Paper.playerConnection.keepAlive` + +- **Vrsta**: `Integer` +- **Zadano**: `30` + +Igrač će biti izbačen ako ne primi nikakve podatke od igrača u određenom vremenskom razdoblju (u sekundama). + +Obično, igra[^7] kontinuirano šalje [srca signala](#user-content-fn-8)[^8] poslužitelju, pa neće biti izbačen, ali ako igra prestane odgovarati, smatrat će se da je igra srušena i više neće obrađivati igrača na poslužitelju, te će ga izbaciti. + +#### `Paper.skipServerPropertiesComments` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Ignorira komentare u postavkama poslužitelja. + +#### `Paper.debug-sync-loads` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje debug logove za sinkronizirano stvaranje dijelova. + +#### `Paper.enable-sync-chunk-writes` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje Minecraftov [zadani sustav stvaranja dijelova](#user-content-fn-10)[^10]. + +Ovo uzrokuje da se svaki dio pohranjuje redoslijedom, što dovodi do značajnog smanjenja performansi. + +#### `Paper.explicit-flush` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Omogućuje eksplicitno ispiranje mrežnih kanala. + +#### `Paper.strict-thread-checks` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Uvijek zapisuje pogreške koje nisu nastale na glavnom dretvu. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Upozorava ako rezervirani zadaci imaju preveliko kašnjenje. + +#### `Paperclip.patchOnly` + +- **Vrsta**: `Boolean` +- **Zadano**: `False` + +Ako koristite zadani izvršni datoteku, primjenjuje se samo zakrpa, a poslužitelj se ne pokreće. + +#### `Plazma.aggressiveOptimize` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` + +{% hint style="warning" %} + +### Ovo će svojstvo biti premješteno u početne argumente nakon verzije 1.20.5. + +{% endhint %} + +Primjenjuje strože optimizacije konfiguracije koje se primjenjuju pri prvom pokretanju. + +Aktivacijom će poslužitelj postati brži i sigurniji, ali može blokirati neke mehanizme ili imati veliki utjecaj na igranje igara. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` + +Poništava upozorenje[^11] koje se pojavljuje prilikom inicijalizacije Plazme. + +### 사용 중단된 svojstvo + +Ispod sustav svojstvo su onemogućeni svojstvo. + +#### `timings.bypassMax` + +- **Vrsta**: `Boolean` +- **Zadano**: `false` +- **ZASTARJELO**: Nakon uklanjanja Timingsa iz Plazme + +Odlučuje može li se premašiti maksimalna vrijednost koja se može poslati Aikarovom Timings API-ju. + +Čak i ako se to dogodi, primjenjuje se ograničenje brzine ako se iznimka ne obradi u API-ju. + +*** + +## Početni argument + +Početni argument se unosi nakon `-jar *.jar` kako bi se Plazma inicijalizirala i obrađivala zajedno s njim. + +### Upute za korištenje + +Svojstva sustava unose se kao programski argument iza `-jar *.jar`. + +Na primjer, ako želite primijeniti početni argument `nogui`,\ +unosom kako slijedi, Plazma će tijekom inicijalizacije obraditi argument `nogui`. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Cjelokupni početni argument + +#### `bukkit-settings` + +- **Nadimak**: `b` +- **Zadana vrijednost**: `bukkit.yml` + +Postavlja ime i lokaciju [Bukkit konfiguracijske datoteke](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Nadimak**: `c` +- **Zadana vrijednost**: `commands.yml` + +Postavlja ime i lokaciju [Bukkit konfiguracijske datoteke naredbi](../reference/configurations/bukkit.md). + +#### `config` + +- **Nadimak**: `c` +- **Zadana vrijednost**: `server.properties` + +Postavlja ime i lokaciju [datoteke svojstava servera](../reference/configurations/property.md). + +#### `demo` + +Pokreće server u demo svijetu. + +#### `eraseCache` + +Briše preostale keš datoteke nakon nadogradnje svijeta. + +#### `forceUpgrade` + +Nasilno [nadograđuje](#user-content-fn-12)[^12] svijet bez obzira na verziju. + +#### `help` + +- **Nadimak**: `?` + +Ispisuje sve početne argumente i opise Plazme. + +#### `initSettings` + +Samo stvara konfiguracijsku datoteku i gasi server. + +#### `jfrProfile` + +Omogućuje JFR profiliranje. + +#### `max-players` + +- **Nadimak**: `s`, `size` +- **Zadana vrijednost**: `(svojstvo servera)` + +Postavlja maksimalni broj [igrača](#user-content-fn-14)[^14] koji su dopušteni. + +#### `nogui` + +Onemogućuje grafički sučelje Plazme. + +#### `nojline` + +Onemogućuje JLine i koristi običnu konzolu. + +#### `online-mode` + +- **Nadimak**: `o` +- **Zadana vrijednost**: `(svojstvo servera)` + +Odabire hoće li se igrači provjeravati preko Mojangovih autentikacijskih poslužitelja. + +**U slučaju da se ne koristi Velocity ili drugi posrednici, može doći do kršenja [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Nadimak**: `paper` +- **Zadana vrijednost**: `paper.yml` + +{% hint style="warning" %} + +### Ovaj argument je prestao se koristiti nakon verzije 1.19.4 + +{% endhint %} + +Postavlja lokaciju [PaperSpigot konfiguracijske datoteke](../reference/configurations/paper/README.md) koja je ukinuta. + +Ovo se koristi za prebacivanje postojeće konfiguracije u novu datoteku i više se ne koristi nakon toga. + +#### `paper-settings-directory` + +- **Nadimak**: `paper-dir` +- **Zadana vrijednost**: `config` + +Postavlja ime i lokaciju mape u kojoj se nalazi [Paper konfiguracijska datoteka](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Nadimak**: `plazma-dir` + +Postavlja ime i lokaciju mape u kojoj se nalazi [Plazma konfiguracijska datoteka](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Nadimak**: `p` +- **Zadana vrijednost**: `plugins` + +Postavlja lokaciju mape dodatka. + +#### `pufferfish-settings` + +- **Nadimak**: `pufferfish` +- **Zadana vrijednost**: `pufferfish.yml` + +Postavlja ime i lokaciju [Pufferfish konfiguracijske datoteke](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Nadimak**: `purpur` +- **Zadana vrijednost**: `purpur.yml` + +Postavlja ime i lokaciju [Purpur konfiguracijske datoteke](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Pokreće server u potpunoj vanilla stanju. + +#### `server-ip` + +- **Nadimak**: `h`, `host` +- **Zadana vrijednost**: `(svojstvo servera)` + +Postavlja ime hosta servera ili [IP adresu](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Nadimak**: `p`, `port` +- **Zadana vrijednost**: `(svojstvo servera)` + +Postavlja port servera. + +#### `server-name` + +- **Zadana vrijednost**: `A Plazma Server` + +Postavlja ime servera. + +#### `spigot-settings` + +- **Nadimak**: `S` +- **Zadana vrijednost**: `spigot.yml` + +Postavlja ime i lokaciju [Spigot konfiguracijske datoteke](../reference/configurations/spigot.md). + +#### `version` + +- **Nadimak**: `v` + +Ispisuje verziju Plazme. + +#### `world-dir` + +- **Nadimak**: `W`, `universe`, `world-container` +- **Zadana vrijednost**: `(mapa servera)` + +Postavlja lokaciju gdje se sprema datoteka svijeta. + +#### `world-name` + +- **Nadimak**: `w`, `world` +- **Zadana vrijednost**: `(svojstvo servera)` + +Postavlja ime datoteke svijeta. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Mjesto na kojem se argumenti obrađuju ovisi o dodatku na kraju. + +[^3]: Na primjer, ako želite postaviti `Plazma.iKnowWhatIAmDoing` na `true`, umjesto `-DPlazma.iKnowWhatIAmDoing=true`, dovoljno je unijeti `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: Na primjer, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor događaja. + +[^6]: Detektor događaja. + +[^7]: Klijent. + +[^8]: Signal koji signalizira da je server uspješno povezan poput otkucaja srca. + +[^9]: Korištenjem Purpur AFK izbacivanja, možete izbaciti igrače koji su odsutni. + +[^10]: Sustav pisanja sinkroniziranog chunka, Sync Chunk Write System. + +[^11]: `UPOZORENJE! Plazma može uzrokovati neočekivane probleme, stoga budite sigurni da je temeljito testirate prije nego je koristite na javnom poslužitelju.` + +[^12]: U igri `svjetska optimizacija` također radi prema tom principu. + +[^13]: Internet protokol, IP. + +[^14]: `Administratori razina 2` ili više su isključeni. diff --git a/hr/origin/plazma/adminstration/reference/commands.md b/hr/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..92a23aeb8 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Saznajte o naredbama koje možete koristiti na Plazmi. +--- + +# 🖥️ Naredbe diff --git a/hr/origin/plazma/adminstration/reference/configurations/bukkit.md b/hr/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..a39e2b59e --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Provjerite što svaki čvor u bukkit.yml znači. +--- + +# 🪣 Bukkit diff --git a/hr/origin/plazma/adminstration/reference/configurations/paper/README.md b/hr/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..863a9c655 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Pronađite svrhu svake datoteke u mapi config. +--- + +# 🛩️ Papir diff --git a/hr/origin/plazma/adminstration/reference/configurations/paper/global.md b/hr/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..4b2d5b23e --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u paper-global.yml znači. +--- + +# 🛩️ Paper (globalna konfiguracija) diff --git a/hr/origin/plazma/adminstration/reference/configurations/paper/world.md b/hr/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..44257ed95 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Pronađite što svaki čvor u paper-world.yml znači. +--- + +# 🛩️ Papir (sastav svijeta) diff --git a/hr/origin/plazma/adminstration/reference/configurations/plazma/README.md b/hr/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..0ffd203cf --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Pronađite svrhu svake datoteke u mapi config. +--- + +# ✨ Plazma diff --git a/hr/origin/plazma/adminstration/reference/configurations/plazma/global.md b/hr/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..73d003c98 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u plazma-global.yml znači. +--- + +# ✨ Plazma (globalna konfiguracija) diff --git a/hr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/hr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..586dc7f19 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Svjetska podjela diff --git a/hr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/hr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..1a9edba2d --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Pronađite što svaki čvor u plazma-world.yml znači. +--- + +# ✨ Plazma (sastav svijeta) diff --git a/hr/origin/plazma/adminstration/reference/configurations/property.md b/hr/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..89d946bc0 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Pronađite što svaki čvor u server.properties znači. +--- + +# 🪨 Server.properties diff --git a/hr/origin/plazma/adminstration/reference/configurations/pufferfish.md b/hr/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..27b6c3742 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Provjerite što svaki čvor u pufferfish.yml znači. +--- + +# 🐡 Pufferfish diff --git a/hr/origin/plazma/adminstration/reference/configurations/purpur/README.md b/hr/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..0ede60b78 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u purpur.yml znači. +--- + +# 🦑 Purpur diff --git a/hr/origin/plazma/adminstration/reference/configurations/purpur/global.md b/hr/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..06b2db6c7 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u purpur.yml znači. +--- + +# 🦑 Purpur (globalna struktura) diff --git a/hr/origin/plazma/adminstration/reference/configurations/purpur/world.md b/hr/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..ce434d306 --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u purpur.yml znači. +--- + +# 🦑 Purpur (svijetna struktura) diff --git a/hr/origin/plazma/adminstration/reference/configurations/spigot.md b/hr/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..85d0ff90a --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Saznajte što svaki čvor u spigot.yml znači. +--- + +# 🚰 Spigot diff --git a/hr/origin/plazma/adminstration/reference/permissions.md b/hr/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..45aece38a --- /dev/null +++ b/hr/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Saznajte više o ovlastima Plazme. +--- + +# 🛡️ Ovlasti diff --git a/hr/origin/plazma/developers.md b/hr/origin/plazma/developers.md new file mode 100644 index 000000000..0777c0705 --- /dev/null +++ b/hr/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Iskoristite Plazmu za razvoj projekata trećih strana. +--- + +# ⚙️ Vodič za programere diff --git a/hr/origin/thunderbolt/README.md b/hr/origin/thunderbolt/README.md new file mode 100644 index 000000000..5f8ef40e6 --- /dev/null +++ b/hr/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt je Plazma temeljena serverska platforma koja omogućava eksperimentalne zakrpe da se koriste izravno kao okus. +--- + +# 🌩️ Vodič za korištenje Thunderbolta diff --git a/hr/origin/volt/README.md b/hr/origin/volt/README.md new file mode 100644 index 000000000..ee8a876fe --- /dev/null +++ b/hr/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt je otvoreni izvorni predložak koji vam omogućuje razvoj vlastite platforme za poslužitelj Paperweight temeljenu na Plazmi. +--- + +# ⚡ Vodič za razvoj Volta diff --git a/hu/origin/README.md b/hu/origin/README.md new file mode 100644 index 000000000..3306edde2 --- /dev/null +++ b/hu/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Ha kérdésed van, kérlek tedd fel a Discordon vagy a GitHub Tárgyalásokon keresztül. +--- + +# 🏠 Üdvözöljük a Docs Portalon + +{% hint style="info" %} + +**A Plazma dokumentum jelenleg gépi fordításban van.** + +[![Fordítási állapot](https://badge.plazmamc.org/internal/crowdin)](https://forditas.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) 에서 문서 번역에 참여하여 문서를 개선해 보세요. + +{% endhint %} + +### Ha probléma merül fel a Plazma használata közben, mi a teendő? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Ha érdekel a Thunderbolt, nézd meg. + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Ha saját szerver platformot szeretnél létrehozni a Volt segítségével. + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `TÁMOGATÓ` Ha több Minecraft-related információra van szükséged. + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/hu/origin/SUMMARY.md b/hu/origin/SUMMARY.md new file mode 100644 index 000000000..5f52b47c4 --- /dev/null +++ b/hu/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Tartalomjegyzék + +- [🏠 Üdvözöljük a Dokumentumok Portálon](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Használati Dokumentáció](plazma/README.md) +- [❓ Mi az a Plazma?](plazma/about/README.md) + - [⬇️ Letöltés](plazma/about/downloads.md) + - [✅ Támogatott verziók](plazma/about/supported-versions.md) +- [⚒️ Szerver kezelési útmutató](plazma/administration/README.md) + - [👟 Elkezdés](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referencia](plazma/administration/reference/README.md) + - [🖥️ Parancsok](plazma/administration/reference/commands.md) + - [🛡️ Jogosultságok](plazma/administration/reference/permissions.md) + - [🎛️ Argumentumok és tulajdonságok](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Tulajdonság](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globális konfiguráció](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Világok szerinti konfiguráció](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globális konfiguráció](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Világok szerinti konfiguráció](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globális konfiguráció](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Világok szerinti konfiguráció](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Haladó](plazma/administration/expert/README.md) + - [🧹 Optimalizálás](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanilla konfigurálás](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blokkolás](plazma/administration/expert/xray.md) + - [⚠️ Sebezhetőségek és megoldások](plazma/administration/expert/fix-exploits.md) + - [⁉️ Gyakran Ismételt Kérdések](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Fejlesztői Útmutató](plazma/developers.md) + - [✏️ Hozzájárulás](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Használati Útmutató](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Fejlesztési Útmutató](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Teljes letöltés](plazma/about/downloads-all.md) diff --git a/hu/origin/miscellaneous/README.md b/hu/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/hu/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/hu/origin/plazma/README.md b/hu/origin/plazma/README.md new file mode 100644 index 000000000..261a2d0ec --- /dev/null +++ b/hu/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma egy nyílt forráskódú szerver platform a Minecraft: Java Edition számára, amely papír alapú kísérleti optimalizálást és több játékmechanizmus testreszabási lehetőségét kínál." +--- + +# ✨ Plazma Használati Dokumentáció + +## 👋 Üdvözöljük a Plazma Dokumentációban + +Üdvözöljük a Plazma használati útmutatójában! + +{% hint style="info" %} + +**Nem tudja megoldani a problémát a kézikönyv segítségével?** + +[Hivatalos Discord szerver](https://discord.gg/MmfC52K8A8) vagy a [GitHub Beszélgetések](https://github.com/PlazmaMC/PlazmaBukkit/discussions) segítségével kérdezz a közösségtől! + +{% endhint %} + +### A Plazma-ról + +> Ismerje meg, hogy mi is pontosan a Plazma szerver platform. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Adminisztrátoroknak + +> Hozzon létre saját szerverét a Plazma segítségével. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Fejlesztőknek + +> Fejlesszen harmadik fél projekteket a Plazma segítségével. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/hu/origin/plazma/about/README.md b/hu/origin/plazma/about/README.md new file mode 100644 index 000000000..d81c9814e --- /dev/null +++ b/hu/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Ismerje meg, hogy mi is pontosan a Plazma szerver platform. +--- + +# ❓ Mi az a Plazma? + +- **Plazma** a [Andromeda](https://github.com/EarendelArchived/Andromeda) és a [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) előnyeit hozza csak a [Paper](https://github.com/PaperMC/Paper) alapján létrehozott szerver platformról. +- Mindig igyekszünk magas stabilitást, erős teljesítményt, gyors frissítéseket és bőséges funkciókat nyújtani. + +## 📋 A Plazma célja + +- Azért dolgozunk, hogy olyan szerver platform legyünk, amely gyors frissítéseket és magas stabilitást nyújt. +- Azért dolgozunk, hogy bőséges funkciókat és erős teljesítményt nyújtsunk, ami nem marad el a mod platformoktól. +- Azért dolgozunk, hogy olyan szabad platformot hozzunk létre, amelyen a Vanilla patcheket is testreszabhatja. + +## ⚙️ Főbb jellemzők + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Leggyorsabb frissítések**\ + [A Mindig Naprakész](https://github.com/PlazmaMC/AlwaysUpToDate) lehetővé teszi, hogy a Plazma beépített patch-ei mindig naprakészek legyenek, így a Paper alapú szerver platformok közül a leggyorsabb frissítéseket nyújtja. +6. **Alapvető konfigurációs fájl optimalizálás**\ + Az alapértelmezett konfigurációs fájlok optimalizáltak, így nem kell közvetlenül optimalizálnia a konfigurációs fájlokat. +7. **Rendszeratlagosan működő többszál**\ + Az olyan rendszermechanizmusokat, amelyek nem kapcsolódnak a játék mechanizmusaihoz, aszinkronizáljuk, hogy optimalizáljuk a szerver teljesítményét és csökkentsük a [késleltetési időt](#user-content-fn-4)[^4]. +8. **Felesleges helyhasználat blokkolása**\ + Az azonos értékű adatokat egyesítjük, hogy csökkentsük a memóriahasználatot. + +## ✨ Használati esetek + +- **Az összetett bővítményeket is megfelelően kezelő platform**\ + [IPECTER fejlesztő](https://github.com/IPECTER) szerverén a Plazma van használva.\ + Saját bővítmény, amely NMS és reflexióval működik, valamint bonyolult és nagy adatcsomagokat alkalmaz,\ + 100 főnél több játékost is fogad anélkül, hogy a teljesítmény csökkenne. +- **Az RPG szerveren is gyors teljesítményt biztosító platform**\ + Egyetlen klaszterben 100 játékost sikerült stabilan fenntartani TPS csökkenés nélkül,\ + 4 klaszterben összesen 250 játékos kellemesen játszhatott. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Sok streamer által választott platform**\ + Sok streamer nézői részvételi vödörként választotta és használja. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Letöltés + +A Plazmát letöltheti az alábbi oldalról. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Ha részletes információkat szeretne a támogatott verziókról, látogasson el ide: + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot bővítmények és Paper, Pufferfish, Purpur bővítmények. + +[^2]: Microsoft Corporation. + +[^3]: Ha kikapcsolja a csevegési jelentési rendszert, a csevegés csak a szerveren lesz feldolgozva, és megakadályozhatja a Mojang csevegési nyomkövetését. + +[^4]: Azért, hogy a rendszermechanizmus működjön, a játék egy rövid ideig leáll. diff --git a/hu/origin/plazma/about/downloads-all.md b/hu/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..534a9f024 --- /dev/null +++ b/hu/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma végrehajtható fájl letöltése Teljes nézet +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Verzió | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/hu/origin/plazma/about/downloads.md b/hu/origin/plazma/about/downloads.md new file mode 100644 index 000000000..1e62ba7db --- /dev/null +++ b/hu/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Töltsd le most a Plazma-t, és próbáld ki személyesen. +--- + +# ⬇️ Letöltés + +#### Ha részletes információkat szeretne a támogatott verziókról, látogasson el ide: + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Az alábbi letöltés a normál felhasználók számára készült futtatható fájl.** + +Ha fejlesztő vagy, és más fájlformára van szükséged, kérlek, tekintsd meg az alábbi oldalt. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VerzióLetöltés
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + letöltés +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/hu/origin/plazma/about/patches-list.md b/hu/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..9641f13d8 --- /dev/null +++ b/hu/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Tudj meg mindent a Plazma-hoz hozzáadott összes funkcióról. +--- + +# 📑 Tartalmazott javítások diff --git a/hu/origin/plazma/about/supported-versions.md b/hu/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..0872fbc8c --- /dev/null +++ b/hu/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Tudja meg, hogy a Plazma támogatja-e a Minecraft: Java Edition verziót." +--- + +# ✅ Verzió támogatási állapot + +{% hint style="info" %} + +**Plazma 1.19.4 után fejlesztették, 1.19.4 alatti verziók nincsenek fejlesztve.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/정보%20없음 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/általános +[100]: https://badge.plazmamc.org/percent/100 + +![Várakozásban][wtr] ![Fejlesztés alatt][idv] ![Támogatás alatt][atv] ![Funkció támogatás megszüntetve][fse] ![Támogatás befejezve][eol] + +| Verzió | Stabilitás és Funkcionális Támogatás | Építés állapota | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Építési állapot](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Build állapot](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Build állapot](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/hu/origin/plazma/administration/README.md b/hu/origin/plazma/administration/README.md new file mode 100644 index 000000000..02329e449 --- /dev/null +++ b/hu/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Hozzon létre saját szerverét a Plazma segítségével. +--- + +# ⚒️ Szerver kezelési útmutató diff --git a/hu/origin/plazma/administration/diagnosis/README.md b/hu/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..a37ac35f0 --- /dev/null +++ b/hu/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Tudj meg többet arról, hogy hogyan kezeljük a problémákat. +--- + +# 🧾 진단 diff --git a/hu/origin/plazma/administration/diagnosis/plugins.md b/hu/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..bd4ebb131 --- /dev/null +++ b/hu/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Tudj meg többet arról, hogyan lehet megoldani, ha a bővítmény nem működik megfelelően. +--- + +# 📜 플러그인 diff --git a/hu/origin/plazma/administration/expert/README.md b/hu/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..829072026 --- /dev/null +++ b/hu/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a Plazma szakmai kezelését. +--- + +# 🎓 Mesterfok diff --git a/hu/origin/plazma/administration/expert/fix-exploits.md b/hu/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..368b5492e --- /dev/null +++ b/hu/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a ismert sebezhetőségeket és azok megoldási módjait. +--- + +# ⚠️ Ismert sebezhetőségek és azok megoldási módja diff --git a/hu/origin/plazma/administration/expert/optimize.md b/hu/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..e69a2d835 --- /dev/null +++ b/hu/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogyan optimalizálja a Plazmát. +--- + +# 🧹 Optimalizálás diff --git a/hu/origin/plazma/administration/expert/proxy.md b/hu/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..99ed9e312 --- /dev/null +++ b/hu/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg, hogyan lehet biztonságosan konfigurálni a "Velocity" proxy platformot. +--- + +# 🔀 Proxy diff --git a/hu/origin/plazma/administration/expert/vanillaize.md b/hu/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..6a583135b --- /dev/null +++ b/hu/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Ismerje meg, hogyan lehet helyreállítani a Paper és a Vanilla patch-ét. +--- + +# ↩️ Vanillaizálás + +{% hint style="warning" %} + +**A Paper nem tartalmaz választási lehetőséget a legtöbb hibajavító javítás esetén a Vanilla hibáinak megoldásához.** + +A Plazma jelenleg olyan konfigurációt fejleszt, amely lehetővé teszi ezeknek a hibajavításoknak a letiltását. + +Ezért ez az útmutató még írás alatt áll, és mindig változhat az információ. + +{% endhint %} diff --git a/hu/origin/plazma/administration/expert/xray.md b/hu/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..b211e4275 --- /dev/null +++ b/hu/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a különböző beágyazott módszereket, amelyek blokkolják az X-Ray-t. +--- + +# 🩻 X-Ray blokkolása diff --git a/hu/origin/plazma/administration/faq.md b/hu/origin/plazma/administration/faq.md new file mode 100644 index 000000000..26b2fcdf6 --- /dev/null +++ b/hu/origin/plazma/administration/faq.md @@ -0,0 +1,43 @@ +--- +description: Ismerje meg a gyakran ismételt kérdéseket. +--- + +# ⁉️ Gyakran Ismételt Kérdések + +{% hint style="info" %} + +**Nem találja a kívánt választ?** + +[Hivatalos Discord szerver](https://discord.gg/MmfC52K8A8) vagy a [GitHub Beszélgetések](https://github.com/PlazmaMC/PlazmaBukkit/discussions) segítségével kérdezz a közösségtől! + +{% endhint %} + +### A Plazma nem indul el + +Ha a `no main manifest attribute, in plazma-(version).jar` üzenet jelenik meg a konzolon, akkor a letöltött fájl a fejlesztői API fájl, és a GitHub oldalról letöltendő a **Reobf Paperweight**. + +További információért tekintse meg a következő oldalt. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### A szerver indításakor figyelmeztetés jelenik meg + +A Plazma néhány instabil javítást tartalmaz, és mindig fennáll a hibás működés lehetősége, ezért a szerver indításakor ilyen figyelmeztetéseket jelenít meg. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ezt a figyelmeztetést a [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] rendszer tulajdonság használatával lehet kikapcsolni. + +További információért tekintse meg a következő oldalt. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Elérhető 1.20.1 verziótól diff --git a/hu/origin/plazma/administration/getting-started/README.md b/hu/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..61d8f1162 --- /dev/null +++ b/hu/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Tudj meg többet arról, hogyan készíthetsz szervereket a Plazma segítségével. +--- + +# 👟 Kezdés + +A Plazma stabil használatához a rendszernek az alábbi követelményeknek kell megfelelnie. + +| | Minimum | Ajánlott | +| :----------: | ------- | -------- | +| Architektúra | x64 | - | +| RAM | 8GB | 16GB | +| Tárhely | 1GB | 8GB | +| JDK | 17 | 21 | + +A könnyebb konfiguráció módosítás érdekében érdemes telepíteni olyan szerkesztőket, mint a [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Helyes kimenet" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Futtatókörnyezet Zulu21.32+17-CA (verzió: 21.0.2+13-LTS) +OpenJDK 64-bites Szerver VM Zulu21.32+17-CA (verzió: 21.0.2+13-LTS, vegyes mód, megosztás) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' nem ismert parancs, belső vagy külső parancs, futtatható program vagy +batch fájl. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Felismeretlen opció: --version +Hiba: Nem lehet létrehozni a Java virtuális gépet. +Hiba: Végzetes kivétel történt. A program leáll. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Először töltsd le az **JDK 21**-et az [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) oldalról `.msi` formátumban. +2. Futtasd a letöltött telepítő varázslót, majd kattints a `Next` gombra. +3. A megjelenő menüben a bal középső részen aktiváld a `Set JAVA_HOME variable` lehetőséget, majd kattints a `Next` gombra. +4. Nyomd meg az `Install` gombot az JRE telepítéséhez. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Ezután futtasd a következő parancsot a terminálban az JRE telepítéséhez. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma letöltése + +A Plazma többféle futtatható fájlt kínál. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +További információk + +A futtatható fájl neve `plazma-(verzió kezelő)-1.20.4-R0.1-SNAPSHOT-(leképezési forma).jar`-ra van beállítva. + +- **Leképezési forma**\ + A leképezés a Minecraft valós kódját és az obfuskált kódot összekötőfajta térkép. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang által leképezett, a Vanilla Minecraft leképezése. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Verzió kezelő**\ + A verzió kezelő egy olyan indító, amely a szerver futtatásához szükséges könyvtárakat és a szerver fájlokat patcheli. + - **Paperclip**\ + A PaperMC csapata által fejlesztett kezelő a Paper és más származékokhoz, amely letölti a könyvtárakat és alkalmazza a javításokat a szerverre. + - **Bundler**\ + A Vanilla Minecraft verzió kezelője. + +
+ +*** + +## 3. Indító szkript létrehozása + +A Plazmát egyszerűen elindíthatod és a szerver automatikusan újraindul, ha egy [indító szkriptet](#user-content-fn-6)[^6] hozol létre. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +A bal alsó sarokban lévő Letöltés gombbal töltheted le az indító szkriptet.\ +**Ellenőrizd, hogy a letöltött indító szkript megegyezik-e az operációs rendszereddel.** + +*** + +## 4. Fájlok rendezése + +Most már mozgasd a letöltött indító szkriptet és a Plazmát egy új mappába. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Most futtasd az indító szkriptet. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA elfogadása + +Miután egyszer futtattad az indító szkriptet, a mappában létrejön az `eula.txt` fájl. + +Az EULA[^9] egy olyan felhasználási szerződés, amelyet elfogadnod kell a [Mojang Studios](#user-content-fn-10)[^10] szolgáltatásainak használata során. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Az EULA elfogadásához módosítsd az `eula.txt` fájlban az `eula=false`-t `eula=true`-ra, majd mentsd el a változtatásokat. + +*** + +## 6. Külső hozzáférés engedélyezése (Windows) + +A modern operációs rendszerek alapértelmezetten blokkolják a külső hozzáférést a tűzfal és a router által, hogy megvédjenek a veszélyes hozzáférésektől. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Ha a router nem támogatja az UPnP-t, vagy a router típusától függően eltérő lehet a panel, akkor magadnak kell keresned információkat. + +Vagy használhatsz az [Ngrok](https://ngrok.com/) segítségével ideiglenes címet. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Port forwarding szükségességének ellenőrzése + +Írd be a Futtatás mezőbe az alábbiakat, majd nyomd meg az Enter billentyűt. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ha a kimenet `True`, akkor elég ennyi, ha viszont `False`, akkor be kell állítani a port forwardingot. + +### 6.2 Szerverhez való csatlakozás + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +A szerverhez való csatlakozáshoz használt cím [itt](https://ip.pe.kr/) található meg. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Ezután a szerver újraindítása után a Plazma automatikusan megpróbálja a porttovábbítást. + +Az alábbiakban az UPnP sikerességét jelző üzenetek találhatók, amelyek a konzolon `[UPnP] (üzenet)` formában jelennek meg. + +| üzenet | jelentés | +| ---------------------------------------- | ------------------------------------------------------------------ | +| `Sikeresen megnyitott port (port)` | Porttovábbítás sikeres. | +| `A port (port) már nyitva van` | Egy másik szolgáltatás használja már ezt a portot. | +| `Nem sikerült megnyitni a portot (port)` | Porttovábbítás sikertelen. | +| `A szolgáltatás nem elérhető` | A router nem támogatja az UPnP-t. | + +Amikor a szerver leáll, a Plazma automatikusan bezárja a portokat. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok weboldal](https://ngrok.com/download)-ról töltsd le a `Windows (64-bit)` ZIP fájlt. +2. Tedd a letöltött Ngrok-ot a szerver mappába. +3. [Ngrok vezérlőpult](https://dashboard.ngrok.com/get-started/your-authtoken)-ról hozz létre egy [hitelesítési token](#user-content-fn-13)[^13]-at. +4. Futtasd a szerver mappában az alábbi `Command Line`-on megjelenő parancsot. +5. A futtatási szkript legtetejére add hozzá `start /b ngrok tcp --region jp 25565`, a legalsó sorba pedig `taskkill /f /t /im ngrok.exe`-t. +6. A konzol tetején található `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`-nél a `0.tcp.jp.ngrok.io:12345` lesz a szerver címe. +7. Most már külsőleg is csatlakozhatsz ezen a címen keresztül. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Például, ha a parancs végrehajtása után a következőképpen jelenik meg a kimenet, + +```log +Windows IP konfiguráció + +Ethernet adapter Ethernet: + + Csatlakoztatott DNS keresztnév. . . . : + IPv4 cím. . . . . . . . . : 192.168.3.7 + Alhálózati maszk . . . . . . . : 255.255.255.0 + Alapértelmezett átjáró . . . . . . : 192.168.3.1 + +``` + +Ha megpróbálja csatlakozni a `192.168.3.7` címen megadott IPv4 címen keresztül, akkor a helyi gépről csatlakozhat a szerverhez. + +Ha a szerver és a játék ugyanazon a PC-n fut, akkor a `localhost`-on keresztül is csatlakozhat. +{% endtab %} +{% endtabs %} + +## 7. Fejlődni + +Ha sikeresen elindította a szervert, és a szerver megfelelően működik, most a szerver testreszabásának ideje van. + +Ismerje meg, hogyan személyre szabhatja a szerver használatát az alábbi útmutató segítségével. + +{% content-ref url="kovetkezo-lepes.md" %} +[kovetkezo-lepes.md](kovetkezo-lepes.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: A Plazma alapú Paper a Spigotra épül, és a Spigot az hivatalos szerver platformon alapul. + +[^3]: Windows kulcs + R + +[^4]: Linux esetén a `java --version` paranccsal a terminálban + +[^5]: A JRE egy nyílt forráskódú projekt, például a Minecraft szerver platformhoz hasonlóan többféle változat létezik. + +[^6]: Általában **hajtóműnek** nevezik. + +[^7]: Az "Automatikus újraindítás" bekapcsolásával a szerver automatikusan újraindul. Beírhatja a `Control + C` parancsot a leállításhoz. + +[^8]: Nem ajánlott a rendszer felének túllépése. + + Például ha a rendszer teljes memóriája 8 GB, akkor nem ajánlott 4 GB-nál többet beállítani. + +[^9]: Végfelhasználói licencszerződés, End-User License Agreement. További részletekért kérjük, látogassa meg a [Minecraft honlapját](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: A Dél-Koreai játékipar támogatásáról szóló törvény 32. cikk (1) bekezdése (9) pontja alapján a **Korea Microsoft Corporation** jogi lépéseket tehet. + +[^12]: Universal Plug & Play. A Purpur, amely a Plazmában található, automatikusan kommunikál a routerrel ezen a technológián keresztül, és csak akkor nyitja meg a portokat, amikor a szerver fut, ezért nincs szükség közvetlen portnyitásra. + +[^13]: Ha nincs fiókja, regisztráljon a Google vagy a GitHub fiókján keresztül a Ngrokhoz. diff --git a/hu/origin/plazma/administration/getting-started/customization.md b/hu/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..f6bace6d3 --- /dev/null +++ b/hu/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,124 @@ +--- +description: Ismerd meg, hogyan személyre szabhatod a szerveredet. +--- + +# 🎨 Felhasználói testreszabás + +Azért használják a módosított szerverplatformot, például a Plazmát, és nem a Mojang Studios által biztosított hivatalos szerverplatformot, mert a legnagyobb előnye az erős felhasználói **testreszabhatóság** lehetősége. + +Az alábbiakban látható néhány módja annak, hogyan lehet testreszabni és kihasználni a Plazmát. + +## Konfiguráció módosítása + +A Plazma testreszabásának leg alapvetőbb módja az, hogy módosítjuk a konfigurációt. + +A Plazma erős konfigurációs beállításokat kínál a játék mechanizmusaitól az entitások tulajdonságaiig. + +A Plazma konfigurációjával kapcsolatos részletekért tekintse meg az alábbi oldalt. + +{% content-ref url="../reference/configurations/" %} +[konfigurációk](../reference/configurations/) +{% endcontent-ref %} + +## Bővítmények használata + +{% hint style="success" %} + +**Plazma támogatja az összes Papír alapú bővítményt.** + +A Spigot bővítmények esetében a 1.20.5-től kezdve a Papír térképezési változása miatt néhány nem működhet megfelelően, +Azonban a Papír, Pufferfish és Purpur alapú bővítmények többsége a Plazmában is megfelelően működik, +Ha valamelyik nem működik megfelelően, az a Plazma hibája, ezért kérjük, azonnal [jelentse be.](../diagnosis/plugins.md) + +{% endhint %} + +A Plazma használatának fő oka és egyben a Plazma testreszabásának legerősebb módja. +A Plazma erős bővítmény ökoszisztémája lehetővé teszi a szerver könnyű testreszabását. + +Számos módszer létezik a bővítmények keresésére és letöltésére. Néhány bővítményt +nyilvános tárolószolgáltatásokra töltik fel, míg másokat a GitHub-on vagy saját +webhelyükön töltenek fel. + +{% hint style="caution" %} + +**A bővítmények közvetlen hozzáférést biztosítanak a rendszerhez!** + +Mindig ellenőrizze a bővítmény biztonságát a VirusTotal és hasonló szolgáltatásokkal, mielőtt alkalmazná, +vagy megbízható forrásból töltse le a bővítményt. + +{% endhint %} + +Számos szolgáltatás létezik a bővítmények letöltésére. Ezek közül a [SpigotMC Fórum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) és más szolgáltatások a bővítmények feltöltése előtt ellenőrzést végeznek, és az biztonságtalan bővítményeket azonnal kezelik, hogy csak biztonságos bővítmények legyenek forgalomban. + +### Bővítmény alkalmazása + +Ha letöltötte a bővítményt, most alkalmazhatja azt. + +1. A bővítmények `.jar` vagy `Java végrehajtható fájl` formátumban vannak.\ + Néhány bővítmény tömörített fájlként van jelen, ilyen esetekben + csomagolja ki, és ha a név tartalmazza a `bukkit`, `spigot` vagy `paper` szót, + akkor a `fat` fájlt használja. +2. Helyezze át a letöltött fájlt a szerver mappájában található `plugins` mappába, majd indítsa újra a szervert. +3. Amikor a Plazma elindul, új tartalom jelenik meg a konzolon. + Ez azt jelenti, hogy a Plazma sikeresen betöltötte a bővítményeket. +4. Még ha a Plazma sikeresen betöltötte a bővítményeket, előfordulhat, hogy nem sikerült elindítani azokat. + A `/plugins` parancs segítségével lekérdezheti a jelenleg betöltött bővítményeket a szerveren. + Ha a telepített bővítmények neve nem + vörös, hanem + zöld, az azt jelenti, hogy a bővítmények sikeresen betöltöttek. + +Ha a bővítmények nem töltődtek be megfelelően, az alábbi oldalon találhat megoldásokat a problémákra. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Adatcsomag használata + +Az adatcsomagok a Minecraft által alapértelmezett módon biztosított testreszabási lehetőségek, hasonlóan a [erőforrás csomagokhoz](#user-content-fn-1)[^1]. + +Az adatcsomagok lehetővé teszik új entitások és kihívások hozzáadását, valamint más játékbeli elemek módosítását. + +{% hint style="caution" %} + +**Az adatcsomagok károsíthatják a világot!** + +Néhány hibás adatcsomag károsíthatja a világot, és ez visszafordíthatatlan. + +Ezért ajánlott a világ biztonsági mentése az adatcsomagok alkalmazása előtt. + +{% endhint %} + +Az adatcsomagokat számos szolgáltatásról letöltheti, mint például a [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) és más szolgáltatások. + +Ha letöltötte az adatcsomagot, helyezze azt a szerver világ mappájában található `datapacks` mappába az alkalmazáshoz. +Ha a mappa nem létezik, hozzon létre egyet az adatcsomagok hozzáadásához. + +{% hint style="warning" %} + +**Néhány [adatcsomag](#user-content-fn-2)[^2] esetén az első alkalmazás nem biztos, hogy sikeres lesz.** + +Ebben az esetben ajánlott **2 alkalommal** újraindítani a szervert. + +{% endhint %} + +Az adatcsomagok könnyen megsérülhetnek a Minecraft frissítésekor. + +Különösen, ha az adatcsomag teljesen megsérült, a szerver összeomolhat, +éppen ezért fontos a szerver frissítése előtt alaposan tesztelni. + +{% hint style="info" %} + +**A szerver indítóparancs után írja be a `safeMode` parancsot, hogy az összes adatcsomagot kikapcsolja, majd indítsa újra a szervert.** + +[További információkért lásd a `Referencia > Argumentumok` részt.](../reference/arguments.md) + +{% endhint %} + +Az alkalmazott adatcsomagokat a `/datapack list` parancs segítségével ellenőrizheti. + +*** + +[^1]: Vagy a Minecraft: Bedrock kiadásának kiegészítője. + +[^2]: Entitások hozzáadása stb. diff --git a/hu/origin/plazma/administration/getting-started/next-step.md b/hu/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..8b6c60ff4 --- /dev/null +++ b/hu/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Ismerd meg, hogyan személyre szabhatod a szerveredet. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Az alábbiakban látható néhány módja annak, hogyan lehet testreszabni és kihasználni a Plazmát. + +## Konfiguráció módosítása + +A Plazma testreszabásának leg alapvetőbb módja az, hogy módosítjuk a konfigurációt. + +A Plazma erős konfigurációs beállításokat kínál a játék mechanizmusaitól az entitások tulajdonságaiig. + +A Plazma konfigurációjával kapcsolatos részletekért tekintse meg az alábbi oldalt. + +{% content-ref url="../reference/configurations/" %} +[konfigurációk](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Bővítmények használata + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +A Plazma használatának fő oka és egyben a Plazma testreszabásának legerősebb módja. A Plazma erős bővítmény ökoszisztémája lehetővé teszi a szerver könnyű testreszabását. + +Számos módszer létezik a bővítmények keresésére és letöltésére. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Számos szolgáltatás létezik a bővítmények letöltésére. Ezek közül a [SpigotMC Fórum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) és más szolgáltatások a bővítmények feltöltése előtt ellenőrzést végeznek, és az biztonságtalan bővítményeket azonnal kezelik, hogy csak biztonságos bővítmények legyenek forgalomban. + +### Bővítmény alkalmazása + +Ha letöltötte a bővítményt, most alkalmazhatja azt. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Helyezze át a letöltött fájlt a szerver mappájában található `plugins` mappába, majd indítsa újra a szervert. +3. Amikor a Plazma elindul, új tartalom jelenik meg a konzolon. Ez azt jelenti, hogy a Plazma sikeresen betöltötte a bővítményeket. +4. Még ha a Plazma sikeresen betöltötte a bővítményeket, előfordulhat, hogy nem sikerült elindítani azokat. A `/plugins` parancs segítségével lekérdezheti a jelenleg betöltött bővítményeket a szerveren. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Ha a bővítmények nem töltődtek be megfelelően, az alábbi oldalon találhat megoldásokat a problémákra. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Adatcsomag használata + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Az adatcsomagok lehetővé teszik új entitások és kihívások hozzáadását, valamint más játékbeli elemek módosítását. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Néhány hibás adatcsomag károsíthatja a világot, és ez visszafordíthatatlan. + +Ezért ajánlott a világ biztonsági mentése az adatcsomagok alkalmazása előtt. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Ha letöltötte az adatcsomagot, helyezze azt a szerver világ mappájában található `datapacks` mappába az alkalmazáshoz. Ha a mappa nem létezik, hozzon létre egyet az adatcsomagok hozzáadásához. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Ebben az esetben ajánlott **2 alkalommal** újraindítani a szervert. +{% endhint %} + +Az adatcsomagok könnyen megsérülhetnek a Minecraft frissítésekor. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Az alkalmazott adatcsomagokat a `/datapack list` parancs segítségével ellenőrizheti. + +*** + +## Optimalizálás + +A Plazmában sok optimalizálási javítás van. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +További információk a biztonságos és helyes proxy beállításokról az alábbi oldalon találhatók. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Biztonság + +A Minecraftban a modok fejlődése miatt könnyen elérhetővé válnak az [exploit motorok](#user-content-fn-3)[^3] online is. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Jogosultság beállítás + +Néhány plugin admin parancsának megfelelő jogosultság nélkül is létezhetnek biztonsági rések. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokkolás + +Az X-Ray az alapvető optimalizálási kliensben könnyen használható egyik exploit. + +A Plazmában alapvetően blokkolható az X-Ray használata. + +Az X-Ray blokkolásának módjáról és leírásáról az alábbi oldalon talál részletes információt. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +A whitelist-re engedélyezett játékosok listájának megtekintéséhez használd a `/whitelist query` parancsot. + +*** + +[^1]: Vagy a Minecraft: Bedrock kiadásának kiegészítője. + +[^2]: Entitások hozzáadása stb. + +[^3]: Általában "hack"-ként említik. + +[^4]: Ha a konfiguráció nincs optimalizálva, vagy a Plazma elavult, vagy újonnan felfedezett exploitok vannak, előfordulhat, hogy nem blokkolódnak. + +[^5]: A játékosok a Ngrok proxy szerveren keresztül csatlakoznak a szerverhez, és minden újraindításkor kiosztott Ngrok cím más lesz. diff --git a/hu/origin/plazma/administration/reference/README.md b/hu/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..424f50997 --- /dev/null +++ b/hu/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Tudj meg többet a Plazma által biztosított alapértelmezett felhasználói testreszabási módszerekről. +--- + +# 📜 리퍼런스 + +A Plazma többféle felhasználói testreszabási módszert kínál. + +Ezek közül 4 módszer azonnal használható, további munka nélkül. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Hivatalos Discord szerver](https://discord.gg/MmfC52K8A8) vagy a [GitHub Beszélgetések](https://github.com/PlazmaMC/PlazmaBukkit/discussions) segítségével kérdezz a közösségtől! +{% endhint %} + +*** + +## 🖥️ Parancs + +> A parancsok lehetővé teszik az információgyűjtést a játékban és a játék környezetének testreszabását. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Jogosultság + +> A jogosultságok meghatározzák a játékosok interakciós lehetőségeit. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumentumok és tulajdonságok + +> Az argumentumok és tulajdonságok általános hatással vannak a Plazma működésére. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguráció + +> A konfiguráció a Plazma leg alapvetőbb testreszabási módja. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/hu/origin/plazma/administration/reference/arguments.md b/hu/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..bb0e46428 --- /dev/null +++ b/hu/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Ismerje meg a kezdő paramétereket és rendszer tulajdonságait. +--- + +# 🎛️ Paraméterek és tulajdonságok + +A kezdő argumentumok és rendszer tulajdonságok azok az értékek, amelyeket hozzá kell adni a Plazma futtatásához használt parancshoz [fn-1](#user-content-fn-1)[^1], és általánosságban befolyásolják a Plazma működését. + +[A **kezdeti argumentumokra** és a **rendszer tulajdonságokra** oszlik az **utasításokhoz hozzáadott helyzet** alapján](#user-content-fn-2)[^2]. + +*** + +## Rendszer tulajdonság + +A rendszer tulajdonságok az `-jar` előtt kerülnek be azon értékek közé, amelyeket a Plazma inicializálása előtt a JVM kezel. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Használati útmutató + +A rendszer tulajdonságok a `java` és a `-jar` közötti Java parancsparaméterként kerülnek megadásra. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +A `-D` azt jelzi, hogy ez a paraméter nem a JVM-be van beágyazva, hanem kizárólag a Plazmához hozzáadott saját paraméter. + +Ha nem ad meg értéket a tulajdonságoknál, az érték [`true`-ra lesz rögzítve](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Összes rendszer tulajdonság + +#### `convertLegacySigns` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a lejárt jelzőtáblák formátumának frissítését. + +#### `debug.entities` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi az entitásokhoz kapcsolódó hibakeresési naplókat. + +#### `debug.rewriteForIDE` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Az IDE-ben a helyes verzióinformációk betöltéséhez letiltja az NMS átvizsgálást,\ +éés automatikusan újra leképezi a belső verzióinformációkat. + +#### `disable.watchdog` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a Spigot Watchdog figyelmeztetési rendszerét. + +#### `letMeReload` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a `/reload` parancs megerősítő üzenetét. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Ha fejlesztő vagy és frissítened kell a bővítményedet, használj inkább hotswapot a `/reload` helyett. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a standard input-output rendszert használó bővítményeket. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Figyelmeztet, ha elavult formázást észlel a csevegés komponensben. + +#### `Paper.bypassHostCheck` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a szerverhez való csatlakozáskor a szerver mintázat ellenőrzését. + +#### `Paper.debugDynamicMissingKeys` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a hiányzó kulcsokkal kapcsolatos hibakeresési naplókat az NBT objektumokban. + +#### `Paper.debugInvalidSkullProfiles` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a hibás koponya profilokkal kapcsolatos hibakeresési naplókat. + +Ez minden hibás koponya blokkot a világban a helyükkel együtt naplóz. + +#### `Paper.disableChannelLimit` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a plugin osztály prioritás rendszert. + +Hasznos lehet problémák esetén a plugin shade-ben. + +#### `Paper.disableFlushConsolidate` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a Netty flush konszolidációs rendszert. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Alapértelmezett**: `750` + +Ha az entitások száma meghaladja ezt az értéket, több részre osztva küldi el őket. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Alapértelmezett**: `8192` + +Beállítja a szerver által egyszerre fogadható maximális csomagméretet. + +#### `Paper.ignoreJavaVersion` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a Java verzió ellenőrzést. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Ez állandóan károsíthatja a világ és más fájlokat, és a játék teljes mechanizmusát tönkreteheti. + +Minden ebből eredő problémáért Ön a felelős, és a Plamza nem nyújt támogatást ezzel kapcsolatban. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Alapértelmezett**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Alapértelmezett**: `80` + +Beállítja a táblák egy sorára írható maximális karakterhosszt. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Alapértelmezett**: `(világ verzió) + 1` + +Beállítja az inicializálandó világfrissítési információ verzióját. + +Hasznos lehet nagy mennyiségű chunk frissítésekor, de egyéb esetekben nem használatos. + +#### `Paper.parseYamlCommentsByDefault` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `True` + +Engedélyezi a YAML fájlok kommentjeinek feldolgozását. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Alapértelmezett**: `30` + +Ha a játékostól a megadott idő (másodperc) alatt nincs adatátvitel, akkor a játékost kirakja. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +A szerver tulajdonságok kommentjeit figyelmen kívül hagyja. + +#### `Paper.debug-sync-loads` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a szinkron chunk írásának hibakeresési naplóit. + +#### `Paper.enable-sync-chunk-writes` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a Minecraft [alapértelmezett chunk írási rendszert](#user-content-fn-10)[^10]. + +Ez a chunkokat sorrendben menti, ami jelentős teljesítményveszteséget okoz. + +#### `Paper.explicit-flush` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a hálózati csatorna explicit kiürítését. + +#### `Paper.strict-thread-checks` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Mindig naplózza a fő szálon nem előforduló hibákat. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Ha a késleltetés túl hosszú, figyelmeztetést ad a tervezett műveletekről. + +#### `Paperclip.patchOnly` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Ha az alapértelmezett futtatható fájlt használja, csak a javítást alkalmazza a szerver indítása nélkül. + +#### `Plazma.aggressiveOptimize` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` +- **Ütközés**: `Plazma.disableConfigOptimization` + +A kezdeti konfigurációt erősebben optimalizálja. + +Aktiválás esetén a szerver gyorsabb és biztonságosabb lesz, de nagy hatással lehet a játékmenetre. + +#### `Plazma.disableConfigOptimization` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` +- **Ütközés**: `Plazma.aggressiveOptimize` + +Nem optimalizálja a kezdeti konfigurációt. + +Ez lehetővé teszi a Paper alapértelmezett konfigurációjának használatát. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` + +Letiltja a Plazma márka használatát, és a vanília alapértelmezett szerver faviót használja. + +#### `Plazma.useVanillaConfiguration` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` +- **Ütközés**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Ez jelentősen befolyásolhatja a szerver biztonságát és teljesítményét. + +Ez a tulajdonság használatából eredő összes problémáért a szerver adminisztrátor a felelős. +{% endhint %} + +A kezdeti konfigurációt a Mojang által rendelt alapértékekkel szolgáltatja. + +Ez letiltja a Paper által alkalmazott összes biztonsági rést. + +A biztonsági réseket újra aktiválhatja a Paper konfigurációban vagy a Plazma konfigurációban. + +#### `Plazma.vanillaize` + +- **Forma**: `Boolean` +- **Alapértelmezés**: `true` +- **Ütközés**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +A kezdeti konfigurációt közelebb állítja a vaníliához. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Használt tulajdonság + +Az alábbi rendszer tulajdonság egy használt tulajdonság. + +#### `timings.bypassMax` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` +- **Használt**: Timings a Plazma-ban történő teljes eltávolítása óta + +Meghatározza, hogy az Aikar Timings API-ba elküldhető érték túllépheti-e a maximált. + +Ha így teszel, és az API nem kezeli kivételesen, akkor a sebességkorlály alkalmazódik. + +*** + +## Indítási argumentum + +Az indítási argumentumok a `-jar *.jar` után kerülnek be, amikor a Plazma inicializálódik és együttesen kezelik őket. + +### Használati útmutató + +A rendszer tulajdonságokat a `-jar *.jar` után program parancs argumentumként adják meg. + +Például, ha a `nogui` indítási argumentumot akarod alkalmazni, \ +akkor az alábbi módon beírva a Plazma inicializálása közben a `nogui` argumentumot fogja kezelni. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Teljes indítási argumentumok + +#### `bukkit-settings` + +- **Alias**: `b` +- **Alapértelmezett**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Alapértelmezett**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Alapértelmezett**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +A demó világgal indítja a szervert. + +#### `eraseCache` + +A világ frissítése után a megmaradt gyorsítótárazott fájlokat eltávolítja. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Kiírja a Plazma teljes indítási argumentumait és leírását. + +#### `initSettings` + +Csak a konfigurációs fájlokat hozza létre és leállítja a szervert. + +#### `jfrProfile` + +Aktiválja a JFR profilozást. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Letiltja a grafikus felhasználói felület panelt. + +#### `nojline` + +JLine-et kikapcsolva, és a vanília konzolt használja. + +#### `online-mode` + +- **Alias**: `o` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +Mojang hitelesítő szerverrel ellenőrzi a játékosokat. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-beállítások` + +- **Alias**: `paper` +- **Alapértelmezett**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +A használaton kívüli PaperSpigot konfigurációs fájl helyét állítja be. + +Ez az előző konfiguráció áthelyezésére szolgál egy új konfigurációs fájlba, majd ezt követően már nem használható. + +#### `paper-beállítások-mappája` + +- **Alias**: `paper-mappa` +- **Alapértelmezett**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-beállítások-mappája` + +- **Alias**: `plazma-mappa` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `bővítmények` + +- **Alias**: `b` +- **Alapértelmezett**: `bővítmények` + +A bővítmények mappájának beállítása. + +#### `pufferfish-beállítások` + +- **Alias**: `pufferfish` +- **Alapértelmezett**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-beállítások` + +- **Alias**: `purpur` +- **Alapértelmezett**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(Biztonságos mód) Teljesen vanília állapotban indítja a szervert. + +#### `szerver-ip` + +- **Alias**: `h`, `host` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `szerver-port` + +- **Alias**: `p`, `port` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +A szerver portját állítja be. + +#### `szerver-név` + +- **Alapértelmezett**: `Egy Plazma Szerver` + +A szerver nevét állítja be. + +#### `spigot-beállítások` + +- **Alias**: `S` +- **Alapértelmezett**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `verzió` + +- **Alias**: `v` + +Plazma verzióját jeleníti meg. + +#### `világ-mappa` + +- **Alias**: `W`, `univerzum`, `világ-tartó` +- **Alapértelmezett**: `(szerver mappa)` + +A világ fájlok mentési helyét állítja be. + +#### `világ-név` + +- **Alias**: `w`, `világ` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +A világ fájl nevét állítja be. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Az argumentumok kezelése a hozzáadott helytől függ. + +[^3]: Például, ha be akarja állítani (aktiválni) a `Plazma.iKnowWhatIAmDoing`-ot `true`-ra, akkor csak a `-DPlazma.iKnowWhatIAmDoing`-ot kell megadnia, és ugyanúgy működni fog, mint a `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Például, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Eseményfigyelő. + +[^6]: Eseményfigyelő. + +[^7]: Kliens. + +[^8]: A szerverrel való megfelelő kapcsolatot jelző jelek, mint a szívverés. + +[^9]: A Purpur AFK kick funkcióval még az inaktív játékosokat is kickelheti. + +[^10]: Szinkron Chunk írási rendszer, Sync Chunk Write System. + +[^11]: `FIGYELEM! Plazma váratlan problémákat okozhat, ezért előtte alaposan tesztelje, mielőtt nyilvános szerveren használná.` + +[^12]: A játékban a `világ optimalizálás` is ugyanezen elven működik. + +[^13]: A `szint 2` vagy nagyobb szintű adminisztrátorokat kizárja. + +[^14]: Internet Protocol, IP. diff --git a/hu/origin/plazma/administration/reference/commands.md b/hu/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..e40ba150c --- /dev/null +++ b/hu/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a Plasma által használható parancsokat. +--- + +# 🖥️ Parancsok diff --git a/hu/origin/plazma/administration/reference/configurations/README.md b/hu/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..d857b1682 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: A konfiguráció a Plazma leg alapvetőbb testreszabási módja. +--- + +# 🧾 구성 + +*** + +## 🪨 Tulajdonság + +> A tulajdonság a Minecraft által biztosított alapvető összetételi fájl. A tulajdonság segítségével megváltoztathatja a játék alapvető mechanizmusait. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit összetétel + +> A Bukkit összetétel a Plazma által biztosított alapvető összetételi fájl. A Bukkit összetétel segítségével megváltoztathatja a Minecraft szerver alapvető mechanizmusait. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot összetétel + +> A Spigot összetétel lehetővé teszi a játék részletes mechanizmusainak, játékoskezelésének, parancsok módosítását és üzenetek módosítását. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper összetétel + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> A Pufferfish összetétel lehetővé teszi a Plazma világának és entitásainak kezelésének módosítását. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur összetétel + +> A Purpur tulajdonság lehetővé teszi a játék általános alapadatainak módosítását. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma összetétel + +> A Plazma összetétel lehetővé teszi a Plazma funkcióinak testreszabását. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/hu/origin/plazma/administration/reference/configurations/bukkit.md b/hu/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..30e1f6270 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelentenek a bukkit.yml egyes csomópontjai. +--- + +# 🪣 Bukkit diff --git a/hu/origin/plazma/administration/reference/configurations/paper/README.md b/hu/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9f6f9b9b5 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy a config mappában található fájlok mindegyikének mi a célja. +--- + +# 🛩️ Papír diff --git a/hu/origin/plazma/administration/reference/configurations/paper/global.md b/hu/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..9f6b4b9b4 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ellenőrizze, hogy a paper-global.yml fájlban minden csomópont mit jelent. +--- + +# 🌏 전역 구성 diff --git a/hu/origin/plazma/administration/reference/configurations/paper/world.md b/hu/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..5610f3b0e --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Ismerje meg, hogy a paper-world.yml fájlban az egyes csomópontok mit jelentenek. +--- + +# 🏳️ 세계별 구성 + +világszerte diff --git a/hu/origin/plazma/administration/reference/configurations/plazma/README.md b/hu/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..715ed1699 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy a config mappában található fájlok mindegyikének mi a célja. +--- + +# ✨ Plazma diff --git a/hu/origin/plazma/administration/reference/configurations/plazma/global.md b/hu/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..c3b092417 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ellenőrizze, hogy a plazma-global.yml minden csomópontja mit jelent. +--- + +# 🌏 전역 구성 diff --git a/hu/origin/plazma/administration/reference/configurations/plazma/world.md b/hu/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..fdd07b4de --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a plazma-world.yml-ben. +--- + +# 🏳️ 세계별 구성 diff --git a/hu/origin/plazma/administration/reference/configurations/plazma/worlds.md b/hu/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a9b37c4c0 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a plazma-world.yml-ben. +--- + +# ✨ Plazma (világok szerkezete) diff --git a/hu/origin/plazma/administration/reference/configurations/property.md b/hu/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..4943a12f6 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy a server.properties egyes csomópontjai mit jelentenek. +--- + +# 🪨 Szerver tulajdonságai diff --git a/hu/origin/plazma/administration/reference/configurations/pufferfish.md b/hu/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..d181ef276 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelentenek a pufferfish.yml minden csomópontja. +--- + +# 🐡 Pufferfish diff --git a/hu/origin/plazma/administration/reference/configurations/purpur/README.md b/hu/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..89b94961c --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a purpur.yml fájlban. +--- + +# 🦑 Purpur diff --git a/hu/origin/plazma/administration/reference/configurations/purpur/global.md b/hu/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..dc7e81e78 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a purpur.yml fájlban. +--- + +# 🌏 전역 구성 diff --git a/hu/origin/plazma/administration/reference/configurations/purpur/world.md b/hu/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..6fe45fbc3 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a purpur.yml fájlban. +--- + +# 🏳️ 세계별 구성 diff --git a/hu/origin/plazma/administration/reference/configurations/spigot.md b/hu/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..e7a59ef44 --- /dev/null +++ b/hu/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ellenőrizze, hogy a spigot.yml minden csomópontja mit jelent. +--- + +# 🚰 Spigot diff --git a/hu/origin/plazma/administration/reference/permissions.md b/hu/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..afcc7c79f --- /dev/null +++ b/hu/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Ismerje meg a Plazma engedélyeit. +--- + +# 🛡️ Engedély + +Jogosultság egy egyszerű biztonsági eszköz, amely beállítja a szerveren belüli játékosok közötti interakció lehetőségeit. + +A jogosultságok megfelelő kihasználásához és könnyű módosításához használni kell a [LuckPerms](https://luckperms.net) vagy hasonló bővítményeket. + +*** + +## Alap jogosultság rendszer megértése + +A Minecraft alapvető adminisztrációs jogosultság csoportokat biztosít. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Játékos**\ + Általában minden játékosnak rendelkezésére álló jogosultság csoport. +2. **Mediátor**\ + Figyelmen kívül hagyhatja a spawn védelmet. +3. **Világkezelő**\ + Minden világkezeléshez kapcsolódó parancsokat és parancsblokkokat használhat.\ + Ez az alapértelmezett jogosultság csoport a datapackokhoz és parancsblokkokhoz. +4. **Adminisztrátor**\ + Minden játékossal kapcsolatos parancsokat használhat. +5. **Főadminisztrátor**\ + Minden szerverkezeléshez kapcsolódó parancsot használhat.\ + Ez az alapértelmezett jogosultság csoport a konzolhoz és az adminisztrátorokhoz. + +*** + +## Jogosultságok beállítása + +*** + +## Összes jogosultság + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Alapértelmezett**: `None` + +Engedélyezi a játékosoknak, hogy lehajolva és interakcióval felszálljanak az entitásra. + +Ha felszáll az entitásra, akkor a `mozgás billentyűkkel` irányíthatja az entitás mozgását, és a `ugrás billentyűvel` ugorhat vagy repülhet. + +A `(Namespaced Key)` helyére az entitás [Namespaced ID](#user-content-fn-2)[^2] kerül. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Alapértelmezett**: `None` + +Engedélyezi a játékosoknak, hogy az entitáson ülve használhassák az entitás speciális képességeit. + +Nem minden entitás speciális képessége használható. Az összes elérhető speciális képességet az alábbiakban találja. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Kérjük, ossza meg az ötleteit a [Plazma Discord](https://plazmamc.org/discord) vagy a [GitHub Beszélgetések](https://github.com/PlazmaMC/PlazmaBukkit/discussions) oldalon! +{% endhint %} + +
+ +<összefoglalás>Elérhető speciális képességek megtekintése + +- **`crepper`**\ + Ha megnyomja az `ugrás gombot`, akkor felrobban.\ + Ha a játékos rendelkezik az `allow.powered.creeper` jogosultsággal, akkor tartsa lenyomva az `ugrás gombot` a töltéshez. +- **`dolphin`**\ + Ha megnyomja az `ugrás gombot`, akkor úszik. +- **`phantom`**\ + Ha megnyomja az `ugrás gombot`, akkor tüzet lövöldöz. +- **`wither`**\ + Ha `kölcsönhatásba lép`, akkor wither fejet lő ki. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/compass` parancs](commands.md#compass) használatát. + +#### `bukkit.command.credits` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/credits (Játékos)` parancs](commands.md#credits) használatát. + +Ha a jogosultság után `.other`-t ír, akkor más játékosok számára is engedélyezi a használatát. + +#### `bukkit.command.demo` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/demo (Játékos)` parancs](commands.md#demo) használatát. + +Ha a jogosultság után `.other`-t ír, akkor más játékosok számára is engedélyezi a használatát. + +#### `bukkit.command.ping` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/ping (Játékos)` parancs](commands.md#ping) használatát. + +Ha a jogosultság után `.other`-t ír, akkor más játékosok számára is engedélyezi a használatát. + +#### `bukkit.command.ram` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/ram` parancs](commands.md#ram) használatát. + +#### `bukkit.command.rambar` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/rambar (Játékos)` parancs](commands.md#rambar) használatát. + +Ha a jogosultság után `.other`-t ír, akkor más játékosok számára is engedélyezi a használatát. + +#### `bukkit.command.restart` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/restart` parancs](commands.md#restart) használatát. + +#### `bukkit.command.tps` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/tps` parancs](commands.md#tps) használatát. + +#### `bukkit.command.tpsbar` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/tpsbar (Játékos)` parancs](commands.md#tpsbar) használatát. + +Ha a jogosultság után `.other`-t ír, akkor más játékosok számára is engedélyezi a használatát. + +#### `bukkit.command.timings` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/timings` parancs](commands.md#timings) használatát. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +További hasonló parancsokért látogasson el a [Spark](https://spark.lucko.me/docs/Command-Usage) oldalra. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/uptime` parancs](commands.md#uptime) használatát. + +#### `minecraft.command.gamemode.(GameMode)` + +- **Alapértelmezett**: `Világkezelő` + +Engedélyezi a [`/gamemode (GameMode) (Játékos)` parancs](commands.md#gamemode) használatát. + +Ha a jogosultság után `.other`-t ír, akkor más játékosok számára is engedélyezi a használatát. + +#### `paper.antixray.bypass` + +- **Alapértelmezett**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Ezzel mindkét fél javulást tapasztalhat. + +> Az X-Ray beállításokról további információért látogasson el az alábbi oldalra. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Alapértelmezett**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Alapértelmezett**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Alapértelmezett**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Alapértelmezett**: `None` + +Lehetővé teszi a kovácsoló asztalon a [MiniMessage címkék](https://docs.advntr.dev/minimessage/format.html) használatát. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Alapértelmezett**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Alapértelmezett**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Alapértelmezett**: `None` + +Kizárja a játékost az inaktív állapotból történő kirúgásból. + +#### `purpur.debug.f3n` + +- **Alapértelmezett**: `Világkezelő` + +Lehetővé teszi a játékos számára, hogy az `F3 + N` billentyűkombinációval változtassa a játék módot. + +Csak akkor működik, ha nincs jogosultsága a megfelelő játékmódhoz. + +#### `purpur.drop.spawners` + +- **Alapértelmezett**: `None` + +Ha az előre beállított tárggyal bányászik spawner blokkot, akkor a spawner blokkot elejti. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Alapértelmezett**: `None` + +Megváltoztatja az ender láda méretét. + +A `(NumberString)` helyére `one`, `two`, `three`, `four`, `five`, `six` írható. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Alapértelmezett**: `None` + +Lehetővé teszi a visszatérő totem működését az inventáriumban. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Alapértelmezett**: `None` + +A játékosnak engedélyezve van, hogy figyelmen kívül hagyja a csatlakozók számának korlátozását. + +#### `purpur.mending_shift_click` + +- **Alapértelmezett**: `None` + +A játékosnak lehetősége van az `együttműködés lehajlására`, hogy megjavítsa a kezében lévő tárgyat. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Alapértelmezett**: `None` + +A játékosnak engedélyezve van a mobgenerálók telepítése. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Alapértelmezett**: `None` + +A játékosnak lehetősége van azonnal átugrani, amikor használja a Nether portált. + +#### `purpur.sign.color` + +- **Alapértelmezett**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Alapértelmezett**: `None` + +표지판에 난독화 kód`(&o)` használatát engedélyezi. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.jel.stílus` + +- **Alapértelmezett**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.hatástalanít` + +- **Alapértelmezett**: `None` + +A játékosok `kölcsönhatás` használatával megakadályozhatják a TNT robbanását. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Biztosított jog + +#### `plazma.mellőzés.ncr-szükség` + +- **Alapértelmezett**: `None` + +A játékosoknak lehetőségük van a [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) módot telepítetlenül is csatlakozni. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operátor. + +[^2]: Például: `ender_dragon` diff --git a/hu/origin/plazma/adminstration/README.md b/hu/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..02329e449 --- /dev/null +++ b/hu/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Hozzon létre saját szerverét a Plazma segítségével. +--- + +# ⚒️ Szerver kezelési útmutató diff --git a/hu/origin/plazma/adminstration/expert/README.md b/hu/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..829072026 --- /dev/null +++ b/hu/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a Plazma szakmai kezelését. +--- + +# 🎓 Mesterfok diff --git a/hu/origin/plazma/adminstration/expert/fix-exploits.md b/hu/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..368b5492e --- /dev/null +++ b/hu/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a ismert sebezhetőségeket és azok megoldási módjait. +--- + +# ⚠️ Ismert sebezhetőségek és azok megoldási módja diff --git a/hu/origin/plazma/adminstration/expert/optimize.md b/hu/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..e69a2d835 --- /dev/null +++ b/hu/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogyan optimalizálja a Plazmát. +--- + +# 🧹 Optimalizálás diff --git a/hu/origin/plazma/adminstration/expert/vanillaize.md b/hu/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..3b3a1c3ac --- /dev/null +++ b/hu/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Ismerje meg, hogyan lehet helyreállítani a Paper és a Vanilla patch-ét. +--- + +# ↩️ Vanillaizálás + +{% hint style="warning" %} + +### A Paper nem tartalmazza a legtöbb Vanilla hibajavító patch választási lehetőségét. + +A Plazma jelenleg olyan konfigurációt fejleszt, amely lehetővé teszi ezeknek a hibajavításoknak a letiltását. + +Ezért ez az útmutató még írás alatt áll, és mindig változhat az információ. +{% endhint %} diff --git a/hu/origin/plazma/adminstration/faq.md b/hu/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..a0fa24c13 --- /dev/null +++ b/hu/origin/plazma/adminstration/faq.md @@ -0,0 +1,42 @@ +--- +description: Ismerje meg a gyakran ismételt kérdéseket. +--- + +# ⁉️ Gyakran Ismételt Kérdések + +{% hint style="info" %} + +### Nem találja a keresett választ? + +[Hivatalos Discord szerver](https://discord.gg/MmfC52K8A8) vagy [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) oldalon tegye fel kérdését a közösségnek! +{% endhint %} + +### Az üzenet megjelenik, de nem fut le + +Ha a `no main manifest attribute, in plazma-(version).jar` üzenet jelenik meg a konzolon, akkor a letöltött fájl a fejlesztői API fájl, és a GitHub oldalról letöltendő a **Reobf Paperweight**. + +További információért tekintse meg a következő oldalt. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### A szerver indításakor figyelmeztetés jelenik meg + +A Plazma néhány instabil javítást tartalmaz, és mindig fennáll a hibás működés lehetősége, ezért a szerver indításakor ilyen figyelmeztetéseket jelenít meg. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ezt a figyelmeztetést a [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] rendszer tulajdonság használatával lehet kikapcsolni. + +További információért tekintse meg a következő oldalt. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Elérhető 1.20.1 verziótól diff --git a/hu/origin/plazma/adminstration/getting-started/README.md b/hu/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..f18e7114e --- /dev/null +++ b/hu/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Tudj meg többet arról, hogyan készíthetsz szervereket a Plazma segítségével. +--- + +# 👟 Kezdés + +A Plazma stabil használatához a rendszernek az alábbi követelményeknek kell megfelelnie. + +| | Minimum | Ajánlott | +| :----------: | ------: | -------: | +| Architektúra | x64 | - | +| RAM | 8GB | 16GB | +| Tárhely | 1GB | 8GB | +| JRE | 17 | 21 | + +A könnyebb konfiguráció módosítás érdekében érdemes telepíteni olyan szerkesztőket, mint a [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE telepítése + +Ahogy a nevéből is kikövetkeztethető, a Minecraft: **"Java"** Edition Java nyelven lett fejlesztve, így futtatásához szükség van a JRE[^1]-re. + +Mivel a Plazma a Mojang Studios hivatalos szerverplatformján [alapul](#user-content-fn-2)[^2], a Plazma használatához szintén szükséges a JRE telepítése. + +### 1.1 JRE jelenlétének ellenőrzése + +Ha meg szeretnéd győződni arról, hogy a rendszeren telepítve van-e a JRE, írd be a Futtatás mezőbe a [`cmd /k java --version`](#user-content-fn-4)[^4] parancsot, majd nyomd meg az Enter billentyűt. + +Ha az alábbiakhoz hasonló eredményt kapsz, ugorj a [2. lépésre](setup.md#id-2). + +{% code title="Helyes eredmény" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Ha nem ez jelenik meg, vagy az alábbihoz hasonló, akkor nincs telepítve a JRE, vagy túl régi verzió van, tehát a [1.2. lépést](setup.md#id-1.2) kell végrehajtani. + +{% code title="Nincs telepítve a JRE" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="Túl régi a JRE" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE telepítése + +Ebben a kézikönyvben az Azul Zulu-t használjuk az JRE egyik [fajtájaként](#user-content-fn-5)[^5]. + +Telepítés után ellenőrizd újra a [1.1. lépést](setup.md#id-1.1), hogy meggyőződj róla, hogy a telepítés sikeresen megtörtént. + +{% tabs %} +{% tab title="Windows" %} + +1. Először töltsd le az **JDK 21**-et az [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) oldalról `.msi` formátumban. +2. Futtasd a letöltött telepítő varázslót, majd kattints a `Next` gombra. +3. A megjelenő menüben a bal középső részen aktiváld a `Set JAVA_HOME variable` lehetőséget, majd kattints a `Next` gombra. +4. Nyomd meg az `Install` gombot az JRE telepítéséhez. + {% endtab %} + +{% tab title="macOS" %} +Töltsd le a **JDK 21**-et az [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) oldalról `.dmg` formátumban, majd telepítsd az JRE-t. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Először futtasd a következő parancsot a terminálban, hogy hozzáadd az Azul Zulu tárolót az APT-hez. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Ezután futtasd a következő parancsot a terminálban az JRE telepítéséhez. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Az alábbi parancs segítségével telepítheted az JRE-t. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma letöltése + +A Plazma többféle futtatható fájlt kínál. + +{% hint style="warning" %} + +### Általában a `Reobf Paperclip`-et használják. + +Az alábbiak a fejlesztőknek vagy az egyes formák jellemzőivel kapcsolatos érdeklődőknek szólnak.\ +Átlagos felhasználók számára nem probléma kihagyni a [3. lépést](setup.md#id-3). +{% endhint %} + +
+ +További információk + +A futtatható fájl neve `plazma-(verzió kezelő)-1.20.4-R0.1-SNAPSHOT-(leképezési forma).jar`-ra van beállítva. + +- **Leképezési forma**\ + A leképezés a Minecraft valós kódját és az obfuskált kódot összekötőfajta térkép. + - **Reobf**\ + Az újraobfuskálás, más néven Spigot leképezés, és a legtöbb NMS bővítményben használják.\ + A 1.20.5-től kezdve a használata befejeződik. + - **Mojmap**\ + Mojang leképezés, a Vanilla Minecraft leképezése. +- **Verzió kezelő**\ + A verzió kezelő egy olyan indító, amely a szerver futtatásához szükséges könyvtárakat és a szerver fájlokat patcheli. + - **Paperclip**\ + A PaperMC csapata által fejlesztett kezelő a Paper és más származékokhoz, amely letölti a könyvtárakat és alkalmazza a javításokat a szerverre. + - **Bundler**\ + A Vanilla Minecraft verzió kezelője. + +
+ +*** + +## 3. Indító szkript létrehozása + +A Plazmát egyszerűen elindíthatod és a szerver automatikusan újraindul, ha egy [indító szkriptet](#user-content-fn-6)[^6] hozol létre. + +[Flags.sh](https://flags.sh) segítségével létrehozhatsz egy [indító szkriptet.](#user-content-fn-7)[^7]\ +Csak add meg a Plazmához [használni kívánt memóriát](#user-content-fn-8)[^8], és a parancs automatikusan optimalizálódik. + +A bal alsó sarokban lévő Letöltés gombbal töltheted le az indító szkriptet.\ +**Ellenőrizd, hogy a letöltött indító szkript megegyezik-e az operációs rendszereddel.** + +*** + +## 4. Fájlok rendezése + +Most már mozgasd a letöltött indító szkriptet és a Plazmát egy új mappába. + +{% hint style="warning" %} + +### A mappanévnek kötelezően szóköz nélkülinek és angol nyelvűnek kell lennie. + +Ellenkező esetben a Plazma vagy a JRE nem működhet megfelelően. +{% endhint %} + +Most futtasd az indító szkriptet. Windows esetén, a tűzfal engedélyezési ablakban, mindenképpen **Engedélyezés**-t válassz. + +*** + +## 5. EULA elfogadása + +Miután egyszer futtattad az indító szkriptet, a mappában létrejön az `eula.txt` fájl. + +Az EULA[^9] egy olyan felhasználási szerződés, amelyet elfogadnod kell a [Mojang Studios](#user-content-fn-10)[^10] szolgáltatásainak használata során. + +Ha nem fogadod el az EULA-t, nem tudod elindítani a szervert, és az EULA megsértése esetén a fiókod felfüggeszthetik vagy más [súlyos következményekkel járhat.](#user-content-fn-11)[^11] + +Az EULA elfogadásához módosítsd az `eula.txt` fájlban az `eula=false`-t `eula=true`-ra, majd mentsd el a változtatásokat. + +*** + +## 6. Külső hozzáférés engedélyezése (Windows) + +A modern operációs rendszerek alapértelmezetten blokkolják a külső hozzáférést a tűzfal és a router által, hogy megvédjenek a veszélyes hozzáférésektől. + +Windows esetén a tűzfalat már a [3. lépésben](setup.md#id-3) engedélyezted, tehát csak port forwardingra van szükség. + +{% hint style="info" %} + +### Ebben az útmutatóban feltételezzük, hogy a Windows operációs rendszer és az [**UPnP**](#user-content-fn-12)[^12] használható router van. + +Ha a router nem támogatja az UPnP-t, vagy a router típusától függően eltérő lehet a panel, akkor magadnak kell keresned információkat. + +Vagy használhatsz az [Ngrok](https://ngrok.com/) segítségével ideiglenes címet. +{% endhint %} + +{% hint style="warning" %} + +### Linux vagy macOS stb. (fél) UNIX rendszerű operációs rendszerek esetén a tűzfal szolgáltatásokhoz különféle beállításokra van szükség, tehát magadnak kell keresned információkat. + +{% endhint %} + +### 6.1 Port forwarding szükségességének ellenőrzése + +Írd be a Futtatás mezőbe az alábbiakat, majd nyomd meg az Enter billentyűt. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ha a kimenet `True`, akkor elég ennyi, ha viszont `False`, akkor be kell állítani a port forwardingot. + +### 6.2 Szerverhez való csatlakozás + +{% tabs %} +{% tab title="Külső csatlakozás" %} +Ha nem szükséges port forwarding, vagy már sikeresen beállítottad, akkor most már csatlakozhatsz a szerverhez. + +A szerverhez való csatlakozáshoz használt cím [itt](https://ip.pe.kr/) található meg. +{% endtab %} + +{% tab title="UPnP porttovábbítási kísérlet" %} +A `purpur.yml` fájlban a szerver mappájában, engedélyezze a `network.upnp-port-forwarding` beállítást `true` értékre. + +Ezután a szerver újraindítása után a Plazma automatikusan megpróbálja a porttovábbítást. + +Az alábbiakban az UPnP sikerességét jelző üzenetek találhatók, amelyek a konzolon `[UPnP] (üzenet)` formában jelennek meg. + +| üzenet | jelentés | +| ---------------------------------------- | -------------------------------------------------- | +| `Sikeresen megnyitott port (port)` | Porttovábbítás sikeres. | +| `A port (port) már nyitva van` | Egy másik szolgáltatás használja már ezt a portot. | +| `Nem sikerült megnyitni a portot (port)` | Porttovábbítás sikertelen. | +| `A szolgáltatás nem elérhető` | A router nem támogatja az UPnP-t. | + +Amikor a szerver leáll, a Plazma automatikusan bezárja a portokat. +{% endtab %} + +{% tab title="Ideiglenes cím létrehozása Ngrok segítségével" %} +Ngrok használata rövid távú teszteléshez, közösségi játékhoz vagy barátokkal való játszáshoz hasznos. + +1. [Ngrok weboldal](https://ngrok.com/download)-ról töltsd le a `Windows (64-bit)` ZIP fájlt. +2. Tedd a letöltött Ngrok-ot a szerver mappába. +3. [Ngrok vezérlőpult](https://dashboard.ngrok.com/get-started/your-authtoken)-ról hozz létre egy [hitelesítési token](#user-content-fn-13)[^13]-at. +4. Futtasd a szerver mappában az alábbi `Command Line`-on megjelenő parancsot. +5. A futtatási szkript legtetejére add hozzá `start /b ngrok tcp --region jp 25565`, a legalsó sorba pedig `taskkill /f /t /im ngrok.exe`-t. +6. A konzol tetején található `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`-nél a `0.tcp.jp.ngrok.io:12345` lesz a szerver címe. +7. Most már külsőleg is csatlakozhatsz ezen a címen keresztül. + {% endtab %} + +{% tab title="Helyi hozzáférés" %} +Ha a szerverhez helyileg szeretnél csatlakozni, futtasd a `cmd /k ipconfig` parancsot a végrehajtás ablakában, és a megjelenő `IPv4 címmel` érhetsz el. + +Például, ha a parancs végrehajtása után a következőképpen jelenik meg a kimenet, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Ha megpróbálja csatlakozni a `192.168.3.7` címen megadott IPv4 címen keresztül, akkor a helyi gépről csatlakozhat a szerverhez. + +Ha a szerver és a játék ugyanazon a PC-n fut, akkor a `localhost`-on keresztül is csatlakozhat. +{% endtab %} +{% endtabs %} + +## 7. Fejlesztési szint + +Ha sikeresen elindította a szervert, és a szerver megfelelően működik, most a szerver testreszabásának ideje van. + +Ismerje meg, hogyan testresztheti a szervert az alábbi útmutató segítségével. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java futási környezet, Java Runtime Environment. + +[^2]: A Plazma alapú Paper a Spigotra épül, és a Spigot az hivatalos szerver platformon alapul. + +[^3]: Windows kulcs + R + +[^4]: Linux esetén a `java --version` paranccsal a terminálban + +[^5]: A JRE egy nyílt forráskódú projekt, például a Minecraft szerver platformhoz hasonlóan többféle változat létezik. + +[^6]: Általában **hajtóműnek** nevezik. + +[^7]: Az "Automatikus újraindítás" bekapcsolásával a szerver automatikusan újraindul. Beírhatja a `Control + C` parancsot a leállításhoz. + +[^8]: Nem ajánlott a rendszer felének túllépése. + + Például ha a rendszer teljes memóriája 8 GB, akkor nem ajánlott 4 GB-nál többet beállítani. + +[^9]: Végfelhasználói licencszerződés, End-User License Agreement. További részletekért kérjük, látogassa meg a [Minecraft honlapját](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: A Dél-Koreai játékipar támogatásáról szóló törvény 32. cikk (1) bekezdése (9) pontja alapján a **Korea Microsoft Corporation** jogi lépéseket tehet. + +[^12]: Universal Plug & Play. A Purpur, amely a Plazmában található, automatikusan kommunikál a routerrel ezen a technológián keresztül, és csak akkor nyitja meg a portokat, amikor a szerver fut, ezért nincs szükség közvetlen portnyitásra. + +[^13]: Ha nincs fiókja, regisztráljon a Google vagy a GitHub fiókján keresztül a Ngrokhoz. diff --git a/hu/origin/plazma/adminstration/getting-started/customization.md b/hu/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..c4f49f6a2 --- /dev/null +++ b/hu/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Ismerd meg, hogyan személyre szabhatod a szerveredet. +--- + +# 🎨 Felhasználói testreszabás diff --git a/hu/origin/plazma/adminstration/reference/arguments.md b/hu/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..0808c1990 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,527 @@ +--- +description: Ismerje meg a kezdő paramétereket és rendszer tulajdonságait. +--- + +# 🎛️ Paraméterek és tulajdonságok + +A kezdő változók és rendszer tulajdonságok olyan értékek, amelyeket a Plazma futtatásához használt parancsokhoz fűznek,\ +és lehetővé teszik, hogy olyan értékeket módosítsanak, amelyeket a Plazma futása után nem lehet megváltoztatni. + +A **kezdő paraméterek** és a **rendszer tulajdonságok** az [utasításokhoz fűzött helyre](#user-content-fn-2)[^2] vannak felosztva. + +*** + +## Rendszer tulajdonság + +A rendszer tulajdonságok az `-jar` előtt kerülnek be azon értékek közé, amelyeket a Plazma inicializálása előtt a JVM kezel. + +{% hint style="warning" %} + +### A rendszer tulajdonságok módosítása befolyásolhatja a Plazma és a JVM működését, és jelentős hatással lehet a játékra! + +Ha nem tudja pontosan, hogy egyes rendszer tulajdonságok milyen szerepet játszanak, **soha ne használja őket!** +{% endhint %} + +### Használati útmutató + +A rendszer tulajdonságok a `java` és a `-jar` közötti Java parancsparaméterként kerülnek megadásra. + +Például, ha alkalmazni kívánja a `Plazma.dummyProperty` rendszer tulajdonságot,\ +a következő módon adja meg, és a következő tulajdonságban `37` kerül be a Plazma inicializálásához. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +A `-D` azt jelzi, hogy ez a paraméter nem a JVM-be van beágyazva, hanem kizárólag a Plazmához hozzáadott saját paraméter. + +Ha nem ad meg semmilyen értéket a tulajdonságnál, az érték [`true`-ra lesz rögzítve.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### A Paperweight sorozatú szerver platformok mindegyikének külön pontot kell tartalmaznia a rendszer tulajdonságok megkülönböztetéséhez. + +Néhány Windows Powershell és más terminálok nem fogadják el ezeket a paramétereket, ezért a paraméterek két végéhez `"`-t kell [hozzáadni.](#user-content-fn-4)[^4] +{% endhint %} + +### Összes rendszer tulajdonság + +#### `convertLegacySigns` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a lejárt jelzőtáblák formátumának frissítését. + +#### `debug.entities` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi az entitásokhoz kapcsolódó hibakeresési naplókat. + +#### `debug.rewriteForIDE` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Az IDE-ben a helyes verzióinformációk betöltéséhez letiltja az NMS átvizsgálást,\ +éés automatikusan újra leképezi a belső verzióinformációkat. + +#### `disable.watchdog` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a Spigot Watchdog figyelmeztetési rendszerét. + +#### `letMeReload` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a `/reload` parancs megerősítő üzenetét. + +{% hint style="danger" %} + +### Mivel a `/reload` parancs nagyon instabil, minden `/reload` utáni probléma a felhasználó felelőssége. + +Ha fejlesztő vagy és frissítened kell a bővítményedet, használj inkább hotswapot a `/reload` helyett. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a standard input-output rendszert használó bővítményeket. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Figyelmeztet, ha elavult formázást észlel a csevegés komponensben. + +#### `Paper.bypassHostCheck` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a szerverhez való csatlakozáskor a szerver mintázat ellenőrzését. + +#### `Paper.debugDynamicMissingKeys` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a hiányzó kulcsokkal kapcsolatos hibakeresési naplókat az NBT objektumokban. + +#### `Paper.debugInvalidSkullProfiles` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a hibás koponya profilokkal kapcsolatos hibakeresési naplókat. + +Ez minden hibás koponya blokkot a világban a helyükkel együtt naplóz. + +#### `Paper.disableChannelLimit` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a játékosonként alkalmazott 128 plugin csatorna[^5] korlátot. + +#### `Paper.disableClassPrioritization` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a plugin osztály prioritás rendszert. + +Hasznos lehet problémák esetén a plugin shade-ben. + +#### `Paper.disableFlushConsolidate` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a Netty flush konszolidációs rendszert. + +#### `Paper.excessiveTELimit` + +- **Forma**: `Integer` +- **Alapértelmezett**: `750` + +Ha az entitások száma meghaladja ezt az értéket, több részre osztva küldi el őket. + +#### `Paper.filterThreshold` + +- **Forma**: `Integer` +- **Alapértelmezett**: `8192` + +Beállítja a szerver által egyszerre fogadható maximális csomagméretet. + +#### `Paper.ignoreJavaVersion` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Letiltja a Java verzió ellenőrzést. + +{% hint style="danger" %} + +### Ez lehetővé teszi a JVM számára, hogy hozzáférjen nem létező kódhoz! + +Ez állandóan károsíthatja a világ és más fájlokat, és a játék teljes mechanizmusát tönkreteheti. + +Minden ebből eredő problémáért Ön a felelős, és a Plamza nem nyújt támogatást ezzel kapcsolatban. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Forma**: `Integer` +- **Alapértelmezett**: `64` + +Beállítja a plugin csatorna[^6] nevének korlátját. + +#### `Paper.maxSignLength` + +- **Forma**: `Integer` +- **Alapértelmezett**: `80` + +Beállítja a táblák egy sorára írható maximális karakterhosszt. + +#### `Paper.minPrecachedDatafixVersion` + +- **Forma**: `Integer` +- **Alapértelmezett**: `(világ verzió) + 1` + +Beállítja az inicializálandó világfrissítési információ verzióját. + +Hasznos lehet nagy mennyiségű chunk frissítésekor, de egyéb esetekben nem használatos. + +#### `Paper.parseYamlCommentsByDefault` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `True` + +Engedélyezi a YAML fájlok kommentjeinek feldolgozását. + +#### `Paper.playerConnection.keepAlive` + +- **Forma**: `Integer` +- **Alapértelmezett**: `30` + +Ha a játékostól a megadott idő (másodperc) alatt nincs adatátvitel, akkor a játékost kirakja. + +Általában a játék folyamatosan küld [szívverés jelet](#user-content-fn-8)[^8] a szervernek, és ekkor nem lesz kirakva,\ +de ha a játék nem válaszol, akkor a játék összeomlottnak tekinti, és nem kezeli tovább a játékost, hanem kirakja. + +#### `Paper.skipServerPropertiesComments` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +A szerver tulajdonságok kommentjeit figyelmen kívül hagyja. + +#### `Paper.debug-sync-loads` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a szinkron chunk írásának hibakeresési naplóit. + +#### `Paper.enable-sync-chunk-writes` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a Minecraft [alapértelmezett chunk írási rendszert](#user-content-fn-10)[^10]. + +Ez a chunkokat sorrendben menti, ami jelentős teljesítményveszteséget okoz. + +#### `Paper.explicit-flush` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Engedélyezi a hálózati csatorna explicit kiürítését. + +#### `Paper.strict-thread-checks` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Mindig naplózza a fő szálon nem előforduló hibákat. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Ha a késleltetés túl hosszú, figyelmeztetést ad a tervezett műveletekről. + +#### `Paperclip.patchOnly` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `False` + +Ha az alapértelmezett futtatható fájlt használja, csak a javítást alkalmazza a szerver indítása nélkül. + +#### `Plazma.aggressiveOptimize` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` + +{% hint style="warning" %} + +### Ez a tulajdonság a 1.20.5 után a kezdő paraméterek közé kerül. + +{% endhint %} + +A kezdeti konfigurációs optimalizálást szigorúbban alkalmazza az első indításkor. + +Ha aktiválja, a szerver gyorsabbá és biztonságosabbá válik, de néhány mechanizmust blokkolhat vagy jelentős hatással lehet a játékmenetre. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` + +Megakadályozza a Plazma inicializálásakor megjelenő figyelmeztetést[^11]. + +### Használt tulajdonság + +Az alábbi rendszer tulajdonság egy használt tulajdonság. + +#### `timings.bypassMax` + +- **Forma**: `Boolean` +- **Alapértelmezett**: `false` +- **Használt**: Timings a Plazma-ban történő teljes eltávolítása óta + +Meghatározza, hogy az Aikar Timings API-ba elküldhető érték túllépheti-e a maximált. + +Ha így teszel, és az API nem kezeli kivételesen, akkor a sebességkorlály alkalmazódik. + +*** + +## Indítási argumentum + +Az indítási argumentumok a `-jar *.jar` után kerülnek be, amikor a Plazma inicializálódik és együttesen kezelik őket. + +### Használati útmutató + +A rendszer tulajdonságokat a `-jar *.jar` után program parancs argumentumként adják meg. + +Például, ha a `nogui` indítási argumentumot akarod alkalmazni, \ +akkor az alábbi módon beírva a Plazma inicializálása közben a `nogui` argumentumot fogja kezelni. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Teljes indítási argumentumok + +#### `bukkit-settings` + +- **Alias**: `b` +- **Alapértelmezett**: `bukkit.yml` + +Beállítja a [Bukkit konfigurációs fájl](../reference/configurations/bukkit.md) nevét és helyét. + +#### `command-settings` + +- **Alias**: `c` +- **Alapértelmezett**: `commands.yml` + +Beállítja a [Bukkit parancs konfigurációs fájl](../reference/configurations/bukkit.md) nevét és helyét. + +#### `config` + +- **Alias**: `c` +- **Alapértelmezett**: `server.properties` + +Beállítja a [szerver tulajdonságok](../reference/configurations/property.md) fájl nevét és helyét. + +#### `demo` + +A demó világgal indítja a szervert. + +#### `eraseCache` + +A világ frissítése után a megmaradt gyorsítótárazott fájlokat eltávolítja. + +#### `forceUpgrade` + +Figyelmen kívül hagyja a verziót és kényszerítetten [frissít](#user-content-fn-12)[^12] a világot. + +#### `help` + +- **Alias**: `?` + +Kiírja a Plazma teljes indítási argumentumait és leírását. + +#### `initSettings` + +Csak a konfigurációs fájlokat hozza létre és leállítja a szervert. + +#### `jfrProfile` + +Aktiválja a JFR profilozást. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +Beállítja a megengedett maximális [játékos](#user-content-fn-14)[^14] számot. + +#### `nogui` + +Letiltja a grafikus felhasználói felület panelt. + +#### `nojline` + +JLine-et kikapcsolva, és a vanília konzolt használja. + +#### `online-mode` + +- **Alias**: `o` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +Mojang hitelesítő szerverrel ellenőrzi a játékosokat. + +**Ha nem használ Velocity vagy más proxy-t, akkor [EULA](../getting-started/README.md#id-5) megszegése miatt büntetésre kerülhet.** + +#### `paper-beállítások` + +- **Alias**: `paper` +- **Alapértelmezett**: `paper.yml` + +{% hint style="warning" %} + +### Ez az opció 1.19.4 után már nem használható + +{% endhint %} + +A használaton kívüli PaperSpigot konfigurációs fájl helyét állítja be. + +Ez az előző konfiguráció áthelyezésére szolgál egy új konfigurációs fájlba, majd ezt követően már nem használható. + +#### `paper-beállítások-mappája` + +- **Alias**: `paper-mappa` +- **Alapértelmezett**: `config` + +A [Paper konfigurációs fájl](../reference/configurations/paper/README.md) mappájának és helyének beállítása. + +#### `plazma-beállítások-mappája` + +- **Alias**: `plazma-mappa` + +A [Plazma konfigurációs fájl](../reference/configurations/plazma/README.md) mappájának és helyének beállítása. + +#### `bővítmények` + +- **Alias**: `b` +- **Alapértelmezett**: `bővítmények` + +A bővítmények mappájának beállítása. + +#### `pufferfish-beállítások` + +- **Alias**: `pufferfish` +- **Alapértelmezett**: `pufferfish.yml` + +A [Pufferfish konfigurációs fájl](../reference/configurations/pufferfish.md) nevének és helyének beállítása. + +#### `purpur-beállítások` + +- **Alias**: `purpur` +- **Alapértelmezett**: `purpur.yml` + +A [Purpur konfigurációs fájl](../reference/configurations/purpur/README.md) nevének és helyének beállítása. + +#### `safeMode` + +(Biztonságos mód) Teljesen vanília állapotban indítja a szervert. + +#### `szerver-ip` + +- **Alias**: `h`, `host` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +A szerver hosztjának nevét vagy [Internet Protocol](#user-content-fn-13)[^13] címét állítja be. + +#### `szerver-port` + +- **Alias**: `p`, `port` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +A szerver portját állítja be. + +#### `szerver-név` + +- **Alapértelmezett**: `Egy Plazma Szerver` + +A szerver nevét állítja be. + +#### `spigot-beállítások` + +- **Alias**: `S` +- **Alapértelmezett**: `spigot.yml` + +A [Spigot konfigurációs fájl](../reference/configurations/spigot.md) nevének és helyének beállítása. + +#### `verzió` + +- **Alias**: `v` + +Plazma verzióját jeleníti meg. + +#### `világ-mappa` + +- **Alias**: `W`, `univerzum`, `világ-tartó` +- **Alapértelmezett**: `(szerver mappa)` + +A világ fájlok mentési helyét állítja be. + +#### `világ-név` + +- **Alias**: `w`, `világ` +- **Alapértelmezett**: `(szerver tulajdonságok)` + +A világ fájl nevét állítja be. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Az argumentumok kezelése a hozzáadott helytől függ. + +[^3]: Például, ha be akarja állítani (aktiválni) a `Plazma.iKnowWhatIAmDoing`-ot `true`-ra, akkor csak a `-DPlazma.iKnowWhatIAmDoing`-ot kell megadnia, és ugyanúgy működni fog, mint a `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Például, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Eseményfigyelő. + +[^6]: Eseményfigyelő. + +[^7]: Kliens. + +[^8]: A szerverrel való megfelelő kapcsolatot jelző jelek, mint a szívverés. + +[^9]: A Purpur AFK kick funkcióval még az inaktív játékosokat is kickelheti. + +[^10]: Szinkron Chunk írási rendszer, Sync Chunk Write System. + +[^11]: `FIGYELEM! Plazma váratlan problémákat okozhat, ezért előtte alaposan tesztelje, mielőtt nyilvános szerveren használná.` + +[^12]: A játékban a `világ optimalizálás` is ugyanezen elven működik. + +[^13]: Internet Protocol, IP. + +[^14]: A `szint 2` vagy nagyobb szintű adminisztrátorokat kizárja. diff --git a/hu/origin/plazma/adminstration/reference/commands.md b/hu/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..e40ba150c --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a Plasma által használható parancsokat. +--- + +# 🖥️ Parancsok diff --git a/hu/origin/plazma/adminstration/reference/configurations/bukkit.md b/hu/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..30e1f6270 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelentenek a bukkit.yml egyes csomópontjai. +--- + +# 🪣 Bukkit diff --git a/hu/origin/plazma/adminstration/reference/configurations/paper/README.md b/hu/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9f6f9b9b5 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy a config mappában található fájlok mindegyikének mi a célja. +--- + +# 🛩️ Papír diff --git a/hu/origin/plazma/adminstration/reference/configurations/paper/global.md b/hu/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..0dd4d8a3e --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ellenőrizze, hogy a paper-global.yml fájlban minden csomópont mit jelent. +--- + +# 🛩️ Paper (globális konfiguráció) diff --git a/hu/origin/plazma/adminstration/reference/configurations/paper/world.md b/hu/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..5d9997541 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg, hogy a paper-world.yml fájlban az egyes csomópontok mit jelentenek. +--- + +# 🛩️ Papír (világ szerkezete) diff --git a/hu/origin/plazma/adminstration/reference/configurations/plazma/README.md b/hu/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..715ed1699 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy a config mappában található fájlok mindegyikének mi a célja. +--- + +# ✨ Plazma diff --git a/hu/origin/plazma/adminstration/reference/configurations/plazma/global.md b/hu/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..3817799b2 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ellenőrizze, hogy a plazma-global.yml minden csomópontja mit jelent. +--- + +# ✨ Plazma (globális konfiguráció) diff --git a/hu/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/hu/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..c9cda15f1 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Világ szerinti összetétel diff --git a/hu/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/hu/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a9b37c4c0 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a plazma-world.yml-ben. +--- + +# ✨ Plazma (világok szerkezete) diff --git a/hu/origin/plazma/adminstration/reference/configurations/property.md b/hu/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..4943a12f6 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy a server.properties egyes csomópontjai mit jelentenek. +--- + +# 🪨 Szerver tulajdonságai diff --git a/hu/origin/plazma/adminstration/reference/configurations/pufferfish.md b/hu/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..d181ef276 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelentenek a pufferfish.yml minden csomópontja. +--- + +# 🐡 Pufferfish diff --git a/hu/origin/plazma/adminstration/reference/configurations/purpur/README.md b/hu/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..89b94961c --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a purpur.yml fájlban. +--- + +# 🦑 Purpur diff --git a/hu/origin/plazma/adminstration/reference/configurations/purpur/global.md b/hu/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..14ad8f7bc --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a purpur.yml fájlban. +--- + +# 🦑 Purpur (globális összetétel) diff --git a/hu/origin/plazma/adminstration/reference/configurations/purpur/world.md b/hu/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..7a73cc582 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Tudja meg, hogy mit jelent minden csomópont a purpur.yml fájlban. +--- + +# 🦑 Purpur (világösszetétel) diff --git a/hu/origin/plazma/adminstration/reference/configurations/spigot.md b/hu/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..e7a59ef44 --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ellenőrizze, hogy a spigot.yml minden csomópontja mit jelent. +--- + +# 🚰 Spigot diff --git a/hu/origin/plazma/adminstration/reference/permissions.md b/hu/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..f1b905eef --- /dev/null +++ b/hu/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Ismerje meg a Plazma engedélyeit. +--- + +# 🛡️ Engedély diff --git a/hu/origin/plazma/adminstration/referencia/README.md b/hu/origin/plazma/adminstration/referencia/README.md new file mode 100644 index 000000000..96eaa2638 --- /dev/null +++ b/hu/origin/plazma/adminstration/referencia/README.md @@ -0,0 +1,2 @@ +# 📜 Referencia + diff --git a/hu/origin/plazma/adminstration/referencia/konfiguracios-fajlok/README.md b/hu/origin/plazma/adminstration/referencia/konfiguracios-fajlok/README.md new file mode 100644 index 000000000..b9aace87b --- /dev/null +++ b/hu/origin/plazma/adminstration/referencia/konfiguracios-fajlok/README.md @@ -0,0 +1,2 @@ +# 🎨 Konfigurációs Fájlok + diff --git a/hu/origin/plazma/developers.md b/hu/origin/plazma/developers.md new file mode 100644 index 000000000..9fd32ee0f --- /dev/null +++ b/hu/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Fejlesszen harmadik fél projekteket a Plazma segítségével. +--- + +# ⚙️ Fejlesztői útmutató diff --git a/hu/origin/thunderbolt/README.md b/hu/origin/thunderbolt/README.md new file mode 100644 index 000000000..f3b41a539 --- /dev/null +++ b/hu/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt egy Plazma alapú szerver platform, amely lehetővé teszi a kísérleti javításokat Flavor szerinti megkülönböztetéssel közvetlenül használhatóvá tételét. +--- + +# 🌩️ Thunderbolt Használati Útmutató diff --git a/hu/origin/volt/README.md b/hu/origin/volt/README.md new file mode 100644 index 000000000..746de4354 --- /dev/null +++ b/hu/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 alapulva saját Paperweight szerver platformját fejlesztheti ki nyílt forráskódú sablonként. +--- + +# ⚡ Volt Fejlesztési Útmutató diff --git a/id/origin/README.md b/id/origin/README.md new file mode 100644 index 000000000..f1bbbe51c --- /dev/null +++ b/id/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Jika Anda memiliki pertanyaan, silakan bertanya melalui Discord atau Diskusi GitHub. +--- + +# 🏠 Selamat datang di Portal Dokumentasi + +{% hint style="info" %} + +**Dokumen Plazma saat ini dalam keadaan diterjemahkan oleh mesin.** + +[![Status Terjemahan](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) di sini untuk berpartisipasi dalam terjemahan dokumen dan meningkatkan dokumen. + +{% endhint %} + +### Jika Anda mengalami masalah saat menggunakan Plazma, apa yang harus dilakukan? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Jika Anda tertarik dengan Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Jika Anda ingin membuat platform server Anda sendiri dengan Volt, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Jika Anda memerlukan informasi lebih lanjut tentang Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/id/origin/SUMMARY.md b/id/origin/SUMMARY.md new file mode 100644 index 000000000..f95dbe709 --- /dev/null +++ b/id/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Daftar isi + +- [🏠 Selamat datang di Portal Dokumen](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Dokumen Penggunaan Plazma](plazma/README.md) +- [❓ Apa itu Plazma?](plazma/about/README.md) + - [⬇️ Unduh](plazma/about/downloads.md) + - [✅ Status Dukungan Versi](plazma/about/supported-versions.md) +- [⚒️ Panduan Administrasi Server](plazma/administration/README.md) + - [👟 Memulai](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referensi](plazma/administration/reference/README.md) + - [🖥️ Perintah](plazma/administration/reference/commands.md) + - [🛡️ Izin](plazma/administration/reference/permissions.md) + - [🎛️ Argumen dan Properti](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Properti](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Konfigurasi Global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfigurasi Berdasarkan Dunia](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Konfigurasi Global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfigurasi Berdasarkan Dunia](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Konfigurasi Global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfigurasi Berdasarkan Dunia](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Lanjutan](plazma/administration/expert/README.md) + - [🧹 Optimalkan](plazma/administration/expert/optimize.md) + - [🔀 Proksi](plazma/administration/expert/proxy.md) + - [↩️ Vanilakan](plazma/administration/expert/vanillaize.md) + - [🩻 Pemblokiran X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Kerentanan dan Solusi](plazma/administration/expert/fix-exploits.md) + - [⁉️ Pertanyaan Umum](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Panduan Pengembang](plazma/developers.md) + - [✏️ Berkontribusi](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Panduan Penggunaan Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Panduan Pengembangan Volt](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Unduh Semua](plazma/about/downloads-all.md) diff --git a/id/origin/miscellaneous/README.md b/id/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/id/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/id/origin/plazma/README.md b/id/origin/plazma/README.md new file mode 100644 index 000000000..7c4ff77a9 --- /dev/null +++ b/id/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma adalah platform server sumber terbuka untuk Minecraft: Java Edition yang menggabungkan optimisasi eksperimental berbasis kertas dan berbagai mekanisme permainan yang disesuaikan pengguna." +--- + +# ✨ Dokumentasi Penggunaan Plazma + +## 👋 Selamat datang di Dokumentasi Plazma + +Selamat datang di Dokumentasi Penggunaan Plazma! + +{% hint style="info" %} + +**Apakah Anda tidak bisa menyelesaikan masalah melalui manual?** + +[Server Discord resmi](https://discord.gg/MmfC52K8A8) atau bertanya kepada komunitas melalui [Diskusi GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Tentang Plazma + +> Pelajari lebih lanjut tentang platform server Plazma. + +{% content-ref url="about/" %} +[tentang](about/) +{% endcontent-ref %} + +### Untuk Administrator + +> Gunakan Plazma untuk membuat server Anda sendiri. + +{% content-ref url="administration/" %} +[administrasi](administration/) +{% endcontent-ref %} + +### Untuk Pengembang + +> Gunakan Plazma untuk mengembangkan proyek pihak ketiga. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/id/origin/plazma/about/README.md b/id/origin/plazma/about/README.md new file mode 100644 index 000000000..e98f672c7 --- /dev/null +++ b/id/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Pelajari lebih lanjut tentang platform server Plazma. +--- + +# ❓ Plazma란? + +- **Plazma**는 [Andromeda](https://github.com/EarendelArchived/Andromeda)와 [Fusion](https://github.com/RuinedTechnologyUnify/Fusion)에서 장점만을 가져온 [Paper](https://github.com/PaperMC/Paper) 기반의 서버 플랫폼 입니다. +- 항상 높은 안정성과 강력한 성능, 빠른 업데이트, 방대한 기능을 제공하기 위하여 노력하고 있습니다. + +## 📋 Plazma의 목표 + +- 빠른 업데이트, 높은 안정성을 가진 서버 플랫폼이 되기 위해 노력하고 있습니다. +- 모드 플랫폼 못지 않은 방대한 기능과 강력한 성능을 제공하기 위해 노력하고 있습니다. +- 바닐라의 패치도 사용자화 할 수 있는 자유로운 플랫폼을 만들기 위해 노력하고 있습니다. + +## ⚙️ 주요 특징 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **가장 빠른 업데이트**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)는 Plazma의 포함 패치가 항상 최신으로 유지될 수 있도록 해서, Paper 기반 서버 플랫폼 중에서 가장 빠른 업데이트를 제공하고 있습니다. +6. **기본 구성 파일 최적화**\ + 기본 적용되는 구성 파일이 최적화되어 있어, 직접 구성 파일을 최적화 하지 않아도 됩니다. +7. **체계적으로 작동하는 멀티스레드**\ + 게임의 메커니즘과 관계 없는 시스템 메커니즘을 비동기화 하여, [지연 시간](#user-content-fn-4)[^4]을 줄여 서버를 최적화 합니다. +8. **불필요한 공간의 사용 차단**\ + 비슷한 값을 가진 데이터를 모두 하나로 합쳐 메모리 사용량을 줄입니다. + +## ✨ 활용 사례 + +- **Platform yang Menangani Plugin Rumit dengan Benar**\ + Plazma digunakan di server pengembang [IPECTER](https://github.com/IPECTER).\ + Plugin internal yang beroperasi dengan NMS dan refleksi, serta banyak paket data kompleks dan besar + diterapkan tanpa penurunan kinerja untuk lebih dari 100 pemain. +- **Platform yang Tetap Cepat di Server RPG**\ + Mampu menjaga 100 pemain dalam satu cluster tanpa penurunan TPS, serta + memungkinkan 250 pemain untuk bermain nyaman di 4 cluster. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platform yang Dipilih Banyak Streamer**\ + Digunakan sebagai ember partisipasi penonton banyak streamer. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Unduh + +아래 페이지에서 Plazma를 다운로드 할 수 있습니다. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Ingin mengetahui informasi detail tentang dukungan versi? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot 플러그인 및 Paper, Pufferfish, Purpur 플러그인. + +[^2]: 이하 Microsoft Corporation. + +[^3]: 채팅 신고 시스템을 비활성화 하면 채팅이 온전히 서버에서만 처리되어 Mojang의 채팅 추적을 막을 수 있습니다. + +[^4]: 시스템 메커니즘이 작동하기 위해 잠시 동안 게임이 멈추는 시간. diff --git a/id/origin/plazma/about/downloads-all.md b/id/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..efa13e5b0 --- /dev/null +++ b/id/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma menjalankan file unduhan lengkap +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versi | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/id/origin/plazma/about/downloads.md b/id/origin/plazma/about/downloads.md new file mode 100644 index 000000000..aff360a01 --- /dev/null +++ b/id/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Segera unduh Plazma sekarang dan coba sendiri. +--- + +# ⬇️ Unduh + +#### Ingin mengetahui informasi detail tentang dukungan versi? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Unduhan di bawah ini adalah file eksekusi untuk pengguna umum.** + +Jika Anda seorang pengembang dan memerlukan jenis file lain, silakan lihat halaman di bawah ini. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersiUnduh
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/id/origin/plazma/about/patches-list.md b/id/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..fbdb79a7a --- /dev/null +++ b/id/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Pelajari semua fitur yang ditambahkan ke Plazma. +--- + +# 📑 Patch yang disertakan diff --git a/id/origin/plazma/about/supported-versions.md b/id/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..b63055f3b --- /dev/null +++ b/id/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Cari tahu versi Minecraft: Java Edition yang didukung oleh Plazma." +--- + +# ✅ Status Dukungan Versi + +{% hint style="info" %} + +**Plazma telah dikembangkan sejak versi 1.19.4, dan versi di bawah 1.19.4 tidak lagi dikembangkan.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/Informasi%20tidak%20tersedia +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| Versi | Keamanan dan Dukungan Fungsional | Status Build | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Status Bangunan](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Status Bangunan](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/id/origin/plazma/administration/README.md b/id/origin/plazma/administration/README.md new file mode 100644 index 000000000..1b7e9c0f0 --- /dev/null +++ b/id/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Gunakan Plazma untuk membuat server Anda sendiri. +--- + +# ⚒️ Panduan Pengelolaan Server diff --git a/id/origin/plazma/administration/diagnosis/README.md b/id/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..15b06db4d --- /dev/null +++ b/id/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara mengatasi ketika masalah terjadi. +--- + +# 🧾 진단 diff --git a/id/origin/plazma/administration/diagnosis/plugins.md b/id/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..7dd56486c --- /dev/null +++ b/id/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Pelajari cara mengatasi ketika plugin tidak berfungsi dengan normal. +--- + +# 📜 플러그인 diff --git a/id/origin/plazma/administration/expert/README.md b/id/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..c33dabbd5 --- /dev/null +++ b/id/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Pelajari cara mengelola Plazma secara profesional. +--- + +# 🎓 Lanjutan diff --git a/id/origin/plazma/administration/expert/fix-exploits.md b/id/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..905e1878b --- /dev/null +++ b/id/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tentang kerentanan yang diketahui dan cara mengatasinya. +--- + +# ⚠️ Kerentanan yang diketahui dan cara penyelesaiannya diff --git a/id/origin/plazma/administration/expert/optimize.md b/id/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..6b2af9d63 --- /dev/null +++ b/id/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Temukan cara untuk mengoptimalkan Plazma. +--- + +# 🧹 Optimalisasi diff --git a/id/origin/plazma/administration/expert/proxy.md b/id/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..b6b7a48cb --- /dev/null +++ b/id/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Pelajari cara mengonfigurasi platform proxy "Velocity" dengan aman. +--- + +# 🔀 Proxy diff --git a/id/origin/plazma/administration/expert/vanillaize.md b/id/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..b2f38ec79 --- /dev/null +++ b/id/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Pelajari cara memulihkan patch Paper dan vanilla. +--- + +# ↩️ Mengvanilakan + +{% hint style="warning" %} + +**Paper tidak menambahkan pilihan kebanyakan patch untuk memperbaiki bug Vanilla.** + +Plazma saat ini sedang mengembangkan kemampuan untuk menonaktifkan perbaikan kesalahan tersebut melalui konfigurasi. + +Oleh karena itu, panduan ini masih dalam proses penulisan dan informasinya dapat berubah kapan saja. + +{% endhint %} diff --git a/id/origin/plazma/administration/expert/xray.md b/id/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..c6cf81a94 --- /dev/null +++ b/id/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Pelajari berbagai metode bawaan untuk mencegah X-Ray. +--- + +# 🩻 Mencegah X-Ray diff --git a/id/origin/plazma/administration/faq.md b/id/origin/plazma/administration/faq.md new file mode 100644 index 000000000..82ff9dba2 --- /dev/null +++ b/id/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Pelajari pertanyaan yang sering diajukan. +--- + +# ⁉️ Pertanyaan yang Sering Diajukan + +{% hint style="info" %} + +**Tidak dapat menemukan jawaban yang Anda cari?** + +[Server Discord resmi](https://discord.gg/MmfC52K8A8) atau bertanya kepada komunitas melalui [Diskusi GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma tidak dapat dimulai + +Jika `no main manifest attribute, in plazma-(version).jar` muncul di konsol,\ +file yang diunduh adalah file API pengembangan, Anda perlu mengunduh **Reobf Paperweight** dari halaman GitHub. + +Untuk informasi lebih lanjut, lihat halaman berikut. + +{% content-ref url="getting-started/" %} +[mulai](getting-started#id-2) +{% endcontent-ref %} + +### Peringatan muncul setiap kali server mulai + +Plazma mengandung beberapa patch yang tidak stabil dan dapat menyebabkan kerusakan, oleh karena itu pesan peringatan berikut ditampilkan setiap kali server mulai. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Pesan peringatan ini dapat dinonaktifkan menggunakan properti sistem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Untuk informasi lebih lanjut, lihat halaman berikut. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tersedia mulai versi 1.20.1 diff --git a/id/origin/plazma/administration/getting-started/README.md b/id/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..4ac776dce --- /dev/null +++ b/id/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Pelajari cara membuat server dengan Plazma. +--- + +# 👟 Mulai + +Untuk menggunakan Plazma secara stabil, sistem harus memenuhi persyaratan berikut: + +| | Minimum | Disarankan | +| :---------------: | ------- | ---------- | +| Arsitektur | x64 | - | +| RAM | 8GB | 16GB | +| Ruang Penyimpanan | 1GB | 8GB | +| JDK | 17 | 21 | + +Untuk pengeditan file konfigurasi yang lancar, disarankan untuk menginstal editor seperti [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Output yang Benar" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' bukanlah perintah internal atau eksternal, program yang dapat dijalankan, atau +file batch. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Pertama, unduh **JDK 21** dari [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) dalam format `.msi`. +2. Jalankan wizard instalasi yang telah diunduh dan klik `Next`. +3. **Aktifkan `Set JAVA_HOME variable` di menu sebelah kiri tengah jendela** dan klik `Next`. +4. Klik `Install` untuk menyelesaikan instalasi JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Selanjutnya, instal JRE dengan menjalankan perintah berikut di terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Unduh Plazma + +Plazma menyediakan berbagai jenis file eksekusi. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Pelajari lebih lanjut + +Nama file eksekusi adalah `plazma-(manajer versi)-1.20.4-R0.1-SNAPSHOT-(jenis pemetaan).jar`. + +- **Jenis Pemetaan**\ + Pemetaan adalah peta yang menghubungkan kode sebenarnya Minecraft dengan kode yang telah diacak. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Pemetaan Mojang, adalah pemetaan Minecraft vanilla. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Manajer Versi**\ + Manajer versi adalah perangkat peluncur yang diperlukan untuk menjalankan server dan menerapkan patch pada file server. + - **Paperclip**\ + Dikembangkan oleh tim PaperMC untuk Paper dan platform turunannya, berperan dalam mengunduh pustaka dan menerapkan patch pada server. + - **Bundler**\ + Manajer versi Minecraft Vanilla. + +
+ +*** + +## 3. Buat Skrip Mulai + +Untuk memulai Plazma dengan mudah dan merestart server secara otomatis, Anda perlu membuat [skrip mulai](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Anda dapat mengunduh skrip mulai melalui tombol unduh di pojok kiri bawah.\ +**Pastikan skrip mulai yang diunduh sesuai dengan sistem operasi Anda.** + +*** + +## 4. Penyusunan File + +Pindahkan skrip mulai yang telah diunduh dan Plazma ke folder baru sekarang. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Jalankan skrip mulai sekarang. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Persetujuan EULA + +Setelah menjalankan skrip mulai sekali, file `eula.txt` akan dibuat di folder tersebut. + +EULA[^9] adalah perjanjian lisensi yang harus disetujui dengan menggunakan layanan [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Untuk menyetujui EULA, ubah `eula=false` menjadi `eula=true` dalam file `eula.txt` dan simpan perubahan. + +*** + +## 6. Izin Akses Eksternal (Windows) + +Sistem operasi modern secara default memblokir akses eksternal untuk melindungi dari akses berbahaya dari luar dengan menggunakan **firewall** dan **router**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Jika router tidak mendukung UPnP, Anda perlu mencari informasi spesifik berdasarkan router masing-masing. + +Atau Anda dapat menggunakan [Ngrok](https://ngrok.com/) untuk membuat alamat sementara. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Memeriksa Kebutuhan Port Forwarding + +Masukkan dan jalankan perintah berikut di jendela eksekusi. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jika output adalah `True`, Anda tidak perlu melakukan apa pun, tetapi jika `False`, Anda perlu mengatur port forwarding. + +### 6.2 Mengakses Server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Alamat yang digunakan untuk mengakses server dapat ditemukan [di sini](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Kemudian, restart server, Plazma akan mencoba port forwarding secara otomatis. + +Keberhasilan UPnP akan tergantung pada pesan yang muncul di konsol, yang akan ditampilkan sebagai `[UPnP] (pesan)`. + +| Pesan | Arti | +| ------------------------------ | -------------------------------------------------------- | +| `Berhasil membuka port (port)` | Port forwarding berhasil. | +| `Port (port) sudah terbuka` | Port sedang digunakan oleh layanan lain. | +| `Gagal membuka port (port)` | Port forwarding gagal. | +| `Layanan tidak tersedia` | Router tidak mendukung UPnP. | + +Ketika server dimatikan, Plazma akan menutup port secara otomatis. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Unduh file ZIP `Windows (64-bit)` dari [situs Ngrok](https://ngrok.com/download). +2. Letakkan file Ngrok yang diunduh ke dalam folder server. +3. Buat [token otentikasi](#user-content-fn-13) dari [Dashboard Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Jalankan perintah yang ditampilkan di `Command Line` dari folder server. +5. Tambahkan `start /b ngrok tcp --region jp 25565` di bagian atas skrip eksekusi dan `taskkill /f /t /im ngrok.exe` di bagian bawahnya. +6. Pada pesan `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` di bagian atas konsol, `0.tcp.jp.ngrok.io:12345` adalah alamat server. +7. Sekarang Anda dapat mengakses melalui alamat tersebut dari luar. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Misalnya, setelah menjalankan perintah, + +```log +Windows Konfigurasi IP + +Ethernet Adapter Ethernet: + + Suffix DNS terhubung. . . . : + Alamat IPv4. . . . . . . . . : 192.168.3.7 + Subnet Mask . . . . . . . : 255.255.255.0 + Gateway Default . . . . . . : 192.168.3.1 + +``` + +Jika Anda mencoba terhubung ke server dari lokal, coba hubungkan ke `192.168.3.7` yang ditunjukkan sebagai Alamat IPv4. + +Jika server dan game dijalankan pada PC yang sama, Anda dapat terhubung melalui `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Growing + +Setelah berhasil memulai server dan server berfungsi dengan baik, saatnya untuk menyesuaikan server. + +Pelajari cara menyesuaikan server melalui panduan di bawah ini. + +{% content-ref url="langkah-selanjutnya.md" %} +[langkah-selanjutnya.md](langkah-selanjutnya.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Berdasarkan Paper yang merupakan dasar dari Plazma, yang juga didasarkan pada Spigot, yang merupakan platform server resmi. + +[^3]: Tombol Windows + R + +[^4]: Untuk Linux, di terminal ketik `java --version` + +[^5]: JRE adalah salah satu proyek sumber terbuka, seperti platform server Minecraft yang memiliki berbagai jenis. + +[^6]: Biasanya dikenal sebagai **launcher**. + +[^7]: Aktifkan "Auto-restart" untuk menjadwalkan restart otomatis server. Anda dapat menutup dengan menekan `Control + C`. + +[^8]: Tidak disarankan melebihi setengah dari kapasitas sistem. + + Misalnya, ketika kapasitas memori sistem secara keseluruhan adalah 8GB, disarankan untuk tidak mengatur lebih dari 4GB. + +[^9]: Perjanjian Lisensi Pengguna Akhir, Perjanjian Lisensi Pengguna Akhir. Silakan lihat [Situs web Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) untuk informasi lebih lanjut. + +[^10]: Perusahaan Microsoft. + +[^11]: Dalam hal Korea Selatan, berdasarkan Pasal 32 Ayat 1 Nomor 9 dari Undang-Undang Promosi Industri Permainan, **Korea Microsoft Corporation** dapat mengajukan tuntutan hukum. + +[^12]: Universal Plug & Play. Purpur yang terdapat dalam Plazma berkomunikasi secara otomatis dengan router melalui teknologi ini, sehingga tidak perlu melakukan port forwarding secara langsung ketika server sedang berjalan. + +[^13]: Jika tidak memiliki akun, daftarlah ke Ngrok melalui akun Google atau GitHub. diff --git a/id/origin/plazma/administration/getting-started/customization.md b/id/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..784267e2b --- /dev/null +++ b/id/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Pelajari cara menyesuaikan server. +--- + +# 🎨 Kustomisasi + +Alasan menggunakan platform server yang dimodifikasi seperti Plazma tanpa menggunakan platform resmi yang disediakan oleh Mojang Studios adalah kemampuan **penyesuaian pengguna** yang kuat. + +Berikut adalah beberapa cara untuk menyesuaikan dan menggunakan Plazma. + +## Modifikasi Konfigurasi + +Cara paling dasar untuk menyesuaikan Plazma adalah dengan memodifikasi konfigurasi. + +Plazma menyediakan pengaturan konfigurasi yang kuat mulai dari mekanisme permainan hingga atribut monster. + +Silakan lihat penjelasan mengenai konfigurasi Plazma pada halaman berikut. + +{% content-ref url="../reference/configurations/" %} +[konfigurasi](../reference/configurations/) +{% endcontent-ref %} + +## Penggunaan Plugin + +{% hint style="success" %} + +**Plazma mendukung semua plugin berbasis kertas dengan baik.** + +Untuk plugin Spigot, mungkin ada beberapa yang tidak berfungsi karena perubahan pemetaan Paper sejak 1.20.5, tetapi sebagian besar plugin yang berbasis Paper seperti Paper, Pufferfish, dan Purpur akan berfungsi dengan baik di Plazma. Jika ada masalah dengan fungsi plugin, segera [laporkan kesalahan ini](../diagnosis/plugins.md) kepada Plazma. + +{% endhint %} + +Ini adalah alasan utama penggunaan Plazma dan cara terkuat untuk menyesuaikan Plazma. +Ekosistem plugin yang kuat dari Plazma memungkinkan server untuk disesuaikan dengan mudah. + +Ada beberapa cara untuk mencari dan mengunduh plugin. Beberapa plugin diunggah ke layanan repositori publik, sementara yang lain diunggah ke GitHub atau situs web mereka sendiri. + +{% hint style="caution" %} + +**Plugin dapat mengakses sistem secara langsung!** + +Selalu periksa keamanan plugin sebelum menerapkannya dengan menggunakan layanan seperti VirusTotal, atau unduh plugin dari layanan tepercaya. + +{% endhint %} + +Ada berbagai layanan yang digunakan untuk mengunduh plugin. Di antaranya, [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) melakukan peninjauan sebelum plugin diunggah, sehingga hanya plugin yang aman yang disebarkan. + +### Menerapkan Plugin + +Setelah mengunduh plugin, saatnya menerapkannya. + +1. Plugin berbentuk `.jar` atau `Java Executable File`. Beberapa plugin dikompresi dalam file zip, dalam kasus tersebut, ekstrak file yang mengandung 'bukkit', 'spigot', atau 'paper', jika ada file 'fat' bersamaan, gunakan file 'fat' tersebut. +2. Letakkan file yang diunduh ke dalam folder `plugins` di folder server, lalu (re)start server. +3. Saat Plazma dimulai, akan ada output baru di konsol. + Ini menandakan bahwa Plazma telah berhasil memuat plugin dengan baik. +4. Meskipun Plazma telah berhasil memuat plugin, mungkin plugin tidak berjalan dengan baik. + Dengan menggunakan perintah `/plugins`, Anda dapat melihat plugin yang saat ini dimuat di server. + Jika nama plugin yang diinstal tidak ditandai dengan merah, tetapi hijau, itu berarti plugin telah dimuat dengan baik. + +Jika plugin tidak dimuat dengan baik, Anda dapat menemukan solusi di halaman berikut. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Menggunakan Data Pack + +Data Pack adalah cara kustomisasi yang disediakan Minecraft, mirip dengan [Resource Pack](#user-content-fn-1). + +Dengan menggunakan Data Pack, Anda dapat menambahkan spesies baru dan tantangan dalam permainan, serta melakukan modifikasi pada bagian tertentu di dalam permainan. + +{% hint style="caution" %} + +**Data Pack dapat merusak dunia!** + +Beberapa Data Pack yang rusak dapat merusak dunia dan tidak dapat dikembalikan. + +Sebaiknya, cadangkan dunia sebelum menerapkan Data Pack. + +{% endhint %} + +Data Pack juga dapat diunduh dari berbagai layanan seperti [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs), dan layanan lainnya. + +Setelah mengunduh Data Pack, letakkan di folder `datapacks` di folder dunia server. +Jika folder tidak ada, buat folder tersebut sebelum menambahkan Data Pack. + +{% hint style="warning" %} + +**Beberapa [Data Pack](#user-content-fn-2) mungkin tidak diterapkan dengan baik pada awalnya.** + +Untuk mengantisipasi hal ini, disarankan untuk me-restart server **2 kali** setelah menerapkan Data Pack. + +{% endhint %} + +Data Pack dapat dengan mudah rusak setiap kali Minecraft diperbarui. + +Khususnya, jika Data Pack rusak, server dapat mengalami crash, oleh karena itu, penting untuk melakukan pengujian yang memadai sebelum memperbarui server. + +{% hint style="info" %} + +**Setelah perintah memulai server, masukkan `safeMode` untuk menonaktifkan semua Data Pack dan kemudian mulai server.** + +[Lihat `Referensi > Argumen dan Properti` untuk informasi lebih lanjut.](../reference/arguments.md) + +{% endhint %} + +Data Pack yang telah diterapkan dapat dikonfirmasi melalui perintah `/datapack list`. + +*** + +[^1]: Atau Add-on Minecraft: Bedrock Edition. + +[^2]: Menambahkan spesies baru dan lainnya. diff --git a/id/origin/plazma/administration/getting-started/next-step.md b/id/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..edc7f261c --- /dev/null +++ b/id/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Pelajari cara menyesuaikan server. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Berikut adalah beberapa cara untuk menyesuaikan dan menggunakan Plazma. + +## Modifikasi Konfigurasi + +Cara paling dasar untuk menyesuaikan Plazma adalah dengan memodifikasi konfigurasi. + +Plazma menyediakan pengaturan konfigurasi yang kuat mulai dari mekanisme permainan hingga atribut monster. + +Silakan lihat penjelasan mengenai konfigurasi Plazma pada halaman berikut. + +{% content-ref url="../reference/configurations/" %} +[konfigurasi](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Penggunaan Plugin + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Ini adalah alasan utama penggunaan Plazma dan cara terkuat untuk menyesuaikan Plazma. Ekosistem plugin yang kuat dari Plazma memungkinkan server untuk disesuaikan dengan mudah. + +Ada beberapa cara untuk mencari dan mengunduh plugin. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Ada berbagai layanan yang digunakan untuk mengunduh plugin. Di antaranya, [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) melakukan peninjauan sebelum plugin diunggah, sehingga hanya plugin yang aman yang disebarkan. + +### Menerapkan Plugin + +Setelah mengunduh plugin, saatnya menerapkannya. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Letakkan file yang diunduh ke dalam folder `plugins` di folder server, lalu (re)start server. +3. Saat Plazma dimulai, akan ada output baru di konsol. Ini menandakan bahwa Plazma telah berhasil memuat plugin dengan baik. +4. Meskipun Plazma telah berhasil memuat plugin, mungkin plugin tidak berjalan dengan baik. Dengan menggunakan perintah `/plugins`, Anda dapat melihat plugin yang saat ini dimuat di server. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Jika plugin tidak dimuat dengan baik, Anda dapat menemukan solusi di halaman berikut. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Menggunakan Data Pack + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Dengan menggunakan Data Pack, Anda dapat menambahkan spesies baru dan tantangan dalam permainan, serta melakukan modifikasi pada bagian tertentu di dalam permainan. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Beberapa Data Pack yang rusak dapat merusak dunia dan tidak dapat dikembalikan. + +Sebaiknya, cadangkan dunia sebelum menerapkan Data Pack. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Setelah mengunduh Data Pack, letakkan di folder `datapacks` di folder dunia server. Jika folder tidak ada, buat folder tersebut sebelum menambahkan Data Pack. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Untuk mengantisipasi hal ini, disarankan untuk me-restart server **2 kali** setelah menerapkan Data Pack. +{% endhint %} + +Data Pack dapat dengan mudah rusak setiap kali Minecraft diperbarui. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Data Pack yang telah diterapkan dapat dikonfirmasi melalui perintah `/datapack list`. + +*** + +## Optimasi + +Plazma telah menerapkan banyak patch optimasi. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proksi + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Lihat informasi tentang pengaturan proksi yang aman dan benar di halaman berikut. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Keamanan + +Minecraft telah berkembang sehingga mudah untuk mendapatkan [mesin serangan kerentanan](#user-content-fn-3)[^3] secara online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Pengaturan Izin + +Beberapa perintah administrator plugin mungkin memiliki kerentanan jika izinnya tidak diatur dengan benar. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Pemblokiran X-Ray + +X-Ray adalah salah satu kerentanan yang mudah digunakan bahkan dalam klien optimasi dasar. + +Plazma menyediakan konfigurasi untuk secara default memblokir X-Ray. + +Lihat cara dan penjelasan pemblokiran X-Ray di halaman berikut. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Gunakan `/whitelist query` untuk melihat pemain yang diizinkan masuk. + +*** + +[^1]: Atau Add-on Minecraft: Bedrock Edition. + +[^2]: Menambahkan spesies baru dan lainnya. + +[^3]: Biasanya disebut sebagai "cheat". + +[^4]: Jika konfigurasi tidak dioptimalkan, Plazma sudah usang, atau terdapat kerentanan baru, pemblokiran mungkin tidak efektif. + +[^5]: Pemain terhubung ke server melalui server proksi Ngrok, dan alamat Ngrok yang dikeluarkan setiap kali restart akan berbeda. diff --git a/id/origin/plazma/administration/reference/README.md b/id/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..51ee94a56 --- /dev/null +++ b/id/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Pelajari cara kustomisasi bawaan dari Plazma. +--- + +# 📜 리퍼런스 + +Plazma menyediakan berbagai metode kustomisasi. + +Di antaranya, 4 metode berikut adalah metode kustomisasi yang dapat digunakan langsung tanpa tindakan tambahan. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Server Discord resmi](https://discord.gg/MmfC52K8A8) atau bertanya kepada komunitas melalui [Diskusi GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Perintah + +> Perintah memungkinkan pengumpulan informasi dalam permainan atau penyesuaian lingkungan bermain. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Izin + +> Izin menentukan jangkauan interaksi pemain. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumen dan Atribut + +> Argumen dan atribut berpengaruh secara keseluruhan pada fungsi Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigurasi + +> Konfigurasi merupakan cara paling dasar untuk mengkustomisasi Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/id/origin/plazma/administration/reference/arguments.md b/id/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..1a514262f --- /dev/null +++ b/id/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Pelajari tentang argumen awal dan properti sistem. +--- + +# 🎛️ Argumen dan Properti + +Argumen awal dan properti sistem adalah nilai tambahan yang ditambahkan ke [perintah yang digunakan](#user-content-fn-1)[^1] untuk menjalankan Plazma, yang secara keseluruhan memengaruhi operasi Plazma. + +[Posisi yang ditambahkan ke perintah](#user-content-fn-2)[^2] akan dibagi menjadi **Argumen Awal** dan **Properti Sistem** sesuai dengan posisi tersebut. + +*** + +## Properti Sistem + +Properti sistem dimasukkan sebelum `-jar` dan diproses oleh JVM sebelum Plazma diinisialisasi. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Cara Penggunaan + +Properti sistem dimasukkan sebagai argumen perintah Java antara `java` dan `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` menandakan argumen tersebut adalah argumen tambahan yang ditambahkan ke Plazma, tidak bawaan JVM, dan + +Jika tidak ada nilai yang dimasukkan ke dalam properti, nilai akan tetap [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Seluruh Properti Sistem + +#### `convertLegacySigns` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Memperbarui format tanda yang sudah tidak digunakan. + +#### `debug.entities` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug terkait informasi entitas. + +#### `debug.rewriteForIDE` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan revisi NMS untuk IDE agar dapat memuat informasi debug dengan benar,\ +dan secara otomatis meremapping informasi versi internal. + +#### `disable.watchdog` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan sistem peringatan Watchdog Spigot. + +#### `letMeReload` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan pesan konfirmasi untuk perintah `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Jika Anda adalah pengembang plugin dan perlu melakukan pembaruan plugin, gunakan hotswap alih-alih `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan plugin yang menggunakan sistem I/O standar. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Memberikan peringatan ketika format lama terdeteksi pada komponen obrolan. + +#### `Paper.bypassHostCheck` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan verifikasi pola server saat pemain terhubung ke server. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug untuk kunci yang hilang pada objek NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug untuk blok tengkorak dengan profil yang tidak valid. + +Semua blok tengkorak yang tidak valid akan dicatat dengan posisi mereka di dunia. + +#### `Paper.disableChannelLimit` + +- **Tipe**: `Boolean` +- **Default**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan sistem prioritas kelas plugin. + +Berguna jika terjadi masalah dalam shading plugin. + +#### `Paper.disableFlushConsolidate` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan sistem konsolidasi flush Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Default**: `750` + +Mengirimkan entitas dalam paket terpisah jika melebihi nilai yang ditetapkan. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Default**: `8192` + +Menetapkan ukuran maksimal paket yang dapat diterima oleh server sekaligus. + +#### `Paper.ignoreJavaVersion` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan pengecekan versi Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Ini dapat menyebabkan kerusakan permanen pada file-file di dunia dan mempengaruhi mekanisme permainan secara keseluruhan. + +Semua masalah yang timbul dari penggunaan ini menjadi tanggung jawab pengguna, dan Plamza tidak memberikan dukungan untuk hal ini. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Default**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Default**: `80` + +Menetapkan panjang maksimal karakter yang dapat dimasukkan dalam satu baris tanda. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Default**: `(versi dunia) + 1` + +Menetapkan versi informasi pembaruan dunia yang akan diinisialisasi terlebih dahulu. + +Berguna saat perlu memperbarui sejumlah besar chunk, tetapi jarang digunakan dalam kasus lain. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipe**: `Boolean` +- **Default**: `True` + +Mengaktifkan pengolahan komentar dalam file YAML secara default. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Default**: `30` + +Mengeluarkan pemain dari server jika tidak menerima data apa pun dari pemain selama jumlah waktu tertentu (dalam detik). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengabaikan komentar properti server. + +#### `Paper.debug-sync-loads` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug untuk pembuatan chunk secara sinkron. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan sistem pembuatan chunk standar Minecraft[^10]. + +Ini menyebabkan setiap chunk disimpan secara berurutan, menyebabkan penurunan kinerja yang signifikan. + +#### `Paper.explicit-flush` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan pengeksekusian eksplisit pada saluran jaringan. + +#### `Paper.strict-thread-checks` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Selalu mencatat kesalahan yang terjadi di luar utas utama. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Memberikan peringatan jika tugas terjadwal mengalami keterlambatan berlebih. + +#### `Paperclip.patchOnly` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Jika menggunakan file eksekusi bawaan, hanya menerapkan patch tanpa memulai server. + +#### `Plazma.aggressiveOptimize` + +- **Tipe**: `Boolean` +- **Default**: `false` +- **Tabrakan**: `Plazma.disableConfigOptimization` + +Mengoptimalkan konfigurasi awal secara lebih kuat. + +Mengaktifkan ini akan membuat server lebih cepat dan aman, namun dapat berdampak besar pada gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Tipe**: `Boolean` +- **Default**: `false` +- **Tabrakan**: `Plazma.aggressiveOptimize` + +Tidak mengoptimalkan konfigurasi awal. + +Ini menggunakan konfigurasi default dari Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipe**: `Boolean` +- **Default**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tipe**: `Boolean` +- **Default**: `false` + +Menonaktifkan branding Plazma dan menggunakan favicon server default vanila. + +#### `Plazma.useVanillaConfiguration` + +- **Tipe**: `Boolean` +- **Default**: `false` +- **Tabrakan**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Ini dapat memiliki dampak besar pada keamanan dan performa server. + +Semua masalah yang timbul dari penggunaan properti ini menjadi tanggung jawab administrator server. +{% endhint %} + +Mengatur konfigurasi awal menjadi nilai default yang disediakan oleh Mojang. + +Ini menonaktifkan semua patch kerentanan yang diterapkan oleh Paper. + +Patch kerentanan dapat diaktifkan kembali dalam konfigurasi Paper atau Plazma. + +#### `Plazma.vanillaize` + +- **Tipe**: `Boolean` +- **Default**: `true` +- **Tabrakan**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Mengatur konfigurasi awal menjadi lebih mendekati vanila. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Atribut yang sudah tidak digunakan + +Berikut adalah atribut sistem yang sudah tidak digunakan. + +#### `timings.bypassMax` + +- **Tipe**: `Boolean` +- **Default**: `false` +- **Dihentikan**: Setelah Timings dihapus dari Plazma + +Menentukan apakah nilai yang dapat dikirim ke API Timings Aikar dapat melebihi batas maksimum. + +Jika tidak diatasi dalam API, batasan kecepatan akan diterapkan. + +*** + +## Argumen Mulai + +Argumen Mulai dimasukkan setelah `-jar *.jar` untuk menginisialisasi Plazma dan merupakan nilai yang diproses bersamaan. + +### Cara Penggunaan + +Properti sistem dimasukkan setelah `-jar *.jar` sebagai argumen perintah program. + +Misalnya, jika Anda ingin menerapkan argumen mulai `nogui`,\ +masukkan seperti ini agar Plazma memproses argumen `nogui` saat inisialisasi. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumen Mulai Lengkap + +#### `bukkit-settings` + +- **Alias**: `b` +- **Nilai Default**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Nilai Default**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Nilai Default**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Memulai server ke dalam dunia demo. + +#### `eraseCache` + +Menghapus file cache yang tersisa setelah upgrade dunia. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Menampilkan argumen mulai lengkap dan penjelasan Plazma. + +#### `initSettings` + +Membuat file konfigurasi saja dan menutup server. + +#### `jfrProfile` + +Mengaktifkan profil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Nilai Default**: `(Properti Server)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Menonaktifkan panel antarmuka grafis. + +#### `nojline` + +Menonaktifkan JLine dan menggunakan konsol vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Nilai Default**: `(Properti Server)` + +Memilih untuk memverifikasi pemain melalui server otentikasi Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Nilai Default**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Menetapkan lokasi [File Konfigurasi PaperSpigot](../reference/configurations/paper/README.md) yang telah dihentikan penggunaannya. + +Digunakan untuk memindahkan konfigurasi lama ke file konfigurasi baru dan tidak digunakan lagi setelahnya. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Nilai Default**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Nilai Default**: `plugins` + +Menetapkan lokasi folder plugin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Nilai Default**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Nilai Default**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Memulai server dalam keadaan vanilla lengkap. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Nilai Default**: `(Properti Server)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Nilai Default**: `(Properti Server)` + +Menetapkan port server. + +#### `server-name` + +- **Nilai Default**: `A Plazma Server` + +Menetapkan nama server. + +#### `spigot-settings` + +- **Alias**: `S` +- **Nilai Default**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Menampilkan versi Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Nilai Default**: `(folder server)` + +Menetapkan lokasi penyimpanan file dunia. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Nilai Default**: `(Properti Server)` + +Menetapkan nama file dunia. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Posisi argumen yang diproses tergantung pada lokasi tambahan yang ditambahkan. + +[^3]: Misalnya, jika ingin mengatur (mengaktifkan) `Plazma.iKnowWhatIAmDoing` menjadi `true`, cukup masukkan `-DPlazma.iKnowWhatIAmDoing` tanpa `=true` dan akan tetap berfungsi. + +[^4]: Misalnya, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor acara. + +[^6]: Detektor acara. + +[^7]: Klien. + +[^8]: Sinyal yang menunjukkan bahwa klien terhubung dengan server dengan lancar seperti detak jantung. + +[^9]: Dengan fitur kick AFK Purpur, Anda dapat mengeluarkan pemain yang meninggalkan tempat. + +[^10]: Sistem Penulisan Chunk Sinkron. + +[^11]: `PERINGATAN! Plazma mungkin menyebabkan masalah yang tidak terduga, jadi pastikan untuk mengujinya secara menyeluruh sebelum menggunakannya di server publik.` + +[^12]: Dalam permainan, `optimisasi dunia` juga beroperasi dengan prinsip yang sama. + +[^13]: Administrator `level 2` ke atas dikecualikan. + +[^14]: Protokol Internet, IP. diff --git a/id/origin/plazma/administration/reference/commands.md b/id/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..d2c08de61 --- /dev/null +++ b/id/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Pelajari perintah yang tersedia di Plazma. +--- + +# 🖥️ Perintah diff --git a/id/origin/plazma/administration/reference/configurations/README.md b/id/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..4b66a3ddf --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigurasi merupakan cara paling dasar untuk mengkustomisasi Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atribut + +> Atribut adalah file konfigurasi paling dasar yang disediakan oleh Minecraft. Dengan menggunakan atribut, Anda dapat mengubah mekanisme dasar permainan. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Konfigurasi Bukkit + +> Konfigurasi Bukkit adalah file konfigurasi paling dasar yang disediakan oleh Plazma. Dengan menggunakan konfigurasi Bukkit, Anda dapat mengubah mekanisme dasar server Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Konfigurasi Spigot + +> Konfigurasi Spigot memungkinkan Anda untuk memodifikasi detail mekanisme permainan, pemrosesan pemain, operasi perintah, dan pesan. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Konfigurasi Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Konfigurasi Pufferfish + +> Konfigurasi Pufferfish memungkinkan Anda untuk mengubah pemrosesan dunia dan entitas Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Konfigurasi Purpur + +> Atribut Purpur memungkinkan Anda untuk memodifikasi data dasar permainan. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Konfigurasi Plazma + +> Konfigurasi Plazma memungkinkan Anda untuk menyesuaikan fitur-fitur Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/id/origin/plazma/administration/reference/configurations/bukkit.md b/id/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..4e5c00b23 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang dimaksud dengan setiap node dalam bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/id/origin/plazma/administration/reference/configurations/paper/README.md b/id/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..5646f34ce --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tujuan dari setiap file di dalam folder config. +--- + +# 🛩️ Kertas diff --git a/id/origin/plazma/administration/reference/configurations/paper/global.md b/id/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f65c3ee92 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang dimaksud dengan setiap node dalam paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/id/origin/plazma/administration/reference/configurations/paper/world.md b/id/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f2df29c0d --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Pelajari apa yang masing-masing node dalam paper-world.yml artikan. +--- + +# 🏳️ 세계별 구성 + +Dunia diff --git a/id/origin/plazma/administration/reference/configurations/plazma/README.md b/id/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..a5a7493d7 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tujuan dari setiap file di dalam folder config. +--- + +# ✨ Plazma diff --git a/id/origin/plazma/administration/reference/configurations/plazma/global.md b/id/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..ec476966d --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa arti dari setiap node dalam plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/id/origin/plazma/administration/reference/configurations/plazma/world.md b/id/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..c1dfdb963 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Cari tahu apa arti dari setiap node dalam plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/id/origin/plazma/administration/reference/configurations/plazma/worlds.md b/id/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..9e02d18da --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Cari tahu apa arti dari setiap node dalam plazma-world.yml. +--- + +# ✨ Plazma (Konfigurasi Berdasarkan Dunia) diff --git a/id/origin/plazma/administration/reference/configurations/property.md b/id/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..2974807af --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Cari tahu apa arti dari setiap node dalam server.properties. +--- + +# 🪨 Server.properties diff --git a/id/origin/plazma/administration/reference/configurations/pufferfish.md b/id/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..13bbadfa1 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang masing-masing node dalam pufferfish.yml artinya. +--- + +# 🐡 Ikan Buntal diff --git a/id/origin/plazma/administration/reference/configurations/purpur/README.md b/id/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd91dc29a --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa yang setiap node dalam purpur.yml berarti. +--- + +# 🦑 Purpur diff --git a/id/origin/plazma/administration/reference/configurations/purpur/global.md b/id/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..6e17236c2 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa yang setiap node dalam purpur.yml berarti. +--- + +# 🌏 전역 구성 diff --git a/id/origin/plazma/administration/reference/configurations/purpur/world.md b/id/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..2d844c429 --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa yang setiap node dalam purpur.yml berarti. +--- + +# 🏳️ 세계별 구성 diff --git a/id/origin/plazma/administration/reference/configurations/spigot.md b/id/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..3e403b85c --- /dev/null +++ b/id/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang dimaksud dengan setiap node di spigot.yml. +--- + +# 🚰 Spigot diff --git a/id/origin/plazma/administration/reference/permissions.md b/id/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..2cdc98e12 --- /dev/null +++ b/id/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Pelajari tentang izin Plazma. +--- + +# 🛡️ Izin + +Izin adalah alat keamanan sederhana yang mengatur jangkauan interaksi antar pemain di dalam server. + +Untuk memanfaatkan izin dengan baik dan mudah diubah, Anda harus menggunakan plugin seperti [LuckPerms](https://luckperms.net). + +*** + +## Memahami Sistem Izin Dasar + +Minecraft menyediakan grup izin administrasi dasar. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Pemain**\ + Grup izin yang diberikan kepada semua pemain secara umum. +2. **Mediator**\ + Dapat mengabaikan perlindungan spawn. +3. **Pengelola Dunia**\ + Dapat menggunakan semua perintah dan blok perintah terkait pengelolaan dunia.\ + Grup izin yang secara default diterapkan pada data paket dan blok perintah. +4. **Administrator**\ + Dapat menggunakan semua perintah terkait manajemen pemain. +5. **Super Administrator**\ + Dapat menggunakan semua perintah termasuk manajemen server.\ + Grup izin yang diterapkan secara default pada konsol dan administrator. + +*** + +## Mengatur Izin + +*** + +## Izin Penuh + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk merangkak dan berinteraksi dengan entitas untuk menaiki entitas. + +Ketika menaiki entitas, pemain dapat mengendalikan gerakan entitas dengan tombol gerak, dan melompat atau terbang dengan tombol lompat. + +`(Namespaced Key)` adalah ID Namespaced entitas yang dimasukkan. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Bawaan**: `None` + +Memungkinkan pemain menggunakan keterampilan khusus entitas saat menaiki entitas. + +Tidak semua keterampilan khusus entitas dapat digunakan. Lihat di bawah untuk daftar lengkap keterampilan khusus yang tersedia. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Silakan posting ide Anda di [Plazma Discord](https://plazmamc.org/discord) atau [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Lihat Keterampilan Khusus yang Tersedia Saat Ini + +- **`crepper`**\ + Meledak saat tombol lompat ditekan.\ + Jika pemain memiliki izin `allow.powered.creeper`, mereka dapat menekan tombol lompat untuk mengisi daya. +- **`dolphin`**\ + Meledak saat tombol lompat ditekan. +- **`phantom`**\ + Menembakkan api saat tombol lompat ditekan. +- **`wither`**\ + Menembakkan kepala wither saat berinteraksi. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/credits (Pemain)`](commands.md#credits). + +Menambahkan `.other` setelah nama izin memungkinkan penggunaan oleh pemain lain. + +#### `bukkit.command.demo` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/demo (Pemain)`](commands.md#demo). + +Menambahkan `.other` setelah nama izin memungkinkan penggunaan oleh pemain lain. + +#### `bukkit.command.ping` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/ping (Pemain)`](commands.md#ping). + +Menambahkan `.other` setelah nama izin memungkinkan penggunaan oleh pemain lain. + +#### `bukkit.command.ram` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/rambar (Pemain)`](commands.md#rambar). + +Menambahkan `.other` setelah nama izin memungkinkan penggunaan oleh pemain lain. + +#### `bukkit.command.restart` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/tpsbar (Pemain)`](commands.md#tpsbar). + +Menambahkan `.other` setelah nama izin memungkinkan penggunaan oleh pemain lain. + +#### `bukkit.command.timings` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Untuk informasi tentang perintah serupa, lihat [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan penggunaan perintah [`/gamemode (GameMode) (Pemain)`]. + +Menambahkan `.other` setelah nama izin memungkinkan penggunaan oleh pemain lain. + +#### `paper.antixray.bypass` + +- **Bawaan**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Ini akan meningkatkan kinerja untuk kedua belah pihak. + +> Untuk informasi tentang pengaturan X-Ray, lihat halaman berikut. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Bawaan**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Bawaan**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Bawaan**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Bawaan**: `None` + +Memungkinkan penggunaan tag [MiniMessage](https://docs.advntr.dev/minimessage/format.html) pada landasan. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Bawaan**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Bawaan**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Bawaan**: `None` + +Mengecualikan pemain dari pemain yang akan dikeluarkan karena tidak aktif. + +#### `purpur.debug.f3n` + +- **Bawaan**: `Pengelola Dunia` + +Memungkinkan pemain untuk mengubah mode permainan dengan tombol `F3 + N`. + +Akan tidak berfungsi tanpa izin untuk mode permainan tersebut. + +#### `purpur.drop.spawners` + +- **Bawaan**: `None` + +Jika menambang blok spawner dengan item yang dikonfigurasi, blok spawner akan jatuh. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Bawaan**: `None` + +Mengubah ukuran ender chest. + +Anda dapat memasukkan `one`, `two`, `three`, `four`, `five`, `six` ke dalam `(NumberString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Bawaan**: `None` + +Memungkinkan totem abadi berfungsi meskipun berada di inventaris. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk mengabaikan batasan jumlah pengguna yang terhubung. + +#### `purpur.mending_shift_click` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk memperbaiki item yang dipegang saat `menunduk dan berinteraksi`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk memasang pembuat spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk langsung teleportasi saat menggunakan portal Nether. + +#### `purpur.sign.color` + +- **Bawaan**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Bawaan**: `None` + +Memungkinkan penggunaan kode enkripsi pada papan nama`(&o)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Bawaan**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk mencegah ledakan TNT dengan `interaksi saling` menggunakan gunting. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Hak akses yang akan datang + +#### `plazma.bypass.ncr-require` + +- **Bawaan**: `None` + +Memungkinkan pemain untuk bergabung tanpa harus menginstal mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Contoh: `ender_dragon` diff --git a/id/origin/plazma/adminstration/README.md b/id/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..1b7e9c0f0 --- /dev/null +++ b/id/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Gunakan Plazma untuk membuat server Anda sendiri. +--- + +# ⚒️ Panduan Pengelolaan Server diff --git a/id/origin/plazma/adminstration/expert/README.md b/id/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..c33dabbd5 --- /dev/null +++ b/id/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Pelajari cara mengelola Plazma secara profesional. +--- + +# 🎓 Lanjutan diff --git a/id/origin/plazma/adminstration/expert/fix-exploits.md b/id/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..905e1878b --- /dev/null +++ b/id/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tentang kerentanan yang diketahui dan cara mengatasinya. +--- + +# ⚠️ Kerentanan yang diketahui dan cara penyelesaiannya diff --git a/id/origin/plazma/adminstration/expert/optimize.md b/id/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..6b2af9d63 --- /dev/null +++ b/id/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Temukan cara untuk mengoptimalkan Plazma. +--- + +# 🧹 Optimalisasi diff --git a/id/origin/plazma/adminstration/expert/vanillaize.md b/id/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..701af836a --- /dev/null +++ b/id/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Pelajari cara memulihkan patch Paper dan vanilla. +--- + +# ↩️ Mengvanilakan + +{% hint style="warning" %} + +### Paper tidak menyertakan pilihan untuk sebagian besar patch yang memperbaiki kesalahan vanilla. + +Plazma saat ini sedang mengembangkan kemampuan untuk menonaktifkan perbaikan kesalahan tersebut melalui konfigurasi. + +Oleh karena itu, panduan ini masih dalam proses penulisan dan informasinya dapat berubah kapan saja. +{% endhint %} diff --git a/id/origin/plazma/adminstration/faq.md b/id/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..a99dd0ea9 --- /dev/null +++ b/id/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Pelajari pertanyaan yang sering diajukan. +--- + +# ⁉️ Pertanyaan yang Sering Diajukan + +{% hint style="info" %} + +### Tidak bisa menemukan jawaban yang Anda inginkan? + +[Server Discord resmi](https://discord.gg/MmfC52K8A8) atau [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) untuk bertanya kepada komunitas! +{% endhint %} + +### Pesan muncul tetapi tidak berjalan + +Jika `no main manifest attribute, in plazma-(version).jar` muncul di konsol,\ +file yang diunduh adalah file API pengembangan, Anda perlu mengunduh **Reobf Paperweight** dari halaman GitHub. + +Untuk informasi lebih lanjut, lihat halaman berikut. + +{% content-ref url="getting-started/" %} +[mulai](getting-started#id-2) +{% endcontent-ref %} + +### Peringatan muncul setiap kali server mulai + +Plazma mengandung beberapa patch yang tidak stabil dan dapat menyebabkan kerusakan, oleh karena itu pesan peringatan berikut ditampilkan setiap kali server mulai. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Pesan peringatan ini dapat dinonaktifkan menggunakan properti sistem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Untuk informasi lebih lanjut, lihat halaman berikut. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tersedia mulai versi 1.20.1 diff --git a/id/origin/plazma/adminstration/getting-started/README.md b/id/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..609957d5f --- /dev/null +++ b/id/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Pelajari cara membuat server dengan Plazma. +--- + +# 👟 Mulai + +Untuk menggunakan Plazma secara stabil, sistem harus memenuhi persyaratan berikut: + +| | Minimum | Disarankan | +| :---------------: | ------: | ---------: | +| Arsitektur | x64 | - | +| RAM | 8GB | 16GB | +| Ruang Penyimpanan | 1GB | 8GB | +| JRE | 17 | 21 | + +Untuk pengeditan file konfigurasi yang lancar, disarankan untuk menginstal editor seperti [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalasi JRE + +Seperti namanya, Minecraft: **"Java"** Edition dikembangkan dengan Java, sehingga memerlukan JRE[^1] untuk dijalankan. + +Karena Plazma didasarkan pada platform server resmi Mojang Studios[^2], untuk menggunakan Plazma juga diperlukan instalasi JRE. + +### 1.1 Memeriksa Ketersediaan JRE + +Untuk memeriksa apakah JRE telah terinstal di sistem, masukkan [`cmd /k java --version`](#user-content-fn-4)[^4] di jendela jalankan dan jalankan perintah tersebut. + +Jika outputnya sama seperti di atas, lanjutkan ke [Langkah 2](setup.md#id-2). + +{% code title="Output yang Benar" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Jika output tidak sama seperti di atas atau jika outputnya menunjukkan bahwa JRE tidak ada atau terlalu lama, maka Anda perlu melakukan [Langkah 1.2](setup.md#id-1.2). + +{% code title="JRE Tidak Terinstal" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE terlalu lama" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalasi JRE + +Dalam panduan ini, kami akan menggunakan Azul Zulu sebagai [salah satu jenis](#user-content-fn-5)[^5] dari JRE. + +Setelah instalasi selesai, lakukan kembali langkah [1.1](setup.md#id-1.1) untuk memastikan instalasi telah selesai dengan benar. + +{% tabs %} +{% tab title="Windows" %} + +1. Pertama, unduh **JDK 21** dari [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) dalam format `.msi`. +2. Jalankan wizard instalasi yang telah diunduh dan klik `Next`. +3. **Aktifkan `Set JAVA_HOME variable` di menu sebelah kiri tengah jendela** dan klik `Next`. +4. Klik `Install` untuk menyelesaikan instalasi JRE. + {% endtab %} + +{% tab title="macOS" %} +Unduh wizard instalasi **JDK 21** dari [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) dalam format `.dmg` dan instal JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Tambahkan repositori Azul Zulu ke APT dengan menjalankan perintah berikut di terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Selanjutnya, instal JRE dengan menjalankan perintah berikut di terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Anda dapat menginstal JRE dengan menjalankan perintah berikut. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Unduh Plazma + +Plazma menyediakan berbagai jenis file eksekusi. + +{% hint style="warning" %} + +### Sebagian besar kasus menggunakan `Reobf Paperclip`. + +Informasi di bawah ini ditujukan untuk pengembang atau mereka yang ingin mengetahui lebih lanjut tentang masing-masing jenis.\ +Jika Anda pengguna umum, tidak masalah untuk melompat ke [langkah 3](setup.md#id-3). +{% endhint %} + +
+ +Pelajari lebih lanjut + +Nama file eksekusi adalah `plazma-(manajer versi)-1.20.4-R0.1-SNAPSHOT-(jenis pemetaan).jar`. + +- **Jenis Pemetaan**\ + Pemetaan adalah peta yang menghubungkan kode sebenarnya Minecraft dengan kode yang telah diacak. + - **Reobf**\ + Reobfuscation, juga dikenal sebagai pemetaan Spigot dan umum digunakan dalam plugin NMS.\ + Akan dihentikan mulai dari versi 1.20.5. + - **Mojmap**\ + Pemetaan Mojang, pemetaan Minecraft Vanilla. +- **Manajer Versi**\ + Manajer versi adalah perangkat peluncur yang diperlukan untuk menjalankan server dan menerapkan patch pada file server. + - **Paperclip**\ + Dikembangkan oleh tim PaperMC untuk Paper dan platform turunannya, berperan dalam mengunduh pustaka dan menerapkan patch pada server. + - **Bundler**\ + Manajer versi Minecraft Vanilla. + +
+ +*** + +## 3. Buat Skrip Mulai + +Untuk memulai Plazma dengan mudah dan merestart server secara otomatis, Anda perlu membuat [skrip mulai](#user-content-fn-6)[^6]. + +Anda dapat membuat skrip mulai melalui [Flags.sh](https://flags.sh).\ +Hanya dengan memasukkan [memori yang akan digunakan oleh Plazma](#user-content-fn-8)[^8], perintah akan dioptimalkan secara otomatis. + +Anda dapat mengunduh skrip mulai melalui tombol unduh di pojok kiri bawah.\ +**Pastikan skrip mulai yang diunduh sesuai dengan sistem operasi Anda.** + +*** + +## 4. Penyusunan File + +Pindahkan skrip mulai yang telah diunduh dan Plazma ke folder baru sekarang. + +{% hint style="warning" %} + +### Nama folder harus tanpa spasi dan berbahasa Inggris. + +Jika tidak, Plazma atau JRE mungkin tidak berfungsi dengan benar. +{% endhint %} + +Jalankan skrip mulai sekarang. Untuk Windows, Anda harus memilih **Allow** saat muncul jendela pilihan izin firewall. + +*** + +## 5. Persetujuan EULA + +Setelah menjalankan skrip mulai sekali, file `eula.txt` akan dibuat di folder tersebut. + +EULA[^9] adalah perjanjian lisensi yang harus disetujui dengan menggunakan layanan [Mojang Studios](#user-content-fn-10)[^10]. + +Jika tidak menyetujui EULA, Anda tidak dapat memulai server dan mungkin menerima sanksi seperti akun ditangguhkan [seperti yang dijelaskan di sini](#user-content-fn-11)[^11]. + +Untuk menyetujui EULA, ubah `eula=false` menjadi `eula=true` dalam file `eula.txt` dan simpan perubahan. + +*** + +## 6. Izin Akses Eksternal (Windows) + +Sistem operasi modern secara default memblokir akses eksternal untuk melindungi dari akses berbahaya dari luar dengan menggunakan **firewall** dan **router**. + +Untuk Windows, karena sudah mengizinkan pada [langkah 3](setup.md#id-3), Anda hanya perlu melakukan port forwarding. + +{% hint style="info" %} + +### Panduan ini diasumsikan untuk sistem operasi Windows dan [**UPnP**](#user-content-fn-12)[^12] yang menggunakan router yang mendukung UPnP. + +Jika router tidak mendukung UPnP, Anda perlu mencari informasi spesifik berdasarkan router masing-masing. + +Atau Anda dapat menggunakan [Ngrok](https://ngrok.com/) untuk membuat alamat sementara. +{% endhint %} + +{% hint style="warning" %} + +### Untuk sistem operasi (semi) UNIX seperti Linux atau macOS, cara mengatur firewall berbeda untuk setiap layanan, jadi Anda perlu mencari informasinya sendiri. + +{% endhint %} + +### 6.1 Memeriksa Kebutuhan Port Forwarding + +Masukkan dan jalankan perintah berikut di jendela eksekusi. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jika output adalah `True`, Anda tidak perlu melakukan apa pun, tetapi jika `False`, Anda perlu mengatur port forwarding. + +### 6.2 Mengakses Server + +{% tabs %} +{% tab title="Akses Eksternal" %} +Jika tidak diperlukan port forwarding atau port forwarding sudah berhasil dilakukan, Anda sekarang dapat mengakses server. + +Alamat yang digunakan untuk mengakses server dapat ditemukan [di sini](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Mencoba UPnP untuk Port Forwarding" %} +Di dalam file `purpur.yml` server, aktifkan `network.upnp-port-forwarding` menjadi `true`. + +Kemudian, restart server, Plazma akan mencoba port forwarding secara otomatis. + +Keberhasilan UPnP akan tergantung pada pesan yang muncul di konsol, yang akan ditampilkan sebagai `[UPnP] (pesan)`. + +| Pesan | Arti | +| ------------------------------ | ---------------------------------------- | +| `Berhasil membuka port (port)` | Port forwarding berhasil. | +| `Port (port) sudah terbuka` | Port sedang digunakan oleh layanan lain. | +| `Gagal membuka port (port)` | Port forwarding gagal. | +| `Layanan tidak tersedia` | Router tidak mendukung UPnP. | + +Ketika server dimatikan, Plazma akan menutup port secara otomatis. +{% endtab %} + +{% tab title="Membuat Alamat Sementara dengan Ngrok" %} +Metode ini berguna untuk pengujian sementara, kolaborasi, atau bermain dengan teman. + +1. Unduh file ZIP `Windows (64-bit)` dari [situs Ngrok](https://ngrok.com/download). +2. Letakkan file Ngrok yang diunduh ke dalam folder server. +3. Buat [token otentikasi](#user-content-fn-13) dari [Dashboard Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Jalankan perintah yang ditampilkan di `Command Line` dari folder server. +5. Tambahkan `start /b ngrok tcp --region jp 25565` di bagian atas skrip eksekusi dan `taskkill /f /t /im ngrok.exe` di bagian bawahnya. +6. Pada pesan `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` di bagian atas konsol, `0.tcp.jp.ngrok.io:12345` adalah alamat server. +7. Sekarang Anda dapat mengakses melalui alamat tersebut dari luar. + {% endtab %} + +{% tab title="Akses Lokal" %} +Jika Anda mencoba terhubung ke server dari lokal, jalankan `cmd /k ipconfig` di jendela eksekusi untuk menggunakan `Alamat IPv4` yang ditampilkan. + +Misalnya, setelah menjalankan perintah, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Jika Anda mencoba terhubung ke server dari lokal, coba hubungkan ke `192.168.3.7` yang ditunjukkan sebagai Alamat IPv4. + +Jika server dan game dijalankan pada PC yang sama, Anda dapat terhubung melalui `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Tahap Pengembangan + +Setelah berhasil memulai server dan server berfungsi dengan baik, saatnya untuk menyesuaikan server. + +Pelajari cara menyesuaikan server melalui panduan di bawah ini. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Lingkungan Eksekusi Java. + +[^2]: Berdasarkan Paper yang merupakan dasar dari Plazma, yang juga didasarkan pada Spigot, yang merupakan platform server resmi. + +[^3]: Tombol Windows + R + +[^4]: Untuk Linux, di terminal ketik `java --version` + +[^5]: JRE adalah salah satu proyek sumber terbuka, seperti platform server Minecraft yang memiliki berbagai jenis. + +[^6]: Biasanya dikenal sebagai **launcher**. + +[^7]: Aktifkan "Auto-restart" untuk menjadwalkan restart otomatis server. Anda dapat menutup dengan menekan `Control + C`. + +[^8]: Tidak disarankan melebihi setengah dari kapasitas sistem. + + Misalnya, ketika kapasitas memori sistem secara keseluruhan adalah 8GB, disarankan untuk tidak mengatur lebih dari 4GB. + +[^9]: Perjanjian Lisensi Pengguna Akhir, Perjanjian Lisensi Pengguna Akhir. Silakan lihat [Situs web Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) untuk informasi lebih lanjut. + +[^10]: Perusahaan Microsoft. + +[^11]: Dalam hal Korea Selatan, berdasarkan Pasal 32 Ayat 1 Nomor 9 dari Undang-Undang Promosi Industri Permainan, **Korea Microsoft Corporation** dapat mengajukan tuntutan hukum. + +[^12]: Universal Plug & Play. Purpur yang terdapat dalam Plazma berkomunikasi secara otomatis dengan router melalui teknologi ini, sehingga tidak perlu melakukan port forwarding secara langsung ketika server sedang berjalan. + +[^13]: Jika tidak memiliki akun, daftarlah ke Ngrok melalui akun Google atau GitHub. diff --git a/id/origin/plazma/adminstration/getting-started/customization.md b/id/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..47e57099b --- /dev/null +++ b/id/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Pelajari cara menyesuaikan server. +--- + +# 🎨 Kustomisasi diff --git a/id/origin/plazma/adminstration/reference/arguments.md b/id/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..587a005b8 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: Pelajari tentang argumen awal dan properti sistem. +--- + +# 🎛️ Argumen dan Properti + +Argumen awal dan properti sistem adalah nilai yang ditambahkan ke [perintah yang digunakan](#user-content-fn-1)[^1] dalam eksekusi Plazma,\ +memungkinkan untuk mengubah nilai yang tidak dapat diubah setelah Plazma dieksekusi. + +Berdasarkan [lokasi nilai yang ditambahkan ke perintah](#user-content-fn-2)[^2], **argumen awal** dan **properti sistem** dibedakan. + +*** + +## Properti Sistem + +Properti sistem dimasukkan sebelum `-jar` dan diproses oleh JVM sebelum Plazma diinisialisasi. + +{% hint style="warning" %} + +### Mengubah properti sistem dapat mengubah cara kerja Plazma dan JVM, serta dapat berdampak besar pada permainan! + +Jika tidak yakin apa peran setiap properti sistem, **jangan pernah gunakan!** +{% endhint %} + +### Cara Penggunaan + +Properti sistem dimasukkan sebagai argumen perintah Java antara `java` dan `-jar`. + +Misalnya, jika ingin menerapkan properti sistem `Plazma.dummyProperty`,\ +masukkan nilai `37` setelah properti tersebut untuk inisialisasi Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` menandakan argumen tersebut adalah argumen tambahan yang ditambahkan ke Plazma, tidak bawaan JVM, dan + +jika tidak ada nilai yang diberikan, nilainya akan [`true secara default.`](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platform server Paperweight memiliki penamaan properti sistem dengan mencakup tanda `.` untuk membedakan properti di setiap platform. + +Beberapa terminal seperti Windows Powershell mungkin tidak mendukung argumen ini, sehingga tambahkan `"` di kedua ujung argumen. [perlu ditambahkan.](#user-content-fn-4)[^4] +{% endhint %} + +### Seluruh Properti Sistem + +#### `convertLegacySigns` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Memperbarui format tanda yang sudah tidak digunakan. + +#### `debug.entities` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug terkait informasi entitas. + +#### `debug.rewriteForIDE` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan revisi NMS untuk IDE agar dapat memuat informasi debug dengan benar,\ +dan secara otomatis meremapping informasi versi internal. + +#### `disable.watchdog` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan sistem peringatan Watchdog Spigot. + +#### `letMeReload` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan pesan konfirmasi untuk perintah `/reload`. + +{% hint style="danger" %} + +### Karena perintah `/reload` sangat tidak stabil, semua masalah yang terjadi setelah menggunakan `/reload` menjadi tanggung jawab pengguna sendiri. + +Jika Anda adalah pengembang plugin dan perlu melakukan pembaruan plugin, gunakan hotswap alih-alih `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan plugin yang menggunakan sistem I/O standar. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Memberikan peringatan ketika format lama terdeteksi pada komponen obrolan. + +#### `Paper.bypassHostCheck` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan verifikasi pola server saat pemain terhubung ke server. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug untuk kunci yang hilang pada objek NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug untuk blok tengkorak dengan profil yang tidak valid. + +Semua blok tengkorak yang tidak valid akan dicatat dengan posisi mereka di dunia. + +#### `Paper.disableChannelLimit` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan batasan 128 saluran plugin per pemain[^5]. + +#### `Paper.disableClassPrioritization` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan sistem prioritas kelas plugin. + +Berguna jika terjadi masalah dalam shading plugin. + +#### `Paper.disableFlushConsolidate` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan sistem konsolidasi flush Netty. + +#### `Paper.excessiveTELimit` + +- **Tipe**: `Integer` +- **Default**: `750` + +Mengirimkan entitas dalam paket terpisah jika melebihi nilai yang ditetapkan. + +#### `Paper.filterThreshold` + +- **Tipe**: `Integer` +- **Default**: `8192` + +Menetapkan ukuran maksimal paket yang dapat diterima oleh server sekaligus. + +#### `Paper.ignoreJavaVersion` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Menonaktifkan pengecekan versi Java. + +{% hint style="danger" %} + +### Hal ini dapat menyebabkan JVM mencoba mengakses kode yang tidak ada! + +Ini dapat menyebabkan kerusakan permanen pada file-file di dunia dan mempengaruhi mekanisme permainan secara keseluruhan. + +Semua masalah yang timbul dari penggunaan ini menjadi tanggung jawab pengguna, dan Plamza tidak memberikan dukungan untuk hal ini. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tipe**: `Integer` +- **Default**: `64` + +Menetapkan batasan nama saluran plugin[^6]. + +#### `Paper.maxSignLength` + +- **Tipe**: `Integer` +- **Default**: `80` + +Menetapkan panjang maksimal karakter yang dapat dimasukkan dalam satu baris tanda. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tipe**: `Integer` +- **Default**: `(versi dunia) + 1` + +Menetapkan versi informasi pembaruan dunia yang akan diinisialisasi terlebih dahulu. + +Berguna saat perlu memperbarui sejumlah besar chunk, tetapi jarang digunakan dalam kasus lain. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipe**: `Boolean` +- **Default**: `True` + +Mengaktifkan pengolahan komentar dalam file YAML secara default. + +#### `Paper.playerConnection.keepAlive` + +- **Tipe**: `Integer` +- **Default**: `30` + +Mengeluarkan pemain dari server jika tidak menerima data apa pun dari pemain selama jumlah waktu tertentu (dalam detik). + +Secara umum, permainan[^7] akan terus mengirimkan [sinyal denyut](#user-content-fn-8)[^8] ke server, sehingga tidak akan diusir, namun, jika tidak merespons, dianggap permainan crash dan akan diusir dari server. + +#### `Paper.skipServerPropertiesComments` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengabaikan komentar properti server. + +#### `Paper.debug-sync-loads` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan log debug untuk pembuatan chunk secara sinkron. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan sistem pembuatan chunk standar Minecraft[^10]. + +Ini menyebabkan setiap chunk disimpan secara berurutan, menyebabkan penurunan kinerja yang signifikan. + +#### `Paper.explicit-flush` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Mengaktifkan pengeksekusian eksplisit pada saluran jaringan. + +#### `Paper.strict-thread-checks` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Selalu mencatat kesalahan yang terjadi di luar utas utama. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Memberikan peringatan jika tugas terjadwal mengalami keterlambatan berlebih. + +#### `Paperclip.patchOnly` + +- **Tipe**: `Boolean` +- **Default**: `False` + +Jika menggunakan file eksekusi bawaan, hanya menerapkan patch tanpa memulai server. + +#### `Plazma.aggressiveOptimize` + +- **Tipe**: `Boolean` +- **Default**: `false` + +{% hint style="warning" %} + +### Properti ini akan dipindahkan ke argumen awal setelah 1.20.5. + +{% endhint %} + +Menerapkan optimalisasi konfigurasi yang lebih ketat saat pertama kali dimulai. + +Mengaktifkan akan membuat server lebih cepat dan aman, tetapi dapat memblokir beberapa mekanisme atau berdampak besar pada gameplay. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipe**: `Boolean` +- **Default**: `false` + +Menghambat pesan peringatan[^11] yang muncul saat Plazma diinisialisasi. + +### Atribut yang sudah tidak digunakan + +Berikut adalah atribut sistem yang sudah tidak digunakan. + +#### `timings.bypassMax` + +- **Tipe**: `Boolean` +- **Default**: `false` +- **Dihentikan**: Setelah Timings dihapus dari Plazma + +Menentukan apakah nilai yang dapat dikirim ke API Timings Aikar dapat melebihi batas maksimum. + +Jika tidak diatasi dalam API, batasan kecepatan akan diterapkan. + +*** + +## Argumen Mulai + +Argumen Mulai dimasukkan setelah `-jar *.jar` untuk menginisialisasi Plazma dan merupakan nilai yang diproses bersamaan. + +### Cara Penggunaan + +Properti sistem dimasukkan setelah `-jar *.jar` sebagai argumen perintah program. + +Misalnya, jika Anda ingin menerapkan argumen mulai `nogui`,\ +masukkan seperti ini agar Plazma memproses argumen `nogui` saat inisialisasi. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumen Mulai Lengkap + +#### `bukkit-settings` + +- **Alias**: `b` +- **Nilai Default**: `bukkit.yml` + +Menetapkan nama dan lokasi [File Konfigurasi Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Nilai Default**: `commands.yml` + +Menetapkan nama dan lokasi [File Konfigurasi Perintah Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Nilai Default**: `server.properties` + +Menetapkan nama dan lokasi [File Properti Server](../reference/configurations/property.md). + +#### `demo` + +Memulai server ke dalam dunia demo. + +#### `eraseCache` + +Menghapus file cache yang tersisa setelah upgrade dunia. + +#### `forceUpgrade` + +Memaksa [upgrade](#user-content-fn-12)[^12] dunia tanpa memperdulikan versi. + +#### `help` + +- **Alias**: `?` + +Menampilkan argumen mulai lengkap dan penjelasan Plazma. + +#### `initSettings` + +Membuat file konfigurasi saja dan menutup server. + +#### `jfrProfile` + +Mengaktifkan profil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Nilai Default**: `(Properti Server)` + +Menetapkan jumlah maksimum [pemain](#user-content-fn-14)[^14] yang diizinkan. + +#### `nogui` + +Menonaktifkan panel antarmuka grafis. + +#### `nojline` + +Menonaktifkan JLine dan menggunakan konsol vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Nilai Default**: `(Properti Server)` + +Memilih untuk memverifikasi pemain melalui server otentikasi Mojang. + +**Jika tidak menggunakan Velocity atau proxy lain, bisa mengakibatkan pelanggaran [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Nilai Default**: `paper.yml` + +{% hint style="warning" %} + +### Argumen ini telah dihentikan penggunaannya setelah 1.19.4 + +{% endhint %} + +Menetapkan lokasi [File Konfigurasi PaperSpigot](../reference/configurations/paper/README.md) yang telah dihentikan penggunaannya. + +Digunakan untuk memindahkan konfigurasi lama ke file konfigurasi baru dan tidak digunakan lagi setelahnya. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Nilai Default**: `config` + +Menetapkan nama dan lokasi folder tempat [File Konfigurasi Paper](../reference/configurations/paper/README.md) berada. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Menetapkan nama dan lokasi folder tempat [File Konfigurasi Plazma](../reference/configurations/plazma/README.md) berada. + +#### `plugins` + +- **Alias**: `p` +- **Nilai Default**: `plugins` + +Menetapkan lokasi folder plugin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Nilai Default**: `pufferfish.yml` + +Menetapkan nama dan lokasi [File Konfigurasi Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Nilai Default**: `purpur.yml` + +Menetapkan nama dan lokasi [File Konfigurasi Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Memulai server dalam keadaan vanilla lengkap. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Nilai Default**: `(Properti Server)` + +Menetapkan nama host server atau alamat [protokol internet](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Nilai Default**: `(Properti Server)` + +Menetapkan port server. + +#### `server-name` + +- **Nilai Default**: `A Plazma Server` + +Menetapkan nama server. + +#### `spigot-settings` + +- **Alias**: `S` +- **Nilai Default**: `spigot.yml` + +Menetapkan nama dan lokasi [File Konfigurasi Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Menampilkan versi Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Nilai Default**: `(folder server)` + +Menetapkan lokasi penyimpanan file dunia. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Nilai Default**: `(Properti Server)` + +Menetapkan nama file dunia. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Posisi argumen yang diproses tergantung pada lokasi tambahan yang ditambahkan. + +[^3]: Misalnya, jika ingin mengatur (mengaktifkan) `Plazma.iKnowWhatIAmDoing` menjadi `true`, cukup masukkan `-DPlazma.iKnowWhatIAmDoing` tanpa `=true` dan akan tetap berfungsi. + +[^4]: Misalnya, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor acara. + +[^6]: Detektor acara. + +[^7]: Klien. + +[^8]: Sinyal yang menunjukkan bahwa klien terhubung dengan server dengan lancar seperti detak jantung. + +[^9]: Dengan fitur kick AFK Purpur, Anda dapat mengeluarkan pemain yang meninggalkan tempat. + +[^10]: Sistem Penulisan Chunk Sinkron. + +[^11]: `PERINGATAN! Plazma mungkin menyebabkan masalah yang tidak terduga, jadi pastikan untuk mengujinya secara menyeluruh sebelum menggunakannya di server publik.` + +[^12]: Dalam permainan, `optimisasi dunia` juga beroperasi dengan prinsip yang sama. + +[^13]: Protokol Internet, IP. + +[^14]: Administrator `level 2` ke atas dikecualikan. diff --git a/id/origin/plazma/adminstration/reference/commands.md b/id/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..d2c08de61 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Pelajari perintah yang tersedia di Plazma. +--- + +# 🖥️ Perintah diff --git a/id/origin/plazma/adminstration/reference/configurations/bukkit.md b/id/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..4e5c00b23 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang dimaksud dengan setiap node dalam bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/id/origin/plazma/adminstration/reference/configurations/paper/README.md b/id/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..5646f34ce --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tujuan dari setiap file di dalam folder config. +--- + +# 🛩️ Kertas diff --git a/id/origin/plazma/adminstration/reference/configurations/paper/global.md b/id/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..3e1625ae9 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang dimaksud dengan setiap node dalam paper-global.yml. +--- + +# 🛩️ Kertas (Konfigurasi Global) diff --git a/id/origin/plazma/adminstration/reference/configurations/paper/world.md b/id/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..1191e0d51 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang masing-masing node dalam paper-world.yml artikan. +--- + +# 🛩️ Kertas (Komposisi Dunia) diff --git a/id/origin/plazma/adminstration/reference/configurations/plazma/README.md b/id/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..a5a7493d7 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tujuan dari setiap file di dalam folder config. +--- + +# ✨ Plazma diff --git a/id/origin/plazma/adminstration/reference/configurations/plazma/global.md b/id/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..5fe664247 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa arti dari setiap node dalam plazma-global.yml. +--- + +# ✨ Plazma (Konfigurasi Global) diff --git a/id/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/id/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..5d53c92f4 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Susunan Berdasarkan Dunia diff --git a/id/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/id/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..9e02d18da --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Cari tahu apa arti dari setiap node dalam plazma-world.yml. +--- + +# ✨ Plazma (Konfigurasi Berdasarkan Dunia) diff --git a/id/origin/plazma/adminstration/reference/configurations/property.md b/id/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..2974807af --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Cari tahu apa arti dari setiap node dalam server.properties. +--- + +# 🪨 Server.properties diff --git a/id/origin/plazma/adminstration/reference/configurations/pufferfish.md b/id/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..13bbadfa1 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang masing-masing node dalam pufferfish.yml artinya. +--- + +# 🐡 Ikan Buntal diff --git a/id/origin/plazma/adminstration/reference/configurations/purpur/README.md b/id/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd91dc29a --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa yang setiap node dalam purpur.yml berarti. +--- + +# 🦑 Purpur diff --git a/id/origin/plazma/adminstration/reference/configurations/purpur/global.md b/id/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..5312d335d --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa yang setiap node dalam purpur.yml berarti. +--- + +# 🦑 Purpur (komposisi global) diff --git a/id/origin/plazma/adminstration/reference/configurations/purpur/world.md b/id/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..becfea179 --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Temukan apa yang setiap node dalam purpur.yml berarti. +--- + +# 🦑 Purpur (komposisi dunia) diff --git a/id/origin/plazma/adminstration/reference/configurations/spigot.md b/id/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..3e403b85c --- /dev/null +++ b/id/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Pelajari apa yang dimaksud dengan setiap node di spigot.yml. +--- + +# 🚰 Spigot diff --git a/id/origin/plazma/adminstration/reference/permissions.md b/id/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..6a55fa05e --- /dev/null +++ b/id/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Pelajari tentang izin Plazma. +--- + +# 🛡️ Izin diff --git a/id/origin/plazma/developers.md b/id/origin/plazma/developers.md new file mode 100644 index 000000000..c0acb0a96 --- /dev/null +++ b/id/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Gunakan Plazma untuk mengembangkan proyek pihak ketiga. +--- + +# ⚙️ Panduan Pengembang diff --git a/id/origin/thunderbolt/README.md b/id/origin/thunderbolt/README.md new file mode 100644 index 000000000..76cb5c7ba --- /dev/null +++ b/id/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt adalah platform server berbasis Plazma yang memungkinkan pengguna untuk mencoba patch eksperimental sebagai Flavor secara langsung. +--- + +# 🌩️ Panduan Penggunaan Thunderbolt diff --git a/id/origin/volt/README.md b/id/origin/volt/README.md new file mode 100644 index 000000000..093721cdf --- /dev/null +++ b/id/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt adalah template sumber terbuka yang memungkinkan pengembangan platform server Paperweight mereka sendiri berbasis Plazma. +--- + +# ⚡ Panduan Pengembangan Volt diff --git a/it/origin/README.md b/it/origin/README.md new file mode 100644 index 000000000..637b63731 --- /dev/null +++ b/it/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Se hai domande, per favore chiedi su Discord o GitHub Discussions. +--- + +# 🏠 Benvenuti nel portale della documentazione + +{% hint style="info" %} + +**Il documento di Plazma è attualmente in stato di traduzione automatica.** + +[![Stato della traduzione](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Partecipa alla traduzione dei documenti su [https://translate.plazmamc.org/](https://translate.plazmamc.org/) per migliorare i documenti. + +{% endhint %} + +### Se hai riscontrato problemi durante l'uso di Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Se sei interessato a Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Se vuoi creare la tua piattaforma server con Volt, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Se hai bisogno di più informazioni su Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/it/origin/SUMMARY.md b/it/origin/SUMMARY.md new file mode 100644 index 000000000..e60bf85d1 --- /dev/null +++ b/it/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Indice + +- [🏠 Benvenuti nel Portale Docs](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documentazione sull'Utilizzo di Plazma](plazma/README.md) +- [❓ Che cos'è Plazma?](plazma/about/README.md) + - [⬇️ Scarica](plazma/about/downloads.md) + - [✅ Stato del Supporto delle Versioni](plazma/about/supported-versions.md) +- [⚒️ Guida alla gestione del server](plazma/administration/README.md) + - [👟 Introduzione](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Riferimento](plazma/administration/reference/README.md) + - [🖥️ Comandi](plazma/administration/reference/commands.md) + - [🛡️ Autorizzazioni](plazma/administration/reference/permissions.md) + - [🎛️ Argomenti e proprietà](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/amministrazione/riferimento/configurazioni/proprietà.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configurazione globale](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Configurazioni per il mondo](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configurazione globale](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Configurazioni per il mondo](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configurazione globale](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Configurazioni per il mondo](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Approfondimenti](plazma/administration/expert/README.md) + - [🧹 Ottimizzazione](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 Blocco X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilità e soluzioni](plazma/administration/expert/fix-exploits.md) + - [⁉️ Domande frequenti](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Guida per Sviluppatori](plazma/developers.md) + - [✏️ Contribuisci](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Guida all'Utilizzo di Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Guida allo Sviluppo di Volt](volt/README.md) + +## Varie + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Visualizza tutti i download](plazma/about/downloads-all.md) diff --git a/it/origin/miscellaneous/README.md b/it/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/it/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/it/origin/plazma/README.md b/it/origin/plazma/README.md new file mode 100644 index 000000000..3680c6ac5 --- /dev/null +++ b/it/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma è una piattaforma server open source per Minecraft: Java Edition che aggiunge ottimizzazione sperimentale basata su carta e personalizzazione di vari meccanismi di gioco." +--- + +# ✨ Documentazione sull'Utilizzo di Plazma + +## 👋 Benvenuti alla Documentazione di Plazma + +Benvenuti alla guida per l'uso di Plazma! + +{% hint style="info" %} + +**Non è possibile risolvere il problema attraverso il manuale?** + +[Server Discord ufficiale](https://discord.gg/MmfC52K8A8) o [Discussioni su GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) per fare domande alla community! + +{% endhint %} + +### Su Plazma + +> Scopri di più su cosa sia Plazma come piattaforma server. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Per gli Amministratori + +> Crea il tuo server utilizzando Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Per gli Sviluppatori + +> Sviluppa progetti di terze parti utilizzando Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/it/origin/plazma/about/README.md b/it/origin/plazma/about/README.md new file mode 100644 index 000000000..b3efcfba8 --- /dev/null +++ b/it/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Scopri di più su cosa sia Plazma come piattaforma server. +--- + +# ❓ Cosa è Plazma? + +- **Plazma** è una piattaforma server basata su [Paper](https://github.com/PaperMC/Paper) che porta solo i vantaggi di [Andromeda](https://github.com/EarendelArchived/Andromeda) e [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Ci sforziamo di offrire sempre elevata stabilità, potente performance, aggiornamenti rapidi e una vasta gamma di funzionalità. + +## 📋 Obiettivo di Plazma + +- Ci sforziamo di diventare una piattaforma server con aggiornamenti rapidi e alta stabilità. +- Ci sforziamo di offrire una vasta gamma di funzionalità e potenti performance paragonabili alle piattaforme mod. +- Ci sforziamo di creare una piattaforma libera che consenta la personalizzazione dei patch di Vanilla. + +## ⚙️ Caratteristiche principali + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Aggiornamenti più veloci**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) mantiene costantemente aggiornati i patch inclusi in Plazma, offrendo gli aggiornamenti più rapidi tra le piattaforme server basate su Paper. +6. **Ottimizzazione dei file di configurazione predefiniti**\ + I file di configurazione predefiniti sono ottimizzati, evitando la necessità di ottimizzarli manualmente. +7. **Funzionamento multithread sistematico**\ + Asincronizzando i meccanismi di sistema non correlati al gioco, si riduce il [tempo di latenza](#user-content-fn-4)[^4] ottimizzando il server. +8. **Blocco dell'uso di spazio non necessario**\ + Unendo i dati con valori simili in un unico dato, si riduce l'utilizzo della memoria. + +## ✨ Esempi di utilizzo + +- **Piattaforma che gestisce anche plugin complessi in modo corretto**\ + Il server dello sviluppatore [IPECTER](https://github.com/IPECTER) utilizza Plazma.\ + Con plugin proprietari che funzionano con NMS e riflessioni, e una vasta quantità di pacchetti dati complessi applicati,\ + é in grado di gestire più di 100 giocatori senza alcuna riduzione delle prestazioni. +- **Piattaforma che mantiene prestazioni elevate anche sui server RPG**\ + Ha mantenuto stabilmente 100 giocatori su un singolo cluster senza riduzione del TPS,\ + e ha permesso a un totale di 250 giocatori su 4 cluster di giocare senza problemi. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Piattaforma scelta da molti streamer**\ + È stata scelta come un secchiello per la partecipazione degli spettatori di molti streamer. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Scarica + +Puoi scaricare Plazma dalla pagina sottostante. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Vuoi informazioni dettagliate sul supporto alle versioni? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plugin di Bukkit, CraftBukkit, Spigot e plugin di Paper, Pufferfish, Purpur. + +[^2]: Microsoft Corporation. + +[^3]: Disattivando il sistema di segnalazione chat, la chat viene gestita solo sul server impedendo il tracciamento della chat da parte di Mojang. + +[^4]: Tempo in cui il gioco si ferma per far funzionare i meccanismi di sistema. diff --git a/it/origin/plazma/about/downloads-all.md b/it/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..785ee5046 --- /dev/null +++ b/it/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Scarica il file di esecuzione di Plazma per la visualizzazione completa +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versione | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/it/origin/plazma/about/downloads.md b/it/origin/plazma/about/downloads.md new file mode 100644 index 000000000..757c060e5 --- /dev/null +++ b/it/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Scarica Plazma ora e provalo personalmente. +--- + +# ⬇️ Scarica + +#### Vuoi informazioni dettagliate sul supporto alle versioni? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Il download qui sotto è un file eseguibile per utenti generali.** + +Se sei uno sviluppatore e hai bisogno di un'altra forma di file, consulta la pagina qui sotto. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersioneScarica
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Scarica +
1.20.1 + Scarica +
1.19.4 + Scarica +
+ +*** diff --git a/it/origin/plazma/about/patches-list.md b/it/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..3d2d308b1 --- /dev/null +++ b/it/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Scopri tutte le funzionalità aggiunte a Plazma. +--- + +# 📑 Patch inclusi diff --git a/it/origin/plazma/about/supported-versions.md b/it/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..bfd6069ed --- /dev/null +++ b/it/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Scopri le versioni supportate da Plazma per Minecraft: Java Edition." +--- + +# ✅ Stato di supporto della versione + +{% hint style="info" %} + +**Plazma è stato sviluppato a partire dalla versione 1.19.4 e le versioni precedenti alla 1.19.4 non sono più supportate.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/In%20attesa%20di%20rilascio +[idv]: https://badge.plazmamc.org/1/In%20sviluppo +[atv]: https://badge.plazmamc.org/2/Supportato +[fse]: https://badge.plazmamc.org/6/Supporto%20funzionalità%20interrotto +[eol]: https://badge.plazmamc.org/4/Supporto%20terminato +[ukn]: https://badge.plazmamc.org/0/Nessuna%20informazione +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Standard +[100]: https://badge.plazmamc.org/percent/100 + +![In attesa di rilascio][wtr] ![In sviluppo][idv] ![Supportato][atv] ![Supporto funzionalità interrotto][fse] ![Supporto terminato][eol] + +| Versione | Stabilità e supporto funzionale | Stato della build | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Stato build](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Stato build](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Stato build](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/it/origin/plazma/administration/README.md b/it/origin/plazma/administration/README.md new file mode 100644 index 000000000..703fcab84 --- /dev/null +++ b/it/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Crea il tuo server utilizzando Plazma. +--- + +# ⚒️ Guida alla gestione del server diff --git a/it/origin/plazma/administration/diagnosis/README.md b/it/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..989752694 --- /dev/null +++ b/it/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri come affrontare il problema quando si verifica. +--- + +# 🧾 진단 diff --git a/it/origin/plazma/administration/diagnosis/plugins.md b/it/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..5d720b6a4 --- /dev/null +++ b/it/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Scopri come risolvere quando il plugin non funziona correttamente. +--- + +# 📜 플러그인 diff --git a/it/origin/plazma/administration/expert/README.md b/it/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..6cfa5426e --- /dev/null +++ b/it/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri come gestire professionalmente il Plazma. +--- + +# 🎓 Approfondimento diff --git a/it/origin/plazma/administration/expert/fix-exploits.md b/it/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..d87e720e8 --- /dev/null +++ b/it/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Scopri le vulnerabilità note e come risolverle. +--- + +# ⚠️ Vulnerabilità note e soluzioni diff --git a/it/origin/plazma/administration/expert/optimize.md b/it/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..52f666108 --- /dev/null +++ b/it/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Scopri come ottimizzare Plazma. +--- + +# 🧹 Ottimizzazione diff --git a/it/origin/plazma/administration/expert/proxy.md b/it/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..2cb1dcd50 --- /dev/null +++ b/it/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Scopri come configurare in modo sicuro la piattaforma proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/it/origin/plazma/administration/expert/vanillaize.md b/it/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..99f8256c0 --- /dev/null +++ b/it/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Scopri come ripristinare il patch di Paper e Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper non aggiunge opzioni alla maggior parte delle correzioni degli errori di Vanilla.** + +Attualmente, Plazma sta sviluppando una configurazione per disattivare tali correzioni degli errori. + +Pertanto, questa guida è ancora in fase di sviluppo e le informazioni possono cambiare in qualsiasi momento. + +{% endhint %} diff --git a/it/origin/plazma/administration/expert/xray.md b/it/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..15dc13f2f --- /dev/null +++ b/it/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Scopri i vari metodi integrati per bloccare gli X-Ray. +--- + +# 🩻 Blocco X-Ray diff --git a/it/origin/plazma/administration/faq.md b/it/origin/plazma/administration/faq.md new file mode 100644 index 000000000..37d324c1d --- /dev/null +++ b/it/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Scopri le domande frequenti. +--- + +# ⁉️ Domande frequenti + +{% hint style="info" %} + +**Non riesci a trovare la risposta che stai cercando?** + +[Server Discord ufficiale](https://discord.gg/MmfC52K8A8) o [Discussioni su GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) per fare domande alla community! + +{% endhint %} + +### Plazma non si avvia + +Se compare `no main manifest attribute, in plazma-(version).jar` sulla console,\ +il file scaricato è un file API di sviluppo, è necessario scaricare **Reobf Paperweight** dalla pagina GitHub. + +Per ulteriori informazioni, consulta la seguente pagina. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Viene visualizzato un avviso ogni volta che il server viene avviato + +Plazma contiene alcune patch instabili e potrebbe non funzionare correttamente, quindi mostra il seguente avviso ogni volta che il server viene avviato. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Questo avviso può essere disattivato utilizzando la proprietà di sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Per ulteriori informazioni, consulta la seguente pagina. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponibile a partire dalla versione 1.20.1 diff --git a/it/origin/plazma/administration/getting-started/README.md b/it/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..be42eba74 --- /dev/null +++ b/it/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Scopri come creare un server con Plazma. +--- + +# 👟 Inizia + +Per utilizzare Plazma in modo stabile, il sistema deve soddisfare i seguenti requisiti. + +| | Minimo | Consigliato | +| :---------------------: | ------ | ----------- | +| Architettura | x64 | - | +| RAM | 8GB | 16GB | +| Spazio di archiviazione | 1GB | 8GB | +| JDK | 17 | 21 | + +Per facilitare la modifica dei file di configurazione, è consigliabile installare un editor come [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Output corretto" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' non è riconosciuto come comando interno o esterno, +un programma eseguibile o un file batch. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Opzione non riconosciuta: --version +Errore: Impossibile creare la Java Virtual Machine. +Errore: Si è verificata un'eccezione fatale. Il programma verrà chiuso. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Scarica il **JDK 21** in formato `.msi` da [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Esegui il file di installazione scaricato e clicca su `Avanti`. +3. Attiva `Imposta la variabile JAVA_HOME` dal menu visualizzato al centro sinistra della finestra e clicca su `Avanti`. +4. Clicca su `Installa` per completare l'installazione di JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Successivamente, installa JRE eseguendo il comando seguente nel terminale. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download di Plazma + +Plazma offre vari file eseguibili tra cui scegliere. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Scopri di più + +Il nome del file eseguibile è `plazma-(versione manager)-1.20.4-R0.1-SNAPSHOT-(forma di mappatura).jar`. + +- **Forma di mappatura**\ + La mappatura è una sorta di mappa che collega il codice reale di Minecraft al codice offuscato. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, è la mappatura di base di Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version Manager**\ + Il version manager è un launcher del server che gestisce le librerie necessarie per l'avvio del server e patcha i file del server. + - **Paperclip**\ + Sviluppato dal team di PaperMC per Paper e altre piattaforme derivate, scarica le librerie e applica le patch al server. + - **Bundler**\ + Version manager di Minecraft vanilla. + +
+ +*** + +## 3. Creazione dello script di avvio + +Per avviare rapidamente Plazma e riavviare automaticamente il server, è necessario creare uno [script di avvio](#user-content-fn-6). + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Puoi scaricare lo script di avvio facendo clic sul pulsante di download in basso a sinistra.\ +**Assicurati che lo script di avvio scaricato sia compatibile con il tuo sistema operativo.** + +*** + +## 4. Organizzazione dei file + +Sposta lo script di avvio scaricato e Plazma in una nuova cartella. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Esegui lo script di avvio. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Accordo EULA + +Dopo aver eseguito lo script di avvio una volta, verrà creato un file `eula.txt` nella cartella. + +L'EULA[^9] è un accordo di licenza che devi accettare per utilizzare i servizi di [Mojang Studios](#user-content-fn-10). + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Per accettare l'EULA, modifica `eula=false` in `eula=true` nel file `eula.txt` e salva le modifiche. + +*** + +## 6. Consentire l'accesso esterno (Windows) + +I moderni sistemi operativi bloccano gli accessi esterni per motivi di sicurezza tramite il **firewall** e il **router** di default. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Se il tuo router non supporta UPnP, dovrai cercare informazioni specifiche poiché i pannelli dei router possono variare. + +Puoi anche utilizzare [Ngrok](https://ngrok.com/) per generare un indirizzo temporaneo. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Verifica della necessità di port forwarding + +Digita il seguente comando nel prompt e premi Invio. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IndirizzoIP -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Se l'output è `True`, non è necessario fare altro. Se è `False`, devi configurare il port forwarding. + +### 6.2 Connessione al server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +L'indirizzo utilizzato per la connessione al server può essere verificato [qui](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Successivamente, al riavvio del server, Plazma proverà automaticamente a fare il forwarding della porta. + +Di seguito vi è la conferma del successo del forwarding della porta in base al messaggio visualizzato sulla console, che apparirà come `[UPnP] (messaggio)`. + +| Messaggio | Significato | +| ------------------------------------- | ----------------------------------------------------------------------- | +| `Porta aperta con successo (porta)` | Forwarding della porta riuscito. | +| `Porta (porta) già aperta` | Un altro servizio sta utilizzando la porta specificata. | +| `Impossibile aprire la porta (porta)` | Forwarding della porta fallito. | +| `Servizio non disponibile` | Il router non supporta UPnP. | + +Quando il server viene spento, Plazma chiude automaticamente le porte. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Scarica il file ZIP `Windows (64-bit)` da [Ngrok website](https://ngrok.com/download). +2. Posiziona il file Ngrok scaricato nella cartella del server. +3. Genera un token di autenticazione dal [dashboard di Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Esegui il comando visualizzato nella riga di comando nella cartella del server. +5. Aggiungi `start /b ngrok tcp --region jp 25565` all'inizio dello script di avvio e `taskkill /f /t /im ngrok.exe` alla fine. +6. Dalla console, l'indirizzo `0.tcp.jp.ngrok.io:12345` sarà l'indirizzo del server. +7. Ora è possibile connettersi esternamente utilizzando questo indirizzo. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Ad esempio, se dopo l'esecuzione del comando viene visualizzato: + +```log +Windows Configurazione IP + +Adattatore Ethernet Ethernet: + + Suffisso DNS specifico per la connessione. . . . : + Indirizzo IPv4. . . . . . . . . : 192.168.3.7 + Subnet mask . . . . . . . : 255.255.255.0 + Gateway predefinito . . . . . . : 192.168.3.1 + +``` + +Provare a connettersi al server localmente utilizzando l'`192.168.3.7` indicato come indirizzo IPv4. + +Se il server e il gioco sono eseguiti sullo stesso PC, è possibile connettersi utilizzando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Crescere + +Se il server è stato avviato con successo e funziona correttamente, è ora il momento di personalizzarlo. + +Scopri come personalizzare il server seguendo le istruzioni di seguito. + +{% content-ref url="prossimo-passo.md" %} +[prossimo-passo.md](prossimo-passo.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, su cui si basa Plazma, è basato su Spigot e Spigot si basa sulla piattaforma ufficiale del server. + +[^3]: Tasto Windows + R + +[^4]: Per Linux, eseguire `java --version` nel terminale. + +[^5]: JRE è uno dei progetti open source e ci sono diverse varianti come piattaforma del server Minecraft. + +[^6]: Comunemente noto come **launcher**. + +[^7]: Attivando l'opzione "Auto-riavvio", il server si riavvierà automaticamente. È possibile terminare premendo `Control + C`. + +[^8]: Non è consigliabile superare la metà della capacità del sistema. + + Ad esempio, se la memoria totale del sistema è di 8GB, non è consigliabile impostarla su più di 4GB. + +[^9]: Contratto di licenza per l'utente finale, End-User License Agreement. Per ulteriori informazioni, consulta il [sito web di Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: In Corea, in base all'articolo 32, paragrafo 1, punto 9 della legge sull'avanzamento dell'industria dei videogiochi, è possibile presentare un'azione legale presso **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur incluso in Plazma comunica automaticamente con il router tramite questa tecnologia per aprire solo le porte quando il server è in esecuzione, eliminando la necessità di fare il forwarding della porta manualmente. + +[^13]: Se non si ha un account, è possibile registrarsi su Ngrok tramite un account Google o GitHub. diff --git a/it/origin/plazma/administration/getting-started/customization.md b/it/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..b7e61c8aa --- /dev/null +++ b/it/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Scopri come personalizzare il server. +--- + +# 🎨 Personalizzazione utente + +Il motivo per cui si utilizza una piattaforma server modificata come Plazma anziché la piattaforma server ufficiale fornita da Mojang Studios è probabilmente la possibilità di una **personalizzazione** potente. + +Di seguito sono riportati vari modi per personalizzare e utilizzare Plazma. + +## Modifica della configurazione + +Il modo più basilare per personalizzare Plazma è modificare la configurazione stessa. + +Plazma offre potenti impostazioni di configurazione, che vanno dai meccanismi di gioco alle proprietà dei mob. + +Per ulteriori informazioni sulla configurazione di Plazma, consultare la pagina seguente. + +{% content-ref url="../reference/configurations/" %} +[configurazioni](../reference/configurations/) +{% endcontent-ref %} + +## Utilizzo di plugin + +{% hint style="success" %} + +**Plazma supporta pienamente tutti i plugin basati su Paper.** + +Per i plugin Spigot, a partire dalla versione 1.20.5, potrebbero non funzionare a causa delle modifiche di mapping di Paper, ma la maggior parte dei plugin basati su Paper come Paper, Pufferfish e Purpur funzionano correttamente su Plazma. Se un plugin non funziona correttamente, si prega di [segnalarlo immediatamente](../diagnosis/plugins.md) poiché potrebbe essere un errore di Plazma. + +{% endhint %} + +Questo è il motivo principale per cui si utilizza Plazma ed è il modo più potente per personalizzare Plazma. +L'ecosistema dei plugin di Plazma consente di personalizzare facilmente il server. + +Ci sono vari modi per trovare e scaricare i plugin. Alcuni plugin vengono caricati su servizi di repository pubblici, mentre altri vengono caricati su GitHub o sui propri siti Web. + +{% hint style="caution" %} + +**I plugin possono accedere direttamente al sistema!** + +Prima di applicare un plugin, assicurarsi sempre che sia sicuro utilizzando servizi come VirusTotal o scaricandolo da servizi affidabili. + +{% endhint %} + +Ci sono vari servizi per scaricare i plugin. Tra questi, servizi come [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) valutano i plugin prima del caricamento per garantire che solo plugin sicuri siano distribuiti. + +### Applicazione dei plugin + +Una volta scaricati i plugin, è ora di applicarli. + +1. I plugin sono file `.jar` o file eseguibili Java. Alcuni plugin sono forniti in formato compresso; in tal caso, estrarre il file e utilizzare il file con estensione `fat` se presente. +2. Copiare il file scaricato nella cartella `plugins` del server e riavviare il server. +3. Quando Plazma si avvia, verrà visualizzato un nuovo output sulla console. + Questo significa che Plazma ha caricato correttamente il plugin. +4. Anche se Plazma ha caricato correttamente il plugin, potrebbe non essere attivato. + Utilizzando il comando `/plugins`, è possibile visualizzare i plugin attualmente caricati sul server. + Se il nome del plugin installato non è in rosso ma in verde, significa che il plugin è stato caricato correttamente. + +Se il plugin non viene caricato correttamente, è possibile trovare soluzioni alla pagina sottostante. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Utilizzo dei datapack + +I datapack sono un modo per personalizzare Minecraft simile ai resource pack. + +Con i datapack è possibile aggiungere nuove entità e sfide al gioco, tra le altre modifiche interne al gioco. + +{% hint style="caution" %} + +**I datapack possono danneggiare il mondo!** + +Alcuni datapack danneggiati possono causare danni permanenti al mondo, irreversibili. + +Si consiglia di eseguire il backup del mondo prima di applicare i datapack. + +{% endhint %} + +I datapack possono essere scaricati da vari servizi come [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) e altri. + +Una volta scaricati i datapack, è possibile applicarli copiandoli nella cartella `datapacks` della directory del mondo del server. +Se la cartella non esiste, è possibile crearla manualmente. + +{% hint style="warning" %} + +**Alcuni [datapack](#user-content-fn-2) potrebbero non essere applicati correttamente la prima volta.** + +In caso di problemi, si consiglia di riavviare il server **2 volte**. + +{% endhint %} + +I datapack possono essere facilmente danneggiati con gli aggiornamenti di Minecraft. + +In caso di danni gravi ai datapack, che possono causare il crash del server, è importante testare attentamente prima di aggiornare il server. + +{% hint style="info" %} + +**Dopo il comando di avvio del server, è possibile disattivare tutti i datapack inserendo `safeMode` e quindi avviare il server.** + +Per ulteriori informazioni, consultare `Reference > Arguments`.](../reference/arguments.md) + +{% endhint %} + +I datapack applicati possono essere verificati utilizzando il comando `/datapack list`. + +*** + +[^1]: Oppure utilizzando gli add-on di Minecraft: Bedrock Edition. + +[^2]: Aggiunta di nuove entità e altro ancora. diff --git a/it/origin/plazma/administration/getting-started/next-step.md b/it/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..fac31f37d --- /dev/null +++ b/it/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Scopri come personalizzare il server. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Di seguito sono riportati vari modi per personalizzare e utilizzare Plazma. + +## Modifica della configurazione + +Il modo più basilare per personalizzare Plazma è modificare la configurazione stessa. + +Plazma offre potenti impostazioni di configurazione, che vanno dai meccanismi di gioco alle proprietà dei mob. + +Per ulteriori informazioni sulla configurazione di Plazma, consultare la pagina seguente. + +{% content-ref url="../reference/configurations/" %} +[configurazioni](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Utilizzo di plugin + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Questo è il motivo principale per cui si utilizza Plazma ed è il modo più potente per personalizzare Plazma. L'ecosistema dei plugin di Plazma consente di personalizzare facilmente il server. + +Ci sono vari modi per trovare e scaricare i plugin. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Ci sono vari servizi per scaricare i plugin. Tra questi, servizi come [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) valutano i plugin prima del caricamento per garantire che solo plugin sicuri siano distribuiti. + +### Applicazione dei plugin + +Una volta scaricati i plugin, è ora di applicarli. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Copiare il file scaricato nella cartella `plugins` del server e riavviare il server. +3. Quando Plazma si avvia, verrà visualizzato un nuovo output sulla console. Questo significa che Plazma ha caricato correttamente il plugin. +4. Anche se Plazma ha caricato correttamente il plugin, potrebbe non essere attivato. Utilizzando il comando `/plugins`, è possibile visualizzare i plugin attualmente caricati sul server. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Se il plugin non viene caricato correttamente, è possibile trovare soluzioni alla pagina sottostante. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Utilizzo dei datapack + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Con i datapack è possibile aggiungere nuove entità e sfide al gioco, tra le altre modifiche interne al gioco. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Alcuni datapack danneggiati possono causare danni permanenti al mondo, irreversibili. + +Si consiglia di eseguire il backup del mondo prima di applicare i datapack. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Una volta scaricati i datapack, è possibile applicarli copiandoli nella cartella `datapacks` della directory del mondo del server. Se la cartella non esiste, è possibile crearla manualmente. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +In caso di problemi, si consiglia di riavviare il server **2 volte**. +{% endhint %} + +I datapack possono essere facilmente danneggiati con gli aggiornamenti di Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +I datapack applicati possono essere verificati utilizzando il comando `/datapack list`. + +*** + +## Ottimizzazione + +Plazma ha molte patch di ottimizzazione applicate. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Per informazioni sulla configurazione sicura e corretta del proxy, consultare la pagina sottostante. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Sicurezza + +Con lo sviluppo dei modi, è possibile trovare facilmente un [motore di attacco alle vulnerabilità](#user-content-fn-3)[^3] anche online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Impostazioni dei permessi + +Alcuni comandi amministrativi dei plugin potrebbero presentare vulnerabilità se i permessi non sono configurati correttamente. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blocco X-Ray + +X-Ray è una delle vulnerabilità facilmente utilizzabili anche su client di ottimizzazione di base. + +Plazma fornisce una configurazione che può bloccare X-Ray di default. + +Per informazioni su come bloccare X-Ray, consultare la pagina sottostante. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Per visualizzare i giocatori autorizzati, utilizzare `/whitelist query`. + +*** + +[^1]: Oppure utilizzando gli add-on di Minecraft: Bedrock Edition. + +[^2]: Aggiunta di nuove entità e altro ancora. + +[^3]: Comunemente noto come "hack". + +[^4]: Se la configurazione non è ottimizzata, se Plazma è obsoleto o se sono state scoperte nuove vulnerabilità, potrebbe non essere bloccato. + +[^5]: I giocatori si connettono al server tramite il server proxy Ngrok e l'indirizzo Ngrok emesso ad ogni riavvio è diverso. diff --git a/it/origin/plazma/administration/reference/README.md b/it/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..f8a7940eb --- /dev/null +++ b/it/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Scopri i metodi di personalizzazione di base offerti da Plazma. +--- + +# 📜 리퍼런스 + +Plazma offre vari metodi di personalizzazione. + +Tra questi, ci sono 4 metodi di personalizzazione che possono essere utilizzati immediatamente senza ulteriori operazioni. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Server Discord ufficiale](https://discord.gg/MmfC52K8A8) o [Discussioni su GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) per fare domande alla community! +{% endhint %} + +*** + +## 🖥️ Comandi + +> I comandi consentono di raccogliere informazioni all'interno del gioco o personalizzare l'ambiente di gioco. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Autorizzazioni + +> Le autorizzazioni definiscono l'ambito in cui i giocatori possono interagire. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argomenti e attributi + +> Gli argomenti e gli attributi influenzano globalmente il funzionamento di Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurazioni + +> Le configurazioni sono il modo più basilare per personalizzare Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/it/origin/plazma/administration/reference/arguments.md b/it/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..3b1411873 --- /dev/null +++ b/it/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Scopri gli argomenti di avvio e le proprietà di sistema. +--- + +# 🎛️ Argomenti di avvio e proprietà + +Gli argomenti di avvio e le proprietà di sistema sono valori aggiunti al comando utilizzato per l'esecuzione di Plazma, che influenzano globalmente il funzionamento di Plazma. + +In base alla posizione a cui si aggiungono i comandi (fn-2), verranno divisi in **argomento iniziale** e **attributi di sistema**. + +*** + +## Proprietà di sistema + +Le proprietà di sistema, inserite prima di `-jar`, sono valori elaborati dalla JVM prima dell'inizializzazione di Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Modalità d'uso + +Le proprietà di sistema vengono inserite come argomenti di comando Java tra `java` e `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +Il prefisso `-D` indica che l'argomento non è integrato nella JVM ma è un argomento specifico aggiunto a Plazma, + +Se non si inserisce alcun valore negli attributi, il valore sarà fissato a [`true`](fn-3). + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Proprietà di sistema complete + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Aggiorna i formati di cartelli dismessi. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug relativi alle informazioni sulle entità. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disabilita la revisione NMS per consentire un corretto caricamento delle informazioni di debug dall'IDE e riconfigura automaticamente le informazioni sulla versione interna. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il sistema di avviso del Watchdog di Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il messaggio di conferma del comando `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Se sei uno sviluppatore di plugin e devi aggiornare un plugin, usa il ricaricamento a caldo anziché il comando `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva i plugin che utilizzano il sistema di input/output standard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Avverte quando viene rilevato un formato obsoleto nella componente di chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva la verifica della corrispondenza del modello del server quando un giocatore si connette al server. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug per le chiavi mancanti negli oggetti NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug per i profili di teste non validi. + +Questo logga tutte le teste non valide nella mappa del mondo insieme alla loro posizione. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il sistema di prioritizzazione delle classi dei plugin. + +Utile in caso di problemi con i plugin shadow. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il sistema di consolidamento dei flush di Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valore predefinito**: `750` + +Se le entità superano il valore impostato, vengono inviate in più pacchetti. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valore predefinito**: `8192` + +Imposta la dimensione massima del pacchetto che il server può ricevere in un'unica volta. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il controllo della versione di Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Ciò potrebbe danneggiare permanentemente file come il mondo e compromettere l'intero meccanismo di gioco. + +Tutti i problemi derivanti dall'uso di questa opzione sono responsabilità dell'utente e Plamza non fornirà alcun supporto in tal senso. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valore predefinito**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valore predefinito**: `80` + +Imposta la lunghezza massima di caratteri per linea sui cartelli. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valore predefinito**: `(versione del mondo) + 1` + +Imposta la versione delle informazioni di aggiornamento del mondo da inizializzare per prima. + +È utile per aggiornare un gran numero di chunk, ma non viene utilizzato in altri casi. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `True` + +Attiva il parsing dei commenti YAML di default. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valore predefinito**: `30` + +Espelle il giocatore se non riceve alcun dato per il tempo specificato (in secondi). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Ignora i commenti delle proprietà del server. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug per la sincronizzazione del chunk. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Abilita il sistema di scrittura di chunk sincronizzata predefinito di Minecraft. + +Questo salva ogni chunk in ordine sequenziale, causando un notevole degrado delle prestazioni. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Abilita il flushing esplicito dei canali di rete. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Registra sempre gli errori che non si verificano nel thread principale. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Visualizza un avviso se un'operazione programmata ha un ritardo eccessivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Se si utilizza il file eseguibile predefinito, applica solo il patch senza avviare il server. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` +- **Collisione**: `Plazma.disableConfigOptimization` + +Ottimizza in modo più aggressivo la configurazione iniziale. + +Attivando questa opzione, il server diventerà più veloce e sicuro, ma potrebbe influenzare notevolmente il gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` +- **Collisione**: `Plazma.aggressiveOptimize` + +Non ottimizza la configurazione iniziale in modo aggressivo. + +Questo imposta l'uso della configurazione di base di Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` + +Disabilita il marchio Plazma e utilizza l'icona del server di base della vaniglia. + +#### `Plazma.useVanillaConfiguration` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` +- **Collisione**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Questo potrebbe influenzare notevolmente la sicurezza e le prestazioni del server. + +Tutti i problemi derivanti dall'uso di questo attributo sono di responsabilità dell'amministratore del server. +{% endhint %} + +Imposta la configurazione iniziale ai valori predefiniti forniti da Mojang. + +Disabilita tutte le patch alle vulnerabilità applicate da Paper. + +Le patch alle vulnerabilità possono essere riattivate nella configurazione di Paper o Plazma. + +#### `Plazma.vanillaize` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `true` +- **Collisione**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Configura la configurazione iniziale per essere più vicina alla vaniglia. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Attributo obsoleto + +Di seguito sono elencati gli attributi di sistema obsoleti. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` +- **Obsoleto**: Dall'eliminazione di Timings da Plazma in poi + +Determina se può essere superato il massimo valore che può essere inviato all'API di Timings di Aikar. + +Anche in questo caso, se non gestito dalle eccezioni nell'API, verrà applicato un limite di velocità. + +*** + +## Argomento di avvio + +L'argomento di avvio viene inserito dopo `-jar *.jar` per inizializzare Plazma e viene elaborato insieme. + +### Modalità d'uso + +Gli attributi di sistema vengono inseriti come argomenti di comando di programma dopo `-jar *.jar`. + +Ad esempio, se si desidera applicare l'argomento di avvio `nogui`,\ +inserire come segue per far sì che Plazma elabori l'argomento `nogui` durante l'inizializzazione. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argomento di avvio completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Predefinito**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Predefinito**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Predefinito**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Avvia il server nel mondo demo. + +#### `eraseCache` + +Elimina i file di cache rimasti dopo l'aggiornamento del mondo. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Stampa tutti gli argomenti di avvio di Plazma e le relative descrizioni. + +#### `initSettings` + +Genera solo il file di configurazione e chiude il server. + +#### `jfrProfile` + +Attiva il profilo JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Predefinito**: `(server properties)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Disattiva il pannello dell'interfaccia grafica. + +#### `nojline` + +Disattiva JLine e utilizza la console vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Predefinito**: `(server properties)` + +Seleziona se verificare i giocatori con il server di autenticazione Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Valore predefinito**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Imposta la posizione del file di configurazione PaperSpigot dismesso. + +Viene utilizzato per trasferire la configurazione esistente in un nuovo file di configurazione e non sarà più utilizzato in futuro. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Valore predefinito**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Valore predefinito**: `plugins` + +Imposta la posizione della cartella dei plugin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Valore predefinito**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Valore predefinito**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Avvia il server in uno stato completamente vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Predefinito**: `(server properties)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Predefinito**: `(server properties)` + +Imposta la porta del server. + +#### `server-name` + +- **Valore predefinito**: `A Plazma Server` + +Imposta il nome del server. + +#### `spigot-settings` + +- **Alias**: `S` +- **Valore predefinito**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Mostra la versione di Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Valore predefinito**: `(cartella del server)` + +Imposta la posizione in cui vengono salvati i file del mondo. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Predefinito**: `(server properties)` + +Imposta il nome del file del mondo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: La posizione aggiuntiva influisce sulla gestione degli argomenti. + +[^3]: Ad esempio, se si desidera impostare (attivare) `Plazma.iKnowWhatIAmDoing` su `true`, invece di inserire `-DPlazma.iKnowWhatIAmDoing=true`, è sufficiente inserire `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: Ad esempio, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Rilevatore di eventi. + +[^6]: Rilevatore di eventi. + +[^7]: Client. + +[^8]: Segnale che indica una connessione corretta con il server, simile ai battiti cardiaci. + +[^9]: Con la funzione di espulsione AFK di Purpur è possibile espellere anche i giocatori inattivi. + +[^10]: Sistema di scrittura di chunk sincronizzato, Sync Chunk Write System. + +[^11]: `ATTENZIONE! Plazma potrebbe causare problemi inaspettati, assicurati di testarlo accuratamente prima di utilizzarlo su un server pubblico.` + +[^12]: Anche l'`ottimizzazione del mondo` in gioco funziona allo stesso modo. + +[^13]: Gli amministratori di `livello 2` o superiore sono esclusi. + +[^14]: Protocollo Internet, IP. diff --git a/it/origin/plazma/administration/reference/commands.md b/it/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..e405546bc --- /dev/null +++ b/it/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Scopri i comandi disponibili su Plazma. +--- + +# 🖥️ Comandi diff --git a/it/origin/plazma/administration/reference/configurations/README.md b/it/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..e4cd0f718 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Le configurazioni sono il modo più basilare per personalizzare Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Proprietà + +> Le proprietà sono i file di configurazione più basilari forniti da Minecraft. Utilizzando le proprietà è possibile modificare i meccanismi di base del gioco. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configurazione di Bukkit + +> La configurazione di Bukkit è il file di configurazione più basilare fornito da Plazma. Utilizzando la configurazione di Bukkit è possibile modificare i meccanismi di base del server Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configurazione di Spigot + +> La configurazione di Spigot consente di modificare i dettagli dei meccanismi di gioco, il trattamento dei giocatori, il funzionamento dei comandi e dei messaggi. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configurazione di Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configurazione di Pufferfish + +> La configurazione di Pufferfish consente di modificare il trattamento dei mondi e delle entità di Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configurazione di Purpur + +> Le proprietà di Purpur consentono di modificare i dati di base del gioco. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configurazione di Plazma + +> La configurazione di Plazma consente di personalizzare le funzionalità di Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/it/origin/plazma/administration/reference/configurations/bukkit.md b/it/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..a46fa9fc2 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo in bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/it/origin/plazma/administration/reference/configurations/paper/README.md b/it/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..56ab6e95a --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri lo scopo di ciascun file nella cartella config. +--- + +# 🛩️ Carta diff --git a/it/origin/plazma/administration/reference/configurations/paper/global.md b/it/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..3cd9875f9 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/it/origin/plazma/administration/reference/configurations/paper/world.md b/it/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..ca346b1ef --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Scopri cosa significa ciascun nodo in paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Mondiale diff --git a/it/origin/plazma/administration/reference/configurations/plazma/README.md b/it/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..26d6dc6e4 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri lo scopo di ciascun file nella cartella config. +--- + +# ✨ Plazma diff --git a/it/origin/plazma/administration/reference/configurations/plazma/global.md b/it/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..e4d51ac91 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo in plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/it/origin/plazma/administration/reference/configurations/plazma/world.md b/it/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..9ebdf03c4 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/it/origin/plazma/administration/reference/configurations/plazma/worlds.md b/it/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d47f2a547 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di plazma-world.yml. +--- + +# ✨ Plazma (composizione mondiale) diff --git a/it/origin/plazma/administration/reference/configurations/property.md b/it/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..35edebd36 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di server.properties. +--- + +# 🪨 Server.properties diff --git a/it/origin/plazma/administration/reference/configurations/pufferfish.md b/it/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..b7416c718 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ogni nodo in pufferfish.yml. +--- + +# 🐡 Pesce palla diff --git a/it/origin/plazma/administration/reference/configurations/purpur/README.md b/it/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..79548dd9a --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa rappresenta ciascun nodo di purpur.yml. +--- + +# 🦑 Purpur diff --git a/it/origin/plazma/administration/reference/configurations/purpur/global.md b/it/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..7c05d527e --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa rappresenta ciascun nodo di purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/it/origin/plazma/administration/reference/configurations/purpur/world.md b/it/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..cdc3373f2 --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa rappresenta ciascun nodo di purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/it/origin/plazma/administration/reference/configurations/spigot.md b/it/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..6b9bffdbe --- /dev/null +++ b/it/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di spigot.yml. +--- + +# 🚰 Spigot diff --git a/it/origin/plazma/administration/reference/permissions.md b/it/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..dc36c9746 --- /dev/null +++ b/it/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Scopri i permessi di Plazma. +--- + +# 🛡️ Permessi + +I permessi sono uno strumento di sicurezza semplice che definisce l'ambito in cui i giocatori del server possono interagire tra loro. + +Per utilizzare e modificare correttamente i permessi, è necessario utilizzare plugin come [LuckPerms](https://luckperms.net). + +*** + +## Comprendere il sistema di permessi predefinito + +Minecraft fornisce gruppi di permessi di amministrazione di base. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Giocatore**\ + Solitamente è il gruppo di permessi assegnato a tutti i giocatori. +2. **Mediatore**\ + Può ignorare le protezioni dello spawn. +3. **Amministratore del mondo**\ + Può utilizzare tutti i comandi e i blocchi di comando relativi alla gestione del mondo.\ + È il gruppo di permessi predefinito per i datapack e i blocchi di comando. +4. **Amministratore**\ + Può utilizzare tutti i comandi relativi alla gestione dei giocatori. +5. **Super amministratore**\ + Può utilizzare tutti i comandi, inclusi quelli per la gestione del server.\ + È il gruppo di permessi predefinito per la console e gli amministratori. + +*** + +## Impostazione dei permessi + +*** + +## Permessi completi + +*** + +#### `allow.ride.(Chiave con spazio dei nomi)` + +- **Predefinito**: `Nessuno` + +Permette ai giocatori di interagire con un'entità mentre si accovacciano per salire sull'entità. + +Salendo sull'entità, i giocatori possono controllarne il movimento con i tasti di movimento e saltare o volare con il tasto di salto. + +La `(Chiave con spazio dei nomi)` corrisponde all'ID con spazio dei nomi dell'entità. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Chiave con spazio dei nomi)` + +- **Predefinito**: `Nessuno` + +Permette ai giocatori di utilizzare le abilità speciali dell'entità su cui si trovano. + +Non tutte le entità dispongono di abilità speciali utilizzabili. Consultare di seguito l'elenco completo delle abilità speciali disponibili. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Pubblica le tue idee su [Plazma Discord](https://plazmamc.org/discord) o [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Visualizza le abilità speciali attualmente disponibili + +- **`crepper`**\ + Premendo il tasto di salto, esploderà.\ + Se un giocatore ha il permesso `allow.powered.creeper`, può caricare l'esplosione premendo a lungo il tasto di salto. +- **`dolphin`**\ + Premendo il tasto di salto, si caricherà in avanti. +- **`phantom`**\ + Premendo il tasto di salto, spareraà fiamme. +- **`wither`**\ + Interagendo, spareraà teste di Wither. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/credits (Giocatore)`](commands.md#credits). + +Aggiungendo `.other` alla fine del nome del permesso, consente ad altri giocatori di utilizzarlo. + +#### `bukkit.command.demo` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/demo (Giocatore)`](commands.md#demo). + +Aggiungendo `.other` alla fine del nome del permesso, consente ad altri giocatori di utilizzarlo. + +#### `bukkit.command.ping` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/ping (Giocatore)`](commands.md#ping). + +Aggiungendo `.other` alla fine del nome del permesso, consente ad altri giocatori di utilizzarlo. + +#### `bukkit.command.ram` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/rambar (Giocatore)`](commands.md#rambar). + +Aggiungendo `.other` alla fine del nome del permesso, consente ad altri giocatori di utilizzarlo. + +#### `bukkit.command.restart` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/tpsbar (Giocatore)`](commands.md#tpsbar). + +Aggiungendo `.other` alla fine del nome del permesso, consente ad altri giocatori di utilizzarlo. + +#### `bukkit.command.timings` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Per scoprire comandi simili, consulta [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(Modalità di gioco)` + +- **Predefinito**: `Amministratore del mondo` + +Permette l'uso del comando [`/gamemode (Modalità di gioco) (Giocatore)`](commands.md#gamemode). + +Aggiungendo `.other` alla fine del nome del permesso, consente ad altri giocatori di utilizzarlo. + +#### `paper.antixray.bypass` + +- **Predefinito**: `Nessuno` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Ciò migliora le prestazioni per entrambi gli utenti. + +> Per informazioni su come configurare l'X-Ray, consulta la pagina seguente. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Predefinito**: `Nessuno` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Predefinito**: `Nessuno` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Predefinito**: `Nessuno` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Predefinito**: `Nessuno` + +Permette l'uso dei [tag MiniMessage](https://docs.advntr.dev/minimessage/format.html) sull'incudine. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Predefinito**: `Nessuno` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Predefinito**: `Nessuno` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Predefinito**: `Nessuno` + +Esclude i giocatori dall'essere espulsi per inattività. + +#### `purpur.debug.f3n` + +- **Predefinito**: `Amministratore del mondo` + +Permette ai giocatori di cambiare modalità di gioco premendo `F3 + N`. + +Funziona solo se il giocatore ha il permesso per quella modalità di gioco. + +#### `purpur.drop.spawners` + +- **Predefinito**: `Nessuno` + +Rilascia un blocco spawner quando viene distrutto con l'oggetto specificato nella configurazione. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(StringaNumerica)` + +- **Predefinito**: `Nessuno` + +Modifica le dimensioni dell'ender chest. + +La `(StringaNumerica)` può essere `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Predefinito**: `Nessuno` + +Consente al totem dell'immortalità di funzionare anche se è nell'inventario. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Predefinito**: `Nessuno` + +Consente al giocatore di ignorare il limite di utenti connessi. + +#### `purpur.mending_shift_click` + +- **Predefinito**: `Nessuno` + +Consente al giocatore di riparare l'oggetto che tiene in mano quando si `accovaccia e interagisce`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Predefinito**: `Nessuno` + +Consente al giocatore di posizionare gli spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Predefinito**: `Nessuno` + +Permette al giocatore di teletrasportarsi immediatamente quando utilizza il portale dell'End. + +#### `purpur.sign.color` + +- **Predefinito**: `Nessuno` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Predefinito**: `Nessuno` + +Consenti l'uso del codice di oscuramento sul cartello `(&o)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Predefinito**: `Nessuno` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Predefinito**: `Nessuno` + +Consenti ai giocatori di prevenire l'esplosione del TNT interagendo con le forbici. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permesso previsto + +#### `plazma.bypass.ncr-require` + +- **Predefinito**: `Nessuno` + +Consenti ai giocatori di accedere anche senza l'installazione della mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operatore. + +[^2]: Esempio: `ender_dragon` diff --git a/it/origin/plazma/adminstration/README.md b/it/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..703fcab84 --- /dev/null +++ b/it/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Crea il tuo server utilizzando Plazma. +--- + +# ⚒️ Guida alla gestione del server diff --git a/it/origin/plazma/adminstration/expert/README.md b/it/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..6cfa5426e --- /dev/null +++ b/it/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri come gestire professionalmente il Plazma. +--- + +# 🎓 Approfondimento diff --git a/it/origin/plazma/adminstration/expert/fix-exploits.md b/it/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..d87e720e8 --- /dev/null +++ b/it/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Scopri le vulnerabilità note e come risolverle. +--- + +# ⚠️ Vulnerabilità note e soluzioni diff --git a/it/origin/plazma/adminstration/expert/optimize.md b/it/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..52f666108 --- /dev/null +++ b/it/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Scopri come ottimizzare Plazma. +--- + +# 🧹 Ottimizzazione diff --git a/it/origin/plazma/adminstration/expert/vanillaize.md b/it/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..c4b127142 --- /dev/null +++ b/it/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Scopri come ripristinare il patch di Paper e Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper non offre opzioni per la maggior parte dei patch che risolvono gli errori di Vanilla. + +Attualmente, Plazma sta sviluppando una configurazione per disattivare tali correzioni degli errori. + +Pertanto, questa guida è ancora in fase di sviluppo e le informazioni possono cambiare in qualsiasi momento. +{% endhint %} diff --git a/it/origin/plazma/adminstration/faq.md b/it/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..00b55514f --- /dev/null +++ b/it/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Scopri le domande frequenti. +--- + +# ⁉️ Domande frequenti + +{% hint style="info" %} + +### Non riesci a trovare la risposta desiderata? + +Fai domande alla comunità tramite il [server Discord ufficiale](https://discord.gg/MmfC52K8A8) o [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Il messaggio viene visualizzato ma non si avvia + +Se compare `no main manifest attribute, in plazma-(version).jar` sulla console,\ +il file scaricato è un file API di sviluppo, è necessario scaricare **Reobf Paperweight** dalla pagina GitHub. + +Per ulteriori informazioni, consulta la seguente pagina. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Viene visualizzato un avviso ogni volta che il server viene avviato + +Plazma contiene alcune patch instabili e potrebbe non funzionare correttamente, quindi mostra il seguente avviso ogni volta che il server viene avviato. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Questo avviso può essere disattivato utilizzando la proprietà di sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Per ulteriori informazioni, consulta la seguente pagina. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponibile a partire dalla versione 1.20.1 diff --git a/it/origin/plazma/adminstration/getting-started/README.md b/it/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..5887c5fbd --- /dev/null +++ b/it/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Scopri come creare un server con Plazma. +--- + +# 👟 Inizia + +Per utilizzare Plazma in modo stabile, il sistema deve soddisfare i seguenti requisiti. + +| | Minimo | Consigliato | +| :---------------------: | -----: | ----------: | +| Architettura | x64 | - | +| RAM | 8GB | 16GB | +| Spazio di archiviazione | 1GB | 8GB | +| JRE | 17 | 21 | + +Per facilitare la modifica dei file di configurazione, è consigliabile installare un editor come [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Installazione di JRE + +Come indica il nome, Minecraft: **"Java"** Edition è sviluppato in Java e richiede JRE[^1] per essere eseguito. + +Poiché Plazma si basa sulla piattaforma ufficiale dei server di Mojang Studios \[^(#user-content-fn-2)], è necessario installare JRE anche per utilizzare Plazma. + +### 1.1 Verifica della presenza di JRE + +Per verificare se JRE è installato nel sistema, digitare [`cmd /k java --version`](#user-content-fn-4) nella finestra di esecuzione e premere Invio. + +Se viene visualizzato l'output corretto, passa al [Passaggio 2](setup.md#id-2). + +{% code title="Output corretto" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Se l'output non è come sopra o se appare come segue, significa che JRE non è installato o è troppo vecchio e devi seguire il [Passaggio 1.2](setup.md#id-1.2). + +{% code title="JRE non installato" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE troppo vecchio" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Installazione di JRE + +In questa guida, useremo Azul Zulu come [una delle varianti](#user-content-fn-5) di JRE. + +Dopo aver completato l'installazione, ripeti il [Passaggio 1.1](setup.md#id-1.1) per verificare che l'installazione sia avvenuta correttamente. + +{% tabs %} +{% tab title="Windows" %} + +1. Scarica il **JDK 21** in formato `.msi` da [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Esegui il file di installazione scaricato e clicca su `Avanti`. +3. Attiva `Imposta la variabile JAVA_HOME` dal menu visualizzato al centro sinistra della finestra e clicca su `Avanti`. +4. Clicca su `Installa` per completare l'installazione di JRE. + {% endtab %} + +{% tab title="macOS" %} +Scarica il file di installazione in formato `.dmg` di **JDK 21** da [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) e installa JRE eseguendo il file scaricato. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Aggiungi il repository Azul Zulu ad APT eseguendo il comando seguente nel terminale. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Successivamente, installa JRE eseguendo il comando seguente nel terminale. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Puoi installare JRE eseguendo il comando seguente. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download di Plazma + +Plazma offre vari file eseguibili tra cui scegliere. + +{% hint style="warning" %} + +### Di solito si utilizza `Reobf Paperclip`. + +Le informazioni seguenti sono per gli sviluppatori o per coloro interessati alle caratteristiche specifiche di ciascuna forma.\ +Se sei un utente normale, puoi saltare al [Passaggio 3](setup.md#id-3) senza problemi. +{% endhint %} + +
+ +Scopri di più + +Il nome del file eseguibile è `plazma-(versione manager)-1.20.4-R0.1-SNAPSHOT-(forma di mappatura).jar`. + +- **Forma di mappatura**\ + La mappatura è una sorta di mappa che collega il codice reale di Minecraft al codice offuscato. + - **Reobf**\ + Reobfuscation, noto anche come mappatura Spigot, è utilizzato principalmente nei plugin NMS.\ + Dal 1.20.5 sarà deprecato. + - **Mojmap**\ + Mappatura Mojang, mappatura di Minecraft vanilla. +- **Version Manager**\ + Il version manager è un launcher del server che gestisce le librerie necessarie per l'avvio del server e patcha i file del server. + - **Paperclip**\ + Sviluppato dal team di PaperMC per Paper e altre piattaforme derivate, scarica le librerie e applica le patch al server. + - **Bundler**\ + Version manager di Minecraft vanilla. + +
+ +*** + +## 3. Creazione dello script di avvio + +Per avviare rapidamente Plazma e riavviare automaticamente il server, è necessario creare uno [script di avvio](#user-content-fn-6). + +Puoi generare lo script di avvio tramite [Flags.sh](https://flags.sh). Inserisci solo la [memoria da utilizzare](#user-content-fn-8) per Plazma e il comando verrà ottimizzato automaticamente. + +Puoi scaricare lo script di avvio facendo clic sul pulsante di download in basso a sinistra.\ +**Assicurati che lo script di avvio scaricato sia compatibile con il tuo sistema operativo.** + +*** + +## 4. Organizzazione dei file + +Sposta lo script di avvio scaricato e Plazma in una nuova cartella. + +{% hint style="warning" %} + +### Il nome della cartella non deve contenere spazi e deve essere in lingua inglese. + +Altrimenti Plazma o JRE potrebbero non funzionare correttamente. +{% endhint %} + +Esegui lo script di avvio. Per Windows, nel prompt di conferma del firewall, seleziona **Consenti**. + +*** + +## 5. Accordo EULA + +Dopo aver eseguito lo script di avvio una volta, verrà creato un file `eula.txt` nella cartella. + +L'EULA[^9] è un accordo di licenza che devi accettare per utilizzare i servizi di [Mojang Studios](#user-content-fn-10). + +Se non accetti l'EULA, non potrai avviare il server e potresti subire sanzioni come la sospensione dell'account in caso di violazione \[^(#user-content-fn-11)]. + +Per accettare l'EULA, modifica `eula=false` in `eula=true` nel file `eula.txt` e salva le modifiche. + +*** + +## 6. Consentire l'accesso esterno (Windows) + +I moderni sistemi operativi bloccano gli accessi esterni per motivi di sicurezza tramite il **firewall** e il **router** di default. + +Poiché hai già consentito l'accesso nel [Passaggio 3](setup.md#id-3) su Windows, devi solo configurare il port forwarding. + +{% hint style="info" %} + +### Questa guida presuppone l'utilizzo di un sistema operativo Windows e un router che supporta [**UPnP**](#user-content-fn-12). + +Se il tuo router non supporta UPnP, dovrai cercare informazioni specifiche poiché i pannelli dei router possono variare. + +Puoi anche utilizzare [Ngrok](https://ngrok.com/) per generare un indirizzo temporaneo. +{% endhint %} + +{% hint style="warning" %} + +### Per sistemi operativi basati su UNIX come Linux o macOS, le impostazioni del firewall variano a seconda del servizio e devi cercare informazioni specifiche. + +{% endhint %} + +### 6.1 Verifica della necessità di port forwarding + +Digita il seguente comando nel prompt e premi Invio. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Se l'output è `True`, non è necessario fare altro. Se è `False`, devi configurare il port forwarding. + +### 6.2 Connessione al server + +{% tabs %} +{% tab title="Accesso esterno" %} +Se non è necessario il forwarding della porta o se è già stato eseguito con successo, è possibile connettersi al server ora. + +L'indirizzo utilizzato per la connessione al server può essere verificato [qui](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Tentativo di forwarding della porta con UPnP" %} +Nel file `purpur.yml` della cartella del server, attivare `network.upnp-port-forwarding` su `true`. + +Successivamente, al riavvio del server, Plazma proverà automaticamente a fare il forwarding della porta. + +Di seguito vi è la conferma del successo del forwarding della porta in base al messaggio visualizzato sulla console, che apparirà come `[UPnP] (messaggio)`. + +| Messaggio | Significato | +| ------------------------------------- | ------------------------------------------------------- | +| `Porta aperta con successo (porta)` | Forwarding della porta riuscito. | +| `Porta (porta) già aperta` | Un altro servizio sta utilizzando la porta specificata. | +| `Impossibile aprire la porta (porta)` | Forwarding della porta fallito. | +| `Servizio non disponibile` | Il router non supporta UPnP. | + +Quando il server viene spento, Plazma chiude automaticamente le porte. +{% endtab %} + +{% tab title="Generazione di un indirizzo temporaneo tramite Ngrok" %} +Il metodo con Ngrok è utile per test temporanei, partite collaborative o giocare con amici. + +1. Scarica il file ZIP `Windows (64-bit)` da [Ngrok website](https://ngrok.com/download). +2. Posiziona il file Ngrok scaricato nella cartella del server. +3. Genera un token di autenticazione dal [dashboard di Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Esegui il comando visualizzato nella riga di comando nella cartella del server. +5. Aggiungi `start /b ngrok tcp --region jp 25565` all'inizio dello script di avvio e `taskkill /f /t /im ngrok.exe` alla fine. +6. Dalla console, l'indirizzo `0.tcp.jp.ngrok.io:12345` sarà l'indirizzo del server. +7. Ora è possibile connettersi esternamente utilizzando questo indirizzo. + {% endtab %} + +{% tab title="Accesso locale" %} +Se si desidera connettersi al server localmente, eseguire `cmd /k ipconfig` nella finestra di esecuzione per ottenere l'`Indirizzo IPv4` visualizzato. + +Ad esempio, se dopo l'esecuzione del comando viene visualizzato: + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Provare a connettersi al server localmente utilizzando l'`192.168.3.7` indicato come indirizzo IPv4. + +Se il server e il gioco sono eseguiti sullo stesso PC, è possibile connettersi utilizzando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Fase successiva + +Se il server è stato avviato con successo e funziona correttamente, è ora il momento di personalizzarlo. + +Scopri come personalizzare il server seguendo la guida qui sotto. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Ambiente di esecuzione Java, Java Runtime Environment. + +[^2]: Paper, su cui si basa Plazma, è basato su Spigot e Spigot si basa sulla piattaforma ufficiale del server. + +[^3]: Tasto Windows + R + +[^4]: Per Linux, eseguire `java --version` nel terminale. + +[^5]: JRE è uno dei progetti open source e ci sono diverse varianti come piattaforma del server Minecraft. + +[^6]: Comunemente noto come **launcher**. + +[^7]: Attivando l'opzione "Auto-riavvio", il server si riavvierà automaticamente. È possibile terminare premendo `Control + C`. + +[^8]: Non è consigliabile superare la metà della capacità del sistema. + + Ad esempio, se la memoria totale del sistema è di 8GB, non è consigliabile impostarla su più di 4GB. + +[^9]: Contratto di licenza per l'utente finale, End-User License Agreement. Per ulteriori informazioni, consulta il [sito web di Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: In Corea, in base all'articolo 32, paragrafo 1, punto 9 della legge sull'avanzamento dell'industria dei videogiochi, è possibile presentare un'azione legale presso **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur incluso in Plazma comunica automaticamente con il router tramite questa tecnologia per aprire solo le porte quando il server è in esecuzione, eliminando la necessità di fare il forwarding della porta manualmente. + +[^13]: Se non si ha un account, è possibile registrarsi su Ngrok tramite un account Google o GitHub. diff --git a/it/origin/plazma/adminstration/getting-started/customization.md b/it/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..f42544b89 --- /dev/null +++ b/it/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Scopri come personalizzare il server. +--- + +# 🎨 Personalizzazione utente diff --git a/it/origin/plazma/adminstration/reference/arguments.md b/it/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..2dcf76864 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Scopri gli argomenti di avvio e le proprietà di sistema. +--- + +# 🎛️ Argomenti di avvio e proprietà + +Gli argomenti di avvio e le proprietà di sistema sono valori aggiunti ai [comandi utilizzati](#user-content-fn-1)[^1] nell'esecuzione di Plazma, che consentono di modificare valori che non possono essere cambiati dopo l'esecuzione di Plazma. + +In base alla [posizione in cui vengono aggiunti ai comandi](#user-content-fn-2)[^2], si distinguono tra **argomenti di avvio** e **proprietà di sistema**. + +*** + +## Proprietà di sistema + +Le proprietà di sistema, inserite prima di `-jar`, sono valori elaborati dalla JVM prima dell'inizializzazione di Plazma. + +{% hint style="warning" %} + +### La modifica delle proprietà di sistema può alterare il funzionamento di Plazma e della JVM, con possibili grandi impatti sul gioco! + +Se non si comprende appieno il ruolo di ciascuna proprietà di sistema, **non utilizzarle assolutamente!** +{% endhint %} + +### Modalità d'uso + +Le proprietà di sistema vengono inserite come argomenti di comando Java tra `java` e `-jar`. + +Ad esempio, per applicare la proprietà di sistema `Plazma.dummyProperty`, inserire il valore `37` come segue per inizializzare Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +Il prefisso `-D` indica che l'argomento non è integrato nella JVM ma è un argomento specifico aggiunto a Plazma, + +Se non viene fornito alcun valore, il valore sarà [`true` per impostazione predefinita.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Le piattaforme server della serie Paperweight includono un punto nel nome delle proprietà per distinguere le proprietà di sistema tra le varie piattaforme. + +In alcuni terminali come Windows Powershell, potrebbe essere necessario aggiungere `"` all'inizio e alla fine degli argomenti per consentirne l'accettazione.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Proprietà di sistema complete + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Aggiorna i formati di cartelli dismessi. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug relativi alle informazioni sulle entità. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disabilita la revisione NMS per consentire un corretto caricamento delle informazioni di debug dall'IDE e riconfigura automaticamente le informazioni sulla versione interna. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il sistema di avviso del Watchdog di Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il messaggio di conferma del comando `/reload`. + +{% hint style="danger" %} + +### Poiché il comando `/reload` è estremamente instabile, tutti i problemi che si verificano dopo l'uso di `/reload` sono di responsabilità dell'utente. + +Se sei uno sviluppatore di plugin e devi aggiornare un plugin, usa il ricaricamento a caldo anziché il comando `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva i plugin che utilizzano il sistema di input/output standard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Avverte quando viene rilevato un formato obsoleto nella componente di chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva la verifica della corrispondenza del modello del server quando un giocatore si connette al server. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug per le chiavi mancanti negli oggetti NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug per i profili di teste non validi. + +Questo logga tutte le teste non valide nella mappa del mondo insieme alla loro posizione. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il limite di 128 canali di plugin per giocatore.[^5] + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il sistema di prioritizzazione delle classi dei plugin. + +Utile in caso di problemi con i plugin shadow. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il sistema di consolidamento dei flush di Netty. + +#### `Paper.excessiveTELimit` + +- **Tipo**: `Integer` +- **Valore predefinito**: `750` + +Se le entità superano il valore impostato, vengono inviate in più pacchetti. + +#### `Paper.filterThreshold` + +- **Tipo**: `Integer` +- **Valore predefinito**: `8192` + +Imposta la dimensione massima del pacchetto che il server può ricevere in un'unica volta. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Disattiva il controllo della versione di Java. + +{% hint style="danger" %} + +### Ciò potrebbe consentire al JVM di accedere a codice inesistente! + +Ciò potrebbe danneggiare permanentemente file come il mondo e compromettere l'intero meccanismo di gioco. + +Tutti i problemi derivanti dall'uso di questa opzione sono responsabilità dell'utente e Plamza non fornirà alcun supporto in tal senso. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tipo**: `Integer` +- **Valore predefinito**: `64` + +Imposta il limite del nome del canale del plugin.[^6] + +#### `Paper.maxSignLength` + +- **Tipo**: `Integer` +- **Valore predefinito**: `80` + +Imposta la lunghezza massima di caratteri per linea sui cartelli. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tipo**: `Integer` +- **Valore predefinito**: `(versione del mondo) + 1` + +Imposta la versione delle informazioni di aggiornamento del mondo da inizializzare per prima. + +È utile per aggiornare un gran numero di chunk, ma non viene utilizzato in altri casi. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `True` + +Attiva il parsing dei commenti YAML di default. + +#### `Paper.playerConnection.keepAlive` + +- **Tipo**: `Integer` +- **Valore predefinito**: `30` + +Espelle il giocatore se non riceve alcun dato per il tempo specificato (in secondi). + +Di solito, il gioco[^7] invia costantemente un [segnale di battito cardiaco](#user-content-fn-8)[^8] al server, quindi non viene espulso; tuttavia, se il gioco non risponde, viene considerato in crash e il server disconnette il giocatore. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Ignora i commenti delle proprietà del server. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Attiva i log di debug per la sincronizzazione del chunk. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Abilita il sistema di scrittura di chunk sincronizzata predefinito di Minecraft. + +Questo salva ogni chunk in ordine sequenziale, causando un notevole degrado delle prestazioni. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Abilita il flushing esplicito dei canali di rete. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Registra sempre gli errori che non si verificano nel thread principale. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Visualizza un avviso se un'operazione programmata ha un ritardo eccessivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `False` + +Se si utilizza il file eseguibile predefinito, applica solo il patch senza avviare il server. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` + +{% hint style="warning" %} + +### Questa proprietà sarà spostata tra gli argomenti di avvio dopo la versione 1.20.5. + +{% endhint %} + +Applica un'ottimizzazione più rigorosa della configurazione all'avvio iniziale. + +Attivando questo, il server diventerà più veloce e sicuro, ma potrebbe bloccare alcune meccaniche o influenzare pesantemente il gameplay. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` + +Sopprime il messaggio di avvertimento[^11] visualizzato durante l'inizializzazione di Plazma. + +### Attributo obsoleto + +Di seguito sono elencati gli attributi di sistema obsoleti. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valore predefinito**: `false` +- **Obsoleto**: Dall'eliminazione di Timings da Plazma in poi + +Determina se può essere superato il massimo valore che può essere inviato all'API di Timings di Aikar. + +Anche in questo caso, se non gestito dalle eccezioni nell'API, verrà applicato un limite di velocità. + +*** + +## Argomento di avvio + +L'argomento di avvio viene inserito dopo `-jar *.jar` per inizializzare Plazma e viene elaborato insieme. + +### Modalità d'uso + +Gli attributi di sistema vengono inseriti come argomenti di comando di programma dopo `-jar *.jar`. + +Ad esempio, se si desidera applicare l'argomento di avvio `nogui`,\ +inserire come segue per far sì che Plazma elabori l'argomento `nogui` durante l'inizializzazione. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argomento di avvio completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Predefinito**: `bukkit.yml` + +Imposta il nome e la posizione del [file di configurazione di Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Predefinito**: `commands.yml` + +Imposta il nome e la posizione del [file di configurazione dei comandi di Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Predefinito**: `server.properties` + +Imposta il nome e la posizione del file di [proprietà del server](../reference/configurations/property.md). + +#### `demo` + +Avvia il server nel mondo demo. + +#### `eraseCache` + +Elimina i file di cache rimasti dopo l'aggiornamento del mondo. + +#### `forceUpgrade` + +Aggiorna forzatamente il mondo ignorando la versione[^12]. + +#### `help` + +- **Alias**: `?` + +Stampa tutti gli argomenti di avvio di Plazma e le relative descrizioni. + +#### `initSettings` + +Genera solo il file di configurazione e chiude il server. + +#### `jfrProfile` + +Attiva il profilo JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Predefinito**: `(server properties)` + +Imposta il numero massimo di [giocatori](#user-content-fn-14). + +#### `nogui` + +Disattiva il pannello dell'interfaccia grafica. + +#### `nojline` + +Disattiva JLine e utilizza la console vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Predefinito**: `(server properties)` + +Seleziona se verificare i giocatori con il server di autenticazione Mojang. + +**Se non si utilizzano proxy come Velocity, potrebbero esserci sanzioni per violazione dell'[EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Valore predefinito**: `paper.yml` + +{% hint style="warning" %} + +### Questo argomento è stato dismesso dopo la versione 1.19.4 + +{% endhint %} + +Imposta la posizione del file di configurazione PaperSpigot dismesso. + +Viene utilizzato per trasferire la configurazione esistente in un nuovo file di configurazione e non sarà più utilizzato in futuro. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Valore predefinito**: `config` + +Imposta il nome e la posizione della cartella in cui si trova il [file di configurazione Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Imposta il nome e la posizione della cartella in cui si trova il [file di configurazione Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Valore predefinito**: `plugins` + +Imposta la posizione della cartella dei plugin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Valore predefinito**: `pufferfish.yml` + +Imposta il nome e la posizione del [file di configurazione Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Valore predefinito**: `purpur.yml` + +Imposta il nome e la posizione del [file di configurazione Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Avvia il server in uno stato completamente vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Predefinito**: `(server properties)` + +Imposta il nome host del server o l'indirizzo IP [Internet Protocol](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Predefinito**: `(server properties)` + +Imposta la porta del server. + +#### `server-name` + +- **Valore predefinito**: `A Plazma Server` + +Imposta il nome del server. + +#### `spigot-settings` + +- **Alias**: `S` +- **Valore predefinito**: `spigot.yml` + +Imposta il nome e la posizione del [file di configurazione Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Mostra la versione di Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Valore predefinito**: `(cartella del server)` + +Imposta la posizione in cui vengono salvati i file del mondo. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Predefinito**: `(server properties)` + +Imposta il nome del file del mondo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: La posizione aggiuntiva influisce sulla gestione degli argomenti. + +[^3]: Ad esempio, se si desidera impostare (attivare) `Plazma.iKnowWhatIAmDoing` su `true`, invece di inserire `-DPlazma.iKnowWhatIAmDoing=true`, è sufficiente inserire `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: Ad esempio, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Rilevatore di eventi. + +[^6]: Rilevatore di eventi. + +[^7]: Client. + +[^8]: Segnale che indica una connessione corretta con il server, simile ai battiti cardiaci. + +[^9]: Con la funzione di espulsione AFK di Purpur è possibile espellere anche i giocatori inattivi. + +[^10]: Sistema di scrittura di chunk sincronizzato, Sync Chunk Write System. + +[^11]: `ATTENZIONE! Plazma potrebbe causare problemi inaspettati, assicurati di testarlo accuratamente prima di utilizzarlo su un server pubblico.` + +[^12]: Anche l'`ottimizzazione del mondo` in gioco funziona allo stesso modo. + +[^13]: Protocollo Internet, IP. + +[^14]: Gli amministratori di `livello 2` o superiore sono esclusi. diff --git a/it/origin/plazma/adminstration/reference/commands.md b/it/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..e405546bc --- /dev/null +++ b/it/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Scopri i comandi disponibili su Plazma. +--- + +# 🖥️ Comandi diff --git a/it/origin/plazma/adminstration/reference/configurations/bukkit.md b/it/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..a46fa9fc2 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo in bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/it/origin/plazma/adminstration/reference/configurations/paper/README.md b/it/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..56ab6e95a --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri lo scopo di ciascun file nella cartella config. +--- + +# 🛩️ Carta diff --git a/it/origin/plazma/adminstration/reference/configurations/paper/global.md b/it/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..e6aeca814 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di paper-global.yml. +--- + +# 🛩️ Paper (Configurazione globale) diff --git a/it/origin/plazma/adminstration/reference/configurations/paper/world.md b/it/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..ea34e074e --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo in paper-world.yml. +--- + +# 🛩️ Paper (Composizione del mondo) diff --git a/it/origin/plazma/adminstration/reference/configurations/plazma/README.md b/it/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..26d6dc6e4 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri lo scopo di ciascun file nella cartella config. +--- + +# ✨ Plazma diff --git a/it/origin/plazma/adminstration/reference/configurations/plazma/global.md b/it/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..2985ed0d3 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo in plazma-global.yml. +--- + +# ✨ Plazma (Configurazione globale) diff --git a/it/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/it/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..efb6cda2b --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Composizione mondiale diff --git a/it/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/it/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d47f2a547 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di plazma-world.yml. +--- + +# ✨ Plazma (composizione mondiale) diff --git a/it/origin/plazma/adminstration/reference/configurations/property.md b/it/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..35edebd36 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di server.properties. +--- + +# 🪨 Server.properties diff --git a/it/origin/plazma/adminstration/reference/configurations/pufferfish.md b/it/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..b7416c718 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ogni nodo in pufferfish.yml. +--- + +# 🐡 Pesce palla diff --git a/it/origin/plazma/adminstration/reference/configurations/purpur/README.md b/it/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..79548dd9a --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa rappresenta ciascun nodo di purpur.yml. +--- + +# 🦑 Purpur diff --git a/it/origin/plazma/adminstration/reference/configurations/purpur/global.md b/it/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..38afe0f8c --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa rappresenta ciascun nodo di purpur.yml. +--- + +# 🦑 Purpur (composizione globale) diff --git a/it/origin/plazma/adminstration/reference/configurations/purpur/world.md b/it/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..99227b079 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa rappresenta ciascun nodo di purpur.yml. +--- + +# 🦑 Purpur (composizione del mondo) diff --git a/it/origin/plazma/adminstration/reference/configurations/spigot.md b/it/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..6b9bffdbe --- /dev/null +++ b/it/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Scopri cosa significa ciascun nodo di spigot.yml. +--- + +# 🚰 Spigot diff --git a/it/origin/plazma/adminstration/reference/permissions.md b/it/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..6a8022a83 --- /dev/null +++ b/it/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Scopri i permessi di Plazma. +--- + +# 🛡️ Permessi diff --git a/it/origin/plazma/developers.md b/it/origin/plazma/developers.md new file mode 100644 index 000000000..d9996fb5e --- /dev/null +++ b/it/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Sviluppa progetti di terze parti utilizzando Plazma. +--- + +# ⚙️ Guida per gli sviluppatori diff --git a/it/origin/thunderbolt/README.md b/it/origin/thunderbolt/README.md new file mode 100644 index 000000000..e47d880dc --- /dev/null +++ b/it/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt è una piattaforma server basata su Plazma che consente di sperimentare patch sperimentali suddividendoli per Flavor per utilizzarli direttamente. +--- + +# 🌩️ Guida all'Uso di Thunderbolt diff --git a/it/origin/volt/README.md b/it/origin/volt/README.md new file mode 100644 index 000000000..5b342087b --- /dev/null +++ b/it/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt è un modello open source che consente di sviluppare la propria piattaforma server Paperweight basata su Plazma. +--- + +# ⚡ Guida allo sviluppo di Volt diff --git a/ja/origin/README.md b/ja/origin/README.md new file mode 100644 index 000000000..5d3b2c8c0 --- /dev/null +++ b/ja/origin/README.md @@ -0,0 +1,41 @@ +--- +description: 質問がある場合は、DiscordまたはGitHub Discussionsを通じて質問してください。 +--- + +# 🏠 ドキュメントポータルへようこそ + +{% hint style="info" %} + +**Plazmaの文書は現在機械翻訳されています。** + +[![翻訳ステータス](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) で文書翻訳に参加して文書を改善してください。 + +{% endhint %} + +### プラズマを使用中に問題が発生した場合は？ + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderboltに興味がある場合は？ + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Voltで独自のサーバープラットフォームを作成したい場合は？ + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` もっと多くのMinecraft関連情報が必要な場合は？ + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ja/origin/SUMMARY.md b/ja/origin/SUMMARY.md new file mode 100644 index 000000000..ad69b283f --- /dev/null +++ b/ja/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# 目次 + +- [🏠 ドキュメントポータルへようこそ](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma 使用説明書](plazma/README.md) +- [❓ Plazmaとは？](plazma/about/README.md) + - [⬇️ ダウンロード](plazma/about/downloads.md) + - [✅ サポートされているバージョン](plazma/about/supported-versions.md) +- [⚒️ 서버 관리 ガイド](plazma/administration/README.md) + - [👟 시작하기](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 リファレンス](plazma/administration/reference/README.md) + - [🖥️ コマンド](plazma/administration/reference/commands.md) + - [🛡️ 権限](plazma/administration/reference/permissions.md) + - [🎛️ 引数とプロパティ](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 グローバル構成](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 グローバル構成](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 グローバル構成](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 エキスパート](plazma/administration/expert/README.md) + - [🧹 最適化](plazma/administration/expert/optimize.md) + - [🔀 プロキシ](plazma/administration/expert/proxy.md) + - [↩️ バニラ化](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray ブロック](plazma/administration/expert/xray.md) + - [⚠️ 脆弱性と対処法](plazma/administration/expert/fix-exploits.md) + - [⁉️ よくある質問](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ 開発者ガイド](plazma/developers.md) + - [✏️ 貢献する](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt 使用ガイド](thunderbolt/README.md) + +## Volt + +- [⚡ Volt 開発ガイド](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ ダウンロード全体を表示](plazma/about/downloads-all.md) diff --git a/ja/origin/miscellaneous/README.md b/ja/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ja/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ja/origin/plazma/README.md b/ja/origin/plazma/README.md new file mode 100644 index 000000000..8d5e26c98 --- /dev/null +++ b/ja/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazmaは、Paperベースの実験的最適化と複数のゲームメカニズムのカスタマイズ機能を追加したMinecraft: Java Edition用のオープンソースサーバープラットフォームです。" +--- + +# ✨ プラズマ使用ドキュメント + +## 👋 プラズマドキュメントへようこそ + +Plazmaのご利用説明書へようこそ！ + +{% hint style="info" %} + +**説明書で問題を解決できませんか？** + +コミュニティの質問は、[公式Discordサーバー](https://discord.gg/MmfC52K8A8)または[GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)でお尋ねください！ + +{% endhint %} + +### Plazmaについて + +> Plazmaがどのようなサーバープラットフォームかを知ってください。 + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### For Administrators + +> Plazmaを活用して独自のサーバーを作成してください。 + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### For Developers + +> Plazmaを活用してサードパーティプロジェクトを開発してください。 + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ja/origin/plazma/about/README.md b/ja/origin/plazma/about/README.md new file mode 100644 index 000000000..53f87ea45 --- /dev/null +++ b/ja/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Plazmaがどのようなサーバープラットフォームかを知ってください。 +--- + +# ❓ Plazma란? + +- **Plazma**は[Andromeda](https://github.com/EarendelArchived/Andromeda)と[Fusion](https://github.com/RuinedTechnologyUnify/Fusion)から利点だけを取り入れた[Paper](https://github.com/PaperMC/Paper)ベースのサーバープラットフォームです。 +- 常に高い安定性と強力なパフォーマンス、迅速なアップデート、多機能を提供するために努力しています。 + +## 📋 Plazmaの目標 + +- 迅速なアップデート、高い安定性を持つサーバープラットフォームとなるために努力しています。 +- モッドプラットフォームに引けを取らない多機能と強力なパフォーマンスを提供するために努力しています。 +- バニラのパッチもカスタマイズ可能な自由なプラットフォームを作るために努力しています。 + +## ⚙️ 主な特徴 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **最速のアップデート**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)はPlazmaの含まれるパッチが常に最新に保たれるようにして、Paperベースのサーバープラットフォームの中で最速のアップデートを提供しています。 +6. **基本構成ファイルの最適化**\ + デフォルトで適用される構成ファイルが最適化されており、直接構成ファイルを最適化する必要がありません。 +7. **体系的に動作するマルチスレッド**\ + ゲームのメカニズムと関係ないシステムメカニズムを非同期化して、[遅延時間](#user-content-fn-4)[^4]を減らし、サーバーを最適化します。 +8. **不要なスペースの使用を防止**\ + 似た値を持つデータをすべて1つにまとめてメモリ使用量を削減します。 + +## ✨ 活用事例 + +- **複雑なプラグインも適切に処理するプラットフォーム**\ + 開発者[IPECTER](https://github.com/IPECTER)のサーバーでPlazmaが使用されています。\ + NMSとリフレクションで動作する独自のプラグイン、複雑で巨大なデータパックが非常に多く適用されているにもかかわらず、\ + 100人以上のプレイヤーをパフォーマンス低下なしに受け入れています。 +- **RPGサーバーでも高速なパフォーマンスを維持するプラットフォーム**\ + 単一クラスターで100人のプレイヤーをTPS低下なしに安定的に維持し、\ + 4つのクラスターで合計250人のプレイヤーが快適にプレイすることができました。 +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **多くのストリーマーが選んだプラットフォーム**\ + 多くのストリーマーの視聴者参加用バケツとして選ばれて使用されています。 + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ ダウンロード + +以下のページからPlazmaをダウンロードできます。 + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### バージョンサポートに関する詳細情報を知りたいですか？ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit、CraftBukkit、SpigotプラグインおよびPaper、Pufferfish、Purpurプラグイン。 + +[^2]: 以下Microsoft Corporation。 + +[^3]: チャットレポートシステムを無効化すると、チャットがサーバー内でのみ処理され、Mojangのチャット追跡を防ぐことができます。 + +[^4]: システムメカニズムが作動するために一時的にゲームが停止する時間。 diff --git a/ja/origin/plazma/about/downloads-all.md b/ja/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..bffafbf7b --- /dev/null +++ b/ja/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma 실행 파일 ダウンロード 全体を表示 +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| バージョン | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ja/origin/plazma/about/downloads.md b/ja/origin/plazma/about/downloads.md new file mode 100644 index 000000000..09158df02 --- /dev/null +++ b/ja/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Plazmaをダウンロードして、直接お試しください。 +--- + +# ⬇️ ダウンロード + +#### バージョンサポートに関する詳細情報を知りたいですか？ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**以下のダウンロードは一般ユーザー向けの実行ファイルです。** + +開発者であり、他の形式のファイルが必要な場合は、以下のページを参照してください。 + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
バージョンダウンロード
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + ダウンロード +
1.20.1 + ダウンロード +
1.19.4 + ダウンロード +
+ +*** diff --git a/ja/origin/plazma/about/patches-list.md b/ja/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..2e53ae791 --- /dev/null +++ b/ja/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Plazmaに追加されたすべての機能について調べてください。 +--- + +# 📑 含まれるパッチ diff --git a/ja/origin/plazma/about/supported-versions.md b/ja/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..91c15909f --- /dev/null +++ b/ja/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "PlazmaがサポートするMinecraft: Java Editionのバージョンを確認してください。" +--- + +# ✅ バージョンサポート状況 + +{% hint style="info" %} + +**Plazmaは1.19.4以降に開発され、1.19.4未満のバージョンは開発されていません。** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/개발中 +[atv]: https://badge.plazmamc.org/2/サポート中 +[fse]: https://badge.plazmamc.org/6/機能サポート中止 +[eol]: https://badge.plazmamc.org/4/サポート終了 +[ukn]: https://badge.plazmamc.org/0/情報なし +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/通常 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| バージョン | 安定性 および 機能サポート | ビルド状況 | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![ビルド状態](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![ビルド状態](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![ビルド状態](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ja/origin/plazma/administration/README.md b/ja/origin/plazma/administration/README.md new file mode 100644 index 000000000..6b6cdd7f4 --- /dev/null +++ b/ja/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazmaを活用して独自のサーバーを作成してください。 +--- + +# ⚒️ サーバー管理ガイド diff --git a/ja/origin/plazma/administration/diagnosis/README.md b/ja/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..c38889153 --- /dev/null +++ b/ja/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: 問題が発生した場合の対処方法を調べてください。 +--- + +# 🧾 진단 diff --git a/ja/origin/plazma/administration/diagnosis/plugins.md b/ja/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..e1f0a1d35 --- /dev/null +++ b/ja/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: プラグインが正常に動作しない場合の解決方法について調べてください。 +--- + +# 📜 플러그인 diff --git a/ja/origin/plazma/administration/expert/README.md b/ja/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..b52e888b4 --- /dev/null +++ b/ja/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazmaを専門的に扱う方法について知ってください。 +--- + +# 🎓 深化 diff --git a/ja/origin/plazma/administration/expert/fix-exploits.md b/ja/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..c9862db12 --- /dev/null +++ b/ja/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 既知の脆弱性とその解決方法について調べてください。 +--- + +# ⚠️ 既知の脆弱性と解決方法 diff --git a/ja/origin/plazma/administration/expert/optimize.md b/ja/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..9808e5070 --- /dev/null +++ b/ja/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazmaの最適化方法を知ってください。 +--- + +# 🧹 最適化 diff --git a/ja/origin/plazma/administration/expert/proxy.md b/ja/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..7ae2aac5c --- /dev/null +++ b/ja/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: プロキシプラットフォーム"Velocity"を安全に構築する方法について学びます。 +--- + +# 🔀 プロキシ diff --git a/ja/origin/plazma/administration/expert/vanillaize.md b/ja/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..8071b8260 --- /dev/null +++ b/ja/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper와 바닐라의 패치를 복원하는 방법에 대해 알아보세요. +--- + +# ↩️ 바닐라화 + +{% hint style="warning" %} + +**Paperはバニラのエラーを解決するほとんどのパッチに選択肢を追加していません。** + +현재 Plazma는 그러한 오류 해결을 구성으로 비활성화 할 수 있도록 개발하고 있습니다. + +따라서 아직 본 가이드는 작성중이며, 언제나 정보가 바뀔 가능성이 있습니다. + +{% endhint %} diff --git a/ja/origin/plazma/administration/expert/xray.md b/ja/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..2bd0fe2df --- /dev/null +++ b/ja/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray를 차단하는 여러 가지 내장된 방법에 대해 알아보세요. +--- + +# 🩻 X-Ray 차단 diff --git a/ja/origin/plazma/administration/faq.md b/ja/origin/plazma/administration/faq.md new file mode 100644 index 000000000..2119eac57 --- /dev/null +++ b/ja/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: よくある質問をご覧ください。 +--- + +# ⁉️ よくある質問 + +{% hint style="info" %} + +**回答が見つからない場合は？** + +コミュニティの質問は、[公式Discordサーバー](https://discord.gg/MmfC52K8A8)または[GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)でお尋ねください！ + +{% endhint %} + +### Plazmaが起動しません + +コンソールに `no main manifest attribute, in plazma-(version).jar` と表示された場合、 +ダウンロードしたファイルは開発用APIファイルであり、GitHubページから **Reobf Paperweight** をダウンロードする必要があります。 + +詳細は次のページをご参照ください。 + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### サーバーが起動するたびに警告が表示されます + +Plazmaには一部不安定なパッチが含まれており、常に誤動作の可能性があるため、サーバーが起動する際に次のような警告文を出力しています。 + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +この警告文は[`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] システムプロパティを使用して無効にすることができます。 + +詳細は次のページをご参照ください。 + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1から利用可能 diff --git a/ja/origin/plazma/administration/getting-started/README.md b/ja/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..1f7bd1f7a --- /dev/null +++ b/ja/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Plazmaでサーバーを作る方法を知ってください。 +--- + +# 👟 始める + +Plazmaを安定して使用するためには、システムが次の要件を満たしている必要があります。 + +| | 最低 | 推奨 | +| :-----: | --- | ---- | +| アーキテクチャ | x64 | - | +| RAM | 8GB | 16GB | +| 保存スペース | 1GB | 8GB | +| JDK | 17 | 21 | + +スムーズな構成ファイルの編集のために、[Visual Studio Code](https://code.visualstudio.com/download)などのエディタをインストールするのも良いでしょう。 + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="正しい出力" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. まず、[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) から **JDK 21**を`.msi`形式でダウンロードします。 +2. ダウンロードしたインストーラーを実行し、`次へ`をクリックします。 +3. **ウィンドウの左中央に表示されるメニューから`Set JAVA_HOME variable`を有効にした後、**`次へ`をクリックします。 +4. `インストール`を押してJREのインストールを`完了`します。 + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +その後、次のコマンドをターミナルで実行してJREをインストールします。 + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazmaのダウンロード + +Plazmaではさまざまな形式の実行ファイルが提供されています。 + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +詳細を見る + +実行ファイルの名前は`plazma-(バージョン管理者)-1.20.4-R0.1-SNAPSHOT-(マッピング形式).jar`に決まります。 + +- **マッピング形式**\ + マッピングはMinecraftの実際のコードと難読化されたコードをつなぐ一種の地図です。 + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, バニラ Minecraft マッピングです。 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **バージョン管理者**\ + バージョン管理者はサーバー駆動に必要なライブラリと、サーバーファイルをパッチするサーバーのランチャーと言えます。 + - **Paperclip**\ + PaperMCチームがPaperおよび他の派生プラットフォームのために開発した管理者で、ライブラリをダウンロードし、サーバーにパッチを適用する役割を果たします。 + - **Bundler**\ + バニラMinecraftバージョン管理者です。 + +
+ +*** + +## 3. 開始スクリプトの作成 + +Plazmaを簡単に開始し、サーバーを自動的に再起動するには、[開始スクリプト](#user-content-fn-6)[^6]を作成する必要があります。 + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +左下のダウンロードボタンをクリックして開始スクリプトをダウンロードできます。\ +**ダウンロードした開始スクリプトが自身のオペレーティングシステムと同じか確認してください。** + +*** + +## 4. ファイルの整理 + +今ダウンロードした開始スクリプトとPlazmaを新しいフォルダに移動します。 + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +今、開始スクリプトを実行します。 Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA同意 + +開始スクリプトを一度実行すると、フォルダに`eula.txt`が作成されます。 + +EULA[^9]は[Mojang Studios](#user-content-fn-10)[^10]のサービスを利用することに同意する使用許諾契約です。 + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULAに同意するには、`eula.txt`ファイルの`eula=false`を`eula=true`に変更して保存してください。 + +*** + +## 6. 外部アクセスを許可 (Windows) + +現代のオペレーティングシステムは、外部からの危険なアクセスをブロックするために、基本的に**ファイアウォール**と**ルーター**が外部アクセスをブロックしています。 + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +ルーターがUPnPをサポートしていない場合、ルーターごとにパネルが異なるため、直接情報を検索する必要があります。 + +または[Ngrok](https://ngrok.com/)を使用して一時的なアドレスを生成することもできます。 +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 ポートフォワーディングの必要有無を確認 + +実行ウィンドウに以下のように入力して実行します。 + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +出力が`True`であれば、ここで終了しても構いませんが、`False`であればポートフォワーディングを設定する必要があります。 + +### 6.2 サーバーに接続 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +サーバーに接続する際に使用されるアドレスは[こちら](https://ip.pe.kr/)で確認できます。 +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +その後、サーバーを再起動すると、Plazmaが自動的にポートフォワーディングを試みます。 + +以下はコンソールに出力されるメッセージに応じたUPnPの成功または失敗です。コンソールでは`[UPnP] (メッセージ)`のように出力されます。 + +| メッセージ | 意味 | +| -------------------------------- | -------------------- | +| `Successfully opened port (ポート)` | ポートフォワーディング成功。 | +| `Port (ポート) is already open` | 他のサービスがそのポートを使用中です。 | +| `Failed to open port (ポート)` | ポートフォワーディング失敗。 | +| `Service is unavailable` | ルーターがUPnPをサポートしていない。 | + +サーバーが終了するとPlazmaが自動的にポートを閉じます。 +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrokホームページ](https://ngrok.com/download)から`Windows (64-bit)`ZIPファイルをダウンロードします。 +2. ダウンロードしたNgrokをサーバーフォルダに入れます。 +3. [Ngrokダッシュボード](https://dashboard.ngrok.com/get-started/your-authtoken)から[認証トークンを生成](#user-content-fn-13)[^13]します。 +4. サーバーフォルダで以下の`Command Line`に表示されるコマンドを実行します。 +5. 実行スクリプト最上部に`start /b ngrok tcp --region jp 25565`、最下部に`taskkill /f /t /im ngrok.exe`を追加します。 +6. コンソール最上部に表示される`Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`から、`0.tcp.jp.ngrok.io:12345`がサーバーのアドレスになります。 +7. これで外部からそのアドレスを介して接続できます。 + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +例えば、コマンド実行後に次のように出力された場合、 + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +ここでIPv4アドレスに表示された`192.168.3.7`で接続を試みると、ローカルからサーバーに接続できます。 + +サーバーとゲームが同じPCで実行される場合、`localhost`で接続できます。 +{% endtab %} +{% endtabs %} + +## 7. 発展する + +サーバーを成功裏に起動し、サーバーが正常に動作している場合は、これでサーバーをカスタマイズする番です。 + +以下の説明書でサーバーをカスタマイズする方法を確認してください。 + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: PlazmaのベースであるPaperはSpigotをベースにしており、Spigotは公式サーバープラットフォームをベースにしています。 + +[^3]: Windowsキー + R + +[^4]: Linuxの場合ターミナルで`java --version` + +[^5]: JREはオープンソースプロジェクトの1つで、Minecraftサーバープラットフォームのようにさまざまな種類があります。 + +[^6]: 一般的に**ランタイム**として知られています。 + +[^7]: "Auto-restart"を有効にすると、サーバーが自動的に再起動されます。 `Control + C`を入力して終了できます。 + +[^8]: システムの半分以上を超えることは推奨されません。 + + 例えば、システム全体のメモリ容量が8GBの場合、4GB以上に設定することは推奨されません。 + +[^9]: End-User License Agreement、最終ユーザーライセンス契約。 詳細は[Minecraftホームページ](https://www.minecraft.net/ko-kr/usage-guidelines)をご確認ください。 + +[^10]: Microsoft Corporation。 + +[^11]: 韓国の場合、ゲーム産業振興に関する法律第32条第1項第9号に基づき**韓国マイクロソフト株式会社**から法的訴訟を行うことができます。 + +[^12]: Universal Plug & Play。 Plazmaに含まれるPurpurはこの技術を介して自動的にルーターと通信し、サーバーが実行中のみポートを開くため、ポートフォワーディングを直接行う必要はありません。 + +[^13]: アカウントがない場合はGoogleまたはGitHubアカウントを使用してNgrokにサインアップします。 diff --git a/ja/origin/plazma/administration/getting-started/customization.md b/ja/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..db7ba7c49 --- /dev/null +++ b/ja/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: サーバーをカスタマイズする方法について学びましょう。 +--- + +# 🎨 ユーザー定義 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 +Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 +**사용자화**가 가능하다는 점이 가장 클 것입니다. + +아래는 Plazma를 사용자화하고 활용하는 여러 방법입니다. + +## 구성 수정 + +Plazma를 사용자화 하는 가장 기본적인 방법은 바로 구성을 수정하는 것입니다. + +Plazma는 게임의 메커니즘부터 몹의 속성 등 강력한 구성 설정을 제공하고 있습니다. + +Plazma의 구성에 대한 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## 플러그인 사용 + +{% hint style="success" %} + +**PlazmaはPaperベースのすべてのプラグインを正常にサポートします。** + +Spigotプラグインの場合、1.20.5からPaperのマッピングの変更により一部が機能しない場合がありますが、 +Paper、Pufferfish、PurpurなどPaperベースのほとんどのプラグインはPlazmaでも +すべて動作し、正常に動作しない場合はPlazmaのエラーであるため、直ちに[報告してください。](../diagnosis/plugins.md) + +{% endhint %} + +Plazmaを使用する主な理由であり、Plazmaをカスタマイズする最も強力な方法です。 +Plazmaの強力なプラグインエコシステムはサーバーを簡単にカスタマイズできるようにします。 + +プラグインを見つけてダウンロードするには、さまざまな方法があります。 いくつかのプラグインは +パブリックリポジトリサービスにプラグインをアップロードし、いくつかのプラグインはGitHubや独自の +サイトにアップロードすることもあります。 + +{% hint style="caution" %} + +**プラグインはシステムに直接アクセスできます！** + +VirusTotalなどのサービスを使用してプラグインを適用する前に常に安全か確認するか、 +信頼できるサービスからプラグインをダウンロードしてください。 + +{% endhint %} + +プラグインをダウンロードするために使用されるサービスにはさまざまなものがあります。 そのうち、[SpigotMCフォーラム](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/)などのサービスはプラグインがアップロードされる前に審査を受け、安全でないプラグインは直ちに処理して安全なプラグインのみが流通するようにしています。 + +### プラグインの適用 + +プラグインをダウンロードしたら、次はプラグインを適用する番です。 + +1. プラグインは`.jar`または`Java実行可能ファイル`で構成されています。\ + 一部のプラグインは圧縮ファイルに圧縮されている場合もあり、その場合 + 圧縮を解除して名前に`bukkit`、`spigot`または`paper`が含まれており、 + `fat`が含まれているファイルが一緒にある場合は`fat`ファイルを使用します。 +2. ダウンロードしたファイルをサーバーフォルダの`plugins`フォルダに入れてサーバーを(再)起動します。 +3. Plazmaが開始されると、コンソールに新しい内容が出力されます。 + これはPlazmaがプラグインを正常にロードしたことを意味します。 +4. Plazmaがプラグインを正常にロードしていても、プラグインを開始できない場合があります。 + `/plugins`コマンドを使用すると、現在のサーバーにロードされたプラグインを読み込むことができます。 + インストールしたプラグインの名前が赤色でなく 緑色であれば、プラグインが正常にロードされたことを意味します。 + +プラグインが正常にロードされない場合、以下のページで問題の解決策を見つけることができます。 + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## データパックの使用 + +データパックはMinecraftが基本的に提供するカスタマイズ方法であり、 +[リソースパック](#user-content-fn-1)[^1]と類似しています。 + +データパックを使用すると、新しい生物群系やチャレンジを追加するなど、ゲーム内の一部を変更できます。 + +{% hint style="caution" %} + +**データパックはワールドを破壊する可能性があります！** + +一部の故障したデータパックはワールドを破壊する可能性があり、元に戻すことはできません。 + +したがって、データパックを適用する前にワールドをバックアップすることが推奨されます。 + +{% endhint %} + +データパックもさまざまなサービスからダウンロードでき、[CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/)などのさまざまなサービスで見つけることができます。 + +データパックをダウンロードしたら、サーバーのワールドフォルダに`datapacks`フォルダに入れて適用できます。 +フォルダがない場合は、フォルダを作成して追加すればよいです。 + +{% hint style="warning" %} + +**一部の[データパック](#user-content-fn-2)[^2]は最初に適用されると正常に適用されない場合があります。** + +このような場合に備えて、サーバーを**2回**再起動することをお勧めします。 + +{% endhint %} + +データパックはMinecraftのバージョンが更新されるたびに簡単に破損する可能性があります。 + +特に、データパックが完全に破損した場合、サーバーがクラッシュするため、 +サーバーを更新する前に十分なテストを行うことが重要です。 + +{% hint style="info" %} + +**サーバー起動コマンドの後に`safeMode`を入力してデータパックをすべて無効にした後、サーバーを起動できます。** + +[詳細については`リファレンス > 引数とプロパティ`を参照してください。](../reference/arguments.md) + +{% endhint %} + +適用されたデータパックは`/datapack list`コマンドで確認できます。 + +*** + +[^1]: またはMinecraft: Bedrock Editionのアドオン。 + +[^2]: 新しい生物群系の追加など。 diff --git a/ja/origin/plazma/administration/getting-started/next-step.md b/ja/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..f1d7008bb --- /dev/null +++ b/ja/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: サーバーをカスタマイズする方法について学びましょう。 +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +아래는 Plazma를 사용자화하고 활용하는 여러 방법입니다. + +## 구성 수정 + +Plazma를 사용자화 하는 가장 기본적인 방법은 바로 구성을 수정하는 것입니다. + +Plazma는 게임의 메커니즘부터 몹의 속성 등 강력한 구성 설정을 제공하고 있습니다. + +Plazma의 구성에 대한 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## 플러그인 사용 + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazmaを使用する主な理由であり、Plazmaをカスタマイズする最も強力な方法です。 Plazmaの強力なプラグインエコシステムはサーバーを簡単にカスタマイズできるようにします。 + +プラグインを見つけてダウンロードするには、さまざまな方法があります。 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +プラグインをダウンロードするために使用されるサービスにはさまざまなものがあります。 そのうち、[SpigotMCフォーラム](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/)などのサービスはプラグインがアップロードされる前に審査を受け、安全でないプラグインは直ちに処理して安全なプラグインのみが流通するようにしています。 + +### プラグインの適用 + +プラグインをダウンロードしたら、次はプラグインを適用する番です。 + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. ダウンロードしたファイルをサーバーフォルダの`plugins`フォルダに入れてサーバーを(再)起動します。 +3. Plazmaが開始されると、コンソールに新しい内容が出力されます。 これはPlazmaがプラグインを正常にロードしたことを意味します。 +4. Plazmaがプラグインを正常にロードしていても、プラグインを開始できない場合があります。 `/plugins`コマンドを使用すると、現在のサーバーにロードされたプラグインを読み込むことができます。 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +プラグインが正常にロードされない場合、以下のページで問題の解決策を見つけることができます。 + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## データパックの使用 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +データパックを使用すると、新しい生物群系やチャレンジを追加するなど、ゲーム内の一部を変更できます。 + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +一部の故障したデータパックはワールドを破壊する可能性があり、元に戻すことはできません。 + +したがって、データパックを適用する前にワールドをバックアップすることが推奨されます。 +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +データパックをダウンロードしたら、サーバーのワールドフォルダに`datapacks`フォルダに入れて適用できます。 フォルダがない場合は、フォルダを作成して追加すればよいです。 + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +このような場合に備えて、サーバーを**2回**再起動することをお勧めします。 +{% endhint %} + +データパックはMinecraftのバージョンが更新されるたびに簡単に破損する可能性があります。 + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +適用されたデータパックは`/datapack list`コマンドで確認できます。 + +*** + +## 最適化 + +Plazmaには多くの最適化パッチが適用されています。 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## プロキシ + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +安全で適切なプロキシ設定に関する情報は以下のページを参照してください。 + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 安全 + +Minecraftはモッドが発達してオンラインでも簡単に[脆弱性攻撃エンジン](#user-content-fn-3)[^3]を入手できます。 + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 権限設定 + +一部のプラグインの管理者コマンドは権限が正しく設定されていない脆弱性が存在することもあります。 + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Rayブロック + +X-Rayは基本的な最適化クライアントでも簡単に使用できる脆弱性の1つです。 + +PlazmaにはX-Rayを基本的にブロックできる構成が提供されています。 + +X-Rayブロック方法と説明については以下のページを参照してください。 + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### ホワイトリスト + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +アクセスが許可されたプレイヤーを確認するには`/whitelist query`を使用します。 + +*** + +[^1]: またはMinecraft: Bedrock Editionのアドオン。 + +[^2]: 新しい生物群系の追加など。 + +[^3]: 一般的に"ハック"と呼ばれます。 + +[^4]: 構成が最適化されていない、Plazmaが古くなっている、または新たに発見された脆弱性の場合、ブロックされていない可能性があります。 + +[^5]: プレイヤーがサーバーにアクセスする際、Ngrokプロキシサーバーを介してアクセスされ、毎回再起動するたびに発行されるNgrokアドレスは異なります。 diff --git a/ja/origin/plazma/administration/reference/README.md b/ja/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..2f7759554 --- /dev/null +++ b/ja/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Plazmaで提供されているユーザー定義方法を調べてください。 +--- + +# 📜 리퍼런스 + +Plazmaでは、さまざまなユーザー定義方法を提供しています。 + +その中で、以下の4つの方法は追加の作業なしに直接使用できるユーザー定義方法です。 + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +コミュニティの質問は、[公式Discordサーバー](https://discord.gg/MmfC52K8A8)または[GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)でお尋ねください！ +{% endhint %} + +*** + +## 🖥️ コマンド + +> コマンドはゲーム内で情報を収集したり、プレイ環境をカスタマイズできるようにします。 + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ 権限 + +> 権限はプレイヤーが相互作用できる範囲を指定します。 + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ 引数とプロパティ + +> 引数とプロパティはPlazmaの動作に全体的な影響を与えます。 + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 構成 + +> 構成はPlazmaをカスタマイズする最も基本的な方法です。 + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ja/origin/plazma/administration/reference/arguments.md b/ja/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..90131ea95 --- /dev/null +++ b/ja/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 開始引数とシステム属性について調べてください。 +--- + +# 🎛️ 引数と属性 + +시작 인수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로, Plazma의 작동에 전반적인 영향을 줍니다. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 インス**と**システム属性**に分かれます。 + +*** + +## システム属性 + +システム属性は`-jar`の前に入力され、Plazmaが初期化される前にJVMで処理される値です。 + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 使用方法 + +システム属性は`java`と`-jar`の間にJavaコマンド引数として入力されます。 + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`はその引数がJVMに組み込まれず、Plazmaに追加された専用の引数であることを示し、 + +属性に何の値も入力しない場合、値は[`true`で固定](#user-content-fn-3)[^3]されます。 + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 全システム属性 + +#### `convertLegacySigns` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +使用中止された看板フォーマットを更新します。 + +#### `debug.entities` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +エンティティ情報に関連するデバッグログを有効にします。 + +#### `debug.rewriteForIDE` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +IDEでデバッグ情報を正しく読み込めるようにNMSリビジョンを無効化し、\ +内部バージョン情報を自動的にリマップします。 + +#### `disable.watchdog` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +SpigotのWatchdog警告システムを無効化します。 + +#### `letMeReload` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +`/reload`コマンドの再確認メッセージを無効化します。 + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +プラグイン開発者でプラグインを更新する必要がある場合は、`/reload`の代わりにホットスワップを使用してください。 +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +プラグインクラスの優先順位システムを無効にします。 + +プラグインシェードで問題が発生した場合に役立ちます。 + +#### `Paper.disableFlushConsolidate` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +Nettyフラッシュ統合システムを無効にします。 + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **デフォルト値**: `750` + +エンティティが設定された値より多い場合は、複数パケットに分割して送信します。 + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **デフォルト値**: `8192` + +サーバーが一度に受け取ることができる最大パケットのサイズを設定します。 + +#### `Paper.ignoreJavaVersion` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +Javaバージョンの確認を無効にします。 + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +ワールドなど全体のファイルが永続的に破損する可能性があり、ゲームの全体的なメカニズムが破壊されます。 + +これを使用して発生したすべての問題はユーザーが責任を負い、Plamzaはこれに関するいかなるサポートも提供しません。 +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **デフォルト値**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **デフォルト値**: `80` + +看板の1行に入力できる文字の最大長を設定します。 + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **デフォルト値**: `(ワールドバージョン) + 1` + +最初に初期化するワールド更新情報のバージョンを設定します。 + +大量のチャンクを更新する必要がある場合に便利ですが、それ以外の場合は使用されません。 + +#### `Paper.parseYamlCommentsByDefault` + +- **形式**: `Boolean` +- **デフォルト値**: `True` + +YAMLファイルのコメントの処理を有効にします。 + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **デフォルト値**: `30` + +プレイヤーから入力された値(秒)だけデータを受信しなかった場合、プレイヤーを追放します。 + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +サーバー属性のコメントを無視します。 + +#### `Paper.debug-sync-loads` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +同期チャンク作成のデバッグログを有効にします。 + +#### `Paper.enable-sync-chunk-writes` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +Minecraftの[デフォルトチャンク作成システム](#user-content-fn-10)[^10]を有効にします。 + +これは各チャンクを順番に保存するため、著しいパフォーマンス低下を引き起こします。 + +#### `Paper.explicit-flush` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +ネットワークチャンネルの明示的なフラッシングを有効にします。 + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **形式**: `Boolean` +- **デフォルト値**: `false` + +Plazmaのブランディングを非アクティブ化し、バニラのデフォルトサーバーファビコンを使用するようにします。 + +#### `Plazma.useVanillaConfiguration` + +- **形式**: `Boolean` +- **デフォルト値**: `false` +- **衝突**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +これはサーバーの安全性とパフォーマンスに大きく影響を与える可能性があります。 + +このプロパティを使用して発生するすべての問題はサーバー管理者にあります。 +{% endhint %} + +初期構成をMojangが提供するデフォルト値で提供します。 + +これはPaperで適用されたすべての脆弱性パッチを非アクティブ化します。 + +脆弱性パッチはPaper構成またはPlazma構成で再度有効化できます。 + +#### `Plazma.vanillaize` + +- **形式**: `Boolean` +- **デフォルト**: `true` +- **衝突**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +初期構成をバニラに近づけます。 + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 廃止された属性 + +以下のシステム属性は廃止されたものです。 + +#### `timings.bypassMax` + +- **形式**: `Boolean` +- **デフォルト値**: `false` +- **廃止**: TimingsがPlazmaから完全に削除されてから + +AikarのTimings APIに送信できる値の最大値を超えてもよいかどうかを決定します。 + +これを行ってもAPIで例外処理されない場合はレート制限が適用されます。 + +*** + +## 開始引数 + +開始引数は`-jar *.jar`の後に入力され、Plazmaが初期化される際に一緒に処理される値です。 + +### 使用方法 + +システム属性は`-jar *.jar`の後にプログラムのコマンド引数として入力されます。 + +例えば、`nogui`開始引数を適用しようとする場合、\ +次のように入力するとPlazmaが初期化中に`nogui`引数を処理することになります。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 全体の開始引数 + +#### `bukkit-settings` + +- **エイリアス**: `b` +- **デフォルト**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **エイリアス**: `c` +- **デフォルト**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **エイリアス**: `c` +- **デフォルト**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +デモワールドでサーバーを起動します。 + +#### `eraseCache` + +ワールドアップグレード後に残ったキャッシュファイルを削除します。 + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **エイリアス**: `?` + +Plazmaの全体の開始引数と説明を出力します。 + +#### `initSettings` + +構成ファイルのみを生成してサーバーを終了します。 + +#### `jfrProfile` + +JFRプロファイリングを有効化します。 + +#### `max-players` + +- **エイリアス**: `s`, `size` +- **デフォルト**: `(サーバー属性)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +グラフィックインターフェースパネルを無効化します。 + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을使用します。 + +#### `online-mode` + +- **별칭**: `o` +- **デフォルト**: `(サーバー属性)` + +Mojang 인증 서버로 플레이어를 검증할지 선택します。 + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본值**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다。 + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며、その後には使用されません。 + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본值**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본值**: `plugins` + +プラグインフォルダの位置を設定します。 + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본值**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본値**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(セーフモード) 完全なバニラ状態でサーバーを起動します。 + +#### `server-ip` + +- **별칭**: `h`, `host` +- **デフォルト**: `(サーバー属性)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **デフォルト**: `(サーバー属性)` + +サーバーのポートを設定します。 + +#### `server-name` + +- **基本値**: `A Plazma Server` + +サーバーの名前を設定します。 + +#### `spigot-settings` + +- **별칭**: `S` +- **基本値**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazmaバージョンを出力します。 + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **基本値**: `(サーバーフォルダ)` + +ワールドファイルが保存される位置を設定します。 + +#### `world-name` + +- **별칭**: `w`, `world` +- **デフォルト**: `(サーバー属性)` + +ワールドファイルの名前を設定します。 + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 追加された場所に応じて引数の処理位置が変更されます。 + +[^3]: たとえば、`Plazma.iKnowWhatIAmDoing`を`true`に設定(有効化)したい場合、`-DPlazma.iKnowWhatIAmDoing=true`ではなく`-DPlazma.iKnowWhatIAmDoing`だけを入力しても同様に機能します。 + +[^4]: たとえば、`"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: イベント検出器。 + +[^6]: イベント検出器。 + +[^7]: クライアント。 + +[^8]: 心拍のようにサーバーと正常に接続されていることを知らせる信号。 + +[^9]: PurpurのAFKキック機能を使用すると、離席中のプレイヤーもキックできます。 + +[^10]: 同期チャンク書き込みシステム、Sync Chunk Write System。 + +[^11]: `WARNING! Plazmaには予期せぬ問題が発生する可能性があるため、公開サーバーで使用する前に十分にテストしてください。` + +[^12]: ゲームで`ワールド最適化`も同じ原理で動作します。 + +[^13]: `レベル 2`以上の管理者は除外します。 + +[^14]: Internet Protocol, IP。 diff --git a/ja/origin/plazma/administration/reference/commands.md b/ja/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..3e5565ed1 --- /dev/null +++ b/ja/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazmaで利用可能なコマンドについて調べてください。 +--- + +# 🖥️ コマンド diff --git a/ja/origin/plazma/administration/reference/configurations/README.md b/ja/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..8558210aa --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: 構成はPlazmaをカスタマイズする最も基本的な方法です。 +--- + +# 🧾 구성 + +*** + +## 🪨 属性 + +> 属性はMinecraftで提供される基本的な構成ファイルです。 属性を使用すると、ゲームの基本的なメカニズムを変更できます。 + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit 構成 + +> Bukkit構成はPlazmaで提供される基本的な構成ファイルです。 Bukkit構成を使用すると、Minecraftサーバーの基本的なメカニズムを変更できます。 + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot 構成 + +> Spigot構成はゲームの詳細なメカニズム、プレイヤーの処理、コマンドなどの動作やメッセージを変更できます。 + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper 構成 + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish構成はPlazmaのワールドとエンティティの処理を変更できます。 + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur 構成 + +> Purpur属性はゲームの全体的な基本データを変更できます。 + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma 構成 + +> Plazma構成はPlazmaの機能をカスタマイズできます。 + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ja/origin/plazma/administration/reference/configurations/bukkit.md b/ja/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..72ceb60ef --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪣 Bukkit diff --git a/ja/origin/plazma/administration/reference/configurations/paper/README.md b/ja/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b5dcfdc14 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config フォルダー内の各ファイルの用途を調べてください。 +--- + +# 🛩️ Paper diff --git a/ja/origin/plazma/administration/reference/configurations/paper/global.md b/ja/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..0437f9948 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/ja/origin/plazma/administration/reference/configurations/paper/world.md b/ja/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..592036cad --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: paper-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 + +世界別 diff --git a/ja/origin/plazma/administration/reference/configurations/plazma/README.md b/ja/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e9606114a --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config フォルダー内の各ファイルの用途を調べてください。 +--- + +# ✨ プラズマ diff --git a/ja/origin/plazma/administration/reference/configurations/plazma/global.md b/ja/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..71f643b20 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 ノードが何を意味するかを調べてください。 +--- + +# 🌏 전역 구성 diff --git a/ja/origin/plazma/administration/reference/configurations/plazma/world.md b/ja/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..833845b94 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/ja/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ja/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/ja/origin/plazma/administration/reference/configurations/property.md b/ja/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..9f333da14 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.propertiesの各ノードが何を意味するか調べてください。 +--- + +# 🪨 Server.properties diff --git a/ja/origin/plazma/administration/reference/configurations/pufferfish.md b/ja/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..00faa1a96 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 フグ diff --git a/ja/origin/plazma/administration/reference/configurations/purpur/README.md b/ja/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd654c84c --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/ja/origin/plazma/administration/reference/configurations/purpur/global.md b/ja/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..fd93dd582 --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/ja/origin/plazma/administration/reference/configurations/purpur/world.md b/ja/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..bf3c65ddc --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/ja/origin/plazma/administration/reference/configurations/spigot.md b/ja/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..87b64d5db --- /dev/null +++ b/ja/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.ymlの各ノードが何を意味するかを調べてください。 +--- + +# 🚰 Spigot diff --git a/ja/origin/plazma/administration/reference/permissions.md b/ja/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..69382fa51 --- /dev/null +++ b/ja/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Plazmaの権限について調べてください。 +--- + +# 🛡️ 権限 + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **プレイヤー**\ + 一般的にすべてのプレイヤーに与えられる権限グループです。 +2. **調停者**\ + スポーン保護を無視することができます。 +3. **ワールド管理者**\ + ワールド管理に関連するすべてのコマンドとコマンドブロックを使用できます。\ + データパックおよびコマンドブロックにデフォルトで適用される権限グループです。 +4. **管理者**\ + プレイヤー管理に関連するすべてのコマンドを使用できます。 +5. **総管理者**\ + サーバー管理を含むすべてのコマンドを使用できます。\ + コンソールおよび管理者にデフォルトで適用される権限グループです。 + +*** + +## 권한 설정하기 + +*** + +## 全体の権限 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **デフォルト**: `なし` + +プレイヤーがエンティティに`しゃがんで相互作用`してエンティティに乗ることを許可します。 + +エンティティに乗ると、`移動キー`でエンティティの移動を操作でき、`ジャンプキー`でジャンプしたり飛べます。 + +`(Namespaced Key)`にはエンティティの[Namespaced ID](#user-content-fn-2)[^2]が入力されます。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **デフォルト**: `なし` + +プレイヤーがエンティティに乗っているとき、エンティティの特殊技能を使用できるようにします。 + +すべてのエンティティの特殊機能が利用可能というわけではありません。 利用可能な全ての特殊技術については以下を参照してください。 + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord)または[GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)にアイデアを投稿してください！ +{% endhint %} + +
+ +現在利用可能な特殊技術を見る + +- **`crepper`**\ + `ジャンプキー`を押すと爆発します。\ + プレイヤーが`allow.powered.creeper`権限を持っている場合、`ジャンプキー`を押し続けてチャージできます。 +- **`dolphin`**\ + `ジャンプキー`を押すと突進します。 +- **`phantom`**\ + `ジャンプキー`を押すと炎を発射します。 +- **`wither`**\ + `相互作用`するとウィザーの頭を発射します。 + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **デフォルト**: `ワールド管理者` + +[`/compass`コマンド](commands.md#compass)の使用を許可します。 + +#### `bukkit.command.credits` + +- **デフォルト**: `ワールド管理者` + +[`/credits (Player)`コマンド](commands.md#credits)の使用を許可します。 + +권한名の後に`.other`を入力すると他のプレイヤーに使用できるように許可します。 + +#### `bukkit.command.demo` + +- **デフォルト**: `ワールド管理者` + +[`/demo (Player)`コマンド](commands.md#demo)の使用を許可します。 + +권한名の後に`.other`を入力すると他のプレイヤーに使用できるように許可します。 + +#### `bukkit.command.ping` + +- **デフォルト**: `ワールド管理者` + +[`/ping (Player)`コマンド](commands.md#ping)の使用を許可します。 + +권한名の後に`.other`を入力すると他のプレイヤーに使用できるように許可します。 + +#### `bukkit.command.ram` + +- **デフォルト**: `ワールド管理者` + +[`/ram`コマンド](commands.md#ram)の使用を許可します。 + +#### `bukkit.command.rambar` + +- **デフォルト**: `ワールド管理者` + +[`/rambar (Player)`コマンド](commands.md#rambar)の使用を許可します。 + +권한名の後に`.other`を入力すると他のプレイヤーに使用できるように許可します。 + +#### `bukkit.command.restart` + +- **デフォルト**: `ワールド管理者` + +[`/restart`コマンド](commands.md#restart)の使用を許可します。 + +#### `bukkit.command.tps` + +- **デフォルト**: `ワールド管理者` + +[`/tps`コマンド](commands.md#tps)の使用を許可します。 + +#### `bukkit.command.tpsbar` + +- **デフォルト**: `ワールド管理者` + +[`/tpsbar (Player)`コマンド](commands.md#tpsbar)の使用を許可します。 + +권한名の後に`.other`を入力すると他のプレイヤーに使用できるように許可します。 + +#### `bukkit.command.timings` + +- **デフォルト**: `ワールド管理者` + +[`/timings`コマンド](commands.md#timings)の使用を許可します。 + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +類似の機能を持つコマンドについては、[Spark](https://spark.lucko.me/docs/Command-Usage)をご確認ください。 +{% endhint %} + +#### `bukkit.command.uptime` + +- **デフォルト**: `ワールド管理者` + +[`/uptime`コマンド](commands.md#uptime)の使用を許可します。 + +#### `minecraft.command.gamemode.(GameMode)` + +- **デフォルト**: `ワールド管理者` + +`/gamemode (GameMode) (Player)`コマンドの使用を許可します。 + +권한名の後に`.other`を入力すると他のプレイヤーに使用できるように許可します。 + +#### `paper.antixray.bypass` + +- **デフォルト**: `なし` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +これにより、両者ともパフォーマンスが向上します。 + +> X-Rayの設定方法については、以下のページを参照してください。 + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **デフォルト**: `なし` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **デフォルト**: `なし` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **デフォルト**: `なし` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **デフォルト**: `なし` + +金床で[MiniMessageタグ](https://docs.advntr.dev/minimessage/format.html)を使用できるようにします。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **デフォルト**: `なし` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **デフォルト**: `なし` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **デフォルト**: `なし` + +プレイヤーをアイドルキックの対象から除外します。 + +#### `purpur.debug.f3n` + +- **デフォルト**: `ワールド管理者` + +プレイヤーが`F3 + N`キーでゲームモードを変更できるようにします。 + +該当ゲームモードの権限がない場合は機能しません。 + +#### `purpur.drop.spawners` + +- **デフォルト**: `なし` + +構成で設定したアイテムでスポナーブロックを採掘するとスポナーブロックが落ちます。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **デフォルト**: `なし` + +エンダーチェストのサイズを変更します。 + +`(NumberString)`には`one`, `two`, `three`, `four`, `five`, `six`を入力できます。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **デフォルト**: `なし` + +不死のトーテムがインベントリにあっても機能するようにします。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **デフォルト**: `なし` + +プレイヤーが接続者数制限を無視するように許可します。 + +#### `purpur.mending_shift_click` + +- **デフォルト**: `なし` + +プレイヤーが`しゃがんで相互作用`すると、持っているアイテムを修理できるように許可します。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **デフォルト**: `なし` + +プレイヤーがスポナーを設置できるように許可します。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **デフォルト**: `なし` + +プレイヤーがネザーポータルを使用した際、直ちにテレポートします。 + +#### `purpur.sign.color` + +- **デフォルト**: `なし` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **デフォルト**: `なし` + +표지판에 난독화 코드`(&o)`를使用できるように許可します。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **デフォルト**: `なし` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **デフォルト**: `なし` + +プレイヤーがはさみで`相互作用`してTNTの爆発を防ぐことを許可します。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### 提供予定権限 + +#### `plazma.bypass.ncr-require` + +- **デフォルト**: `なし` + +プレイヤーが[`NoChatReports`](https://modrinth.com/mod/no-chat-reports)モードがインストールされていなくても接続できるように許可します。 + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: 例:`ender_dragon` diff --git a/ja/origin/plazma/adminstration/README.md b/ja/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..6b6cdd7f4 --- /dev/null +++ b/ja/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazmaを活用して独自のサーバーを作成してください。 +--- + +# ⚒️ サーバー管理ガイド diff --git a/ja/origin/plazma/adminstration/expert/README.md b/ja/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..b52e888b4 --- /dev/null +++ b/ja/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazmaを専門的に扱う方法について知ってください。 +--- + +# 🎓 深化 diff --git a/ja/origin/plazma/adminstration/expert/fix-exploits.md b/ja/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..c9862db12 --- /dev/null +++ b/ja/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 既知の脆弱性とその解決方法について調べてください。 +--- + +# ⚠️ 既知の脆弱性と解決方法 diff --git a/ja/origin/plazma/adminstration/expert/optimize.md b/ja/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..9808e5070 --- /dev/null +++ b/ja/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazmaの最適化方法を知ってください。 +--- + +# 🧹 最適化 diff --git a/ja/origin/plazma/adminstration/expert/vanillaize.md b/ja/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..73dab0249 --- /dev/null +++ b/ja/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper와 바닐라의 패치를 복원하는 방법에 대해 알아보세요. +--- + +# ↩️ 바닐라화 + +{% hint style="warning" %} + +### Paper는 바닐라의 오류를 해결하는 대부분의 패치에 선택지를 추가하고 있지 않습니다. + +현재 Plazma는 그러한 오류 해결을 구성으로 비활성화 할 수 있도록 개발하고 있습니다. + +따라서 아직 본 가이드는 작성중이며, 언제나 정보가 바뀔 가능성이 있습니다. +{% endhint %} diff --git a/ja/origin/plazma/adminstration/faq.md b/ja/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..ba9660618 --- /dev/null +++ b/ja/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: よくある質問をご覧ください。 +--- + +# ⁉️ よくある質問 + +{% hint style="info" %} + +### 回答が見つからない場合は？ + +[公式 Discord サーバー](https://discord.gg/MmfC52K8A8)または[GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)を通じてコミュニティに質問してみてください！ +{% endhint %} + +### メッセージが表示されて実行されない + +コンソールに `no main manifest attribute, in plazma-(version).jar` と表示された場合、 +ダウンロードしたファイルは開発用APIファイルであり、GitHubページから **Reobf Paperweight** をダウンロードする必要があります。 + +詳細は次のページをご参照ください。 + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### サーバーが起動するたびに警告が表示されます + +Plazmaには一部不安定なパッチが含まれており、常に誤動作の可能性があるため、サーバーが起動する際に次のような警告文を出力しています。 + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +この警告文は[`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] システムプロパティを使用して無効にすることができます。 + +詳細は次のページをご参照ください。 + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1から利用可能 diff --git a/ja/origin/plazma/adminstration/getting-started/README.md b/ja/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..39387d04d --- /dev/null +++ b/ja/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Plazmaでサーバーを作る方法を知ってください。 +--- + +# 👟 始める + +Plazmaを安定して使用するためには、システムが次の要件を満たしている必要があります。 + +| | 最低 | 推奨 | +| :-----: | --: | ---: | +| アーキテクチャ | x64 | - | +| RAM | 8GB | 16GB | +| 保存スペース | 1GB | 8GB | +| JRE | 17 | 21 | + +スムーズな構成ファイルの編集のために、[Visual Studio Code](https://code.visualstudio.com/download)などのエディタをインストールするのも良いでしょう。 + +*** + +## 1. JREのインストール + +名前からもわかるように、Minecraft: **"Java"** Edition はJavaで開発されており、実行するためにはJRE[^1]が必要です。 + +PlazmaはMojang Studiosの公式サーバープラットフォームを[基にしているため](#user-content-fn-2)[^2]、Plazmaを使用するためにもJREをインストールする必要があります。 + +### 1.1 JREの有無を確認 + +JREがシステムにインストールされているかどうかを確認するには、[実行ウィンドウ](#user-content-fn-3)[^3]に [`cmd /k java --version`](#user-content-fn-4)[^4]を入力して実行します。 + +以下のように出力された場合は、[2ステップ](setup.md#id-2)に進んでください。 + +{% code title="正しい出力" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +上記のように出力されない場合、または以下のように出力される場合は、JREがないか古すぎるため、[1.2ステップ](setup.md#id-1.2)を実行する必要があります。 + +{% code title="JREがインストールされていない" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JREが古すぎる" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JREのインストール + +本ガイドではJREの[種類の一つ](#user-content-fn-5)[^5]としてAzul Zuluを使用します。 + +インストールが完了した後、[1.1ステップ](setup.md#id-1.1)をもう一度実行してインストールが正しく完了したか確認してください。 + +{% tabs %} +{% tab title="Windows" %} + +1. まず、[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) から **JDK 21**を`.msi`形式でダウンロードします。 +2. ダウンロードしたインストーラーを実行し、`次へ`をクリックします。 +3. **ウィンドウの左中央に表示されるメニューから`Set JAVA_HOME variable`を有効にした後、**`次へ`をクリックします。 +4. `インストール`を押してJREのインストールを`完了`します。 + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) から **JDK 21**を`.dmg`形式のインストーラーをダウンロードし、JREをインストールします。 +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +まず、次のコマンドをターミナルで実行してAPTにAzul Zuluリポジトリを追加します。 + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +その後、次のコマンドをターミナルで実行してJREをインストールします。 + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +次のコマンドを入力してJREをインストールできます。 + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazmaのダウンロード + +Plazmaではさまざまな形式の実行ファイルが提供されています。 + +{% hint style="warning" %} + +### ほとんどの場合、`Reobf Paperclip`を使用します。 + +以下の内容は開発者または各形式の特性に興味がある方のためのものです。\ +一般ユーザーであれば[3ステップ](setup.md#id-3)にスキップしても問題ありません。 +{% endhint %} + +
+ +詳細を見る + +実行ファイルの名前は`plazma-(バージョン管理者)-1.20.4-R0.1-SNAPSHOT-(マッピング形式).jar`に決まります。 + +- **マッピング形式**\ + マッピングはMinecraftの実際のコードと難読化されたコードをつなぐ一種の地図です。 + - **Reobf**\ + Reobfuscation、Spigotマッピングとも呼ばれ、ほとんどのNMSプラグインで使用されます。\ + 1.20.5から使用が終了される予定です。 + - **Mojmap**\ + Mojangマッピング、バニラMinecraftマッピングです。 +- **バージョン管理者**\ + バージョン管理者はサーバー駆動に必要なライブラリと、サーバーファイルをパッチするサーバーのランチャーと言えます。 + - **Paperclip**\ + PaperMCチームがPaperおよび他の派生プラットフォームのために開発した管理者で、ライブラリをダウンロードし、サーバーにパッチを適用する役割を果たします。 + - **Bundler**\ + バニラMinecraftバージョン管理者です。 + +
+ +*** + +## 3. 開始スクリプトの作成 + +Plazmaを簡単に開始し、サーバーを自動的に再起動するには、[開始スクリプト](#user-content-fn-6)[^6]を作成する必要があります。 + +[Flags.sh](https://flags.sh)を通じて開始スクリプトを[生成できます。](#user-content-fn-7)[^7]\ +Plazmaに[使用するメモリ](#user-content-fn-8)[^8]だけ入力すれば、コマンドが自動的に最適化されます。 + +左下のダウンロードボタンをクリックして開始スクリプトをダウンロードできます。\ +**ダウンロードした開始スクリプトが自身のオペレーティングシステムと同じか確認してください。** + +*** + +## 4. ファイルの整理 + +今ダウンロードした開始スクリプトとPlazmaを新しいフォルダに移動します。 + +{% hint style="warning" %} + +### フォルダの名前は必ずスペースがなく、英語で設定されている必要があります。 + +そうでないと、PlazmaまたはJREが正しく動作しない可能性があります。 +{% endhint %} + +今、開始スクリプトを実行します。 Windowsの場合、ファイアウォール許可選択ウィンドウで、必ず **許可**を選択する必要があります。 + +*** + +## 5. EULA同意 + +開始スクリプトを一度実行すると、フォルダに`eula.txt`が作成されます。 + +EULA[^9]は[Mojang Studios](#user-content-fn-10)[^10]のサービスを利用することに同意する使用許諾契約です。 + +EULAに同意しない場合、サーバーを開始することができず、EULAに違反するとアカウントが停止されるなどの[制裁を受ける可能性があります。](#user-content-fn-11)[^11] + +EULAに同意するには、`eula.txt`ファイルの`eula=false`を`eula=true`に変更して保存してください。 + +*** + +## 6. 外部アクセスを許可 (Windows) + +現代のオペレーティングシステムは、外部からの危険なアクセスをブロックするために、基本的に**ファイアウォール**と**ルーター**が外部アクセスをブロックしています。 + +Windowsの場合、ファイアウォールは[3ステップ](setup.md#id-3)で許可したので、ポートフォワーディングだけすればよいです。 + +{% hint style="info" %} + +### このガイドでは、Windowsオペレーティングシステムおよび[**UPnP**](#user-content-fn-12)[^12]を使用できるルーターを前提として作成されています。 + +ルーターがUPnPをサポートしていない場合、ルーターごとにパネルが異なるため、直接情報を検索する必要があります。 + +または[Ngrok](https://ngrok.com/)を使用して一時的なアドレスを生成することもできます。 +{% endhint %} + +{% hint style="warning" %} + +### LinuxまたはmacOSなど（準）UNIX系オペレーティングシステムの場合、ファイアウォールサービスごとに設定方法が異なるため、直接情報を検索する必要があります。 + +{% endhint %} + +### 6.1 ポートフォワーディングの必要有無を確認 + +実行ウィンドウに以下のように入力して実行します。 + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +出力が`True`であれば、ここで終了しても構いませんが、`False`であればポートフォワーディングを設定する必要があります。 + +### 6.2 サーバーに接続 + +{% tabs %} +{% tab title="外部からの接続" %} +ポートフォワーディングが必要ないか、すでにポートフォワーディングに成功している場合は、これでサーバーに接続できます。 + +サーバーに接続する際に使用されるアドレスは[こちら](https://ip.pe.kr/)で確認できます。 +{% endtab %} + +{% tab title="UPnPでポートフォワーディングを試みる" %} +サーバーフォルダの`purpur.yml`で、`network.upnp-port-forwarding`を`true`に設定します。 + +その後、サーバーを再起動すると、Plazmaが自動的にポートフォワーディングを試みます。 + +以下はコンソールに出力されるメッセージに応じたUPnPの成功または失敗です。コンソールでは`[UPnP] (メッセージ)`のように出力されます。 + +| メッセージ | 意味 | +| -------------------------------- | -------------------- | +| `Successfully opened port (ポート)` | ポートフォワーディング成功。 | +| `Port (ポート) is already open` | 他のサービスがそのポートを使用中です。 | +| `Failed to open port (ポート)` | ポートフォワーディング失敗。 | +| `Service is unavailable` | ルーターがUPnPをサポートしていない。 | + +サーバーが終了するとPlazmaが自動的にポートを閉じます。 +{% endtab %} + +{% tab title="Ngrokで一時アドレスを作成" %} +Ngrokを利用する方法は、一時的なテスト、参加型または友達と一緒にプレイするのに便利です。 + +1. [Ngrokホームページ](https://ngrok.com/download)から`Windows (64-bit)`ZIPファイルをダウンロードします。 +2. ダウンロードしたNgrokをサーバーフォルダに入れます。 +3. [Ngrokダッシュボード](https://dashboard.ngrok.com/get-started/your-authtoken)から[認証トークンを生成](#user-content-fn-13)[^13]します。 +4. サーバーフォルダで以下の`Command Line`に表示されるコマンドを実行します。 +5. 実行スクリプト最上部に`start /b ngrok tcp --region jp 25565`、最下部に`taskkill /f /t /im ngrok.exe`を追加します。 +6. コンソール最上部に表示される`Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`から、`0.tcp.jp.ngrok.io:12345`がサーバーのアドレスになります。 +7. これで外部からそのアドレスを介して接続できます。 + {% endtab %} + +{% tab title="ローカルからの接続" %} +ローカルからサーバーに接続しようとする場合、実行ウィンドウで`cmd /k ipconfig`を実行して出力された`IPv4アドレス`で接続できます。 + +例えば、コマンド実行後に次のように出力された場合、 + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +ここでIPv4アドレスに表示された`192.168.3.7`で接続を試みると、ローカルからサーバーに接続できます。 + +サーバーとゲームが同じPCで実行される場合、`localhost`で接続できます。 +{% endtab %} +{% endtabs %} + +## 7. 発展段階 + +サーバーを成功裏に起動し、サーバーが正常に動作している場合は、これでサーバーをカスタマイズする番です。 + +以下のガイドを通じてサーバーをカスタマイズする方法について知ってください。 + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment、Java実行環境。 + +[^2]: PlazmaのベースであるPaperはSpigotをベースにしており、Spigotは公式サーバープラットフォームをベースにしています。 + +[^3]: Windowsキー + R + +[^4]: Linuxの場合ターミナルで`java --version` + +[^5]: JREはオープンソースプロジェクトの1つで、Minecraftサーバープラットフォームのようにさまざまな種類があります。 + +[^6]: 一般的に**ランタイム**として知られています。 + +[^7]: "Auto-restart"を有効にすると、サーバーが自動的に再起動されます。 `Control + C`を入力して終了できます。 + +[^8]: システムの半分以上を超えることは推奨されません。 + + 例えば、システム全体のメモリ容量が8GBの場合、4GB以上に設定することは推奨されません。 + +[^9]: End-User License Agreement、最終ユーザーライセンス契約。 詳細は[Minecraftホームページ](https://www.minecraft.net/ko-kr/usage-guidelines)をご確認ください。 + +[^10]: Microsoft Corporation。 + +[^11]: 韓国の場合、ゲーム産業振興に関する法律第32条第1項第9号に基づき**韓国マイクロソフト株式会社**から法的訴訟を行うことができます。 + +[^12]: Universal Plug & Play。 Plazmaに含まれるPurpurはこの技術を介して自動的にルーターと通信し、サーバーが実行中のみポートを開くため、ポートフォワーディングを直接行う必要はありません。 + +[^13]: アカウントがない場合はGoogleまたはGitHubアカウントを使用してNgrokにサインアップします。 diff --git a/ja/origin/plazma/adminstration/getting-started/customization.md b/ja/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..062e147f9 --- /dev/null +++ b/ja/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: サーバーをカスタマイズする方法について学びましょう。 +--- + +# 🎨 ユーザー定義 diff --git a/ja/origin/plazma/adminstration/reference/arguments.md b/ja/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..5771704cc --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 開始引数とシステム属性について調べてください。 +--- + +# 🎛️ 引数と属性 + +開始変数とシステム属性はPlazmaの実行に使用される[コマンド](#user-content-fn-1)[^1]に追加される値であり、\ +Plazmaが実行された後に変更できない値を変更できるようにします。 + +[コマンドに追加される位置に](#user-content-fn-2)[^2]よって **開始引数** と **システム属性** に分かれます。 + +*** + +## システム属性 + +システム属性は`-jar`の前に入力され、Plazmaが初期化される前にJVMで処理される値です。 + +{% hint style="warning" %} + +### システム属性を変更すると、PlazmaやJVMの動作が変更される可能性があり、ゲームに大きな影響を与える可能性があります！ + +各システム属性がどのような役割を果たしているか確実に知らない場合、**絶対に使用しないでください！** +{% endhint %} + +### 使用方法 + +システム属性は`java`と`-jar`の間にJavaコマンド引数として入力されます。 + +例えば、`Plazma.dummyProperty`システム属性を適用しようとする場合、\ +次のように入力すると次の属性に`37`が入力され、Plazmaが初期化されます。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`はその引数がJVMに組み込まれず、Plazmaに追加された専用の引数であることを示し、 + +属性に何の値も入力しない場合、値は[`true`で固定されます。](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight系サーバープラットフォームは各プラットフォームごとにシステム属性を区別するために属性名に`.`を含んでいます。 + +Windows Powershellなど一部のターミナルではこのような引数を許可しない場合があるため、引数の両端に`"`を[追加する必要があります。](#user-content-fn-4)[^4] +{% endhint %} + +### 全システム属性 + +#### `convertLegacySigns` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +使用中止された看板フォーマットを更新します。 + +#### `debug.entities` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +エンティティ情報に関連するデバッグログを有効にします。 + +#### `debug.rewriteForIDE` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +IDEでデバッグ情報を正しく読み込めるようにNMSリビジョンを無効化し、\ +内部バージョン情報を自動的にリマップします。 + +#### `disable.watchdog` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +SpigotのWatchdog警告システムを無効化します。 + +#### `letMeReload` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +`/reload`コマンドの再確認メッセージを無効化します。 + +{% hint style="danger" %} + +### `/reload`コマンドは非常に不安定ですので、`/reload`使用後に発生するサーバー内のすべての問題はユーザー自身の責任です。 + +プラグイン開発者でプラグインを更新する必要がある場合は、`/reload`の代わりにホットスワップを使用してください。 +{% endhint %} + +#### `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個のプラグインチャンネル[^5]の数の制限を無効にします。 + +#### `Paper.disableClassPrioritization` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +プラグインクラスの優先順位システムを無効にします。 + +プラグインシェードで問題が発生した場合に役立ちます。 + +#### `Paper.disableFlushConsolidate` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +Nettyフラッシュ統合システムを無効にします。 + +#### `Paper.excessiveTELimit` + +- **形式**: `Integer` +- **デフォルト値**: `750` + +エンティティが設定された値より多い場合は、複数パケットに分割して送信します。 + +#### `Paper.filterThreshold` + +- **形式**: `Integer` +- **デフォルト値**: `8192` + +サーバーが一度に受け取ることができる最大パケットのサイズを設定します。 + +#### `Paper.ignoreJavaVersion` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +Javaバージョンの確認を無効にします。 + +{% hint style="danger" %} + +### これにより、JVMが存在しないコードにアクセスしようとすることができます！ + +ワールドなど全体のファイルが永続的に破損する可能性があり、ゲームの全体的なメカニズムが破壊されます。 + +これを使用して発生したすべての問題はユーザーが責任を負い、Plamzaはこれに関するいかなるサポートも提供しません。 +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **形式**: `Integer` +- **デフォルト値**: `64` + +プラグインチャンネル[^6]の名前の制限を設定します。 + +#### `Paper.maxSignLength` + +- **形式**: `Integer` +- **デフォルト値**: `80` + +看板の1行に入力できる文字の最大長を設定します。 + +#### `Paper.minPrecachedDatafixVersion` + +- **形式**: `Integer` +- **デフォルト値**: `(ワールドバージョン) + 1` + +最初に初期化するワールド更新情報のバージョンを設定します。 + +大量のチャンクを更新する必要がある場合に便利ですが、それ以外の場合は使用されません。 + +#### `Paper.parseYamlCommentsByDefault` + +- **形式**: `Boolean` +- **デフォルト値**: `True` + +YAMLファイルのコメントの処理を有効にします。 + +#### `Paper.playerConnection.keepAlive` + +- **形式**: `Integer` +- **デフォルト値**: `30` + +プレイヤーから入力された値(秒)だけデータを受信しなかった場合、プレイヤーを追放します。 + +通常、ゲーム[^7]はサーバーに継続的に[心拍信号](#user-content-fn-8)[^8]を送信するため、[追放されませんが、](#user-content-fn-9)[^9]ゲームが応答しない場合、ゲームがクラッシュしたと見なしてサーバーでプレイヤーを処理しなくなります。 + +#### `Paper.skipServerPropertiesComments` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +サーバー属性のコメントを無視します。 + +#### `Paper.debug-sync-loads` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +同期チャンク作成のデバッグログを有効にします。 + +#### `Paper.enable-sync-chunk-writes` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +Minecraftの[デフォルトチャンク作成システム](#user-content-fn-10)[^10]を有効にします。 + +これは各チャンクを順番に保存するため、著しいパフォーマンス低下を引き起こします。 + +#### `Paper.explicit-flush` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +ネットワークチャンネルの明示的なフラッシングを有効にします。 + +#### `Paper.strict-thread-checks` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +メインスレッドで発生しないエラーを常にログに記録します。 + +#### `Paper.tickList-warn-on-excessive-delay` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +予約されたタスクが過度の遅延を持つ場合、警告を出力します。 + +#### `Paperclip.patchOnly` + +- **形式**: `Boolean` +- **デフォルト値**: `False` + +デフォルトで提供される実行ファイルを使用する場合、サーバーを起動せずにパッチのみを適用します。 + +#### `Plazma.aggressiveOptimize` + +- **形式**: `Boolean` +- **デフォルト値**: `false` + +{% hint style="warning" %} + +### この属性は1.20.5以降、開始引数に移動する予定です。 + +{% endhint %} + +初めて開始時に適用される構成最適化をより厳格に適用します。 + +활성화 하면 서버가 더욱 빨라지고 安全になりますが、一部のミスをブロックしたりゲームプレイに大きな影響を与える可能性があります。 + +#### `Plazma.iKnowWhatIAmDoing` + +- **形式**: `Boolean` +- **デフォルト値**: `false` + +Plazmaが初期化される際に表示される警告文[^11]を抑制します。 + +### 廃止された属性 + +以下のシステム属性は廃止されたものです。 + +#### `timings.bypassMax` + +- **形式**: `Boolean` +- **デフォルト値**: `false` +- **廃止**: TimingsがPlazmaから完全に削除されてから + +AikarのTimings APIに送信できる値の最大値を超えてもよいかどうかを決定します。 + +これを行ってもAPIで例外処理されない場合はレート制限が適用されます。 + +*** + +## 開始引数 + +開始引数は`-jar *.jar`の後に入力され、Plazmaが初期化される際に一緒に処理される値です。 + +### 使用方法 + +システム属性は`-jar *.jar`の後にプログラムのコマンド引数として入力されます。 + +例えば、`nogui`開始引数を適用しようとする場合、\ +次のように入力するとPlazmaが初期化中に`nogui`引数を処理することになります。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 全体の開始引数 + +#### `bukkit-settings` + +- **エイリアス**: `b` +- **デフォルト**: `bukkit.yml` + +[Bukkit構成ファイル](../reference/configurations/bukkit.md)の名前と位置を設定します。 + +#### `command-settings` + +- **エイリアス**: `c` +- **デフォルト**: `commands.yml` + +[Bukkitコマンド構成ファイル](../reference/configurations/bukkit.md)の名前と位置を設定します。 + +#### `config` + +- **エイリアス**: `c` +- **デフォルト**: `server.properties` + +[サーバー属性](../reference/configurations/property.md)ファイルの名前と位置を設定します。 + +#### `demo` + +デモワールドでサーバーを起動します。 + +#### `eraseCache` + +ワールドアップグレード後に残ったキャッシュファイルを削除します。 + +#### `forceUpgrade` + +バージョンを無視してワールドを強制的に[アップグレード](#user-content-fn-12)[^12]します。 + +#### `help` + +- **エイリアス**: `?` + +Plazmaの全体の開始引数と説明を出力します。 + +#### `initSettings` + +構成ファイルのみを生成してサーバーを終了します。 + +#### `jfrProfile` + +JFRプロファイリングを有効化します。 + +#### `max-players` + +- **エイリアス**: `s`, `size` +- **デフォルト**: `(サーバー属性)` + +許容される最大[プレイヤー](#user-content-fn-14)[^14]数を設定します。 + +#### `nogui` + +グラフィックインターフェースパネルを無効化します。 + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을使用します。 + +#### `online-mode` + +- **별칭**: `o` +- **デフォルト**: `(サーバー属性)` + +Mojang 인증 서버로 플레이어를 검증할지 선택します。 + +**Velocity 등 프록시를 사용하는 것이 아닌 경우 [EULA](../getting-started/README.md#id-5) 위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본值**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용이 중지되었습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다。 + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며、その後には使用されません。 + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본值**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)が位置するフォルダの名前と位置を設定します。 + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)が位置するフォルダの名前と位置を設定します。 + +#### `plugins` + +- **별칭**: `p` +- **기본值**: `plugins` + +プラグインフォルダの位置を設定します。 + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본值**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)の名前と位置を設定します。 + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본値**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)の名前と位置を設定します。 + +#### `safeMode` + +(セーフモード) 完全なバニラ状態でサーバーを起動します。 + +#### `server-ip` + +- **별칭**: `h`, `host` +- **デフォルト**: `(サーバー属性)` + +サーバーのホスト名または[インターネットプロトコル](#user-content-fn-13)[^13]アドレスを設定します。 + +#### `server-port` + +- **별칭**: `p`, `port` +- **デフォルト**: `(サーバー属性)` + +サーバーのポートを設定します。 + +#### `server-name` + +- **基本値**: `A Plazma Server` + +サーバーの名前を設定します。 + +#### `spigot-settings` + +- **별칭**: `S` +- **基本値**: `spigot.yml` + +[Spigot構成ファイル](../reference/configurations/spigot.md)の名前と位置を設定します。 + +#### `version` + +- **별칭**: `v` + +Plazmaバージョンを出力します。 + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **基本値**: `(サーバーフォルダ)` + +ワールドファイルが保存される位置を設定します。 + +#### `world-name` + +- **별칭**: `w`, `world` +- **デフォルト**: `(サーバー属性)` + +ワールドファイルの名前を設定します。 + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 追加された場所に応じて引数の処理位置が変更されます。 + +[^3]: たとえば、`Plazma.iKnowWhatIAmDoing`を`true`に設定(有効化)したい場合、`-DPlazma.iKnowWhatIAmDoing=true`ではなく`-DPlazma.iKnowWhatIAmDoing`だけを入力しても同様に機能します。 + +[^4]: たとえば、`"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: イベント検出器。 + +[^6]: イベント検出器。 + +[^7]: クライアント。 + +[^8]: 心拍のようにサーバーと正常に接続されていることを知らせる信号。 + +[^9]: PurpurのAFKキック機能を使用すると、離席中のプレイヤーもキックできます。 + +[^10]: 同期チャンク書き込みシステム、Sync Chunk Write System。 + +[^11]: `WARNING! Plazmaには予期せぬ問題が発生する可能性があるため、公開サーバーで使用する前に十分にテストしてください。` + +[^12]: ゲームで`ワールド最適化`も同じ原理で動作します。 + +[^13]: Internet Protocol, IP。 + +[^14]: `レベル 2`以上の管理者は除外します。 diff --git a/ja/origin/plazma/adminstration/reference/commands.md b/ja/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..3e5565ed1 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazmaで利用可能なコマンドについて調べてください。 +--- + +# 🖥️ コマンド diff --git a/ja/origin/plazma/adminstration/reference/configurations/bukkit.md b/ja/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..72ceb60ef --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪣 Bukkit diff --git a/ja/origin/plazma/adminstration/reference/configurations/paper/README.md b/ja/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b5dcfdc14 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config フォルダー内の各ファイルの用途を調べてください。 +--- + +# 🛩️ Paper diff --git a/ja/origin/plazma/adminstration/reference/configurations/paper/global.md b/ja/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..197a42e45 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🛩️ ペーパー（グローバル構成） diff --git a/ja/origin/plazma/adminstration/reference/configurations/paper/world.md b/ja/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f5f0b0e2a --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: paper-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🛩️ Paper (ワールドごとの構成) diff --git a/ja/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ja/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e9606114a --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config フォルダー内の各ファイルの用途を調べてください。 +--- + +# ✨ プラズマ diff --git a/ja/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ja/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..71cd33322 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 ノードが何を意味するかを調べてください。 +--- + +# ✨ Plazma (グローバル構成) diff --git a/ja/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ja/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..ba43ab0b0 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ 世界ごとの構成 diff --git a/ja/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ja/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/ja/origin/plazma/adminstration/reference/configurations/property.md b/ja/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..9f333da14 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.propertiesの各ノードが何を意味するか調べてください。 +--- + +# 🪨 Server.properties diff --git a/ja/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ja/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..00faa1a96 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 フグ diff --git a/ja/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ja/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd654c84c --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/ja/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ja/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..39f0af15d --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 パープル（グローバル構成） diff --git a/ja/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ja/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..503a69d70 --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 パープル（ワールド別構成） diff --git a/ja/origin/plazma/adminstration/reference/configurations/spigot.md b/ja/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..87b64d5db --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.ymlの各ノードが何を意味するかを調べてください。 +--- + +# 🚰 Spigot diff --git a/ja/origin/plazma/adminstration/reference/permissions.md b/ja/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..7bcbf936d --- /dev/null +++ b/ja/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Plazmaの権限について調べてください。 +--- + +# 🛡️ 権限 diff --git a/ja/origin/plazma/developers.md b/ja/origin/plazma/developers.md new file mode 100644 index 000000000..b4e73ac89 --- /dev/null +++ b/ja/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Plazmaを活用してサードパーティプロジェクトを開発してください。 +--- + +# ⚙️ 開発者ガイド diff --git a/ja/origin/thunderbolt/README.md b/ja/origin/thunderbolt/README.md new file mode 100644 index 000000000..0f9ef1b00 --- /dev/null +++ b/ja/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 패치를 Flavor로 구분하여 직접 사용해볼 수 있도록 하는 Plazma 기반 서버 플랫폼입니다. +--- + +# 🌩️ サンダーボルトの使用ガイド diff --git a/ja/origin/volt/README.md b/ja/origin/volt/README.md new file mode 100644 index 000000000..19dd5567b --- /dev/null +++ b/ja/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Paperweight 서버 플랫폼을 개발할 수 있는 오픈 소스 템플릿입니다. +--- + +# ⚡ Volt 開発ガイド diff --git a/lol/origin/README.md b/lol/origin/README.md new file mode 100644 index 000000000..a96e42886 --- /dev/null +++ b/lol/origin/README.md @@ -0,0 +1,41 @@ +--- +description: 질문이 있다면 Discord 또는 GitHub Discussions를 통해 질문해 주세요. +--- + +# 🏠 Welcome to Docs Portal + +{% hint style="info" %} + +**Plazma의 문서는 현재 기계 번역된 상태입니다.** + +[![Translation Status](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) 에서 문서 번역에 참여하여 문서를 개선해 보세요. + +{% endhint %} + +### Plazma 사용 중 문제가 생겼다면? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderbolt에 대해 관심이 있다면? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` 더 많은 Minecraft 관련 정보가 필요하다면? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/lol/origin/SUMMARY.md b/lol/origin/SUMMARY.md new file mode 100644 index 000000000..0c4d8016b --- /dev/null +++ b/lol/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Taybul ov kontents + +- [🏠 Welcum 2 Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Usage Docs](plazma/README.md) +- [❓ Plazma란?](plazma/about/README.md) + - [⬇️ Downlode](plazma/about/downloads.md) + - [✅ Vurshun Suppurt Status](plazma/about/supported-versions.md) +- [⚒️ 서버 관리 가이드](plazma/administration/README.md) + - [👟 시작하기](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 REEFURRUNZ](plazma/administration/reference/README.md) + - [🖥️ MUNYURZ](plazma/administration/reference/commands.md) + - [🛡️ KWONZ](plazma/administration/reference/permissions.md) + - [🎛️ EENSOO WAA SOOKSHUNZ](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 BUKKIT](plazma/administration/reference/configurations/bukkit.md) + - [🚰 SPIGOT](plazma/administration/reference/configurations/spigot.md) + - [🛩️ PAPUR](plazma/administration/reference/configurations/paper/README.md) + - [🌏 JEON-YUK GOOTSYEON](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ WURLD SETTINZ](plazma/administration/reference/configurations/paper/world.md) + - [🐡 PUFFURFISH](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 PURPUR](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 JEON-YUK GOOTSYEON](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ WURLD SETTINZ](plazma/administration/reference/configurations/purpur/world.md) + - [✨ PLAZMA](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 JEON-YUK GOOTSYEON](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ WURLD SETTINZ](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 SHEEMWAH](plazma/administration/expert/README.md) + - [🧹 CHOYZHEEPZ](plazma/administration/expert/optimize.md) + - [🔀 프록시](plazma/administration/expert/proxy.md) + - [↩️ BAHDEENYAHWAH](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray 차단](plazma/administration/expert/xray.md) + - [⚠️ KEEYOHNJUNZ AN HAYSHUL BAHNAM](plazma/administration/expert/fix-exploits.md) + - [⁉️ JAHZHOO MOOTKEEN JILKEUN](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Developerz Guide](plazma/developers.md) + - [✏️ Contriboot](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thundrbolt + +- [🌩️ Thundrbolt Usage Guide](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Development Guide](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ DAHNLOHD JEON-YUKBOGEE](plazma/about/downloads-all.md) diff --git a/lol/origin/miscellaneous/README.md b/lol/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/lol/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/lol/origin/plazma/README.md b/lol/origin/plazma/README.md new file mode 100644 index 000000000..6faeb21e8 --- /dev/null +++ b/lol/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma haz Paper 기반의 실험적 최적화와 여러 게임 메커니즘 사용자화 기능을 추가한 Minecraft: Java Edition용 오픈 소스 서버 플랫폼입니다." +--- + +# ✨ Plazma Usage Docs + +## 👋 Welcome to Plazma Docs + +Plazma 사용 설명서에 방문하신 것을 환영합니다! + +{% hint style="info" %} + +**Iz u can't fix problemz thru manualz?** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! + +{% endhint %} + +### About Plazma + +> Plazma haz 어떤 서버 플랫폼인지 알아보세요. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### For Administrators + +> Plazma를 활용하여 자신만의 서버를 만들어 보세요. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### For Developers + +> Plazma를 활용하여 서드파티 프로젝트를 개발해 보세요. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/lol/origin/plazma/about/README.md b/lol/origin/plazma/about/README.md new file mode 100644 index 000000000..3363512a2 --- /dev/null +++ b/lol/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Plazma haz 어떤 서버 플랫폼인지 알아보세요. +--- + +# ❓ Plazma란? + +- **Plazma**는 [Andromeda](https://github.com/EarendelArchived/Andromeda)와 [Fusion](https://github.com/RuinedTechnologyUnify/Fusion)에서 장점만을 가져온 [Paper](https://github.com/PaperMC/Paper) 기반의 서버 플랫폼 입니다. +- 항상 높은 안정성과 강력한 성능, 빠른 업데이트, 방대한 기능을 제공하기 위하여 노력하고 있습니다. + +## 📋 Plazma의 목표 + +- 빠른 업데이트, 높은 안정성을 가진 서버 플랫폼이 되기 위해 노력하고 있습니다. +- 모드 플랫폼 못지 않은 방대한 기능과 강력한 성능을 제공하기 위해 노력하고 있습니다. +- 바닐라의 패치도 사용자화 할 수 있는 자유로운 플랫폼을 만들기 위해 노력하고 있습니다. + +## ⚙️ 주요 특징 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **가장 빠른 업데이트**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)는 Plazma의 포함 패치가 항상 최신으로 유지될 수 있도록 해서, Paper 기반 서버 플랫폼 중에서 가장 빠른 업데이트를 제공하고 있습니다. +6. **기본 구성 파일 최적화**\ + 기본 적용되는 구성 파일이 최적화되어 있어, 직접 구성 파일을 최적화 하지 않아도 됩니다. +7. **체계적으로 작동하는 멀티스레드**\ + 게임의 메커니즘과 관계 없는 시스템 메커니즘을 비동기화 하여, [지연 시간](#user-content-fn-4)[^4]을 줄여 서버를 최적화 합니다. +8. **불필요한 공간의 사용 차단**\ + 비슷한 값을 가진 데이터를 모두 하나로 합쳐 메모리 사용량을 줄입니다. + +## ✨ 활용 사례 + +- **HANDLIN COMPLEX PLUG-INZ RIGHT**\ + USED ON Plazma SERVER BY DEVELOPER [IPECTER](https://github.com/IPECTER).\ + SELF PLUG-INZ OPERATIN WITH NMS AND REFLECTION, EXTENSIVE DATA PACKZ APPLIED,\ + ACCEPTIN 100+ PLAYERZ WITHOUT PERFORMANCE DROP. +- **MAINTAININ FAST PERFORMANCE ON RPG SERVERZ**\ + SUSTAINED STABLE TPS FOR 100 PLAYERZ ON SINGLE CLUSTER,\ + 250 PLAYERZ PLAYIN SMOOTHLY ACROSS 4 CLUSTERZ. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **MANY STREAMERZ HAS CHOSEN DA PLATFORM**\ + MANY STREAMERZ PEEPS R USIN' DIS AS DA BUCKET FER VIEWER PARTICIPATION. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ 다운로드 + +아래 페이지에서 Plazma를 다운로드 할 수 있습니다. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### 버전 지원에 대한 자세한 정보를 알고 싶다면? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot 플러그인 및 Paper, Pufferfish, Purpur 플러그인. + +[^2]: 이하 Microsoft Corporation. + +[^3]: 채팅 신고 시스템을 비활성화 하면 채팅이 온전히 서버에서만 처리되어 Mojang의 채팅 추적을 막을 수 있습니다. + +[^4]: 시스템 메커니즘이 작동하기 위해 잠시 동안 게임이 멈추는 시간. diff --git a/lol/origin/plazma/about/downloads-all.md b/lol/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..06365734c --- /dev/null +++ b/lol/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma 실행 파일 다운로드 전체보기 +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| vershun | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/lol/origin/plazma/about/downloads.md b/lol/origin/plazma/about/downloads.md new file mode 100644 index 000000000..8d5391943 --- /dev/null +++ b/lol/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Nao downloadz Plazma rite meow n try it out fur yourself. +--- + +# ⬇️ 다운로드 + +#### 버전 지원에 대한 자세한 정보를 알고 싶다면? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**아래 다운로드는 일반 사용자용 실행 파일입니다.** + +개발자이고, 다른 형태의 파일이 필요하다면, 아래 페이지를 참고하세요. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
vershundownloadz
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/lol/origin/plazma/about/patches-list.md b/lol/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..588d3f680 --- /dev/null +++ b/lol/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Plazma에 추가된 모든 기능에 대해 알아보세요. +--- + +# 📑 포함된 패치 diff --git a/lol/origin/plazma/about/supported-versions.md b/lol/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..c4c67acd9 --- /dev/null +++ b/lol/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Plazma에서 지원하는 Minecraft: Java Edition 버전을 알아보세요." +--- + +# ✅ 버전 지원 상태 + +{% hint style="info" %} + +**Plazma iz 1.19.4 aftur development, versions under 1.19.4 not bein' developed.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/정보%20없음 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| vershun | 안정성 및 기능 지원 | 빌드 상태 | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://bedj.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/lol/origin/plazma/administration/README.md b/lol/origin/plazma/administration/README.md new file mode 100644 index 000000000..06d085a5a --- /dev/null +++ b/lol/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 활용하여 자신만의 서버를 만들어 보세요. +--- + +# ⚒️ 서버 관리 가이드 diff --git a/lol/origin/plazma/administration/diagnosis/README.md b/lol/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..46c2e1bac --- /dev/null +++ b/lol/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: PROBLEMZ GOT HAPPENED, FIND OUT HOW TO DEAL WIF DEM. +--- + +# 🧾 진단 diff --git a/lol/origin/plazma/administration/diagnosis/plugins.md b/lol/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..0e15380e0 --- /dev/null +++ b/lol/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: PLUGZ IZ NOT WERKIN PROPA, FIND A WAY TO FIX IT. +--- + +# 📜 플러그인 diff --git a/lol/origin/plazma/administration/expert/README.md b/lol/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..684276f31 --- /dev/null +++ b/lol/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 전문적으로 다루는 방법에 대해 알아보세요. +--- + +# 🎓 심화 diff --git a/lol/origin/plazma/administration/expert/fix-exploits.md b/lol/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..c2f7e35f4 --- /dev/null +++ b/lol/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Alowd, findin' vulnerabiliteez an' fixin' dem wif style. +--- + +# ⚠️ Alowd, findin' vulnerabiliteez an' fixin' dem wif style diff --git a/lol/origin/plazma/administration/expert/optimize.md b/lol/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..fb072e183 --- /dev/null +++ b/lol/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 최적화 하는 방법을 알아보세요. +--- + +# 🧹 최적화 diff --git a/lol/origin/plazma/administration/expert/proxy.md b/lol/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..640dda86d --- /dev/null +++ b/lol/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: 프록시 플랫폼 "Velocity"를 안전하게 구성하는 방법에 대해 알아보세요. +--- + +# 🔀 프록시 diff --git a/lol/origin/plazma/administration/expert/vanillaize.md b/lol/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..1fd2fba86 --- /dev/null +++ b/lol/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper와 바닐라의 패치를 복원하는 방법에 대해 알아보세요. +--- + +# ↩️ 바닐라화 + +{% hint style="warning" %} + +**Paper haz no addin optionz in most patchez fixin vanilla errorz.** + +현재 Plazma는 그러한 오류 해결을 구성으로 비활성화 할 수 있도록 개발하고 있습니다. + +따라서 아직 본 가이드는 작성중이며, 언제나 정보가 바뀔 가능성이 있습니다. + +{% endhint %} diff --git a/lol/origin/plazma/administration/expert/xray.md b/lol/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..2bd0fe2df --- /dev/null +++ b/lol/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray를 차단하는 여러 가지 내장된 방법에 대해 알아보세요. +--- + +# 🩻 X-Ray 차단 diff --git a/lol/origin/plazma/administration/faq.md b/lol/origin/plazma/administration/faq.md new file mode 100644 index 000000000..e7e1d14e4 --- /dev/null +++ b/lol/origin/plazma/administration/faq.md @@ -0,0 +1,43 @@ +--- +description: Jazzu luvvz FAQz, find out moar. +--- + +# ⁉️ Jazzu luvvz FAQz + +{% hint style="info" %} + +**WONNEUN DAPBEON EUL CHAJEUL SU EOBNAYO?** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! + +{% endhint %} + +### Plazma haz startd nt werkin + +If console sez `no main manifest attribute, in plazma-(version).jar`, da file yoo downloadz be dev API file, yoo needz to download **Reobf Paperweight** frum GitHub page. + +Check dis page fur moar info. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Warningz show up every time da server startz + +Plazma haz sum unstable patchez, it can act weird, so it displayz warningz when da server startz like dis: + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +U can disable dis warnin' message wif [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +Check dis page fur moar info. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available frum 1.20.1 diff --git a/lol/origin/plazma/administration/getting-started/README.md b/lol/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..f219e0881 --- /dev/null +++ b/lol/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Plazma로 서버를 만드는 방법을 알아 보세요. +--- + +# 👟 시작하기 + +Plazma를 안정적으로 사용하기 위해선, 시스템이 다음과 같은 요구 사항을 충족해야 합니다. + +| | 최저 | 권장 | +| :--: | --- | ---- | +| 아키텍쳐 | x64 | - | +| RAM | 8GB | 16GB | +| 저장공간 | 1GB | 8GB | +| JDK | 17 | 21 | + +원할한 구성 파일 수정을 위하여, [Visual Studio Code](https://code.visualstudio.com/download)등의 편집기를 설치하는것도 좋습니다. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="OH RITE OUTPUT" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' iz not an internal or external command, program, or batch file. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP configuration + +Ethernet adapter Ethernet: + + Connection-specific DNS Suffix. . . . . . . : + IPv4 Address. . . . . . . . . . . . . . . : 192.168.3.7 + Subnet Mask. . . . . . . . . . . . . . . : 255.255.255.0 + Default Gateway . . . . . . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전하기 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 설명서를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Microsoft Corporation. + +[^11]: 대한민국의 경우 게임산업진흥에 관한 법률 제32조 제1항 제9호에 따라 **한국 마이크로스프트 주식회사**에서 법적 고소를 할 수 있습니다. + +[^12]: Universal Plug & Play. Plazma에 포함된 Purpur가 이 기술을 통해 자동으로 라우터와 통신하여 서버가 실행 중일 때만 포트를 열기 때문에, 포트 포워딩을 직접 할 필요가 없습니다. + +[^13]: 계정이 없는 경우 Google 또는 GitHub 계정을 통해 Ngrok에 가입합니다. diff --git a/lol/origin/plazma/administration/getting-started/customization.md b/lol/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..c4a5d41ab --- /dev/null +++ b/lol/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: 서버를 사용자화하는 방법에 대해 알아보세요. +--- + +# 🎨 사용자화 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 +Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 +**사용자화**가 가능하다는 점이 가장 클 것입니다. + +아래는 Plazma를 사용자화하고 활용하는 여러 방법입니다. + +## 구성 수정 + +Plazma를 사용자화 하는 가장 기본적인 방법은 바로 구성을 수정하는 것입니다. + +Plazma는 게임의 메커니즘부터 몹의 속성 등 강력한 구성 설정을 제공하고 있습니다. + +Plazma의 구성에 대한 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## 플러그인 사용 + +{% hint style="success" %} + +**Plazma haz Paper 기반의 allz 플러그인을 supportz.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 somez 동작하지 않을 수 있지만, +Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 mostz 플러그인은 Plazma에서도 +allz 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 errorz이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 strongestz 방법입니다. +Plazma의 strongestz 플러그인 생태계는 서버를 easilyz 사용자화 할 수 있게 합니다. + +플러그인을 찾고 downloadz 하는데에는 severalz 방법이 있습니다. 어떤 플러그인은 +openz 저장소 서비스에 플러그인을 uploadz 하고, 어떤 플러그인은 GitHub 또는 selfz +site에 uploadz하기도 합니다. + +{% hint style="caution" %} + +**플러그인은 system에 directlyz access할 수 있습니다!** + +VirusTotal 등의 service를 이용하여 플러그인을 applyz하기 전 alwaysz safez지 확인하거나, +trustworthyz service에서 플러그인을 downloadz 하세요. + +{% endhint %} + +플러그인을 downloadz하기 위해 use되는 service에는 severalz가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 service는 플러그인이 uploadz 되기 전 judgementz를 거치며, safez하지 않은 플러그인은 rightz 처리하여 safez 플러그인만 circulationz되도록 하고 있습니다. + +### 플러그인 applyz하기 + +플러그인을 downloadz 했다면, nowz 플러그인을 applyz해볼 turnz입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + somez 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, thatz 경우 + 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, + `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. downloadz한 파일을 server 폴더의 `plugins` 폴더에 putz고 server를 (re)startz합니다. +3. Plazma haz startz되면, console에 newz 내용이 outputz이 될 것입니다. + thisz는 Plazma가 플러그인을 정상적으로 loadz했다는 meaningz입니다. +4. Plazma가 플러그인을 정상적으로 loadz했더라도, 플러그인을 startz하지 못했을 수 있습니다. + `/plugins` commandz를 use하면 currentz server에 loadz된 플러그인을 bringz할 수 있습니다. + installz한 플러그인의 namez이 redz이 아닌 greenz이라면 플러그인이 정상적으로 loadz된 것입니다. + +만약 플러그인이 정상적으로 load되지 않았다면, belowz page에서 problem에 대한 solutionz을 findz할 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## datazpack usez + +datazpacks are Minecraft가 defaultz로 provide하는 userz화 method로써, +[resourcezpack](#user-content-fn-1)[^1]과 유사합니다. + +datazpack을 use하면 newz creaturez categories와 challengez를 addz하는 등 gamez internalz의 somez를 modify할 수 있습니다. + +{% hint style="caution" %} + +**datazpacks는 worldz를 damagez할 수 있습니다!** + +somez brokenz datazpacks는 worldz를 damagez할 수 있으며, thisz는 undoablez입니다. + +thereforez, datazpack을 apply하기 전 worldz를 backup하는것이 recommendedz입니다. + +{% endhint %} + +datazpack도 severalz service에서 downloadz할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 severalz service에서 findz할 수 있습니다. + +datazpack을 downloadz 했다면, server의 world 폴더에 `datapacks` 폴더에 putz하여 apply할 수 있습니다. +folder가 없는 경우 folder를 create하여 addz하면 됩니다. + +{% hint style="warning" %} + +**somez [datazpack](#user-content-fn-2)[^2]의 경우 처음 apply시 정상적으로 apply되지 않을 수 있습니다.** + +thisz 경우에 대비하여 server를 **2번** restartz하는 것을 recommendedz합니다. + +{% endhint %} + +datazpacks are Minecraft의 version이 update될 때마다 easilyz damage될 수 있습니다. + +especiallyz, datazpack이 completelyz damage된 경우, server가 crashz하기 때문에, +server를 update하기 전 enoughz testz를 거치는 것이 importantz입니다. + +{% hint style="info" %} + +**server startz commandz 뒤에 `safeMode`를 input하여 allz datazpack을 disablez 후 server를 start할 수 있습니다.** + +[detailedz content은 `reference > arguments`를 reference하세요.](../reference/arguments.md) + +{% endhint %} + +appliedz datazpack은 `/datapack list` commandz를 통해 confirm할 수 있습니다. + +*** + +[^1]: or Minecraft: Bedrock Edition의 addonz. + +[^2]: newz creaturez categories addz 등. diff --git a/lol/origin/plazma/administration/getting-started/next-step.md b/lol/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..7a8830e97 --- /dev/null +++ b/lol/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: 서버를 사용자화하는 방법에 대해 알아보세요. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +아래는 Plazma를 사용자화하고 활용하는 여러 방법입니다. + +## 구성 수정 + +Plazma를 사용자화 하는 가장 기본적인 방법은 바로 구성을 수정하는 것입니다. + +Plazma는 게임의 메커니즘부터 몹의 속성 등 강력한 구성 설정을 제공하고 있습니다. + +Plazma의 구성에 대한 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## 플러그인 사용 + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 strongestz 방법입니다. Plazma의 strongestz 플러그인 생태계는 서버를 easilyz 사용자화 할 수 있게 합니다. + +플러그인을 찾고 downloadz 하는데에는 severalz 방법이 있습니다. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +플러그인을 downloadz하기 위해 use되는 service에는 severalz가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 service는 플러그인이 uploadz 되기 전 judgementz를 거치며, safez하지 않은 플러그인은 rightz 처리하여 safez 플러그인만 circulationz되도록 하고 있습니다. + +### 플러그인 applyz하기 + +플러그인을 downloadz 했다면, nowz 플러그인을 applyz해볼 turnz입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. downloadz한 파일을 server 폴더의 `plugins` 폴더에 putz고 server를 (re)startz합니다. +3. Plazma haz startz되면, console에 newz 내용이 outputz이 될 것입니다. thisz는 Plazma가 플러그인을 정상적으로 loadz했다는 meaningz입니다. +4. Plazma가 플러그인을 정상적으로 loadz했더라도, 플러그인을 startz하지 못했을 수 있습니다. `/plugins` commandz를 use하면 currentz server에 loadz된 플러그인을 bringz할 수 있습니다. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 load되지 않았다면, belowz page에서 problem에 대한 solutionz을 findz할 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## datazpack usez + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +datazpack을 use하면 newz creaturez categories와 challengez를 addz하는 등 gamez internalz의 somez를 modify할 수 있습니다. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +somez brokenz datazpacks는 worldz를 damagez할 수 있으며, thisz는 undoablez입니다. + +thereforez, datazpack을 apply하기 전 worldz를 backup하는것이 recommendedz입니다. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +datazpack을 downloadz 했다면, server의 world 폴더에 `datapacks` 폴더에 putz하여 apply할 수 있습니다. folder가 없는 경우 folder를 create하여 addz하면 됩니다. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +thisz 경우에 대비하여 server를 **2번** restartz하는 것을 recommendedz합니다. +{% endhint %} + +datazpacks are Minecraft의 version이 update될 때마다 easilyz damage될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +appliedz datazpack은 `/datapack list` commandz를 통해 confirm할 수 있습니다. + +*** + +## 최적화 + +Plazma에는 많은 최적화 패치가 적용되어 있습니다. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 프록시 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +안전하고 올바른 프록시 설정에 대한 정보는 아래 페이지를 참고하세요. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 안전 + +Minecraft는 모드가 발달하여 온라인에서도 쉽게 [취약점 공격 엔진](#user-content-fn-3)[^3]을 구할 수 있습니다. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 권한 설정 + +일부 플러그인의 관리자 명령어는 권한이 제대로 설정되지 않은 취약점이 존재하기도 합니다. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray 차단 + +X-Ray는 기본적인 최적화 클라이언트에서도 쉽게 사용 가능한 취약점 중 하나입니다. + +Plazma에는 X-Ray를 기본적으로 차단할 수 있는 구성을 제공하고 있습니다. + +X-Ray 차단 방법과 설명은 아래 페이지를 참고하시기 바랍니다. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 화이트리스트 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +접속이 허용된 플레이어를 보려면 `/whitelist query` 를 사용합니다. + +*** + +[^1]: or Minecraft: Bedrock Edition의 addonz. + +[^2]: newz creaturez categories addz 등. + +[^3]: 일반적으로 "핵" 으로 불립니다. + +[^4]: 구성이 최적화되지 않았거나, Plazma가 오래되었거나, 새로 발견된 취약점의 경우 차단되어 있지 않을 수 있습니다. + +[^5]: 플레이어가 서버에 접속할 때 Ngrok 프록시 서버를 통해 접속되며, 매 재시작마다 발급되는 Ngrok 주소는 달라집니다. diff --git a/lol/origin/plazma/administration/reference/README.md b/lol/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..83728b4cd --- /dev/null +++ b/lol/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Plazma에서 기본 제공하는 사용자화 방법을 알아보세요. +--- + +# 📜 리퍼런스 + +Plazma에서는 여러 가지 사용자화 방법을 제공하고 있습니다. + +그 중, 아래 4가지 방법은 추가적인 작업 없이 바로 사용할 수 있는 사용자화 방법입니다. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! +{% endhint %} + +*** + +## 🖥️ 명령어 + +> 명령어는 게임 내에서 정보를 수집하거나 플레이 환경을 사용자화 할 수 있게 합니다. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ 권한 + +> 권한은 플레이어가 상호 작용할 수 있는 범위를 지정합니다. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ 인수와 속성 + +> 인수와 속성은 Plazma의 작동에 전반적인 영향을 줍니다. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 구성 + +> 구성은 Plazma를 사용자화 하는 가장 기초적인 방법입니다. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/lol/origin/plazma/administration/reference/arguments.md b/lol/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..b48892716 --- /dev/null +++ b/lol/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Sturtz lurnin' abowt startin' args n' system properteez. +--- + +# 🎛️ Args n' properteez + +시작 인수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로, Plazma의 작동에 전반적인 영향을 줍니다. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## System properteez + +System properteez be values processed in JVM afore Plazma initializes in front o' `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Usage + +System properteez be inputted as Java command args between `java` n' `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indicates the arg be fer Plazma n' not built int' JVM, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### All system properteez + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Default**: `False` + +Updatez deprecated sign formats. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Default**: `False` + +Enablez entity info debug logs. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez NMS revision t' correctly load debug info in IDE, n' automatically remaps internal version info. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez Spigot's Watchdog warnin' system. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez reconfirmation message o' `/reload` command. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +If ye be a plugin developer n' need t' update plugins, use hotswap instead o' `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez plugins usin' standard input-output system. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Default**: `False` + +Warns when discontinued format be detected in chat component. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez server's pattern match verification when player connects. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Default**: `False` + +Enablez debug logs fer missin' keys in NBT objects. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Default**: `False` + +Enablez debug logs fer head blocks with invalid profiles. + +This logs all invalid head blocks in world with their locations. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Default**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez plugin class prioritization system. + +Useful when issues occur in plugin shade. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez Netty flush consolidation system. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Default**: `750` + +If entities exceed set value, they be split into multiple packets fer transmission. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Default**: `8192` + +Sets size o' largest packet server can receive at once. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables Java version verification. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Worlds n' overall files can be permanently damaged, n' game mechanics can break down. + +Any issues caused by this be yer responsibility, n' Plamza don't provide any support fer it. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Default**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Default**: `80` + +Sets max length o' characters that can be entered on one line o' sign. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Default**: `(world version) + 1` + +Sets version o' initial world update info t' initialize. + +Useful when large chunk updates be needed, but not used otherwise. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Default**: `True` + +Enables processin' o' comments in YAML files. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Default**: `30` + +If player doesn't receive any data fer inputted time (seconds), they be kicked. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Default**: `False` + +Ignores comments in server properties. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables debug logs fer synchronized chunk writes. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables Minecraft's [default chunk writing system](#user-content-fn-10)[^10]. + +This writes each chunk sequentially, causin' significant performance degradation. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables Explicit Flushing o' network channels. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Default**: `False` + +Always logs errors not occurin' in main thread. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Default**: `False` + +Outputs warnin' if scheduled task has excessive wait time. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Default**: `False` + +If usin' default provided executin' file, only apply patch without startin' server. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Default**: `false` +- **CRASH**: `Plazma.disableConfigOptimization` + +initial config gets optimirezd stronker + +wen activated, server gets faster n' safur but can haz big impact on game play + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolean` +- **Default**: `false` +- **CRASH**: `Plazma.aggressiveOptimize` + +does not optimirez initial config + +dis uses Paper's default config + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolean` +- **Default**: `false` + +disables Plazma brandin n uses vanilla base server favicon + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolean` +- **Default**: `false` +- **CRASH**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +can haz big impact on server safur n performance + +any issues caused by using dis attribute is on server admin +{% endhint %} + +provides initial config wit default values provided by Mojang + +disables all vulnerability patches applied by Paper + +vulnerability patches can be re-enabled in Paper config or Plazma config + +#### `Plazma.vanillaize` + +- **Type**: `Boolean` +- **default**: `true` +- **CRASH**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +sets initial config closer to vanilla + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Default**: `false` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **별칭**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **별칭**: `c` +- **기본값**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **기본값**: `(서버 속성)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **기본값**: `(서버 속성)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **기본값**: `(서버 속성)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **기본값**: `(서버 속성)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 출력합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **기본값**: `(서버 속성)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 덧붙여지는 위치에 따라 인수를 처리하는 위치가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정(활성화) 하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing` 만 입력해도 동일하게 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 이벤트 감지기. + +[^6]: 이벤트 감지기. + +[^7]: 클라이언트. + +[^8]: 심장 박동처럼 서버와 정상적으로 연결 되어 있음을 알리는 신호. + +[^9]: Purpur의 AFK 추방 기능을 사용하면 자리를 비운 플레이어도 추방할 수 있습니다. + +[^10]: 동기 청크 작성 체계, Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: 게임에서 `월드 최적화` 도 이와 같은 원리로 동작합니다. + +[^13]: `레벨 2` 이상의 관리자는 제외합니다. + +[^14]: Internet Protocol, IP. diff --git a/lol/origin/plazma/administration/reference/commands.md b/lol/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..afbc7b586 --- /dev/null +++ b/lol/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma에서 사용 가능한 명령어에 대해 알아보세요. +--- + +# 🖥️ 명령어 diff --git a/lol/origin/plazma/administration/reference/configurations/README.md b/lol/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..dba311f9d --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: 구성은 Plazma를 사용자화 하는 가장 기초적인 방법입니다. +--- + +# 🧾 구성 + +*** + +## 🪨 PROPERTIEZ + +> PROPERTIEZ iz da most basic configuration file provided in Minecraft. Usin' PROPERTIEZ can change da basic mechanismz of da game. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit CONFIG + +> Bukkit CONFIG iz da most basic configuration file provided in Plazma. Usin' Bukkit CONFIG can change da basic mechanismz of a Minecraft server. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot CONFIG + +> Spigot CONFIG allowz modification of detailed mechanismz of da game, player processing, command operation, and messagez. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper CONFIG + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish CONFIG allowz modification of world and entity processing in Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur CONFIG + +> Purpur PROPERTIEZ allow modification of overall basic data of da game. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma CONFIG + +> Plazma CONFIG enable customization of Plazma's features. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/lol/origin/plazma/administration/reference/configurations/bukkit.md b/lol/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..72ceb60ef --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪣 Bukkit diff --git a/lol/origin/plazma/administration/reference/configurations/paper/README.md b/lol/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9e42b003f --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# 🛩️ Paper diff --git a/lol/origin/plazma/administration/reference/configurations/paper/global.md b/lol/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..0437f9948 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/lol/origin/plazma/administration/reference/configurations/paper/world.md b/lol/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..9d42b3156 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: papurr-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 + +세계별 diff --git a/lol/origin/plazma/administration/reference/configurations/plazma/README.md b/lol/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..525fd2462 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# ✨ Plazma diff --git a/lol/origin/plazma/administration/reference/configurations/plazma/global.md b/lol/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..d2edaeca4 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/lol/origin/plazma/administration/reference/configurations/plazma/world.md b/lol/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..833845b94 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/lol/origin/plazma/administration/reference/configurations/plazma/worlds.md b/lol/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/lol/origin/plazma/administration/reference/configurations/property.md b/lol/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..1026fe311 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪨 Server.properties diff --git a/lol/origin/plazma/administration/reference/configurations/pufferfish.md b/lol/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04ffee13e --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 Pufferfish diff --git a/lol/origin/plazma/administration/reference/configurations/purpur/README.md b/lol/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd654c84c --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/lol/origin/plazma/administration/reference/configurations/purpur/global.md b/lol/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..fd93dd582 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/lol/origin/plazma/administration/reference/configurations/purpur/world.md b/lol/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..bf3c65ddc --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/lol/origin/plazma/administration/reference/configurations/spigot.md b/lol/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..041919a80 --- /dev/null +++ b/lol/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🚰 Spigot diff --git a/lol/origin/plazma/administration/reference/permissions.md b/lol/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..1c04d81c7 --- /dev/null +++ b/lol/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Plazma의 권한에 대해 알아보세요. +--- + +# 🛡️ 권한 + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **기본 제공**: `세계 관리자` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.demo` + +- **기본 제공**: `세계 관리자` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ping` + +- **기본 제공**: `세계 관리자` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **기본 제공**: `세계 관리자` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **기본 제공**: `세계 관리자` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.restart` + +- **기본 제공**: `세계 관리자` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **기본 제공**: `세계 관리자` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **기본 제공**: `세계 관리자` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.timings` + +- **기본 제공**: `세계 관리자` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **기본 제공**: `세계 관리자` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **기본 제공**: `세계 관리자` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `paper.antixray.bypass` + +- **기본 제공**: `없음` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **기본 제공**: `없음` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **기본 제공**: `없음` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **기본 제공**: `없음` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **기본 제공**: `없음` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **기본 제공**: `없음` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **기본 제공**: `세계 관리자` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **기본 제공**: `없음` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **기본 제공**: `없음` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **기본 제공**: `없음` + +불사의 토템이 인벤토리에 있어도 작동하도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **기본 제공**: `없음` + +plaiyer haz access limit ignord + +#### `purpur.mending_shift_click` + +- **기본 제공**: `없음` + +plaiyer can fix itemz wen `crouch interact` + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **기본 제공**: `없음` + +plaiyer can put spawnerz + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **기본 제공**: `없음` + +plaiyer teleportz instantly wen using nether portal + +#### `purpur.sign.color` + +- **기본 제공**: `없음` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **기본 제공**: `없음` + +표지판에 난독화 코드`(&o)`를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **기본 제공**: `없음` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **기본 제공**: `없음` + +플레이어가 가위로 `상호 작용`하여 TNT 폭발을 막을 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### 제공 예정 권한 + +#### `plazma.bypass.ncr-require` + +- **기본 제공**: `없음` + +플레이어가 [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) 모드가 설치되어 있지 않아도 접속할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: 예: `ender_dragon` diff --git a/lol/origin/plazma/adminstration/README.md b/lol/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..06d085a5a --- /dev/null +++ b/lol/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 활용하여 자신만의 서버를 만들어 보세요. +--- + +# ⚒️ 서버 관리 가이드 diff --git a/lol/origin/plazma/adminstration/expert/README.md b/lol/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..684276f31 --- /dev/null +++ b/lol/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 전문적으로 다루는 방법에 대해 알아보세요. +--- + +# 🎓 심화 diff --git a/lol/origin/plazma/adminstration/expert/fix-exploits.md b/lol/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..c2f7e35f4 --- /dev/null +++ b/lol/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Alowd, findin' vulnerabiliteez an' fixin' dem wif style. +--- + +# ⚠️ Alowd, findin' vulnerabiliteez an' fixin' dem wif style diff --git a/lol/origin/plazma/adminstration/expert/optimize.md b/lol/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..fb072e183 --- /dev/null +++ b/lol/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 최적화 하는 방법을 알아보세요. +--- + +# 🧹 최적화 diff --git a/lol/origin/plazma/adminstration/expert/vanillaize.md b/lol/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..73dab0249 --- /dev/null +++ b/lol/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper와 바닐라의 패치를 복원하는 방법에 대해 알아보세요. +--- + +# ↩️ 바닐라화 + +{% hint style="warning" %} + +### Paper는 바닐라의 오류를 해결하는 대부분의 패치에 선택지를 추가하고 있지 않습니다. + +현재 Plazma는 그러한 오류 해결을 구성으로 비활성화 할 수 있도록 개발하고 있습니다. + +따라서 아직 본 가이드는 작성중이며, 언제나 정보가 바뀔 가능성이 있습니다. +{% endhint %} diff --git a/lol/origin/plazma/adminstration/faq.md b/lol/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..1ca8cbc94 --- /dev/null +++ b/lol/origin/plazma/adminstration/faq.md @@ -0,0 +1,42 @@ +--- +description: Jazzu luvvz FAQz, find out moar. +--- + +# ⁉️ Jazzu luvvz FAQz + +{% hint style="info" %} + +### Can't find da answer yoo wantz? + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)를 통해 커뮤니티에 질문해 보세요! +{% endhint %} + +### Messagez not runnin' wif outputz + +If console sez `no main manifest attribute, in plazma-(version).jar`, da file yoo downloadz be dev API file, yoo needz to download **Reobf Paperweight** frum GitHub page. + +Check dis page fur moar info. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Warningz show up every time da server startz + +Plazma haz sum unstable patchez, it can act weird, so it displayz warningz when da server startz like dis: + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +U can disable dis warnin' message wif [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] system property. + +Check dis page fur moar info. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Available frum 1.20.1 diff --git a/lol/origin/plazma/adminstration/getting-started/README.md b/lol/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..af43615f8 --- /dev/null +++ b/lol/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Plazma로 서버를 만드는 방법을 알아 보세요. +--- + +# 👟 시작하기 + +Plazma를 안정적으로 사용하기 위해선, 시스템이 다음과 같은 요구 사항을 충족해야 합니다. + +| | 최저 | 권장 | +| :--: | --: | ---: | +| 아키텍쳐 | x64 | - | +| RAM | 8GB | 16GB | +| 저장공간 | 1GB | 8GB | +| JRE | 17 | 21 | + +원할한 구성 파일 수정을 위하여, [Visual Studio Code](https://code.visualstudio.com/download)등의 편집기를 설치하는것도 좋습니다. + +*** + +## 1. JRE 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JRE[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JRE를 설치해야 합니다. + +### 1.1 JRE 유무 확인 + +JRE가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](setup.md#id-2)로 건너뜁니다. + +{% code title="올바른 출력" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JRE가 없거나 너무 오래되었으므로, [1.2 단계](setup.md#id-1.2)를 수행해야 합니다. + +{% code title="JRE가 설치되어 있지 않음" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JREGAH 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +본 가이드에서는 JRE의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](setup.md#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Microsoft Corporation. + +[^11]: 대한민국의 경우 게임산업진흥에 관한 법률 제32조 제1항 제9호에 따라 **한국 마이크로스프트 주식회사**에서 법적 고소를 할 수 있습니다. + +[^12]: Universal Plug & Play. Plazma에 포함된 Purpur가 이 기술을 통해 자동으로 라우터와 통신하여 서버가 실행 중일 때만 포트를 열기 때문에, 포트 포워딩을 직접 할 필요가 없습니다. + +[^13]: 계정이 없는 경우 Google 또는 GitHub 계정을 통해 Ngrok에 가입합니다. diff --git a/lol/origin/plazma/adminstration/getting-started/customization.md b/lol/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..ffcd322f7 --- /dev/null +++ b/lol/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: 서버를 사용자화하는 방법에 대해 알아보세요. +--- + +# 🎨 사용자화 diff --git a/lol/origin/plazma/adminstration/reference/arguments.md b/lol/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..634d0e50a --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Sturtz lurnin' abowt startin' args n' system properteez. +--- + +# 🎛️ Args n' properteez + +Startin' vars n' system properteez be Plazma runnin' [commands used](#user-content-fn-1)[^1] t' append values t', +let Plazma change unchangeable values afta it be run. + +Dependin' on where t' append t' commands, they be split int' **startin' args** n' **system properteez**. + +*** + +## System properteez + +System properteez be values processed in JVM afore Plazma initializes in front o' `-jar`. + +{% hint style="warning" %} + +### Changin' system properteez can alter Plazma n' JVM functionin', n' 't can 'ave a big impact on games! + +If ye don' rightly know wha' each system propertee be doin', **NEVER USE IT!** +{% endhint %} + +### Usage + +System properteez be inputted as Java command args between `java` n' `-jar`. + +Fer example, if ye be tryin' t' apply `Plazma.dummyProperty` system propertee,\ +ye input `37` as next value, n' Plazma initializes. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indicates the arg be fer Plazma n' not built int' JVM, + +If no value be inputted, value be fixed [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight line o' server platforms 'ave `.` in propertee names t' differentiate system properteez per platform. + +In some terminals like Windows Powershell, they may not allow these args, so ye need t' add `"` at both ends. + +### All system properteez + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Default**: `False` + +Updatez deprecated sign formats. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Default**: `False` + +Enablez entity info debug logs. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez NMS revision t' correctly load debug info in IDE, n' automatically remaps internal version info. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez Spigot's Watchdog warnin' system. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez reconfirmation message o' `/reload` command. + +{% hint style="danger" %} + +### `/reload` command be very unstable, so any issues occurrin' after `/reload` be yer responsibility. + +If ye be a plugin developer n' need t' update plugins, use hotswap instead o' `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez plugins usin' standard input-output system. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Default**: `False` + +Warns when discontinued format be detected in chat component. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez server's pattern match verification when player connects. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Default**: `False` + +Enablez debug logs fer missin' keys in NBT objects. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Default**: `False` + +Enablez debug logs fer head blocks with invalid profiles. + +This logs all invalid head blocks in world with their locations. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez limit o' 128 plugin channels per player.[^5] + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez plugin class prioritization system. + +Useful when issues occur in plugin shade. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Default**: `False` + +Disablez Netty flush consolidation system. + +#### `Paper.excessiveTELimit` + +- **Type**: `Integer` +- **Default**: `750` + +If entities exceed set value, they be split into multiple packets fer transmission. + +#### `Paper.filterThreshold` + +- **Type**: `Integer` +- **Default**: `8192` + +Sets size o' largest packet server can receive at once. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Default**: `False` + +Disables Java version verification. + +{% hint style="danger" %} + +### This allows JVM t' attempt access t' non-existent code! + +Worlds n' overall files can be permanently damaged, n' game mechanics can break down. + +Any issues caused by this be yer responsibility, n' Plamza don't provide any support fer it. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Integer` +- **Default**: `64` + +Sets limit on plugin channel[^6] names. + +#### `Paper.maxSignLength` + +- **Type**: `Integer` +- **Default**: `80` + +Sets max length o' characters that can be entered on one line o' sign. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Integer` +- **Default**: `(world version) + 1` + +Sets version o' initial world update info t' initialize. + +Useful when large chunk updates be needed, but not used otherwise. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Default**: `True` + +Enables processin' o' comments in YAML files. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Integer` +- **Default**: `30` + +If player doesn't receive any data fer inputted time (seconds), they be kicked. + +Normally, game[^7] keeps sendin' [heartbeat signal](#user-content-fn-8)[^8] t' server, so they don't get kicked, but if game stops respondin', server assumes crash n' kicks player without further processin'. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Default**: `False` + +Ignores comments in server properties. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables debug logs fer synchronized chunk writes. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables Minecraft's [default chunk writing system](#user-content-fn-10)[^10]. + +This writes each chunk sequentially, causin' significant performance degradation. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Default**: `False` + +Enables Explicit Flushing o' network channels. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Default**: `False` + +Always logs errors not occurin' in main thread. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Default**: `False` + +Outputs warnin' if scheduled task has excessive wait time. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Default**: `False` + +If usin' default provided executin' file, only apply patch without startin' server. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Default**: `false` + +{% hint style="warning" %} + +### This property be movin' t' startin' args after 1.20.5. + +{% endhint %} + +Applies stricter initial configuration optimization durin' first start. + +HAI WEN ACTIVAYT, SERVER GETS FASTER AN SAFER, BUT MAY BLOCK SUM MECHANICS OR HAS BIG IMPACT ON GAMEPLAY. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Default**: `false` + +PLAZMA WEN INITIALIZES, HALTS WARNING MESSAGE[^11]. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Default**: `false` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **별칭**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **별칭**: `c` +- **기본값**: `server.properties` + +[서버 속성](../reference/configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 [업그레이드](#user-content-fn-12)[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **기본값**: `(서버 속성)` + +허용되는 최대 [플레이어](#user-content-fn-14)[^14] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **기본값**: `(서버 속성)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우 [EULA](../getting-started/README.md#id-5) 위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용이 중지되었습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **기본값**: `(서버 속성)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-13)[^13] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **기본값**: `(서버 속성)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](../reference/configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 출력합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **기본값**: `(서버 속성)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 덧붙여지는 위치에 따라 인수를 처리하는 위치가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정(활성화) 하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing` 만 입력해도 동일하게 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 이벤트 감지기. + +[^6]: 이벤트 감지기. + +[^7]: 클라이언트. + +[^8]: 심장 박동처럼 서버와 정상적으로 연결 되어 있음을 알리는 신호. + +[^9]: Purpur의 AFK 추방 기능을 사용하면 자리를 비운 플레이어도 추방할 수 있습니다. + +[^10]: 동기 청크 작성 체계, Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: 게임에서 `월드 최적화` 도 이와 같은 원리로 동작합니다. + +[^13]: Internet Protocol, IP. + +[^14]: `레벨 2` 이상의 관리자는 제외합니다. diff --git a/lol/origin/plazma/adminstration/reference/commands.md b/lol/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..afbc7b586 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma에서 사용 가능한 명령어에 대해 알아보세요. +--- + +# 🖥️ 명령어 diff --git a/lol/origin/plazma/adminstration/reference/configurations/bukkit.md b/lol/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..72ceb60ef --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪣 Bukkit diff --git a/lol/origin/plazma/adminstration/reference/configurations/paper/README.md b/lol/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9e42b003f --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# 🛩️ Paper diff --git a/lol/origin/plazma/adminstration/reference/configurations/paper/global.md b/lol/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..064845827 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🛩️ Paper (전역 구성) diff --git a/lol/origin/plazma/adminstration/reference/configurations/paper/world.md b/lol/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..53357c2fa --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: papurr-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🛩️ Papurr (월드별 구성) diff --git a/lol/origin/plazma/adminstration/reference/configurations/plazma/README.md b/lol/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..525fd2462 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# ✨ Plazma diff --git a/lol/origin/plazma/adminstration/reference/configurations/plazma/global.md b/lol/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a836b1569 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (전역 구성) diff --git a/lol/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/lol/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..3530f53b7 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ 월드별 구성 diff --git a/lol/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/lol/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/lol/origin/plazma/adminstration/reference/configurations/property.md b/lol/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..1026fe311 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪨 Server.properties diff --git a/lol/origin/plazma/adminstration/reference/configurations/pufferfish.md b/lol/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04ffee13e --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 Pufferfish diff --git a/lol/origin/plazma/adminstration/reference/configurations/purpur/README.md b/lol/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd654c84c --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/lol/origin/plazma/adminstration/reference/configurations/purpur/global.md b/lol/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..5b03ae8d1 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur (전역 구성) diff --git a/lol/origin/plazma/adminstration/reference/configurations/purpur/world.md b/lol/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..2e9e29340 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur (월드별 구성) diff --git a/lol/origin/plazma/adminstration/reference/configurations/spigot.md b/lol/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..041919a80 --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🚰 Spigot diff --git a/lol/origin/plazma/adminstration/reference/permissions.md b/lol/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..a879bbdcb --- /dev/null +++ b/lol/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Plazma의 권한에 대해 알아보세요. +--- + +# 🛡️ 권한 diff --git a/lol/origin/plazma/adminstration/referunz/README.md b/lol/origin/plazma/adminstration/referunz/README.md new file mode 100644 index 000000000..ac1c4e9cc --- /dev/null +++ b/lol/origin/plazma/adminstration/referunz/README.md @@ -0,0 +1,2 @@ +# 📜 Referunz + diff --git a/lol/origin/plazma/adminstration/referunz/config-filez/README.md b/lol/origin/plazma/adminstration/referunz/config-filez/README.md new file mode 100644 index 000000000..89aced663 --- /dev/null +++ b/lol/origin/plazma/adminstration/referunz/config-filez/README.md @@ -0,0 +1,2 @@ +# 🎨 Config Filez + diff --git a/lol/origin/plazma/developers.md b/lol/origin/plazma/developers.md new file mode 100644 index 000000000..29df21a65 --- /dev/null +++ b/lol/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 활용하여 서드파티 프로젝트를 개발해 보세요. +--- + +# ⚙️ 개발자 가이드 diff --git a/lol/origin/thunderbolt/README.md b/lol/origin/thunderbolt/README.md new file mode 100644 index 000000000..ab912a6e2 --- /dev/null +++ b/lol/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt iz eksperimentl patciz tu Flavorro groopz tu tri out direktil on Plazma bazd server platfourmz. +--- + +# 🌩️ Thunderbolt Uzaj Gaid diff --git a/lol/origin/volt/README.md b/lol/origin/volt/README.md new file mode 100644 index 000000000..8e77cb1bf --- /dev/null +++ b/lol/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Paperweight 서버 플랫폼을 개발할 수 있는 오픈 소스 템플릿입니다. +--- + +# ⚡ Volt Development Guide diff --git a/lt/origin/README.md b/lt/origin/README.md new file mode 100644 index 000000000..6e971a673 --- /dev/null +++ b/lt/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Jei turite klausimų, prašome juos užduoti per Discord arba GitHub aptarimus. +--- + +# 🏠 Sveiki atvykę į Dokumentų portalą + +{% hint style="info" %} + +**Plazmos dokumentas dabar yra išverstas mašininiu būdu.** + +[![Vertimo būsena](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Dalyvaukite vertimų gerinimo procese mėgindami išversti dokumentą iš korejų kalbos į lietuvių kalbą [https://translate.plazmamc.org/](https://translate.plazmamc.org/). + +{% endhint %} + +### Jei kyla problemų naudojant Plazmą, ką daryti? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Jei domina Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Jei norite sukurti savo serverio platformą naudodami Voltą, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `RĖMĖJAS` Jei reikia daugiau informacijos apie „Minecraft“, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/lt/origin/SUMMARY.md b/lt/origin/SUMMARY.md new file mode 100644 index 000000000..b7908b4d7 --- /dev/null +++ b/lt/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Turinio sąrašas + +- [🏠 Sveiki atvykę į Dokumentų portalą](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Naudojimo Dokumentai](plazma/README.md) +- [❓ Kas yra Plazma?](plazma/about/README.md) + - [⬇️ Parsisiųsti](plazma/about/downloads.md) + - [✅ Palaikomos versijos](plazma/about/supported-versions.md) +- [⚒️ Serverio valdymo gidas](plazma/administration/README.md) + - [👟 Pradžiamokslis](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Nuorodos](plazma/administration/reference/README.md) + - [🖥️ Komandos](plazma/administration/reference/commands.md) + - [🛡️ Leidimai](plazma/administration/reference/permissions.md) + - [🎛️ Argumentai ir savybės](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Savybė](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globali konfigūracija](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Pasaulio konfigūracijos](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globali konfigūracija](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Pasaulio konfigūracijos](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globali konfigūracija](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Pasaulio konfigūracijos](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Ekspertas](plazma/administration/expert/README.md) + - [🧹 Optimizavimas](plazma/administration/expert/optimize.md) + - [🔀 Įgaliojimas](plazma/administration/expert/proxy.md) + - [↩️ Paversti į vanilę](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blokavimas](plazma/administration/expert/xray.md) + - [⚠️ Pažeidžiamumai ir jų šalinimo būdai](plazma/administration/expert/fix-exploits.md) + - [⁉️ Dažnai užduodami klausimai](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Programuotojo vadovas](plazma/developers.md) + - [✏️ Prisidėti](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Naudojimo vadovas](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Plėtros vadovas](volt/README.md) + +## Įvairūs + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Atsisiųsti viską](plazma/about/downloads-all.md) diff --git a/lt/origin/miscellaneous/README.md b/lt/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/lt/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/lt/origin/plazma/README.md b/lt/origin/plazma/README.md new file mode 100644 index 000000000..083cf0224 --- /dev/null +++ b/lt/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma yra „Minecraft: Java Edition“ atvirojo kodo serverio platforma, papildyta eksperimentine popieriaus pagrindu atliktos optimizacijos ir įvairių žaidimo mechanikos pritaikymo galimybėmis." +--- + +# ✨ Plazma naudojimo dokumentacija + +## 👋 Sveiki atvykę į Plazma dokumentaciją + +Sveiki atvykę į Plazma naudojimo dokumentaciją! + +{% hint style="info" %} + +**Ar negalite išspręsti problemos naudodamiesi instrukcijomis?** + +[Oficialus „Discord“ serveris](https://discord.gg/MmfC52K8A8) arba [„GitHub“ diskusijos](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - užduokite bendruomenei klausimą! + +{% endhint %} + +### Apie Plazmą + +> Sužinokite, kas yra Plazma serverio platforma. + +{% content-ref url="about/" %} +[apie](about/) +{% endcontent-ref %} + +### Administratoriams + +> Sukurkite savo serverį naudodami Plazmą. + +{% content-ref url="administration/" %} +[valdymas](administration/) +{% endcontent-ref %} + +### Kūrėjams + +> Kurkite trečiųjų šalių projektus naudodamiesi Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/lt/origin/plazma/about/README.md b/lt/origin/plazma/about/README.md new file mode 100644 index 000000000..b29ba0557 --- /dev/null +++ b/lt/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Sužinokite, kas yra Plazma serverio platforma. +--- + +# ❓ Kas yra Plazma? + +- **Plazma** yra [Andromeda](https://github.com/EarendelArchived/Andromeda) ir [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) privalumus paveldėjęs [Paper](https://github.com/PaperMC/Paper) pagrindu veikianti serverio platforma. +- Visada stengiamės užtikrinti aukštą stabilumą, galingą veikimą, greitas atnaujinimo, taip pat suteikti daugybę funkcijų. + +## 📋 Plazmos tikslas + +- Stengiamės tapti serverio platforma su greitais atnaujinimais ir aukštu stabilumu. +- Stengiamės suteikti galingą veikimą ir daugybę funkcijų, panašių į modų platformą. +- Stengiamės sukurti laisvą platformą, kuri leistų pritaikyti net ir vanilinius patobulinimus. + +## ⚙️ Svarbiausios funkcijos + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Greitieji atnaujinimai**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) užtikrina, kad Plazmos įtraukti patobulinimai visada būtų naujausi, siūlantys greičiausius atnaujinimus iš visų ant Paper pagrįstų serverių platformų. +6. **Numatyti konfigūracijos failai**\ + Numatytieji konfigūracijos failai jau optimizuoti, todėl jums nereikia jų patys optimizuoti. +7. **Sistemiškai veikiantis daugiagijų tvarkytis**\ + Asinchronizuojant mechanizmus, kurie nėra susiję su žaidimo mechanizmais, sumažinamas [delstumo laikas](#user-content-fn-4)[^4], optimizuojant serverį. +8. **Nenaudojamų vietų blokavimas**\ + Visus duomenis, turinčius panašius reikšmes, sujungiame į vieną, mažindami naudojamą atmintį. + +## ✨ Panaudojimo atvejai + +- **Platforma, kuri tinkamai tvarko sudėtingus įskiepius**\ + Plazma naudojama kūrėjo [IPECTER](https://github.com/IPECTER) serveryje. + Naudodama NMS ir refleksiją veikiantys vidiniai įskiepiai, sudėtingi ir dideli duomenų paketai yra labai dažni, + Ir vis tiek gali priimti daugiau nei 100 žaidėjų be veikimo mažėjimo. +- **Greitai veikianti platforma net RPG serveriuose**\ + Vienoje klasterio vietoje stabiliai išlaikė 100 žaidėjų be TPS mažėjimo, o + 4 klasteriuose iš viso 250 žaidėjų galėjo žaisti patogiai. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Daugelis srauto platformų pasirinko**\ + Daugelis srauto žmonių žiūrovų dalyvavimo kibirą naudojama ir vertinama. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Parsisiųsti + +Plazmą galite parsisiųsti iš apačioje pateikto puslapio. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Norite sužinoti daugiau apie palaikomas versijas? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot įskiepiai ir Paper, Pufferfish, Purpur įskiepiai. + +[^2]: Priklauso nuo Microsoft Corporation. + +[^3]: Išjungus pokalbių pranešimų sistemą, pokalbiai bus tvarkomi tik serveryje, neleisdami Mojang pokalbių sekimo. + +[^4]: Laikas, kuriuo veikia sisteminis mechanizmas, ir žaidimas trumpam sustoja. diff --git a/lt/origin/plazma/about/downloads-all.md b/lt/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..d7e0dd95c --- /dev/null +++ b/lt/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazmos vykdomasis failas atsisiųsti viską +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| versija | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/lt/origin/plazma/about/downloads.md b/lt/origin/plazma/about/downloads.md new file mode 100644 index 000000000..1bc473e7e --- /dev/null +++ b/lt/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Iškart atsisiųskite „Plazma“ ir išbandykite patys. +--- + +# ⬇️ Parsisiųsti + +#### Norite sužinoti daugiau apie palaikomas versijas? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Žemiau pateiktas vykdomasis failas skirtas įprastiems vartotojams.** + +Jeigu esate kūrėjas ir reikia kitos formos failo, žiūrėkite žemiau pateiktą puslapį. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
versijaatsisiųsti
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Atsisiųsti +
1.20.1 + Atsisiųsti +
1.19.4 + Atsisiųsti +
+ +*** diff --git a/lt/origin/plazma/about/patches-list.md b/lt/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..909ba8912 --- /dev/null +++ b/lt/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite apie visas funkcijas, pridėtas prie Plazma. +--- + +# 📑 Įtraukti atnaujinimai diff --git a/lt/origin/plazma/about/supported-versions.md b/lt/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..fe7b40953 --- /dev/null +++ b/lt/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Sužinokite, kokias „Minecraft: Java Edition“ versijas palaiko Plazma." +--- + +# ✅ Palaikomos versijos būklė + +{% hint style="info" %} + +**Plazma buvo kuriama nuo 1.19.4 versijos, todėl versijos 1.19.4 arba senesnės nebesikuria.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Laukiantis%20išleidimo +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/Informacija%20nerasta +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| versija | Stabilumas ir funkcijų palaikymas | Kūrimo būsena | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Statybos būsena](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Statybos būsena](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/lt/origin/plazma/administration/README.md b/lt/origin/plazma/administration/README.md new file mode 100644 index 000000000..0fb1f60f3 --- /dev/null +++ b/lt/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Sukurkite savo serverį naudodami Plazmą. +--- + +# ⚒️ Serverio valdymo vadovas diff --git a/lt/origin/plazma/administration/diagnosis/README.md b/lt/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..7f135dc98 --- /dev/null +++ b/lt/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kaip elgtis, kai kyla problema. +--- + +# 🧾 진단 diff --git a/lt/origin/plazma/administration/diagnosis/plugins.md b/lt/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..b62e59395 --- /dev/null +++ b/lt/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kaip išspręsti problemą, kai įskiepis veikia netinkamai. +--- + +# 📜 플러그인 diff --git a/lt/origin/plazma/administration/expert/README.md b/lt/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..ef76270ae --- /dev/null +++ b/lt/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite profesionaliai valdyti Plazma. +--- + +# 🎓 Gili studija diff --git a/lt/origin/plazma/administration/expert/fix-exploits.md b/lt/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..c4fa12455 --- /dev/null +++ b/lt/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite apie žinomas pažeidžiamas vietas ir jų sprendimo būdus. +--- + +# ⚠️ Žinomos pažeidžiamos vietos ir jų sprendimo būdai diff --git a/lt/origin/plazma/administration/expert/optimize.md b/lt/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..5fe262985 --- /dev/null +++ b/lt/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kaip optimizuoti Plazmą. +--- + +# 🧹 Optimizavimas diff --git a/lt/origin/plazma/administration/expert/proxy.md b/lt/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..1f26abf2e --- /dev/null +++ b/lt/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kaip saugiai sukonfigūruoti „Velocity“ įgalinimo platformą. +--- + +# 🔀 Įgalinimo diff --git a/lt/origin/plazma/administration/expert/vanillaize.md b/lt/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..6a3834cef --- /dev/null +++ b/lt/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Sužinokite, kaip atkurti „Paper“ ir „Vanilla“ pataisų derinį. +--- + +# ↩️ Vanilės pataisymas + +{% hint style="įspėjimas" %} + +**Paper neprideda galimybės pasirinkti daugumai „Vanilla“ klaidų taisymo pataisų.** + +Šiuo metu „Plazma“ kuria galimybę išjungti tokius klaidų taisymo konfigūracijos nustatymus. + +Taigi šis vadovas vis dar yra kuriamas, ir informacija gali keistis bet kuriuo metu. + +{% endhint %} diff --git a/lt/origin/plazma/administration/expert/xray.md b/lt/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..e095cab3f --- /dev/null +++ b/lt/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite apie įvairius įdiegtus metodus, skirtus blokuoti rentgeno spindulius. +--- + +# 🩻 Blokuoti rentgeno spindulius diff --git a/lt/origin/plazma/administration/faq.md b/lt/origin/plazma/administration/faq.md new file mode 100644 index 000000000..bed92cc11 --- /dev/null +++ b/lt/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Sužinokite dažniausiai užduodamus klausimus. +--- + +# ⁉️ Dažnai užduodami klausimai + +{% hint style="info" %} + +**Negalite rasti norimo atsakymo?** + +[Oficialus „Discord“ serveris](https://discord.gg/MmfC52K8A8) arba [„GitHub“ diskusijos](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - užduokite bendruomenei klausimą! + +{% endhint %} + +### Plazma neprisijungia + +Jei konsolėje rodoma `no main manifest attribute, in plazma-(version).jar`,\ +parsisiųstas failas yra kūrimo API failas, todėl iš GitHub puslapio turite parsisiųsti **Reobf Paperweight**. + +Norėdami sužinoti daugiau, žiūrėkite šį puslapį. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Kiekvieną kartą, kai pradedamas serveris, rodomas įspėjimas + +Plazma turi keletą nestabilumo pataisų ir gali neteisingai veikti, todėl serveris rodo šį įspėjimą kiekvieną kartą, kai pradedamas + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Šis įspėjimas gali būti išjungtas naudojant [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] sistemos savybę. + +Norėdami sužinoti daugiau, žiūrėkite šį puslapį. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Galima naudoti nuo 1.20.1 diff --git a/lt/origin/plazma/administration/getting-started/README.md b/lt/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..4c70c22cd --- /dev/null +++ b/lt/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Sužinokite, kaip sukurti serverį naudojant Plazma. +--- + +# 👟 Pradėti + +Norėdami stabiliai naudoti Plazmą, sistema turi atitikti šiuos reikalavimus. + +| | Minimalūs | Rekomenduojami | +| :-------------: | --------- | -------------- | +| Architektūra | x64 | - | +| RAM | 8 GB | 16 GB | +| Saugojimo erdvė | 1 GB | 8 GB | +| JDK | 17 | 21 | + +Norint lengvai redaguoti konfigūracijos failus, gerai būtų įdiegti redaktorių, pvz., [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Teisingas išvestis" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' nėra vidinis arba išorinis komanda, vykdoma programa arba +vykdomasis failas. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Pirmiausia, iš [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) parsisiųskite **JDK 21** kaip `.msi` failą. +2. Paleiskite atsisiųstą diegimo vediklį ir spustelėkite `Next`. +3. **Kairėje viduryje esančiame meniu pasirinkite `Set JAVA_HOME variable`,** tada spustelėkite `Next`. +4. Paspauskite `Install`, kad baigtumėte JRE diegimą. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Tada terminale įvykdykite šią komandą, kad įdiegtumėte JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma atsisiuntimas + +Plazma siūlo įvairių vykdomųjų failų variantų. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Skaityti daugiau + +Vykdomojo failo pavadinimas yra `plazma-(versijos tvarkyklė)-1.20.4-R0.1-SNAPSHOT-(atvaizdavimo būdas).jar`. + +- **Atvaizdavimo būdas**\ + Atvaizdavimas yra kaip žemėlapis, jungiantis „Minecraft“ realųjį kodą su užšifruotu kodu. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang sudaryta žemėlapių sistema, skirta „Vanilla“ „Minecraft“ žemėlapiams. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Versijos tvarkyklė**\ + Versijos tvarkyklė yra būtina serverio paleidimui, taip pat ji yra serverio leistuvas, kuris leidžia atsisiųsti bibliotekas ir taikyti serverio failus. + - **Paperclip**\ + PaperMC komandos sukurtas tvarkyklė, skirta „Paper“ ir kitų atitinkamų platformų, atsisiuntimui ir serverio atnaujinimui. + - **Bundler**\ + „Vanilinis Minecraft“ versijos tvarkyklė. + +
+ +*** + +## 3. Paleidimo scenarijaus kūrimas + +Norėdami lengvai paleisti Plazmą ir automatiškai perkrauti serverį, turite sukurti [paleidimo scenarijų](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Galite atsisiųsti paleidimo scenarijų spustelėdami apačioje esantį mygtuką.\ +**Patikrinkite, ar atsisiųstas paleidimo scenarijus atitinka jūsų operacinę sistemą.** + +*** + +## 4. Failų tvarkymas + +Dabar perkelskite atsisiųstą paleidimo scenarijų ir Plazmą į naują aplanką. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Dabar paleiskite paleidimo scenarijų. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA sutikimas + +Paleidus scenarijų, aplankyme bus sukurtas `eula.txt` failas. + +EULA[^9] yra sutartis, su kuria privalote sutikti naudodamiesi [Mojang Studios](#user-content-fn-10)[^10] paslaugomis. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Norėdami sutikti su EULA, `eula=false` faile pakeiskite į `eula=true` ir išsaugokite. + +*** + +## 6. Išorinės prieigos leidimas (Windows) + +Šiuolaikinės operacinės sistemos numatytai blokuoja pavojingus išorinius prisijungimus ugniasienės ir maršrutizatoriaus lygmeniu. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Jei maršrutizatorius nepalaiko UPnP, reikės paieškoti informacijos apie konkrečią maršrutizatoriaus sąsają. + +Taip pat galite naudoti [Ngrok](https://ngrok.com/) sukurti laikiną adresą. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Patikrinkite, ar reikalingas portų peradresavimas + +Įveskite ir paleiskite šią komandą vykdymo lange. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jei išvestis yra `True`, galite sustoti, jei `False`, turėsite nustatyti portų peradresavimą. + +### 6.2 Prisijungimas prie serverio + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Prisijungimo adresas galite patikrinti [čia](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Tada paleiskite serverį ir Plazma automatiškai bandys nustatyti portų peradresavimą. + +Sėkmės UPnP atveju bus matoma pagal išvestį konsolėje, kurioje bus rodomas `[UPnP] (pranešimas)`. + +| Pranešimas | Reikšmė | +| ----------------------------------------- | -------------------------------------------------------- | +| `Sėkmingai atidarytas prievadas (portas)` | Portų peradresavimas sėkmingas. | +| `Prievadas (portas) jau yra atviras` | Kitas paslaugas jau naudoja šį prievadą. | +| `Nepavyko atidaryti prievado (portas)` | Portų peradresavimas nepavyko. | +| `Paslauga nepasiekiama` | Maršrutizatorius nepalaiko UPnP. | + +Uždarius serverį, Plazma automatiškai uždarys prievadą. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Iš [Ngrok svetainės](https://ngrok.com/download) atsisiųskite `Windows (64-bit)` ZIP failą. +2. Įdėkite atsisiųstą Ngrok į serverio aplanką. +3. [Ngrok skydelis](https://dashboard.ngrok.com/get-started/your-authtoken) leidžia [sukurti autentifikacijos raktą](#user-content-fn-13)[^13]. +4. Serverio aplanke įvykdykite komandą, kurią rodo `Command Line` skyriuje. +5. Paleidimo scenarijaus viršuje pridėkite `start /b ngrok tcp --region jp 25565`, o apačioje - `taskkill /f /t /im ngrok.exe`. +6. `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` yra rodomas konsolės viršuje, čia `0.tcp.jp.ngrok.io:12345` tampa serverio adresu. +7. Dabar galite prisijungti iš išorės naudodami šį adresą. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Pavyzdžiui, jei po komandos vykdymo atrodo taip, + +```log +Windows IP konfigūracija + +Ethernet adapter Ethernet: + + Prijungtas DNS sufiksas. . . . : + IPv4 adresas. . . . . . . . : 192.168.3.7 + Podtinklo kaukė . . . . . . . : 255.255.255.0 + Numatytasis šaltinis . . . . . . : 192.168.3.1 + +``` + +Bandydami prisijungti prie serverio iš vietinės mašinos, naudokite `192.168.3.7`, kuris yra IPv4 adrese, kad prisijungtumėte. + +Jei serveris ir žaidimas vyksta toje pačioje PC, galite prisijungti naudodami `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Tobulėkite + +Kai serveris sėkmingai paleistas ir veikia teisingai, dabar laikas pritaikyti serverį pagal savo poreikius. + +Sužinokite, kaip pritaikyti serverį, peržiūrėdami žemiau pateiktą vadovą. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, kuris yra pagrįstas Plazma, remiasi Spigot ir yra oficialus serverio platformos pagrindas. + +[^3]: Windows klavišai + R + +[^4]: Linux atveju terminale naudokite `java --version` + +[^5]: JRE yra vienas iš atviro kodo projektų, kaip ir Minecraft serverio platforma, kuri turi daugybę variantų. + +[^6]: Įprastai žinomas kaip **vykdyklė**. + +[^7]: Įjungus „Automatinį paleidimą“, serveris automatiškai perkraunamas. Norėdami sustabdyti, įveskite `Control + C`. + +[^8]: Nerekomenduojama viršyti daugiau nei pusės sistemos resursų. + + Pavyzdžiui, jei viso sistemos atminties talpa yra 8GB, nerekomenduojama nustatyti daugiau kaip 4GB. + +[^9]: Galutinio vartotojo licencijavimo sutartis, End-User License Agreement. Daugiau informacijos rasite [Minecraft svetainėje](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Pagal Korėjos žaidimų pramonės skatinimo įstatymo 32 straipsnio 1 dalies 9 punktą, **Korea Microsoft Corporation** gali teikti teisminę ieškinį. + +[^12]: Universalus įtaisų jungimas ir grojimas, Universal Plug & Play. Purpur, įtrauktas į Plazma, automatiškai bendrauja su maršrutizatoriumi per šią technologiją, todėl nereikia tiesiogiai konfigūruoti portų persiuntimo, kai serveris veikia. + +[^13]: Jei neturite paskyros, užsiregistruokite į Ngrok naudodami „Google“ arba „GitHub“ paskyrą. diff --git a/lt/origin/plazma/administration/getting-started/customization.md b/lt/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..6ff15f206 --- /dev/null +++ b/lt/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,123 @@ +--- +description: Sužinokite, kaip pritaikyti serverį vartotojui. +--- + +# 🎨 Vartotojų pritaikymas + +Naudojant patobulintą serverio platformą, tokia kaip Plazma, o ne oficialią Mojang Studios teikiamą serverio platformą, pagrindinė priežastis yra galimybė labai stipriai **pritaikyti**. + +Žemiau pateikiami keli būdai, kaip pritaikyti ir naudoti Plazmą. + +## Konfigūracijos pakeitimas + +Paprastiausias būdas pritaikyti Plazmą yra tiesiog pakeisti konfigūraciją. + +Plazma teikia galimybę nustatyti stiprius konfigūracijos parametrus nuo žaidimo mechanikos iki būtybių savybių. + +Daugiau informacijos apie Plazmos konfigūraciją rasite žemiau pateiktame puslapyje. + +{% content-ref url="../reference/configurations/" %} +[konfigūracijos](../reference/configurations/) +{% endcontent-ref %} + +## Įskiepiai + +{% hint style="success" %} + +**Plazma palaiko visus popieriaus pagrindu veikiančius įskiepius.** + +Spigot įskiepiams, pradedant nuo 1.20.5, dėl Paper žemėlapio pasikeitimų kai kurie gali neveikti, +Tačiau dauguma įskiepių, kurie yra pagrįsti Paper, Pufferfish ar Purpur, veiks Plazmoje, +ir jei jie neveiks tinkamai, tai yra Plazmos klaida, todėl nedelsiant [praneškite apie tai.](../diagnosis/plugins.md) + +{% endhint %} + +Tai svarbiausias Plazmos naudojimo motyvas ir galingiausias būdas pritaikyti Plazmą vartotojui. +Plazmos galinga įskiepių ekosistema leidžia lengvai pritaikyti serverį vartotojui. + +Yra keletas būdų rasti ir atsisiųsti įskiepius. Kai kurie įskiepiai +yra įkelti į viešą saugyklą ir kai kurie į GitHub ar savo +svetainę. + +{% hint style="caution" %} + +**Įskiepiai gali tiesiogiai prieiti prie sistemos!** + +Prieš taikydami įskiepį, visada patikrinkite jo saugumą naudodami VirusTotal ar kitas paslaugas arba +atsisiųskite įskiepį iš patikimos paslaugos. + +{% endhint %} + +Yra keletas paslaugų, skirtų įskiepiams atsisiųsti. Iš jų, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) ir kt. paslaugos įskiepius vertina prieš įkeliant ir tik saugūs įskiepiai platinami. + +### Taikyti įskiepį + +Kai įskiepis atsisiųstas, dabar laikas jį taikyti. + +1. Įskiepis yra `.jar` arba `Java vykdomasis failas`.\ + Kai kurie įskiepiai gali būti suspausti, tokiu atveju + išpakuokite failą, kuriame yra `bukkit`, `spigot` ar `paper` pavadinime ir + naudokite failą, kuriame yra `fat` kartu su kitais failais. +2. Įkeltą failą įkelkite į serverio `plugins` aplanką ir paleiskite (iš naujo) serverį. +3. Kai Plazma paleidžiama, konsolėje bus rodomas naujas turinys. + Tai reiškia, kad Plazma sėkmingai įkėlė įskiepį. +4. Nors Plazma sėkmingai įkėlė įskiepį, gali būti, kad įskiepis nepradėjo veikti. + Naudodami komandą `/plugins`, galite pamatyti įkeltus įskiepius serveryje. + Jei įskiepis, kurį įkėlėte, nėra raudonas, o žalias, tai reiškia, kad įskiepis sėkmingai įkeltas. + +Jei įskiepis nebuvo sėkmingai įkeltas, galite rasti problemos sprendimo būdus žemiau pateiktame puslapyje. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Duomenų paketo naudojimas + +Duomenų paketas yra Minecraft pagrindinis vartotojo pritaikymo būdas, panašus į +[šaltinių paketus](#user-content-fn-1)[^1]. + +Naudojant duomenų paketą, galite redaguoti žaidimo dalis, pvz., pridėti naujų būtybių rūšių ir iššūkių. + +{% hint style="caution" %} + +**Duomenų paketas gali sugadinti pasaulį!** + +Kai kurie sugadinti duomenų paketai gali sugadinti pasaulį ir tai negali būti atstatyta. + +Dėl šios priežasties prieš taikydami duomenų paketą rekomenduojama atlikti pasaulio atsarginę kopiją. + +{% endhint %} + +Duomenų paketą galima atsisiųsti iš įvairių paslaugų, tokių kaip [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) ir kt. + +Atsisiuntus duomenų paketą, jį galima pritaikyti įkeliant į serverio pasaulio aplanką `datapacks` aplanką. +Jei aplanko nėra, jį galima sukurti ir pridėti. + +{% hint style="įspėjimas" %} + +**Kai kurių [duomenų paketų](#user-content-fn-2)[^2] pritaikymas pirmą kartą gali būti nesėkmingas.** + +Tokiu atveju rekomenduojama **2 kartus** paleisti serverį. + +{% endhint %} + +Duomenų paketai gali būti lengvai sugadinti kiekvieną kartą, kai atnaujinamas Minecraft versija. + +Ypač, jei duomenų paketas yra visiškai sugadintas, serveris gali susidurti su sutrikimais, +todėl prieš atnaujinant serverį svarbu atlikti pakankamai testavimo. + +{% hint style="info" %} + +**Paleidus serverį, galima įvesti `safeMode` po serverio paleidimo komandos, kad išjungtumėte visus duomenų paketus ir tada paleisti serverį.** + +[Daugiau informacijos rasite `Nuorodų > Argumentai ir savybės` skyriuje.](../reference/arguments.md) + +{% endhint %} + +Pritaikytus duomenų paketus galima patikrinti naudojant komandą `/datapack list`. + +*** + +[^1]: Arba Minecraft: Bedrock Edition papildymai. + +[^2]: Pridėti būtybių rūšis ir kt. diff --git a/lt/origin/plazma/administration/getting-started/next-step.md b/lt/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..d172bd8df --- /dev/null +++ b/lt/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Sužinokite, kaip pritaikyti serverį vartotojui. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Žemiau pateikiami keli būdai, kaip pritaikyti ir naudoti Plazmą. + +## Konfigūracijos pakeitimas + +Paprastiausias būdas pritaikyti Plazmą yra tiesiog pakeisti konfigūraciją. + +Plazma teikia galimybę nustatyti stiprius konfigūracijos parametrus nuo žaidimo mechanikos iki būtybių savybių. + +Daugiau informacijos apie Plazmos konfigūraciją rasite žemiau pateiktame puslapyje. + +{% content-ref url="../reference/configurations/" %} +[konfigūracijos](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Įskiepiai + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Tai svarbiausias Plazmos naudojimo motyvas ir galingiausias būdas pritaikyti Plazmą vartotojui. Plazmos galinga įskiepių ekosistema leidžia lengvai pritaikyti serverį vartotojui. + +Yra keletas būdų rasti ir atsisiųsti įskiepius. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Yra keletas paslaugų, skirtų įskiepiams atsisiųsti. Iš jų, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) ir kt. paslaugos įskiepius vertina prieš įkeliant ir tik saugūs įskiepiai platinami. + +### Taikyti įskiepį + +Kai įskiepis atsisiųstas, dabar laikas jį taikyti. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Įkeltą failą įkelkite į serverio `plugins` aplanką ir paleiskite (iš naujo) serverį. +3. Kai Plazma paleidžiama, konsolėje bus rodomas naujas turinys. Tai reiškia, kad Plazma sėkmingai įkėlė įskiepį. +4. Nors Plazma sėkmingai įkėlė įskiepį, gali būti, kad įskiepis nepradėjo veikti. Naudodami komandą `/plugins`, galite pamatyti įkeltus įskiepius serveryje. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Jei įskiepis nebuvo sėkmingai įkeltas, galite rasti problemos sprendimo būdus žemiau pateiktame puslapyje. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Duomenų paketo naudojimas + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Naudojant duomenų paketą, galite redaguoti žaidimo dalis, pvz., pridėti naujų būtybių rūšių ir iššūkių. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Kai kurie sugadinti duomenų paketai gali sugadinti pasaulį ir tai negali būti atstatyta. + +Dėl šios priežasties prieš taikydami duomenų paketą rekomenduojama atlikti pasaulio atsarginę kopiją. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Atsisiuntus duomenų paketą, jį galima pritaikyti įkeliant į serverio pasaulio aplanką `datapacks` aplanką. Jei aplanko nėra, jį galima sukurti ir pridėti. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Tokiu atveju rekomenduojama **2 kartus** paleisti serverį. +{% endhint %} + +Duomenų paketai gali būti lengvai sugadinti kiekvieną kartą, kai atnaujinamas Minecraft versija. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Pritaikytus duomenų paketus galima patikrinti naudojant komandą `/datapack list`. + +*** + +## Optimizavimas + +Plazmoje taikyta daug optimizavimo patobulinimų. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Tarpininkas + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Daugiau informacijos apie saugų ir teisingą tarpininko nustatymą rasite žemiau pateiktame puslapyje. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Saugumas + +Minecraft, besivystant modams, lengvai gali būti rasta internete ir naudojama [pažeidžiamųjų atakų variklių](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Leidimų nustatymas + +Kai kurių įskiepių administratoriaus komandos gali turėti pažeidžiamumų, jei leidimai nėra tinkamai nustatyti. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokavimas + +X-Ray yra vienas iš pažeidžiamumų, kurį lengva naudoti net su pagrindiniu optimizavimo klientu. + +Plazmoje yra konfigūracija, kuri pagrindiniu lygiu blokuoja X-Ray naudojimą. + +X-Ray blokavimo būdas ir aprašymas pateikti žemiau pateiktame puslapyje. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Baltasis sąrašas + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Norėdami pamatyti, kokie žaidėjai yra įtraukti į baltąjį sąrašą, naudokite `/whitelist query`. + +*** + +[^1]: Arba Minecraft: Bedrock Edition papildymai. + +[^2]: Pridėti būtybių rūšis ir kt. + +[^3]: Paprastai vadinamas „cheat“. + +[^4]: Jei konfigūracija nėra optimizuota, Plazma yra sena arba yra naujų pažeidžiamumų, gali būti, kad blokavimas neveiks. + +[^5]: Kai žaidėjas prisijungia prie serverio, jis prisijungia per Ngrok tarpinio serverio, o kiekvieno paleidimo metu skiriasi Ngrok adresas. diff --git a/lt/origin/plazma/administration/reference/README.md b/lt/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..fb4864aed --- /dev/null +++ b/lt/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Sužinokite, kaip naudotis Plazma numatytais vartotojo pritaikymo būdais. +--- + +# 📜 리퍼런스 + +Plazma siūlo įvairius vartotojo pritaikymo būdus. + +Iš jų, šie 4 būdai yra vartotojo pritaikymo būdai, kuriuos galima naudoti be papildomo darbo. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Oficialus „Discord“ serveris](https://discord.gg/MmfC52K8A8) arba [„GitHub“ diskusijos](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - užduokite bendruomenei klausimą! +{% endhint %} + +*** + +## 🖥️ Komandos + +> Komandos leidžia rinkti informaciją žaidime arba pritaikyti žaidimo aplinką vartotojui. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Leidimai + +> Leidimai nustato, kokiame mastelyje žaidėjas gali sąveikauti. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumentai ir savybės + +> Argumentai ir savybės turėjo įtakos Plazmos veikimui. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigūracija + +> Konfigūracija yra pagrindinis būdas pritaikyti Plazmą. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/lt/origin/plazma/administration/reference/arguments.md b/lt/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..477ceea9a --- /dev/null +++ b/lt/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Sužinokite apie pradinį argumentą ir sistemos savybes. +--- + +# 🎛️ Argumentas ir savybės + +Pradžios argumentai ir sistemos savybės yra reikšmės, pridedamos prie Plazma vykdymo [naudojamų komandų](#user-content-fn-1)[^1], kurios turi įtakos Plazmos veikimui iš esmės. + +\[Pagal **pradinius parametrus** ir **sistemos savybes** bus suskirstyta pagal [komandos papildymo vietą](#user-content-fn-2)[^2]. + +*** + +## Sistemos savybės + +Sistemos savybės yra reikšmės, įvestos prieš Plazmos inicijavimą prieš JVM, kuris jas apdoroja. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Naudojimo instrukcija + +Sistemos savybės įvedamos kaip Java komandos argumentas tarp `java` ir `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` nurodo, kad ši reikšmė yra specialus argumentas, pridėtas prie Plazmos, o + +Jei į savybes neįvedate jokios vertės, vertė bus nustatyta kaip [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Visos sistemos savybės + +#### `convertLegacySigns` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Atnaujina naudojamus išjungtus ženklus. + +#### `debug.entities` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia susijusią entiteto informacijos derinį. + +#### `debug.rewriteForIDE` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +IDE teisingai įkelia derinimo informaciją, išjungia NMS reviziją ir automatiškai pertvarko vidinę versijos informaciją. + +#### `disable.watchdog` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia Spigot stebėjimo šuns sistemos įspėjimus. + +#### `letMeReload` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia patvirtinimo pranešimą dėl `reload` komandos. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Jeigu esate įskiepių kūrėjas ir turite atnaujinti įskiepius, naudokite šilumą vietoj `reload` komandos. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia įprastos įvesties-išvesties sistemos įskiepius. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įspėja, kai aptinkamas pasenusi formatavimo sistema pokalbių komponente. + +#### `Paper.bypassHostCheck` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia serverio šablono patikros patikrinimą, kai žaidėjas prisijungia prie serverio. + +#### `Paper.debugDynamicMissingKeys` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia derinimo įrašus, susijusius su praleistomis NBT raktažodžių dalimis. + +#### `Paper.debugInvalidSkullProfiles` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia derinimo įrašus, susijusius su netinkamais kaukių profiliais. + +Tai įrašo visus neteisingus kaukių blokus žemėlapyje kartu su jų vietomis. + +#### `Paper.disableChannelLimit` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia įskiepių klasės prioritizavimo sistemą. + +Tai naudinga, jei yra problemų su įskiepių šešėliu. + +#### `Paper.disableFlushConsolidate` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia Netty nusistovėjusią plūduriavimo konsolidavimo sistemą. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Numatytasis**: `750` + +Jei entitetas yra didesnis nei nustatyta vertė, jis siunčiamas skaidruose paketuose. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Numatytasis**: `8192` + +Nustato didžiausią paketo dydį, kurį serveris gali priimti vienu metu. + +#### `Paper.ignoreJavaVersion` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia Java versijos patikrinimą. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Tai gali pakenkti failams ir visam žaidimo mechanizmui, nes jie gali būti negrįžtamai sugadinti. + +Visos su tuo susijusios problemos yra jūsų atsakomybė, o Plamza nepateiks jokios pagalbos šiuo atveju. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Numatytasis**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Numatytasis**: `80` + +Nustato didžiausią simbolių skaičių, kurį galima įvesti į vieną piktogramą. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Numatytasis**: `(pasaulio versija) + 1` + +Nustato pradinės pasaulio atnaujinimo informacijos versiją. + +Tai naudinga tik tais atvejais, kai reikia atnaujinti didžiulius kiekvieno ruožo duomenis, tačiau kitais atvejais nebenaudojama. + +#### `Paper.parseYamlCommentsByDefault` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `True` + +Įjungia YAML failų komentarų apdorojimą. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Numatytasis**: `30` + +Jei žaidėjas neperduoda jokių duomenų per nustatytą laiką (sekundėmis), jis bus išmestas iš žaidimo. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Ignoruoja serverio savybių komentarus. + +#### `Paper.debug-sync-loads` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia sinchronizuotų ruožų kūrimo derinimo įrašus. + +#### `Paper.enable-sync-chunk-writes` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia Minecraft [numatytą ruožų kūrimo sistemą](#user-content-fn-10)[^10]. + +Tai leidžia kiekvieną ruožą išsaugoti eilės tvarka, kuri labai sumažina našumą. + +#### `Paper.explicit-flush` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia tinklo kanalo išsamią nusistovėjimą. + +#### `Paper.strict-thread-checks` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Visada žurnališkai užfiksuoja klaidas, kurios neįvyko pagrindiniame gijime. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Jeigu užduotis turi per didelį laukimo laiką, išspausdina įspėjimą. + +#### `Paperclip.patchOnly` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Kai naudojamas numatytas vykdomasis failas, tačiau nepradedamas serveris, tik taikomi pataisymai. + +#### `Plazma.aggressiveOptimize` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` +- **Konfliktas**: `Plazma.disableConfigOptimization` + +Stipriau optimizuoja pradinę konfigūraciją. + +Įjungus šį nustatymą serveris tampa greitesnis ir saugesnis, tačiau gali turėti didelį poveikį žaidimo procesui. + +#### `Plazma.disableConfigOptimization` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` +- **Konfliktas**: `Plazma.aggressiveOptimize` + +Neoptimizuoja pradinės konfigūracijos. + +Tai nustato paprastąjį Paper konfigūracijos variantą. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` + +Išjungia Plazma prekinį ženklą ir naudoja standartinį serverio favicon. + +#### `Plazma.useVanillaConfiguration` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` +- **Konfliktas**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Tai gali labai paveikti serverio saugumą ir veikimą. + +Visos problemas, kylančios naudojant šį parametrą, yra operatoriaus dėl serverio. +{% endhint %} + +Nustato pradinę konfigūraciją pagal Mojang numatytuosius nustatymus. + +Tai atšaukia visus ištaisytus pažeidžiamumus, kuriuos taiko Paper. + +Ištaisymus galima vėl įjungti naudojant Paper arba Plazma konfigūracijas. + +#### `Plazma.vanillaize` + +- **Formatas**: `Logiškas` +- **Pagal nutylėjimą**: `true` +- **Konfliktas**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Nustato pradinę konfigūraciją artimą standartiniam variantui. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Nebenaudojamas atributas + +Žemiau pateikti sistemos atributai yra nebenaudojami. + +#### `timings.bypassMax` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` +- **Nebenaudojamas**: Timings buvo pašalintas iš Plazma nuo + +Nusprendžia, ar galima viršyti maksimalų Timings API siunčiamų reikšmių skaičių. + +Jei tai padarysite, tačiau API neapdoros išimčių, bus taikomas greičio apribojimas. + +*** + +## Pradžios argumentas + +Pradžios argumentas yra įvestas po `-jar *.jar` ir yra reikšmė, kuri bus apdorota kartu su Plazma inicializavimu. + +### Naudojimo instrukcija + +Sistemos savybės yra įvestos po `-jar *.jar` kaip programos komandiniai argumentai. + +Pavyzdžiui, norint pritaikyti pradžios argumentą `nogui`,\ +įvedus taip, Plazma inicializuojant bus apdorotas argumentas `nogui`. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Visas pradžios argumentas + +#### `bukkit-settings` + +- **Pseudonimas**: `b` +- **Numatytoji reikšmė**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Pseudonimas**: `c` +- **Numatytoji reikšmė**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Pseudonimas**: `c` +- **Numatytoji reikšmė**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Paleidžia serverį su demonstraciniu pasauliu. + +#### `eraseCache` + +Ištrina likusius talpyklos failus po pasaulio atnaujinimo. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Pseudonimas**: `?` + +Atspausdina Plazmos visus pradžios argumentus ir aprašymą. + +#### `initSettings` + +Sukuria tik konfigūracijos failą ir išjungia serverį. + +#### `jfrProfile` + +Įjungia JFR profilį. + +#### `max-players` + +- **Pseudonimas**: `s`, `size` +- **Numatytoji reikšmė**: `(serverio savybė)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Išjungia grafinį sąsajos skydelį. + +#### `nojline` + +Išjungia JLine ir naudoja standartinę konsolę. + +#### `online-mode` + +- **Pseudonimas**: `o` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Pasirenka, ar patikrinti žaidėją su Mojang autentifikavimo serveriu. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Pseudonimas**: `paper` +- **Numatytoji reikšmė**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Nustato naudoto PaperSpigot konfigūracijos failo vietą. + +Tai naudojama perkelti seną konfigūraciją į naują failą, po to ji nebeveikia. + +#### `paper-settings-directory` + +- **Pseudonimas**: `paper-dir` +- **Numatytoji reikšmė**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Pseudonimas**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Pseudonimas**: `p` +- **Numatytoji reikšmė**: `plugins` + +Nustato papildomų įskiepių aplankalo vietą. + +#### `pufferfish-settings` + +- **Pseudonimas**: `pufferfish` +- **Numatytoji reikšmė**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Pseudonimas**: `purpur` +- **Numatytoji reikšmė**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Paleidžia serverį saugiuoju režimu, kaip visiškai standartinį. + +#### `server-ip` + +- **Pseudonimas**: `h`, `host` +- **Numatytoji reikšmė**: `(serverio savybė)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Pseudonimas**: `p`, `port` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Nustato serverio prievadą. + +#### `server-name` + +- **Numatytoji reikšmė**: `A Plazma Server` + +Nustato serverio pavadinimą. + +#### `spigot-settings` + +- **Pseudonimas**: `S` +- **Numatytoji reikšmė**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Pseudonimas**: `v` + +Atspausdina Plazma versiją. + +#### `world-dir` + +- **Pseudonimas**: `W`, `universe`, `world-container` +- **Numatytoji reikšmė**: `(serverio aplankas)` + +Nustato vietą, kur saugomi pasaulio failai. + +#### `world-name` + +- **Pseudonimas**: `w`, `world` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Nustato pasaulio failo pavadinimą. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Parametrų tvarka priklauso nuo vietos, kurioje yra pridėti argumentai. + +[^3]: Pavyzdžiui, norint nustatyti `Plazma.iKnowWhatIAmDoing` į `true`, vietoje `-DPlazma.iKnowWhatIAmDoing=true` galima įvesti tik `-DPlazma.iKnowWhatIAmDoing` ir taip pat veiks. + +[^4]: Pavyzdžiui, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Įvykio jutiklis. + +[^6]: Įvykio jutiklis. + +[^7]: Klientas. + +[^8]: Signalas, pranešantis, kad serveris yra sėkmingai prijungtas kaip širdies plakimas. + +[^9]: Naudodami Purpur AFK išmesti funkciją, galite išmesti net tuos žaidėjus, kurie paliko vietą. + +[^10]: Sinchroninis ruožo rašymo sistema, Sync Chunk Write System. + +[^11]: `ĮSPĖJIMAS! Plazma gali sukelti netikėtų problemų, todėl būtinai išsamiai išbandykite jį prieš naudojant jį viešame serveryje.` + +[^12]: Žaidimuose `pasaulio optimizavimas` taip pat veikia pagal šį principą. + +[^13]: `Lygio 2` arba aukštesnis administratorius yra išskiriamas. + +[^14]: Interneto protokolas, IP. diff --git a/lt/origin/plazma/administration/reference/commands.md b/lt/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..c87ec4c1a --- /dev/null +++ b/lt/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kokius komandas galima naudoti „Plazma“. +--- + +# 🖥️ Komandos diff --git a/lt/origin/plazma/administration/reference/configurations/README.md b/lt/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..3b91a1c7e --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigūracija yra pagrindinis būdas pritaikyti Plazmą. +--- + +# 🧾 구성 + +*** + +## 🪨 Savybės + +> Savybės yra pagrindinis Minecraft teikiamas konfigūracijos failas. Naudodami savybes galite pakeisti žaidimo pagrindinius mechanizmus. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit konfigūracija + +> Bukkit konfigūracija yra pagrindinis Plazma teikiamas konfigūracijos failas. Naudodami Bukkit konfigūraciją galite pakeisti Minecraft serverio pagrindinius mechanizmus. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot konfigūracija + +> Spigot konfigūracija leidžia keisti žaidimo detaliuosius mechanizmus, žaidėjų apdorojimą, komandas ir tt. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper konfigūracija + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish konfigūracija leidžia keisti Plazmos pasaulio ir entiteto tvarkymą. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur konfigūracija + +> Purpur savybės leidžia keisti žaidimo bendrą duomenų struktūrą. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfigūracija + +> Plazma konfigūracija leidžia pritaikyti Plazmos funkcijas vartotojui. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/lt/origin/plazma/administration/reference/configurations/bukkit.md b/lt/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..17ebf6164 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas bukkit.yml mazgas. +--- + +# 🪣 Bukkit diff --git a/lt/origin/plazma/administration/reference/configurations/paper/README.md b/lt/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9dd22fac7 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kokia yra kiekvieno failo config aplankale paskirtis. +--- + +# 🛩️ Popierius diff --git a/lt/origin/plazma/administration/reference/configurations/paper/global.md b/lt/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..d60e4de29 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas paper-global.yml mazgas. +--- + +# 🌏 전역 구성 diff --git a/lt/origin/plazma/administration/reference/configurations/paper/world.md b/lt/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..9e6543754 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Sužinokite, ką reiškia kiekvienas paper-world.yml mazgas. +--- + +# 🏳️ 세계별 구성 + +Pasaulio diff --git a/lt/origin/plazma/administration/reference/configurations/plazma/README.md b/lt/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..3ef8353e0 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kokia yra kiekvieno failo config aplankale paskirtis. +--- + +# ✨ Plazma diff --git a/lt/origin/plazma/administration/reference/configurations/plazma/global.md b/lt/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..6c467381b --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Išsiaiškinkite, ką reiškia kiekvienas plazma-global.yml mazgas. +--- + +# 🌏 전역 구성 diff --git a/lt/origin/plazma/administration/reference/configurations/plazma/world.md b/lt/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..e88470938 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas plazma-world.yml mazgas. +--- + +# 🏳️ 세계별 구성 diff --git a/lt/origin/plazma/administration/reference/configurations/plazma/worlds.md b/lt/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..7397f1e2f --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas plazma-world.yml mazgas. +--- + +# ✨ Plazma (pasaulių struktūra) diff --git a/lt/origin/plazma/administration/reference/configurations/property.md b/lt/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..ff669ef08 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas server.properties mazgas. +--- + +# 🪨 Server.properties diff --git a/lt/origin/plazma/administration/reference/configurations/pufferfish.md b/lt/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..744e03b7d --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką kiekvienas pufferfish.yml mazgas reiškia. +--- + +# 🐡 Pufferfish diff --git a/lt/origin/plazma/administration/reference/configurations/purpur/README.md b/lt/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..44595d571 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas purpur.yml mazgas. +--- + +# 🦑 Purpur diff --git a/lt/origin/plazma/administration/reference/configurations/purpur/global.md b/lt/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..94cac7f3e --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas purpur.yml mazgas. +--- + +# 🌏 전역 구성 diff --git a/lt/origin/plazma/administration/reference/configurations/purpur/world.md b/lt/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..6d98c718a --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas purpur.yml mazgas. +--- + +# 🏳️ 세계별 구성 diff --git a/lt/origin/plazma/administration/reference/configurations/spigot.md b/lt/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..ed07c0cb4 --- /dev/null +++ b/lt/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas spigot.yml mazgas. +--- + +# 🚰 Spigot diff --git a/lt/origin/plazma/administration/reference/permissions.md b/lt/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..20a55cc85 --- /dev/null +++ b/lt/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Sužinokite apie Plazma teises. +--- + +# 🛡️ Teisės + +Leidimai yra paprastas saugumo įrankis, nustatantis serverio žaidėjų sąveikos galimybės. + +Norint tinkamai naudoti leidimus ir lengvai juos keisti, reikia naudoti įskiepius, pvz., [LuckPerms](https://luckperms.net). + +*** + +## Suprasti pagrindinę leidimų sistemą + +Minecraft teikia pagrindinius valdymo leidimų grupes. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Žaidėjas**\ + Paprastai tai yra priskiriamas visiems žaidėjams leidimų grupė. +2. **Tarpininkas**\ + Gali ignoruoti spawno apsaugą. +3. **Pasaulio valdytojas**\ + Gali naudoti visas komandas ir komandų blokus, susijusius su pasaulio valdymu.\ + Tai yra numatytasis leidimų grupė, taikomas duomenų paketams ir komandų blokams. +4. **Administratorius**\ + Gali naudoti visas komandas, susijusias su žaidėjų valdymu. +5. **Visagalis**\ + Gali naudoti visas komandas, įskaitant serverio valdymą.\ + Tai yra numatytasis leidimų grupė, taikomas konsolėje ir administratoriams. + +*** + +## Leidimų nustatymas + +*** + +## Visiški leidimai + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Numatytasis**: `None` + +Leidžia žaidėjams šliaužti prie entiteto ir jį apeiti. + +Kai sėdite ant entiteto, galite valdyti jo judėjimą naudodami `judėjimo klavišus` ir šokinėti arba skristi naudodami `šuolio klavišą`. + +Į `(Namespaced Key)` įveskite entiteto [Namespaced ID](#user-content-fn-2)[^2]. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Numatytasis**: `None` + +Leidžia žaidėjams naudoti entiteto specialias funkcijas, kai jie sėdi ant jo. + +Ne visiems entitetams yra leidžiama naudoti specialias funkcijas. Pilną specialių funkcijų sąrašą rasite žemiau. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Paskelbkite savo idėjas [Plazma Discord](https://plazmamc.org/discord) arba [GitHub diskusijose](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Žiūrėti dabartines specialias funkcijas + +- **`crepper`**\ + Paspaudus `šuolio klavišą`, jis sprogs.\ + Jei žaidėjas turi `allow.powered.creeper` leidimą, jis gali ilgai laikyti `šuolio klavišą`, kad įkrautų. +- **`dolphin`**\ + Paspaudus `šuolio klavišą`, jis puola. +- **`phantom`**\ + Paspaudus `šuolio klavišą`, jis išspjaudys ugnį. +- **`wither`**\ + Jei su juo sąveikaujate, jis iššaudys wither galvą. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/compass` komandą](commands.md#compass). + +#### `bukkit.command.credits` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/credits (Žaidėjas)` komandą](commands.md#credits). + +Įrašius leidimo pavadinimą pabaigoje `.other`, leidžia kitiems žaidėjams naudoti. + +#### `bukkit.command.demo` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/demo (Žaidėjas)` komandą](commands.md#demo). + +Įrašius leidimo pavadinimą pabaigoje `.other`, leidžia kitiems žaidėjams naudoti. + +#### `bukkit.command.ping` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/ping (Žaidėjas)` komandą](commands.md#ping). + +Įrašius leidimo pavadinimą pabaigoje `.other`, leidžia kitiems žaidėjams naudoti. + +#### `bukkit.command.ram` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/ram` komandą](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/rambar (Žaidėjas)` komandą](commands.md#rambar). + +Įrašius leidimo pavadinimą pabaigoje `.other`, leidžia kitiems žaidėjams naudoti. + +#### `bukkit.command.restart` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/restart` komandą](commands.md#restart). + +#### `bukkit.command.tps` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/tps` komandą](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/tpsbar (Žaidėjas)` komandą](commands.md#tpsbar). + +Įrašius leidimo pavadinimą pabaigoje `.other`, leidžia kitiems žaidėjams naudoti. + +#### `bukkit.command.timings` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/timings` komandą](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Norėdami sužinoti apie panašias funkcijas, apsilankykite [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/uptime` komandą](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia naudoti [`/gamemode (GameMode) (Žaidėjas)` komandą](commands.md#gamemode). + +Įrašius leidimo pavadinimą pabaigoje `.other`, leidžia kitiems žaidėjams naudoti. + +#### `paper.antixray.bypass` + +- **Numatytasis**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Tai leidžia abiem pusėms patirti našumo pagerėjimą. + +> Norėdami sužinoti daugiau apie X-Ray nustatymus, apsilankykite žemiau pateiktame puslapyje. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Numatytasis**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Numatytasis**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Numatytasis**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Numatytasis**: `None` + +Leidžia naudoti [MiniMessage žymes](https://docs.advntr.dev/minimessage/format.html) kalvėje. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Numatytasis**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Numatytasis**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Numatytasis**: `None` + +Išskiria žaidėją iš neaktyvių išmetimo sąrašo. + +#### `purpur.debug.f3n` + +- **Numatytasis**: `Pasaulio valdytojas` + +Leidžia žaidėjui naudoti `F3 + N` klavišus keisti žaidimo režimą. + +Veiks tik turint atitinkamą žaidimo režimo leidimą. + +#### `purpur.drop.spawners` + +- **Numatytasis**: `None` + +Iškasant bloką, nustatytą konfigūracijoje, sukuria spawnerį. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Numatytasis**: `None` + +Keičia enderlado dydį. + +Į `(NumberString)` galima įvesti `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Numatytasis**: `None` + +Leidžia totemui veikti, net jei jis yra inventoriuje. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Numatytasis**: `None` + +Leidžia žaidėjui ignoruoti prisijungusių vartotojų limitą. + +#### `purpur.mending_shift_click` + +- **Numatytasis**: `None` + +Leidžia žaidėjui remontuoti laikomą daiktą, kai jis `pasilenkia ir sąveikauja`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Numatytasis**: `None` + +Leidžia žaidėjui įdiegti spawnerius. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Numatytasis**: `None` + +Leidžia žaidėjui iškart teleportuotis, kai jis naudoja Nether portalą. + +#### `purpur.sign.color` + +- **Numatytasis**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Numatytasis**: `None` + +Leidžiama naudoti kodavimo simbolį `(&o)` ant ženklelio. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Numatytasis**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Numatytasis**: `None` + +Leidžiama žaidėjui su švyturėliu `sąveikauti` ir išvengti TNT sprogimo. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Suteikiamos numatomosios teisės + +#### `plazma.bypass.ncr-require` + +- **Numatytasis**: `None` + +Leidžiama žaidėjui prisijungti neturint įdiegto [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) modifikacijos. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operatorius. + +[^2]: Pavyzdys: `ender_dragon` diff --git a/lt/origin/plazma/adminstration/README.md b/lt/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..0fb1f60f3 --- /dev/null +++ b/lt/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Sukurkite savo serverį naudodami Plazmą. +--- + +# ⚒️ Serverio valdymo vadovas diff --git a/lt/origin/plazma/adminstration/expert/README.md b/lt/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..ef76270ae --- /dev/null +++ b/lt/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite profesionaliai valdyti Plazma. +--- + +# 🎓 Gili studija diff --git a/lt/origin/plazma/adminstration/expert/fix-exploits.md b/lt/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..c4fa12455 --- /dev/null +++ b/lt/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite apie žinomas pažeidžiamas vietas ir jų sprendimo būdus. +--- + +# ⚠️ Žinomos pažeidžiamos vietos ir jų sprendimo būdai diff --git a/lt/origin/plazma/adminstration/expert/optimize.md b/lt/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..5fe262985 --- /dev/null +++ b/lt/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kaip optimizuoti Plazmą. +--- + +# 🧹 Optimizavimas diff --git a/lt/origin/plazma/adminstration/expert/vanillaize.md b/lt/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..7b3f066ca --- /dev/null +++ b/lt/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Sužinokite, kaip atkurti „Paper“ ir „Vanilla“ pataisų derinį. +--- + +# ↩️ Vanilės pataisymas + +{% hint style="įspėjimas" %} + +### „Paper“ dažniausiai neįtraukia pasirinkimo daugumai „Vanilla“ klaidų taisymo pataisų. + +Šiuo metu „Plazma“ kuria galimybę išjungti tokius klaidų taisymo konfigūracijos nustatymus. + +Taigi šis vadovas vis dar yra kuriamas, ir informacija gali keistis bet kuriuo metu. +{% endhint %} diff --git a/lt/origin/plazma/adminstration/faq.md b/lt/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..2f0e6cc73 --- /dev/null +++ b/lt/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Sužinokite dažniausiai užduodamus klausimus. +--- + +# ⁉️ Dažnai užduodami klausimai + +{% hint style="info" %} + +### Negalite rasti norimo atsakymo? + +Užduokite klausimą bendruomenei naudodami [oficialų Discord serverį](https://discord.gg/MmfC52K8A8) arba [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Įvyksta pranešimas, bet vykdymas nevyksta + +Jei konsolėje rodoma `no main manifest attribute, in plazma-(version).jar`,\ +parsisiųstas failas yra kūrimo API failas, todėl iš GitHub puslapio turite parsisiųsti **Reobf Paperweight**. + +Norėdami sužinoti daugiau, žiūrėkite šį puslapį. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Kiekvieną kartą, kai pradedamas serveris, rodomas įspėjimas + +Plazma turi keletą nestabilumo pataisų ir gali neteisingai veikti, todėl serveris rodo šį įspėjimą kiekvieną kartą, kai pradedamas + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Šis įspėjimas gali būti išjungtas naudojant [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] sistemos savybę. + +Norėdami sužinoti daugiau, žiūrėkite šį puslapį. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Galima naudoti nuo 1.20.1 diff --git a/lt/origin/plazma/adminstration/getting-started/README.md b/lt/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..3953f0a74 --- /dev/null +++ b/lt/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Sužinokite, kaip sukurti serverį naudojant Plazma. +--- + +# 👟 Pradėti + +Norėdami stabiliai naudoti Plazmą, sistema turi atitikti šiuos reikalavimus. + +| | Minimalūs | Rekomenduojami | +| :-------------: | --------: | -------------: | +| Architektūra | x64 | - | +| RAM | 8 GB | 16 GB | +| Saugojimo erdvė | 1 GB | 8 GB | +| JRE | 17 | 21 | + +Norint lengvai redaguoti konfigūracijos failus, gerai būtų įdiegti redaktorių, pvz., [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE diegimas + +Kaip matyti iš pavadinimo, „Minecraft: **"Java"** Edition“ yra sukurtas naudojant Java, todėl paleidimui reikalingas JRE[^1]. + +Plazma yra paremta Mojang Studios oficialia serverio platforma, todėl norint naudoti Plazmą, taip pat reikia įdiegti JRE. + +### 1.1 Patikrinkite, ar yra įdiegta JRE + +Norėdami patikrinti, ar sistemoje yra įdiegta JRE, eikite į [vykdomąjį langą](#user-content-fn-3) ir įveskite [`cmd /k java --version`](#user-content-fn-4), tada paleiskite komandą. + +Jei matote tokius rezultatus, eikite prie [2 žingsnio](setup.md#id-2). + +{% code title="Teisingas rezultatas" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Jei nerodoma taip, arba matote šį rezultatą, reiškia, kad JRE nėra arba yra per senas, todėl turite vykdyti [1.2 žingsnį](setup.md#id-1.2). + +{% code title="JRE neįdiegta" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE yra per senas" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE diegimas + +Šiame vadove naudojamas Azul Zulu kaip [vienas iš variantų](#user-content-fn-5)[^5] JRE. + +Įdiegus, patikrinkite, ar diegimas buvo sėkmingas, pakartodami [1.1 žingsnį](setup.md#id-1.1). + +{% tabs %} +{% tab title="Windows" %} + +1. Pirmiausia, iš [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) parsisiųskite **JDK 21** kaip `.msi` failą. +2. Paleiskite atsisiųstą diegimo vediklį ir spustelėkite `Next`. +3. **Kairėje viduryje esančiame meniu pasirinkite `Set JAVA_HOME variable`,** tada spustelėkite `Next`. +4. Paspauskite `Install`, kad baigtumėte JRE diegimą. + {% endtab %} + +{% tab title="macOS" %} +Iš [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) parsisiųskite **JDK 21** kaip `.dmg` failą ir įdiekite JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Pirma, terminale įvykdykite šią komandą, kad pridėtumėte Azul Zulu saugyklą į APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Tada terminale įvykdykite šią komandą, kad įdiegtumėte JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Galite įdiegti JRE naudodami šią komandą. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma atsisiuntimas + +Plazma siūlo įvairių vykdomųjų failų variantų. + +{% hint style="įspėjimas" %} + +### Daugumai atvejų naudojamas `Reobf Paperclip`. + +Ši informacija skirta kūrėjams arba tiems, kurie domisi kiekvienu variantu.\ +Paprastiems vartotojams galima tiesiog praleisti ir pereiti prie [3 žingsnio](setup.md#id-3). +{% endhint %} + +
+ +Skaityti daugiau + +Vykdomojo failo pavadinimas yra `plazma-(versijos tvarkyklė)-1.20.4-R0.1-SNAPSHOT-(atvaizdavimo būdas).jar`. + +- **Atvaizdavimo būdas**\ + Atvaizdavimas yra kaip žemėlapis, jungiantis „Minecraft“ realųjį kodą su užšifruotu kodu. + - **Reobf**\ + Reobfuscation, taip pat žinomas kaip Spigot atvaizdavimas, daugiausia naudojamas NMS įskiepiuose.\ + Nuo 1.20.5 palaikymas bus nutrauktas. + - **Mojmap**\ + Mojang atvaizdavimas, tai „vanilinis Minecraft“ atvaizdavimas. +- **Versijos tvarkyklė**\ + Versijos tvarkyklė yra būtina serverio paleidimui, taip pat ji yra serverio leistuvas, kuris leidžia atsisiųsti bibliotekas ir taikyti serverio failus. + - **Paperclip**\ + PaperMC komandos sukurtas tvarkyklė, skirta „Paper“ ir kitų atitinkamų platformų, atsisiuntimui ir serverio atnaujinimui. + - **Bundler**\ + „Vanilinis Minecraft“ versijos tvarkyklė. + +
+ +*** + +## 3. Paleidimo scenarijaus kūrimas + +Norėdami lengvai paleisti Plazmą ir automatiškai perkrauti serverį, turite sukurti [paleidimo scenarijų](#user-content-fn-6)[^6]. + +Per [Flags.sh](https://flags.sh) galite [sukurti paleidimo scenarijų](#user-content-fn-7)[^7].\ +Įvedus tik norimą atmintį Plazmoje, komanda automatiškai optimizuojama. + +Galite atsisiųsti paleidimo scenarijų spustelėdami apačioje esantį mygtuką.\ +**Patikrinkite, ar atsisiųstas paleidimo scenarijus atitinka jūsų operacinę sistemą.** + +*** + +## 4. Failų tvarkymas + +Dabar perkelskite atsisiųstą paleidimo scenarijų ir Plazmą į naują aplanką. + +{% hint style="įspėjimas" %} + +### Aplankas turi būti be tarpų ir sukonfigūruotas anglų kalba. + +Kitu atveju Plazma ar JRE gali neteisingai veikti. +{% endhint %} + +Dabar paleiskite paleidimo scenarijų. Windows atveju, užtikrinkite, kad **leidžiama** būtų pasirinkta atsiradus ugniasienės leidimo langui. + +*** + +## 5. EULA sutikimas + +Paleidus scenarijų, aplankyme bus sukurtas `eula.txt` failas. + +EULA[^9] yra sutartis, su kuria privalote sutikti naudodamiesi [Mojang Studios](#user-content-fn-10)[^10] paslaugomis. + +Nesutikus su EULA, negalėsite paleisti serverio, o pažeidus EULA gali būti taikomos [sankcijos](#user-content-fn-11)[^11], pvz., paskyros sustabdymas. + +Norėdami sutikti su EULA, `eula=false` faile pakeiskite į `eula=true` ir išsaugokite. + +*** + +## 6. Išorinės prieigos leidimas (Windows) + +Šiuolaikinės operacinės sistemos numatytai blokuoja pavojingus išorinius prisijungimus ugniasienės ir maršrutizatoriaus lygmeniu. + +Windows atveju, užteks tik atlikti [3 žingsnį](setup.md#id-3) ir nustatyti portų peradresavimą. + +{% hint style="info" %} + +### Šiame vadove daroma prielaida, kad naudojate Windows operacinę sistemą ir [**UPnP**](#user-content-fn-12)[^12] galintį maršrutizatorių. + +Jei maršrutizatorius nepalaiko UPnP, reikės paieškoti informacijos apie konkrečią maršrutizatoriaus sąsają. + +Taip pat galite naudoti [Ngrok](https://ngrok.com/) sukurti laikiną adresą. +{% endhint %} + +{% hint style="įspėjimas" %} + +### Linux arba macOS ir kitų (pseudonimo) UNIX operacinių sistemų atveju, nesaugumo tarnybos turi skirtingus nustatymus, todėl reikės ieškoti informacijos patiems. + +{% endhint %} + +### 6.1 Patikrinkite, ar reikalingas portų peradresavimas + +Įveskite ir paleiskite šią komandą vykdymo lange. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jei išvestis yra `True`, galite sustoti, jei `False`, turėsite nustatyti portų peradresavimą. + +### 6.2 Prisijungimas prie serverio + +{% tabs %} +{% tab title="Iš išorės" %} +Jei portų peradresavimas nereikalingas arba jį jau sėkmingai atlikote, dabar galite prisijungti prie serverio. + +Prisijungimo adresas galite patikrinti [čia](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Bandyti su UPnP portų peradresavimu" %} +Paleidus serverio aplankale `purpur.yml`, įjunkite `network.upnp-port-forwarding` parametrą į `true`. + +Tada paleiskite serverį ir Plazma automatiškai bandys nustatyti portų peradresavimą. + +Sėkmės UPnP atveju bus matoma pagal išvestį konsolėje, kurioje bus rodomas `[UPnP] (pranešimas)`. + +| Pranešimas | Reikšmė | +| ----------------------------------------- | ---------------------------------------- | +| `Sėkmingai atidarytas prievadas (portas)` | Portų peradresavimas sėkmingas. | +| `Prievadas (portas) jau yra atviras` | Kitas paslaugas jau naudoja šį prievadą. | +| `Nepavyko atidaryti prievado (portas)` | Portų peradresavimas nepavyko. | +| `Paslauga nepasiekiama` | Maršrutizatorius nepalaiko UPnP. | + +Uždarius serverį, Plazma automatiškai uždarys prievadą. +{% endtab %} + +{% tab title="Ngrok naudojant laikiną adresą" %} +Ngrok metodas yra naudingas trumpalaikiams bandymams, bendradarbiavimui ar žaidimui su draugais. + +1. Iš [Ngrok svetainės](https://ngrok.com/download) atsisiųskite `Windows (64-bit)` ZIP failą. +2. Įdėkite atsisiųstą Ngrok į serverio aplanką. +3. [Ngrok skydelis](https://dashboard.ngrok.com/get-started/your-authtoken) leidžia [sukurti autentifikacijos raktą](#user-content-fn-13)[^13]. +4. Serverio aplanke įvykdykite komandą, kurią rodo `Command Line` skyriuje. +5. Paleidimo scenarijaus viršuje pridėkite `start /b ngrok tcp --region jp 25565`, o apačioje - `taskkill /f /t /im ngrok.exe`. +6. `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` yra rodomas konsolės viršuje, čia `0.tcp.jp.ngrok.io:12345` tampa serverio adresu. +7. Dabar galite prisijungti iš išorės naudodami šį adresą. + {% endtab %} + +{% tab title="Prisijungimas iš vietinės mašinos" %} +Jei norite prisijungti prie serverio iš vietinės mašinos, vykdymo lange paleiskite `cmd /k ipconfig` ir naudokite `IPv4 adresas`, kuris bus rodomas kaip prisijungimo adresas. + +Pavyzdžiui, jei po komandos vykdymo atrodo taip, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Bandydami prisijungti prie serverio iš vietinės mašinos, naudokite `192.168.3.7`, kuris yra IPv4 adrese, kad prisijungtumėte. + +Jei serveris ir žaidimas vyksta toje pačioje PC, galite prisijungti naudodami `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Evoliucijos etapas + +Kai serveris sėkmingai paleistas ir veikia teisingai, dabar laikas pritaikyti serverį pagal savo poreikius. + +Sužinokite, kaip pritaikyti serverį, sekdami šį vadovą. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java vykdymo aplinka, Java vykdymo aplinka. + +[^2]: Paper, kuris yra pagrįstas Plazma, remiasi Spigot ir yra oficialus serverio platformos pagrindas. + +[^3]: Windows klavišai + R + +[^4]: Linux atveju terminale naudokite `java --version` + +[^5]: JRE yra vienas iš atviro kodo projektų, kaip ir Minecraft serverio platforma, kuri turi daugybę variantų. + +[^6]: Įprastai žinomas kaip **vykdyklė**. + +[^7]: Įjungus „Automatinį paleidimą“, serveris automatiškai perkraunamas. Norėdami sustabdyti, įveskite `Control + C`. + +[^8]: Nerekomenduojama viršyti daugiau nei pusės sistemos resursų. + + Pavyzdžiui, jei viso sistemos atminties talpa yra 8GB, nerekomenduojama nustatyti daugiau kaip 4GB. + +[^9]: Galutinio vartotojo licencijavimo sutartis, End-User License Agreement. Daugiau informacijos rasite [Minecraft svetainėje](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Pagal Korėjos žaidimų pramonės skatinimo įstatymo 32 straipsnio 1 dalies 9 punktą, **Korea Microsoft Corporation** gali teikti teisminę ieškinį. + +[^12]: Universalus įtaisų jungimas ir grojimas, Universal Plug & Play. Purpur, įtrauktas į Plazma, automatiškai bendrauja su maršrutizatoriumi per šią technologiją, todėl nereikia tiesiogiai konfigūruoti portų persiuntimo, kai serveris veikia. + +[^13]: Jei neturite paskyros, užsiregistruokite į Ngrok naudodami „Google“ arba „GitHub“ paskyrą. diff --git a/lt/origin/plazma/adminstration/getting-started/customization.md b/lt/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..14859f924 --- /dev/null +++ b/lt/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kaip pritaikyti serverį vartotojui. +--- + +# 🎨 Vartotojų pritaikymas diff --git a/lt/origin/plazma/adminstration/reference/arguments.md b/lt/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..e71541150 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Sužinokite apie pradinį argumentą ir sistemos savybes. +--- + +# 🎛️ Argumentas ir savybės + +Pradinis kintamasis ir sistemos savybės yra reikšmės, pridedamos prie [komandos naudojamos Plazma](#user-content-fn-1)[^1] vykdymo, leidžiančios pakeisti nekeičiamą reikšmę po Plazmos vykdymo. + +Priklausomai nuo [pridėjimo vietos prie komandos](#user-content-fn-2)[^2], jie suskirstomi į **pradinį argumentą** ir **sistemos savybes**. + +*** + +## Sistemos savybės + +Sistemos savybės yra reikšmės, įvestos prieš Plazmos inicijavimą prieš JVM, kuris jas apdoroja. + +{% hint style="įspėjimas" %} + +### Modifikuojant sistemos savybes, Plazmos ir JVM veikimas gali pasikeisti ir tai gali turėti didelį poveikį žaidimui! + +Jei nežinote, kokią vaidmenį atlieka kiekviena sistemos savybė, **niekada jų nenaudokite!** +{% endhint %} + +### Naudojimo instrukcija + +Sistemos savybės įvedamos kaip Java komandos argumentas tarp `java` ir `-jar`. + +Pavyzdžiui, norint pritaikyti `Plazma.dummyProperty` sistemos savybę,\ +įvedus taip, į kitą savybę įrašomas `37`, ir Plazma inicijuojamas. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` nurodo, kad ši reikšmė yra specialus argumentas, pridėtas prie Plazmos, o + +jei neįvedate jokios reikšmės, ji bus fiksuota kaip [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight serveryje kiekvienas sistemos savybes atskiria, įtraukdamas `.` į savybės pavadinimą. + +Kai kuriuose terminaluose, pvz., Windows Powershell, šių argumentų gali būti neleidžiama, todėl reikės pridėti `"` prie argumento galo.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Visos sistemos savybės + +#### `convertLegacySigns` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Atnaujina naudojamus išjungtus ženklus. + +#### `debug.entities` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia susijusią entiteto informacijos derinį. + +#### `debug.rewriteForIDE` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +IDE teisingai įkelia derinimo informaciją, išjungia NMS reviziją ir automatiškai pertvarko vidinę versijos informaciją. + +#### `disable.watchdog` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia Spigot stebėjimo šuns sistemos įspėjimus. + +#### `letMeReload` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia patvirtinimo pranešimą dėl `reload` komandos. + +{% hint style="danger" %} + +### Kadangi `reload` komanda yra labai nestabili, visos problemos, kurios atsiranda po jos naudojimo, yra naudotojo atsakomybė. + +Jeigu esate įskiepių kūrėjas ir turite atnaujinti įskiepius, naudokite šilumą vietoj `reload` komandos. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia įprastos įvesties-išvesties sistemos įskiepius. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įspėja, kai aptinkamas pasenusi formatavimo sistema pokalbių komponente. + +#### `Paper.bypassHostCheck` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia serverio šablono patikros patikrinimą, kai žaidėjas prisijungia prie serverio. + +#### `Paper.debugDynamicMissingKeys` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia derinimo įrašus, susijusius su praleistomis NBT raktažodžių dalimis. + +#### `Paper.debugInvalidSkullProfiles` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia derinimo įrašus, susijusius su netinkamais kaukių profiliais. + +Tai įrašo visus neteisingus kaukių blokus žemėlapyje kartu su jų vietomis. + +#### `Paper.disableChannelLimit` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia 128 įskiepių kanalų ribojimą vienam žaidėjui. + +#### `Paper.disableClassPrioritization` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia įskiepių klasės prioritizavimo sistemą. + +Tai naudinga, jei yra problemų su įskiepių šešėliu. + +#### `Paper.disableFlushConsolidate` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia Netty nusistovėjusią plūduriavimo konsolidavimo sistemą. + +#### `Paper.excessiveTELimit` + +- **Formatas**: `Sveikas skaičius` +- **Numatytasis**: `750` + +Jei entitetas yra didesnis nei nustatyta vertė, jis siunčiamas skaidruose paketuose. + +#### `Paper.filterThreshold` + +- **Formatas**: `Sveikas skaičius` +- **Numatytasis**: `8192` + +Nustato didžiausią paketo dydį, kurį serveris gali priimti vienu metu. + +#### `Paper.ignoreJavaVersion` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Išjungia Java versijos patikrinimą. + +{% hint style="danger" %} + +### Tai gali leisti JVM bandyti pasiekti neegzistuojantį kodą! + +Tai gali pakenkti failams ir visam žaidimo mechanizmui, nes jie gali būti negrįžtamai sugadinti. + +Visos su tuo susijusios problemos yra jūsų atsakomybė, o Plamza nepateiks jokios pagalbos šiuo atveju. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Formatas**: `Sveikas skaičius` +- **Numatytasis**: `64` + +Nustato įskiepių kanalų pavadinimo ribą. + +#### `Paper.maxSignLength` + +- **Formatas**: `Sveikas skaičius` +- **Numatytasis**: `80` + +Nustato didžiausią simbolių skaičių, kurį galima įvesti į vieną piktogramą. + +#### `Paper.minPrecachedDatafixVersion` + +- **Formatas**: `Sveikas skaičius` +- **Numatytasis**: `(pasaulio versija) + 1` + +Nustato pradinės pasaulio atnaujinimo informacijos versiją. + +Tai naudinga tik tais atvejais, kai reikia atnaujinti didžiulius kiekvieno ruožo duomenis, tačiau kitais atvejais nebenaudojama. + +#### `Paper.parseYamlCommentsByDefault` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `True` + +Įjungia YAML failų komentarų apdorojimą. + +#### `Paper.playerConnection.keepAlive` + +- **Formatas**: `Sveikas skaičius` +- **Numatytasis**: `30` + +Jei žaidėjas neperduoda jokių duomenų per nustatytą laiką (sekundėmis), jis bus išmestas iš žaidimo. + +Paprastai žaidimas[^7] tęsia siųsti [širdies plakimo signalą](#user-content-fn-8)[^8] į serverį, todėl [neišmestas,](#user-content-fn-9)[^9] bet jei žaidimas neatsako, jis laikomas susidūrus ir serveris daugiau nebeapdoroja žaidėjo ir išmeta jį. + +#### `Paper.skipServerPropertiesComments` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Ignoruoja serverio savybių komentarus. + +#### `Paper.debug-sync-loads` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia sinchronizuotų ruožų kūrimo derinimo įrašus. + +#### `Paper.enable-sync-chunk-writes` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia Minecraft [numatytą ruožų kūrimo sistemą](#user-content-fn-10)[^10]. + +Tai leidžia kiekvieną ruožą išsaugoti eilės tvarka, kuri labai sumažina našumą. + +#### `Paper.explicit-flush` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Įjungia tinklo kanalo išsamią nusistovėjimą. + +#### `Paper.strict-thread-checks` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Visada žurnališkai užfiksuoja klaidas, kurios neįvyko pagrindiniame gijime. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Jeigu užduotis turi per didelį laukimo laiką, išspausdina įspėjimą. + +#### `Paperclip.patchOnly` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `Neteisinga` + +Kai naudojamas numatytas vykdomasis failas, tačiau nepradedamas serveris, tik taikomi pataisymai. + +#### `Plazma.aggressiveOptimize` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` + +{% hint style="įspėjimas" %} + +### Ši savybė bus perkelta į pradinį argumentą nuo 1.20.5 versijos. + +{% endhint %} + +Pradinės konfigūracijos optimizavimas bus taikomas griežčiau nuo pradžios. + +Aktyvavus, serveris tampa greitesnis ir saugesnis, tačiau gali būti užblokuoti kai kurie mechanizmai arba tai gali turėti didelį poveikį žaidimo žaidimui. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` + +Slopina įspėjimą[^11], rodomą, kai inicijuojamas Plazma atkūrimas. + +### Nebenaudojamas atributas + +Žemiau pateikti sistemos atributai yra nebenaudojami. + +#### `timings.bypassMax` + +- **Formatas**: `Logiškas` +- **Numatytasis**: `false` +- **Nebenaudojamas**: Timings buvo pašalintas iš Plazma nuo + +Nusprendžia, ar galima viršyti maksimalų Timings API siunčiamų reikšmių skaičių. + +Jei tai padarysite, tačiau API neapdoros išimčių, bus taikomas greičio apribojimas. + +*** + +## Pradžios argumentas + +Pradžios argumentas yra įvestas po `-jar *.jar` ir yra reikšmė, kuri bus apdorota kartu su Plazma inicializavimu. + +### Naudojimo instrukcija + +Sistemos savybės yra įvestos po `-jar *.jar` kaip programos komandiniai argumentai. + +Pavyzdžiui, norint pritaikyti pradžios argumentą `nogui`,\ +įvedus taip, Plazma inicializuojant bus apdorotas argumentas `nogui`. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Visas pradžios argumentas + +#### `bukkit-settings` + +- **Pseudonimas**: `b` +- **Numatytoji reikšmė**: `bukkit.yml` + +Nurodo [Bukkit konfigūracijos failo](../reference/configurations/bukkit.md) pavadinimą ir vietą. + +#### `command-settings` + +- **Pseudonimas**: `c` +- **Numatytoji reikšmė**: `commands.yml` + +Nurodo [Bukkit komandų konfigūracijos failo](../reference/configurations/bukkit.md) pavadinimą ir vietą. + +#### `config` + +- **Pseudonimas**: `c` +- **Numatytoji reikšmė**: `server.properties` + +Nurodo [serverio savybių](../reference/configurations/property.md) failo pavadinimą ir vietą. + +#### `demo` + +Paleidžia serverį su demonstraciniu pasauliu. + +#### `eraseCache` + +Ištrina likusius talpyklos failus po pasaulio atnaujinimo. + +#### `forceUpgrade` + +Nesvarbu kokios versijos, priverčia pasaulį [atnaujinti](#user-content-fn-12)[^12]. + +#### `help` + +- **Pseudonimas**: `?` + +Atspausdina Plazmos visus pradžios argumentus ir aprašymą. + +#### `initSettings` + +Sukuria tik konfigūracijos failą ir išjungia serverį. + +#### `jfrProfile` + +Įjungia JFR profilį. + +#### `max-players` + +- **Pseudonimas**: `s`, `size` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Nustato maksimalų leidžiamą [žaidėjų](#user-content-fn-14)[^14] skaičių. + +#### `nogui` + +Išjungia grafinį sąsajos skydelį. + +#### `nojline` + +Išjungia JLine ir naudoja standartinę konsolę. + +#### `online-mode` + +- **Pseudonimas**: `o` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Pasirenka, ar patikrinti žaidėją su Mojang autentifikavimo serveriu. + +**Naudoti [EULA](../getting-started/README.md#id-5) pažeidimas, jei naudojamas ne Velocity ar kitas įgaliojimų serveris.** + +#### `paper-settings` + +- **Pseudonimas**: `paper` +- **Numatytoji reikšmė**: `paper.yml` + +{% hint style="įspėjimas" %} + +### Šis argumentas nebeveikia nuo 1.19.4 + +{% endhint %} + +Nustato naudoto PaperSpigot konfigūracijos failo vietą. + +Tai naudojama perkelti seną konfigūraciją į naują failą, po to ji nebeveikia. + +#### `paper-settings-directory` + +- **Pseudonimas**: `paper-dir` +- **Numatytoji reikšmė**: `config` + +Nustato [Paper konfigūracijos failo](../reference/configurations/paper/README.md) aplankalo pavadinimą ir vietą. + +#### `plazma-settings-directory` + +- **Pseudonimas**: `plazma-dir` + +Nustato [Plazma konfigūracijos failo](../reference/configurations/plazma/README.md) aplankalo pavadinimą ir vietą. + +#### `plugins` + +- **Pseudonimas**: `p` +- **Numatytoji reikšmė**: `plugins` + +Nustato papildomų įskiepių aplankalo vietą. + +#### `pufferfish-settings` + +- **Pseudonimas**: `pufferfish` +- **Numatytoji reikšmė**: `pufferfish.yml` + +Nustato [Pufferfish konfigūracijos failo](../reference/configurations/pufferfish.md) pavadinimą ir vietą. + +#### `purpur-settings` + +- **Pseudonimas**: `purpur` +- **Numatytoji reikšmė**: `purpur.yml` + +Nustato [Purpur konfigūracijos failo](../reference/configurations/purpur/README.md) pavadinimą ir vietą. + +#### `safeMode` + +Paleidžia serverį saugiuoju režimu, kaip visiškai standartinį. + +#### `server-ip` + +- **Pseudonimas**: `h`, `host` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Nustato serverio prievado pavadinimą arba [internetinio protokolo](#user-content-fn-13)[^13] adresą. + +#### `server-port` + +- **Pseudonimas**: `p`, `port` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Nustato serverio prievadą. + +#### `server-name` + +- **Numatytoji reikšmė**: `A Plazma Server` + +Nustato serverio pavadinimą. + +#### `spigot-settings` + +- **Pseudonimas**: `S` +- **Numatytoji reikšmė**: `spigot.yml` + +Nurodo [Spigot konfigūracijos failo](../reference/configurations/spigot.md) pavadinimą ir vietą. + +#### `version` + +- **Pseudonimas**: `v` + +Atspausdina Plazma versiją. + +#### `world-dir` + +- **Pseudonimas**: `W`, `universe`, `world-container` +- **Numatytoji reikšmė**: `(serverio aplankas)` + +Nustato vietą, kur saugomi pasaulio failai. + +#### `world-name` + +- **Pseudonimas**: `w`, `world` +- **Numatytoji reikšmė**: `(serverio savybė)` + +Nustato pasaulio failo pavadinimą. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Parametrų tvarka priklauso nuo vietos, kurioje yra pridėti argumentai. + +[^3]: Pavyzdžiui, norint nustatyti `Plazma.iKnowWhatIAmDoing` į `true`, vietoje `-DPlazma.iKnowWhatIAmDoing=true` galima įvesti tik `-DPlazma.iKnowWhatIAmDoing` ir taip pat veiks. + +[^4]: Pavyzdžiui, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Įvykio jutiklis. + +[^6]: Įvykio jutiklis. + +[^7]: Klientas. + +[^8]: Signalas, pranešantis, kad serveris yra sėkmingai prijungtas kaip širdies plakimas. + +[^9]: Naudodami Purpur AFK išmesti funkciją, galite išmesti net tuos žaidėjus, kurie paliko vietą. + +[^10]: Sinchroninis ruožo rašymo sistema, Sync Chunk Write System. + +[^11]: `ĮSPĖJIMAS! Plazma gali sukelti netikėtų problemų, todėl būtinai išsamiai išbandykite jį prieš naudojant jį viešame serveryje.` + +[^12]: Žaidimuose `pasaulio optimizavimas` taip pat veikia pagal šį principą. + +[^13]: Interneto protokolas, IP. + +[^14]: `Lygio 2` arba aukštesnis administratorius yra išskiriamas. diff --git a/lt/origin/plazma/adminstration/reference/commands.md b/lt/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..c87ec4c1a --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kokius komandas galima naudoti „Plazma“. +--- + +# 🖥️ Komandos diff --git a/lt/origin/plazma/adminstration/reference/configurations/bukkit.md b/lt/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..17ebf6164 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas bukkit.yml mazgas. +--- + +# 🪣 Bukkit diff --git a/lt/origin/plazma/adminstration/reference/configurations/paper/README.md b/lt/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9dd22fac7 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kokia yra kiekvieno failo config aplankale paskirtis. +--- + +# 🛩️ Popierius diff --git a/lt/origin/plazma/adminstration/reference/configurations/paper/global.md b/lt/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..6a9a9c95a --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas paper-global.yml mazgas. +--- + +# 🛩️ Popierius (globalus konfigūravimas) diff --git a/lt/origin/plazma/adminstration/reference/configurations/paper/world.md b/lt/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..0cf456f3f --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas paper-world.yml mazgas. +--- + +# 🛩️ Popierius (pasaulio sudėtis) diff --git a/lt/origin/plazma/adminstration/reference/configurations/plazma/README.md b/lt/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..3ef8353e0 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, kokia yra kiekvieno failo config aplankale paskirtis. +--- + +# ✨ Plazma diff --git a/lt/origin/plazma/adminstration/reference/configurations/plazma/global.md b/lt/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..330525582 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Išsiaiškinkite, ką reiškia kiekvienas plazma-global.yml mazgas. +--- + +# ✨ Plazma (globalus konfigūravimas) diff --git a/lt/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/lt/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..771fdff3b --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Pasaulio šalių sudėtis diff --git a/lt/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/lt/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..7397f1e2f --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas plazma-world.yml mazgas. +--- + +# ✨ Plazma (pasaulių struktūra) diff --git a/lt/origin/plazma/adminstration/reference/configurations/property.md b/lt/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..ff669ef08 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas server.properties mazgas. +--- + +# 🪨 Server.properties diff --git a/lt/origin/plazma/adminstration/reference/configurations/pufferfish.md b/lt/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..744e03b7d --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką kiekvienas pufferfish.yml mazgas reiškia. +--- + +# 🐡 Pufferfish diff --git a/lt/origin/plazma/adminstration/reference/configurations/purpur/README.md b/lt/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..44595d571 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas purpur.yml mazgas. +--- + +# 🦑 Purpur diff --git a/lt/origin/plazma/adminstration/reference/configurations/purpur/global.md b/lt/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..6ed2db87b --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas purpur.yml mazgas. +--- + +# 🦑 Purpur (visuotinis sudėtis) diff --git a/lt/origin/plazma/adminstration/reference/configurations/purpur/world.md b/lt/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..698151d8e --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas purpur.yml mazgas. +--- + +# 🦑 Purpuras (pasaulio struktūra) diff --git a/lt/origin/plazma/adminstration/reference/configurations/spigot.md b/lt/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..ed07c0cb4 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite, ką reiškia kiekvienas spigot.yml mazgas. +--- + +# 🚰 Spigot diff --git a/lt/origin/plazma/adminstration/reference/permissions.md b/lt/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..885067117 --- /dev/null +++ b/lt/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Sužinokite apie Plazma teises. +--- + +# 🛡️ Teisės diff --git a/lt/origin/plazma/developers.md b/lt/origin/plazma/developers.md new file mode 100644 index 000000000..4d24a2259 --- /dev/null +++ b/lt/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Kurkite trečiųjų šalių projektus naudodamiesi Plazma. +--- + +# ⚙️ Programuotojo vadovas diff --git a/lt/origin/thunderbolt/README.md b/lt/origin/thunderbolt/README.md new file mode 100644 index 000000000..b9474b802 --- /dev/null +++ b/lt/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt yra Plazma pagrindu paremta serverių platforma, kuri leidžia eksperimentinius atnaujinimus suskirstyti į skirtingus skonius, kad galėtumėte tiesiogiai juos išbandyti. +--- + +# 🌩️ Thunderbolt Naudojimo Gidas diff --git a/lt/origin/volt/README.md b/lt/origin/volt/README.md new file mode 100644 index 000000000..54fef8cd5 --- /dev/null +++ b/lt/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt yra atvirojo kodo šablonas, leidžiantis kurti savo Paperweight serverio platformą pagrįstą Plazma. +--- + +# ⚡ Volt Plėtros Gidas diff --git a/ms/origin/README.md b/ms/origin/README.md new file mode 100644 index 000000000..ec339f009 --- /dev/null +++ b/ms/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Jika anda mempunyai sebarang pertanyaan, sila tanyakan melalui Discord atau Perbincangan GitHub. +--- + +# 🏠 Selamat datang ke Portal Dokumen + +{% hint style="info" %} + +**Dokumen Plazma sedang diterjemahkan oleh mesin pada masa ini.** + +[![Keadaan Terjemahan](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Sertai penyertaan anda dalam menterjemahkan dokumen di [https://translate.plazmamc.org/](https://translate.plazmamc.org/) untuk meningkatkan dokumen tersebut. + +{% endhint %} + +### Jika terdapat masalah semasa menggunakan Plazma, apakah yang perlu dilakukan? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Jika anda berminat tentang Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Jika anda ingin membuat platform pelayan anda sendiri dengan Volt, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `PENAJA` Jika anda memerlukan lebih banyak maklumat berkaitan Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ms/origin/SUMMARY.md b/ms/origin/SUMMARY.md new file mode 100644 index 000000000..49437561a --- /dev/null +++ b/ms/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Jadual kandungan + +- [🏠 Selamat datang ke Portal Dokumen](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Dokumen Penggunaan Plazma](plazma/README.md) +- [❓ Apakah Plazma?](plazma/about/README.md) + - [⬇️ Muat turun](plazma/about/downloads.md) + - [✅ Status Sokongan Versi](plazma/about/supported-versions.md) +- [⚒️ Panduan Pengurusan Pelayan](plazma/administration/README.md) + - [👟 Memulakan](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Rujukan](plazma/administration/reference/README.md) + - [🖥️ Perintah](plazma/administration/reference/commands.md) + - [🛡️ Kebenaran](plazma/administration/reference/permissions.md) + - [🎛️ Arguments and Properties](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Sifat](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Konfigurasi Global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfigurasi Mengikut Dunia](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Konfigurasi Global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfigurasi Mengikut Dunia](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Konfigurasi Global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfigurasi Mengikut Dunia](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Advanced](plazma/administration/expert/README.md) + - [🧹 Optimumkan](plazma/administration/expert/optimize.md) + - [🔀 Proksi](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 Saringan X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Kebocoran dan Penyelesaian](plazma/administration/expert/fix-exploits.md) + - [⁉️ Soalan Lazim](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Panduan Pembangun](plazma/developers.md) + - [✏️ Sumbang](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Panduan Penggunaan Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Panduan Pembangunan Volt](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Muat Turun Semua](plazma/about/downloads-all.md) diff --git a/ms/origin/miscellaneous/README.md b/ms/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ms/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ms/origin/plazma/README.md b/ms/origin/plazma/README.md new file mode 100644 index 000000000..f47e312d8 --- /dev/null +++ b/ms/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma adalah platform server sumber terbuka untuk Minecraft: Java Edition yang menggabungkan optimasi eksperimental berbasis kertas dan fitur kustomisasi berbagai mekanisme permainan." +--- + +# ✨ Dokumentasi Penggunaan Plazma + +## 👋 Selamat datang di Dokumentasi Plazma + +Selamat datang di Dokumentasi Penggunaan Plazma! + +{% hint style="info" %} + +**Bolehkah anda menyelesaikan masalah melalui manual?** + +[Server Discord rasmi](https://discord.gg/MmfC52K8A8) atau [Perbincangan GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) untuk bertanya kepada komuniti! + +{% endhint %} + +### Tentang Plazma + +> Pelajari apa itu platform server Plazma. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Untuk Administrator + +> Cobalah membuat server Anda sendiri dengan menggunakan Plazma. + +{% content-ref url="pentadbiran/" %} +[pentadbiran](pentadbiran/) +{% endcontent-ref %} + +### Untuk Pengembang + +> Coba kembangkan proyek pihak ketiga dengan menggunakan Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ms/origin/plazma/about/README.md b/ms/origin/plazma/about/README.md new file mode 100644 index 000000000..0f06426a9 --- /dev/null +++ b/ms/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Pelajari apa itu platform server Plazma. +--- + +# ❓ Plazma란? + +- **Plazma**는 [Andromeda](https://github.com/EarendelArchived/Andromeda)와 [Fusion](https://github.com/RuinedTechnologyUnify/Fusion)에서 장점만을 가져온 [Paper](https://github.com/PaperMC/Paper) 기반의 서버 플랫폼 입니다. +- 항상 높은 안정성과 강력한 성능, 빠른 업데이트, 방대한 기능을 제공하기 위하여 노력하고 있습니다. + +## 📋 Plazma의 목표 + +- 빠른 업데이트, 높은 안정성을 가진 서버 플랫폼이 되기 위해 노력하고 있습니다. +- 모드 플랫폼 못지 않은 방대한 기능과 강력한 성능을 제공하기 위해 노력하고 있습니다. +- 바닐라의 패치도 사용자화 할 수 있는 자유로운 플랫폼을 만들기 위해 노력하고 있습니다. + +## ⚙️ 주요 특징 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **가장 빠른 업데이트**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)는 Plazma의 포함 패치가 항상 최신으로 유지될 수 있도록 해서, Paper 기반 서버 플랫폼 중에서 가장 빠른 업데이트를 제공하고 있습니다. +6. **기본 구성 파일 최적화**\ + 기본 적용되는 구성 파일이 최적화되어 있어, 직접 구성 파일을 최적화 하지 않아도 됩니다. +7. **체계적으로 작동하는 멀티스레드**\ + 게임의 메커니즘과 관계 없는 시스템 메커니즘을 비동기화 하여, [지연 시간](#user-content-fn-4)[^4]을 줄여 서버를 최적화 합니다. +8. **불필요한 공간의 사용 차단**\ + 비슷한 값을 가진 데이터를 모두 하나로 합쳐 메모리 사용량을 줄입니다. + +## ✨ 활용 사례 + +- **Platform yang Menangani Plugin Kompleks Dengan Betul**\ + Plazma digunakan di server [IPECTER](https://github.com/IPECTER) pengembang.\ + Dengan plugin sendiri yang beroperasi dengan NMS dan refleksi, serta penggunaan banyak data pack yang kompleks dan besar,\ + server mampu menampung lebih dari 100 pemain tanpa penurunan prestasi. +- **Platform yang Menjaga Prestasi Cepat di Server RPG**\ + Menjaga 100 pemain dalam kluster tunggal tanpa penurunan TPS, dan membolehkan 250 pemain bermain dengan lancar dalam 4 kluster. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platform yang dipilih oleh banyak streamer**\ + Digunakan sebagai bekas penonton untuk banyak streamer yang dipilih. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Muat turun + +아래 페이지에서 Plazma를 다운로드 할 수 있습니다. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Ingin mengetahui maklumat terperinci mengenai sokongan versi? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot 플러그인 및 Paper, Pufferfish, Purpur 플러그인. + +[^2]: 이하 Microsoft Corporation. + +[^3]: 채팅 신고 시스템을 비활성화 하면 채팅이 온전히 서버에서만 처리되어 Mojang의 채팅 추적을 막을 수 있습니다. + +[^4]: 시스템 메커니즘이 작동하기 위해 잠시 동안 게임이 멈추는 시간. diff --git a/ms/origin/plazma/about/downloads-all.md b/ms/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..de8431409 --- /dev/null +++ b/ms/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Muat turun fail eksekusi Plazma penuh +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versi | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ms/origin/plazma/about/downloads.md b/ms/origin/plazma/about/downloads.md new file mode 100644 index 000000000..1b090f02e --- /dev/null +++ b/ms/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Muat turun Plazma sekarang dan cuba gunakan sendiri. +--- + +# ⬇️ Muat turun + +#### Ingin mengetahui maklumat terperinci mengenai sokongan versi? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Muat turun di bawah adalah fail eksekusi untuk pengguna biasa.** + +Jika anda seorang pembangun dan memerlukan jenis fail yang lain, sila rujuk kepada halaman di bawah. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersiMuat turun
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/ms/origin/plazma/about/patches-list.md b/ms/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..ded3dbbf3 --- /dev/null +++ b/ms/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Ketahui semua fungsi yang ditambahkan ke Plazma. +--- + +# 📑 Patch yang disertakan diff --git a/ms/origin/plazma/about/supported-versions.md b/ms/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..c27d52d41 --- /dev/null +++ b/ms/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Ketahui versi Minecraft: Edisi Java yang disokong oleh Plazma." +--- + +# ✅ Status Sokongan Versi + +{% hint style="info" %} + +**Plazma telah dibangunkan selepas 1.19.4, versi di bawah 1.19.4 tidak lagi dibangunkan.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/under-development +[atv]: https://badge.plazmamc.org/2/supporting +[fse]: https://badge.plazmamc.org/6/support-discontinued +[eol]: https://badge.plazmamc.org/4/support-ended +[ukn]: https://badge.plazmamc.org/0/Informasi%20Tidak%20Disediakan +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: https://badge.plazmamc.org/percent/100 + +![waiting for release][wtr] ![under development][idv] ![supporting][atv] ![support discontinued][fse] ![support ended][eol] + +| Versi | Kebolehpercayaan dan Sokongan Fungsi | Status Bina | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![build status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Status Pembinaan](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Status Pembinaan](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ms/origin/plazma/administration/README.md b/ms/origin/plazma/administration/README.md new file mode 100644 index 000000000..f9ea6874a --- /dev/null +++ b/ms/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Cobalah membuat server Anda sendiri dengan menggunakan Plazma. +--- + +# ⚒️ Panduan Pengurusan Pelayan diff --git a/ms/origin/plazma/administration/diagnosis/README.md b/ms/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..e90bab8f2 --- /dev/null +++ b/ms/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara mengendalikan masalah yang timbul. +--- + +# 🧾 진단 diff --git a/ms/origin/plazma/administration/diagnosis/plugins.md b/ms/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..f5c642e75 --- /dev/null +++ b/ms/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara menyelesaikan masalah apabila plugin tidak berfungsi dengan normal. +--- + +# 📜 플러그인 diff --git a/ms/origin/plazma/administration/expert/README.md b/ms/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..c38bc4242 --- /dev/null +++ b/ms/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara mengendalikan Plazma secara profesional. +--- + +# 🎓 Lanjutan diff --git a/ms/origin/plazma/administration/expert/fix-exploits.md b/ms/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..9bf0fa04f --- /dev/null +++ b/ms/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Ketahui tentang kerentanan yang diketahui dan cara menanganinya. +--- + +# ⚠️ Kerentanan yang diketahui dan cara penyelesaiannya diff --git a/ms/origin/plazma/administration/expert/optimize.md b/ms/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..d92c69cc0 --- /dev/null +++ b/ms/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara untuk mengoptimumkan Plazma. +--- + +# 🧹 Optimumkan diff --git a/ms/origin/plazma/administration/expert/proxy.md b/ms/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..3f2e247a2 --- /dev/null +++ b/ms/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara mengkonfigurasi platform proksi "Velocity" dengan selamat. +--- + +# 🔀 Proksi diff --git a/ms/origin/plazma/administration/expert/vanillaize.md b/ms/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..62411f1b7 --- /dev/null +++ b/ms/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Ketahui cara untuk mengembalikan patch Paper dan vanilla. +--- + +# ↩️ Membuat menjadi seperti vanilla + +{% hint style="warning" %} + +**Paper tidak menyertakan pilihan pada kebanyakan patch untuk memperbaiki kesalahan vanilla.** + +Plazma sedang mengembangkan konfigurasi untuk menonaktifkan pemulihan kesalahan tersebut. + +Oleh karena itu, panduan ini masih dalam proses penulisan dan informasi dapat berubah kapan saja. + +{% endhint %} diff --git a/ms/origin/plazma/administration/expert/xray.md b/ms/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..f1a99d5ed --- /dev/null +++ b/ms/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Ketahui pelbagai cara dalaman untuk menghalang X-Ray. +--- + +# 🩻 Penghalang X-Ray diff --git a/ms/origin/plazma/administration/faq.md b/ms/origin/plazma/administration/faq.md new file mode 100644 index 000000000..f10b61008 --- /dev/null +++ b/ms/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Ketahui tentang soalan lazim. +--- + +# ⁉️ Soalan Lazim + +{% hint style="info" %} + +**Tidak dapat menemui jawapan yang anda cari?** + +[Server Discord rasmi](https://discord.gg/MmfC52K8A8) atau [Perbincangan GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) untuk bertanya kepada komuniti! + +{% endhint %} + +### Plazma tidak dapat dimulakan + +Jika `tiada atribut manifest utama, dalam plazma-(versi).jar` dipaparkan di konsol,\ +fail yang dimuat turun adalah fail API pembangunan, anda perlu memuat turun **Reobf Paperweight** dari laman GitHub. + +Untuk maklumat lanjut, sila rujuk kepada halaman berikut. + +{% content-ref url="getting-started/" %} +[mula-mula](getting-started#id-2) +{% endcontent-ref %} + +### Amaran dipaparkan setiap kali pelayan dihidupkan + +Plazma mengandungi beberapa penyelesaian yang tidak stabil dan sentiasa berpotensi untuk berfungsi dengan tidak baik, oleh itu amaran berikut dipaparkan setiap kali pelayan dihidupkan. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Amaran tersebut boleh dimatikan menggunakan ciri sistem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Untuk maklumat lanjut, sila rujuk kepada halaman berikut. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Boleh digunakan mulai versi 1.20.1 diff --git a/ms/origin/plazma/administration/getting-started/README.md b/ms/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..0ad1f95f7 --- /dev/null +++ b/ms/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Ketahui cara membuat server dengan Plazma. +--- + +# 👟 Mula + +Untuk menggunakan Plazma secara stabil, sistem perlu memenuhi keperluan berikut: + +| | Minimum | Disyorkan | +| :--------------: | ------- | --------- | +| Seni bina | x64 | - | +| RAM | 8GB | 16GB | +| Ruangan simpanan | 1GB | 8GB | +| JDK | 17 | 21 | + +Untuk mengedit fail konfigurasi dengan lancar, disarankan untuk memasang editor seperti [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Output yang betul" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' bukanlah program perintah internal atau eksternal, program yang dapat dijalankan, atau +file batch. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Pertama, muat turun **JDK 21** dari [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) dalam format `.msi`. +2. Jalankan penyelenggaraan muat turun dan klik `Next`. +3. Di tengah kiri tetingkap, aktifkan `Set JAVA_HOME variable` dan kemudian klik `Next`. +4. Tekan `Install` untuk menyelesaikan pemasangan JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Kemudian, jalankan arahan berikut dalam terminal untuk memasang JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Muat Turun Plazma + +Plazma menyediakan pelbagai jenis fail eksekusi. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Ketahui lebih lanjut + +Nama fail eksekusi adalah `plazma-(pengurus versi)-1.20.4-R0.1-SNAPSHOT-(jenis pemetaan).jar` yang telah ditetapkan. + +- **Jenis Pemetaan**\ + Pemetaan adalah jenis peta yang menghubungkan kod sebenar Minecraft dengan kod yang telah digarap. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Pengurus Versi**\ + Pengurus versi adalah pustaka yang diperlukan untuk menjalankan pelayan dan berfungsi sebagai pelancar pelayan yang memuat turun pustaka dan memohonkan fail pelayan. + - **Paperclip**\ + Dicipta oleh pasukan PaperMC untuk Paper dan platform terbitan lain, berperanan dalam memuat turun pustaka dan menyelaraskan pelayan. + - **Bundler**\ + Pengurus versi Minecraft Vanilla. + +
+ +*** + +## 3. Cipta Skrip Mula + +Untuk memulakan Plazma dengan mudah dan membolehkan pelayan secara automatik mulakan semula, anda perlu membuat [skrip mula](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Anda boleh muat turun skrip mula melalui butang muat turun di bahagian kiri bawah.\ +**Pastikan skrip mula yang dimuat turun sepadan dengan sistem operasi anda.** + +*** + +## 4. Penyusunan Fail + +Pindahkan skrip mula yang dimuat turun dan Plazma ke folder baru sekarang. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Kini jalankan skrip mula. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Persetujuan EULA + +Apabila anda menjalankan skrip mula, fail `eula.txt` akan dicipta dalam folder. + +EULA[^9] adalah perjanjian lesen yang perlu anda setujui untuk menggunakan perkhidmatan [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Untuk bersetuju dengan EULA, ubah `eula=false` kepada `eula=true` dalam fail `eula.txt` dan simpan. + +*** + +## 6. Membenarkan Sambungan Luar (Windows) + +Sistem operasi moden secara asasnya menghalang akses luaran melalui **firewall** dan **router** untuk melindungi daripada akses berbahaya. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Jika router anda tidak menyokong UPnP, anda perlu mencari maklumat mengikut panel router yang berbeza. + +Atau anda boleh menggunakan [Ngrok](https://ngrok.com/) untuk mencipta alamat sementara. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Semak Keperluan Penerusan Port + +Masukkan dan jalankan seperti yang berikut dalam tetingkap eksekusi. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jika output adalah `True`, anda boleh berhenti di sini, tetapi jika `False`, anda perlu tetapkan penerusan port. + +### 6.2 Menyambung ke Pelayan + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Alamat yang digunakan untuk menyambung ke pelayan boleh disemak [di sini](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Kemudian, mulakan semula pelayan dan Plazma akan cuba meneruskan port secara automatik. + +Kejayaan UPnP bergantung kepada mesej yang dipaparkan dalam konsol, di mana ia akan menunjukkan `[UPnP] (mesej)`. + +| Mesej | Makna | +| ----------------------------- | ------------------------------------------------------------ | +| `Berjaya membuka port (port)` | Penerusan port berjaya. | +| `Port (port) sudah terbuka` | Port telah digunakan oleh perkhidmatan lain. | +| `Gagal membuka port (port)` | Penerusan port gagal. | +| `Perkhidmatan tidak tersedia` | Router tidak menyokong UPnP. | + +Apabila pelayan ditutup, Plazma akan menutup port secara automatik. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Muat turun fail ZIP `Windows (64-bit)` dari [Laman Web Ngrok](https://ngrok.com/download). +2. Letakkan fail Ngrok yang dimuat turun ke dalam folder pelayan. +3. Di [Papan Pemuka Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), cipta [token pengesahan](#user-content-fn-13)[^13]. +4. Di dalam folder pelayan, jalankan arahan yang dipaparkan dalam `Command Line`. +5. Tambahkan `start /b ngrok tcp --region jp 25565` di bahagian atas skrip eksekusi, dan `taskkill /f /t /im ngrok.exe` di bahagian bawahnya. +6. Dari mesej yang dipaparkan di bahagian atas konsol `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, `0.tcp.jp.ngrok.io:12345` adalah alamat pelayan. +7. Sekarang anda boleh mengakses alamat tersebut dari luar. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Contohnya, apabila output seperti berikut dipaparkan selepas menjalankan arahan tersebut, + +```log +Konfigurasi IP Windows + +Adaptor Ethernet Ethernet: + + Sufiks DNS yang Terhubung. . . . : + Alamat IPv4. . . . . . . . . : 192.168.3.7 + Masker Subnet . . . . . . . : 255.255.255.0 + Gateway Default. . . . . . : 192.168.3.1 + +``` + +Anda boleh menyambung ke pelayan dari komputer tempatan dengan mencuba menyambung ke alamat `192.168.3.7` yang dipaparkan pada IPv4. + +Jika pelayan dan permainan dijalankan pada PC yang sama, anda boleh menyambung melalui `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Maju + +Setelah berjaya memulakan pelayan dan pelayan berfungsi dengan betul, kini tiba masanya untuk menyesuaikan pelayan. + +Terokai cara untuk menyesuaikan penggunaan pelayan melalui dokumen di bawah. + +{% content-ref url="langkah-seterusnya.md" %} +[langkah-seterusnya.md](langkah-seterusnya.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper yang berasaskan Plazma dibina di atas Spigot, yang pada gilirannya berasaskan platform pelayan rasmi Spigot. + +[^3]: Tombol Windows + R + +[^4]: Untuk Linux, jalankan `java --version` di terminal + +[^5]: JRE merupakan salah satu projek sumber terbuka yang terdapat pelbagai jenis seperti platform pelayan Minecraft. + +[^6]: Biasanya dikenali sebagai **launcher**. + +[^7]: Aktifkan "Auto-restart" untuk pelayan akan restart secara automatik. Anda boleh menamatkan dengan memasukkan `Control + C`. + +[^8]: Tidak disarankan melebihi separuh kapasiti sistem. + + Sebagai contoh, apabila kapasiti memori keseluruhan sistem adalah 8GB, tidak disyorkan untuk mengaturnya melebihi 4GB. + +[^9]: Perjanjian Lesen Pengguna Akhir, Perjanjian Lesen Pengguna Akhir. Sila rujuk [Laman Web Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) untuk maklumat lanjut. + +[^10]: Korporasi Microsoft. + +[^11]: Di Korea, mengikut Seksyen 32(1)(9) Undang-Undang Pemajuan Industri Permainan, **Korea Microsoft Corporation** boleh mengambil tindakan undang-undang. + +[^12]: Plug & Play Universal. Purpur yang termasuk dalam Plazma secara automatik berkomunikasi dengan router melalui teknologi ini hanya membuka port apabila server sedang berjalan, oleh itu, tidak perlu meneruskan port secara manual. + +[^13]: Jika tiada akaun, daftar masuk ke Ngrok menggunakan akaun Google atau GitHub. diff --git a/ms/origin/plazma/administration/getting-started/customization.md b/ms/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..d23856e9d --- /dev/null +++ b/ms/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,116 @@ +--- +description: Ketahui cara menggunaan semula pelayan. +--- + +# 🎨 Penggunaan semula + +Alasan mengapa menggunakan platform server yang telah diubah seperti Plazma daripada platform server rasmi yang disediakan oleh Mojang Studios adalah kerana ia membolehkan **penyesuaian pengguna** yang kuat. + +Berikut adalah beberapa cara untuk menyesuaikan dan menggunakan Plazma. + +## Penyesuaian Konfigurasi + +Cara paling asas untuk menyesuaikan Plazma adalah dengan mengubah konfigurasi. + +Plazma menyediakan pengaturan konfigurasi yang kuat, mulai dari mekanisme permainan hingga sifat-sifat entiti. + +Sila rujuk halaman di bawah untuk penjelasan mengenai konfigurasi Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Penggunaan Plugin + +{% hint style="kejayaan" %} + +**Plazma menyokong semua plugin berasaskan kertas dengan baik.** + +Bagi plugin Spigot, mungkin tidak berfungsi sepenuhnya disebabkan oleh perubahan pemetaan Paper sejak 1.20.5, tetapi kebanyakan plugin yang berasaskan Paper seperti Paper, Pufferfish, dan Purpur berfungsi dengan baik di Plazma. Jika tidak berfungsi dengan betul, sila [laporkan segera.](../diagnosis/plugins.md) + +{% endhint %} + +Ini adalah sebab utama penggunaan Plazma dan cara terkuat untuk mengkustomisasi Plazma. +Ekosistem plugin yang kuat bagi Plazma membolehkan pengguna mengkustomisasi server dengan mudah. + +Terdapat pelbagai cara untuk mencari dan memuat turun plugin. Sesetengah plugin dimuat naik ke perkhidmatan repositori awam, manakala yang lain dimuat naik ke GitHub atau laman web sendiri. + +{% hint style="amaran" %} + +**Plugin boleh mengakses sistem secara langsung!** + +Pastikan plugin selamat sebelum menggunakannya dengan menggunakan perkhidmatan seperti VirusTotal atau muat turun plugin dari perkhidmatan yang dipercayai. + +{% endhint %} + +Terdapat pelbagai perkhidmatan untuk memuat turun plugin. Antara perkhidmatan yang digunakan untuk muat naik plugin termasuk [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) yang melakukan penilaian sebelum membenarkan plugin tidak selamat disebarkan. + +### Memasang Plugin + +Setelah memuat turun plugin, tiba masanya untuk memasangnya. + +1. Plugin berbentuk `.jar` atau `Fail Eksekutif Java`.\ + Beberapa plugin mungkin berbentuk fail yang ditekan dan perlu ditekan semula, jika begitu,\ + buka fail yang mengandungi `bukkit`, `spigot`, atau `paper` dan gunakan fail yang mengandungi `fat`. +2. Letakkan fail yang dimuat turun ke dalam folder `plugins` dalam folder pelayan dan mulakan semula pelayan. +3. Apabila Plazma dimulakan, mesej baru akan dipaparkan di konsol. + Ini bermakna Plazma telah memuatkan plugin dengan betul. +4. Walaupun Plazma telah memuatkan plugin dengan betul, mungkin plugin tidak dapat dimulakan. + Dengan menggunakan perintah `/plugins`, anda boleh melihat senarai plugin yang dimuatkan pada pelayan. + Jika nama plugin yang dipasang tidak berwarna merah tetapi berwarna hijau, bermakna plugin telah dimuatkan dengan betul. + +Jika plugin tidak dimuatkan dengan betul, anda boleh mencari penyelesaian di halaman berikut. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Penggunaan Data Pack + +Data Pack adalah cara untuk mengkustomisasi Minecraft yang disediakan secara asas, serupa dengan [Pak Sumber](#user-content-fn-1)[^1]. + +Dengan menggunakan Data Pack, anda boleh menambahkan kumpulan makhluk baru dan cabaran permainan lain dalam permainan. + +{% hint style="amaran" %} + +**Data Pack boleh merosakkan dunia!** + +Beberapa Data Pack yang rosak boleh merosakkan dunia dan ini tidak dapat dikembalikan. + +Oleh itu, disarankan untuk membuat salinan data dunia sebelum menggunakan Data Pack. + +{% endhint %} + +Data Pack boleh didapati dari pelbagai perkhidmatan seperti [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) dan lain-lain. + +Selepas memuat turun Data Pack, letakkan dalam folder `datapacks` dalam folder dunia pelayan untuk menggunakannya. +Jika folder tidak wujud, anda boleh ciptakannya dan masukkan Data Pack di dalamnya. + +{% hint style="warning" %} + +**Beberapa [Data Pack](#user-content-fn-2)[^2] mungkin tidak berfungsi dengan betul pada permulaan.** + +Untuk kes seperti ini, disarankan untuk memulakan semula pelayan **2 kali**. + +{% endhint %} + +Data Pack mudah rosak setiap kali Minecraft dikemaskini. + +Khususnya, jika Data Pack rosak sepenuhnya, menyebabkan pelayan mengalami kegagalan, oleh itu, +ujian yang mencukupi sebelum mengemaskini pelayan adalah penting. + +{% hint style="info" %} + +**Selepas memulakan pelayan, masukkan `safeMode` selepas arahan permulaan untuk menonaktifkan semua Data Pack sebelum memulakan semula pelayan.** + +[Sila rujuk `Rujukan > Argumen dan Sifat` untuk maklumat lanjut.](../reference/arguments.md) + +{% endhint %} + +Data Pack yang dipasang boleh disahkan dengan menggunakan perintah `/datapack list`. + +*** + +[^1]: Atau tambahan untuk Edisi Minecraft: Bedrock. + +[^2]: Menambah kumpulan makhluk dan lain-lain. diff --git a/ms/origin/plazma/administration/getting-started/next-step.md b/ms/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..9b8b30759 --- /dev/null +++ b/ms/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Ketahui cara menggunaan semula pelayan. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Berikut adalah beberapa cara untuk menyesuaikan dan menggunakan Plazma. + +## Penyesuaian Konfigurasi + +Cara paling asas untuk menyesuaikan Plazma adalah dengan mengubah konfigurasi. + +Plazma menyediakan pengaturan konfigurasi yang kuat, mulai dari mekanisme permainan hingga sifat-sifat entiti. + +Sila rujuk halaman di bawah untuk penjelasan mengenai konfigurasi Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Penggunaan Plugin + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Ini adalah sebab utama penggunaan Plazma dan cara terkuat untuk mengkustomisasi Plazma. Ekosistem plugin yang kuat bagi Plazma membolehkan pengguna mengkustomisasi server dengan mudah. + +Terdapat pelbagai cara untuk mencari dan memuat turun plugin. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Terdapat pelbagai perkhidmatan untuk memuat turun plugin. Antara perkhidmatan yang digunakan untuk muat naik plugin termasuk [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) yang melakukan penilaian sebelum membenarkan plugin tidak selamat disebarkan. + +### Memasang Plugin + +Setelah memuat turun plugin, tiba masanya untuk memasangnya. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Letakkan fail yang dimuat turun ke dalam folder `plugins` dalam folder pelayan dan mulakan semula pelayan. +3. Apabila Plazma dimulakan, mesej baru akan dipaparkan di konsol. Ini bermakna Plazma telah memuatkan plugin dengan betul. +4. Walaupun Plazma telah memuatkan plugin dengan betul, mungkin plugin tidak dapat dimulakan. Dengan menggunakan perintah `/plugins`, anda boleh melihat senarai plugin yang dimuatkan pada pelayan. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Jika plugin tidak dimuatkan dengan betul, anda boleh mencari penyelesaian di halaman berikut. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Penggunaan Data Pack + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Dengan menggunakan Data Pack, anda boleh menambahkan kumpulan makhluk baru dan cabaran permainan lain dalam permainan. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Beberapa Data Pack yang rosak boleh merosakkan dunia dan ini tidak dapat dikembalikan. + +Oleh itu, disarankan untuk membuat salinan data dunia sebelum menggunakan Data Pack. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Selepas memuat turun Data Pack, letakkan dalam folder `datapacks` dalam folder dunia pelayan untuk menggunakannya. Jika folder tidak wujud, anda boleh ciptakannya dan masukkan Data Pack di dalamnya. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Untuk kes seperti ini, disarankan untuk memulakan semula pelayan **2 kali**. +{% endhint %} + +Data Pack mudah rosak setiap kali Minecraft dikemaskini. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Data Pack yang dipasang boleh disahkan dengan menggunakan perintah `/datapack list`. + +*** + +## Pemodenan + +Plazma telah dilengkapi dengan banyak penambahbaikan pemodenan. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proksi + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Sila rujuk maklumat pengaturan proksi yang selamat dan betul di halaman berikut. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Selamat + +Minecraft telah berkembang sehingga [enjin serangan titik lemah](#user-content-fn-3)[^3] boleh diperoleh dengan mudah secara dalam talian. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Tetapan Kebenaran + +Perintah pentadbir beberapa plugin mungkin mempunyai titik lemah jika kebenaran tidak ditetapkan dengan betul. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Penghalang X-Ray + +X-Ray adalah salah satu titik lemah yang boleh digunakan dengan mudah pada pelanggan pemodenan asas. + +Plazma menyediakan konfigurasi untuk menghalang X-Ray secara asas. + +Sila rujuk cara dan penerangan mengenai penghalang X-Ray di halaman berikut. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Senarai Putih + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Gunakan `/whitelist query` untuk melihat senarai pemain yang dibenarkan menyertai. + +*** + +[^1]: Atau tambahan untuk Edisi Minecraft: Bedrock. + +[^2]: Menambah kumpulan makhluk dan lain-lain. + +[^3]: Biasanya dikenali sebagai "cheats". + +[^4]: Konfigurasi yang tidak dioptimumkan, Plazma yang usang, atau titik lemah yang baru ditemui mungkin tidak dihalang. + +[^5]: Pemain menyertai pelayan melalui pelayan proksi Ngrok, dan alamat Ngrok yang dikeluarkan setiap kali pelayan dihidupkan semula adalah berbeza. diff --git a/ms/origin/plazma/administration/reference/README.md b/ms/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..aeea4698f --- /dev/null +++ b/ms/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Ketahui cara penggunaan asas yang disediakan oleh Plazma. +--- + +# 📜 리퍼런스 + +Plazma menyediakan pelbagai cara penggunaan. + +Antara cara tersebut, terdapat 4 cara penggunaan yang boleh digunakan dengan serta-merta tanpa sebarang kerja tambahan. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Server Discord rasmi](https://discord.gg/MmfC52K8A8) atau [Perbincangan GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) untuk bertanya kepada komuniti! +{% endhint %} + +*** + +## 🖥️ Perintah + +> Perintah membolehkan pengumpulan maklumat dalam permainan atau penggunaan persekitaran permainan. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Kebenaran + +> Kebenaran menetapkan lingkungan interaksi yang boleh dilakukan oleh pemain. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumen dan Sifat + +> Argumen dan Sifat memberi kesan keseluruhan kepada operasi Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigurasi + +> Konfigurasi merupakan cara asas untuk mengguna Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ms/origin/plazma/administration/reference/arguments.md b/ms/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..6c2448491 --- /dev/null +++ b/ms/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Ketahui tentang argumen permulaan dan sifat sistem. +--- + +# 🎛️ Argumen dan Sifat + +Permulaan dan sifat sistem adalah nilai tambahan kepada [perintah yang digunakan](#user-content-fn-1)[^1] dalam pelaksanaan Plazma, yang memberi kesan keseluruhan kepada operasi Plazma. + +[Posisi yang dilampirkan pada arahan](#user-content-fn-2)[^2] akan dibahagikan kepada **Argumen Permulaan** dan **Sifat Sistem**. + +*** + +## Sifat sistem + +Sifat sistem dimasukkan sebelum `-jar` dan diproses oleh JVM sebelum Plazma diinisialisasi. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Cara Penggunaan + +Sifat sistem dimasukkan sebagai argumen perintah Java antara `java` dan `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` menandakan argumen tersebut adalah tambahan khas untuk Plazma dan tidak disertakan dalam JVM, + +Jika tidak ada nilai yang dimasukkan ke dalam sifat, nilai akan tetap [`benar`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Sifat Sistem Penuh + +#### `convertLegacySigns` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Mengemaskini format tanda yang telah digunakan. + +#### `debug.entities` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug berkaitan maklumat entiti. + +#### `debug.rewriteForIDE` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan semula revisi NMS untuk IDE,\ +memetakan semula maklumat versi dalaman secara automatik. + +#### `disable.watchdog` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan sistem amaran Watchdog Spigot. + +#### `letMeReload` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan mesej pengesahan semula perintah `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Untuk pembangun plugin yang perlu mengemaskini plugin, gunakan hotswap sebagai gantinya. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan plugin yang menggunakan sistem input/output standard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Amaran jika format lama dikesan dalam komponen chat. + +#### `Paper.bypassHostCheck` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan pengesahan pola hos semasa pemain menyambung ke pelayan. + +#### `Paper.debugDynamicMissingKeys` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug untuk kunci yang hilang dalam objek NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug untuk profil kepala yang tidak sah. + +Log ini mencatat semua blok kepala yang salah dalam dunia bersama dengan lokasinya. + +#### `Paper.disableChannelLimit` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan sistem keutamaan kelas plugin. + +Berguna jika ada masalah dalam shading plugin. + +#### `Paper.disableFlushConsolidate` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan sistem konsolidasi flush Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Nilai Lalai**: `750` + +Jika entiti melebihi nilai yang ditetapkan, ia akan dihantar melalui paket berganda. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Nilai Lalai**: `8192` + +Tetapkan saiz maksimum paket yang boleh diterima oleh pelayan pada satu masa. + +#### `Paper.ignoreJavaVersion` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan pengesahan versi Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Ini boleh merosakkan fail dan dunia secara kekal, menyebabkan kegagalan mekanisme permainan. + +Semua masalah yang timbul daripada penggunaan ini adalah tanggungjawab pengguna dan Plamza tidak akan memberikan sebarang sokongan untuk itu. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Nilai Lalai**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Nilai Lalai**: `80` + +Tetapkan panjang maksimum teks pada satu baris tanda. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Nilai Lalai**: `(versi dunia) + 1` + +Tetapkan versi maklumat pembetulan data yang perlu diinisialisasi terlebih dahulu. + +Berguna jika perlu mengemaskini banyak chunk, tetapi jarang digunakan dalam keadaan biasa. + +#### `Paper.parseYamlCommentsByDefault` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `True` + +Aktifkan pemprosesan komen YAML secara lalai. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Nilai Lalai**: `30` + +Pemain akan dikeluarkan jika tiada data diterima daripada mereka selama tempoh yang ditetapkan (dalam saat). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Abaikan komen sifat pelayan. + +#### `Paper.debug-sync-loads` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug penulisan chunk secara selari. + +#### `Paper.enable-sync-chunk-writes` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan [sistem penulisan chunk asas Minecraft](#user-content-fn-10)[^10]. + +Ini akan menyebabkan setiap chunk disimpan secara berurutan, menyebabkan penurunan prestasi yang ketara. + +#### `Paper.explicit-flush` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan Pengepaman Eksplisit saluran rangkaian. + +#### `Paper.strict-thread-checks` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Log ralat yang berlaku di luar utama sentiasa. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Paparkan amaran jika tugas yang dirancang mempunyai kelewatan yang terlalu lama. + +#### `Paperclip.patchOnly` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Jika menggunakan fail eksekusi yang disediakan secara lalai, hanya lakukan pengepaman tanpa memulakan pelayan. + +#### `Plazma.aggressiveOptimize` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` +- **Konflik**: `Plazma.disableConfigOptimization` + +Optimum konfigurasi awal yang lebih kuat. + +Mengaktifkan ini akan membuat server lebih cepat dan lebih selamat, tetapi boleh memberi impak besar kepada permainan. + +#### `Plazma.disableConfigOptimization` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` +- **Konflik**: `Plazma.aggressiveOptimize` + +Tidak mengoptimumkan konfigurasi awal. + +Ini akan menggunakan konfigurasi asas Kertas. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` + +Melumpuhkan jenama Plazma dan menggunakan favicon asas vanila untuk server. + +#### `Plazma.useVanillaConfiguration` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` +- **Konflik**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Ini boleh memberi kesan besar kepada keselamatan dan prestasi server. + +Sebarang masalah yang timbul dari penggunaan ciri ini adalah tanggungjawab pentadbir server. +{% endhint %} + +Menggunakan nilai asas yang disediakan oleh Mojang untuk konfigurasi awal. + +Ini mematikan semua penambalan kelemahan yang digunakan dalam Paper. + +Penambalan kelemahan boleh diaktifkan semula dalam konfigurasi Paper atau Plazma. + +#### `Plazma.vanillaize` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `true` +- **Konflik**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Menetapkan konfigurasi awal kepada sesuatu yang lebih hampir kepada vanila. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Harta tanah yang telah dihentikan penggunaannya + +Ciri-ciri sistem di bawah ini adalah ciri-ciri yang telah dihentikan penggunaannya. + +#### `timings.bypassMax` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` +- **Dihentikan**: Selepas Plazma mengeluarkan Timings secara keseluruhan dari penggunaan + +Menentukan sama ada nilai yang melebihi had yang boleh dihantar ke API Timings Aikar. + +Walaupun begitu, sekiranya tidak diuruskan dalam API, had kadar akan dikenakan. + +*** + +## Argumen Permulaan + +Argumen Permulaan dimasukkan selepas `-jar *.jar` untuk inisialisasi Plazma dan nilainya diproses bersama. + +### Cara Penggunaan + +Ciri sistem dimasukkan sebagai argumen arahan program selepas `-jar *.jar`. + +Contohnya, jika ingin menggunakan argumen permulaan `nogui`,\ +masukkan seperti berikut untuk membolehkan Plazma memproses argumen `nogui` semasa inisialisasi. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumen Permulaan Penuh + +#### `bukkit-settings` + +- **Alias**: `b` +- **Nilai Asas**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Nilai Asas**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Nilai Asas**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Memulakan pelayan dengan dunia demo. + +#### `eraseCache` + +Menghapus fail cache yang tinggal selepas menaik taraf dunia. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Mencetak argumen permulaan dan penerangan penuh Plazma. + +#### `initSettings` + +Mencipta fail konfigurasi sahaja dan menamatkan pelayan. + +#### `jfrProfile` + +Aktifkan profil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Nilai Asas**: `(Sifat Pelayan)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Matikan panel antara muka grafik. + +#### `nojline` + +Matikan JLine dan gunakan konsol biasa. + +#### `online-mode` + +- **Alias**: `o` +- **Nilai Asas**: `(Sifat Pelayan)` + +Pilih untuk mengesahkan pemain dengan pelayan pengesahan Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Nilai Asas**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Menetapkan lokasi [Fail Konfigurasi PaperSpigot](../reference/configurations/paper/README.md) yang tidak lagi digunakan. + +Digunakan untuk memindahkan konfigurasi sedia ada ke fail konfigurasi baru dan tidak digunakan selepas itu. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Nilai Asas**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Nilai Asas**: `plugins` + +Menetapkan lokasi folder plugin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Nilai Asas**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Nilai Asas**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Memulakan pelayan dalam keadaan vanilla penuh. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Nilai Asas**: `(Sifat Pelayan)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Nilai Asas**: `(Sifat Pelayan)` + +Menetapkan port pelayan. + +#### `server-name` + +- **Nilai Asas**: `A Pelayan Plazma` + +Menetapkan nama pelayan. + +#### `spigot-settings` + +- **Alias**: `S` +- **Nilai Asas**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Mencetak versi Plazma. + +#### `world-dir` + +- **Alias**: `W`, `alam semesta`, `bekas alam semesta` +- **Nilai Asas**: `(Folder Pelayan)` + +Menetapkan lokasi di mana fail dunia disimpan. + +#### `world-name` + +- **Alias**: `w`, `dunia` +- **Nilai Asas**: `(Sifat Pelayan)` + +Menetapkan nama fail dunia. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Lokasi tambahan yang menentukan bagaimana argumen diproses berubah. + +[^3]: Sebagai contoh, jika ingin menetapkan `Plazma.iKnowWhatIAmDoing` kepada `true`, menggantikan `-DPlazma.iKnowWhatIAmDoing=true` dengan `-DPlazma.iKnowWhatIAmDoing` akan berfungsi sama. + +[^4]: Sebagai contoh, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Pendeteksi acara. + +[^6]: Pendeteksi acara. + +[^7]: Pelayan. + +[^8]: Isyarat yang mengesahkan bahawa pelayan berhubung dengan betul seperti denyutan jantung. + +[^9]: Dengan menggunakan ciri pembersihan AFK Purpur, anda boleh mengeluarkan pemain yang tidak hadir. + +[^10]: Sistem Penulisan Cebisan Serentak, Sync Chunk Write System. + +[^11]: `AMARAN! Plazma mungkin menyebabkan masalah yang tidak dijangka, jadi pastikan untuk mengujinya dengan teliti sebelum menggunakannya di server awam.` + +[^12]: Dalam permainan, `pengoptimuman dunia` beroperasi dengan prinsip yang sama. + +[^13]: Pentadbir `Tahap 2` atau yang lebih tinggi dikecualikan. + +[^14]: Protokol Internet, IP. diff --git a/ms/origin/plazma/administration/reference/commands.md b/ms/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..868c7fdfe --- /dev/null +++ b/ms/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Ketahui perintah yang boleh digunakan di Plazma. +--- + +# 🖥️ Perintah diff --git a/ms/origin/plazma/administration/reference/configurations/README.md b/ms/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..152f10fe3 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigurasi merupakan cara asas untuk mengguna Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atribut + +> Atribut adalah fail konfigurasi yang paling asas yang disediakan dalam Minecraft. Dengan menggunakan atribut, anda boleh menukar mekanisme asas permainan. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Konfigurasi Bukkit + +> Konfigurasi Bukkit adalah fail konfigurasi yang paling asas yang disediakan dalam Plazma. Dengan menggunakan konfigurasi Bukkit, anda boleh menukar mekanisme asas pelayan Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Konfigurasi Spigot + +> Konfigurasi Spigot membolehkan anda mengubah mekanisme permainan yang lebih terperinci, pemprosesan pemain, operasi perintah, dan pesanan. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Konfigurasi Kertas + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Konfigurasi Pufferfish + +> Konfigurasi Pufferfish membolehkan anda mengubah pemprosesan dunia dan entiti Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Konfigurasi Purpur + +> Atribut Purpur membolehkan anda mengubah data asas permainan. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Konfigurasi Plazma + +> Konfigurasi Plazma membolehkan anda menyesuaikan ciri-ciri Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ms/origin/plazma/administration/reference/configurations/bukkit.md b/ms/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e90d8c061 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang dimaksudkan oleh setiap nod dalam bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ms/origin/plazma/administration/reference/configurations/paper/README.md b/ms/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b4a316f2e --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti tujuan setiap fail dalam folder config. +--- + +# 🛩️ Kertas diff --git a/ms/origin/plazma/administration/reference/configurations/paper/global.md b/ms/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..eb5b36097 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod dalam paper-global.yml bermaksud. +--- + +# 🌏 전역 구성 diff --git a/ms/origin/plazma/administration/reference/configurations/paper/world.md b/ms/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..71e5edaf7 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Ketahui apa yang setiap node dalam paper-world.yml bermakna. +--- + +# 🏳️ 세계별 구성 + +Dunia diff --git a/ms/origin/plazma/administration/reference/configurations/plazma/README.md b/ms/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..55f28028a --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti tujuan setiap fail dalam folder config. +--- + +# ✨ Plazma diff --git a/ms/origin/plazma/administration/reference/configurations/plazma/global.md b/ms/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..9924dc52c --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod dalam plazma-global.yml bermaksud. +--- + +# 🌏 전역 구성 diff --git a/ms/origin/plazma/administration/reference/configurations/plazma/world.md b/ms/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..e1985a784 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti apa yang setiap nod dalam plazma-world.yml bermaksud. +--- + +# 🏳️ 세계별 구성 diff --git a/ms/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ms/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..31b0fe580 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti apa yang setiap nod dalam plazma-world.yml bermaksud. +--- + +# ✨ Plazma (Susunan Mengikut Dunia) diff --git a/ms/origin/plazma/administration/reference/configurations/property.md b/ms/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..87e7eaaea --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod di server.properties maksudkan. +--- + +# 🪨 Server.properties diff --git a/ms/origin/plazma/administration/reference/configurations/pufferfish.md b/ms/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..e6a2f8db4 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod dalam pufferfish.yml bermakna. +--- + +# 🐡 Ikan Buntal diff --git a/ms/origin/plazma/administration/reference/configurations/purpur/README.md b/ms/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..cd15c1045 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Kenal pasti apa yang setiap nod dalam purpur.yml bermakna. +--- + +# 🦑 Purpur diff --git a/ms/origin/plazma/administration/reference/configurations/purpur/global.md b/ms/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..f336df3c6 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Kenal pasti apa yang setiap nod dalam purpur.yml bermakna. +--- + +# 🌏 전역 구성 diff --git a/ms/origin/plazma/administration/reference/configurations/purpur/world.md b/ms/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..f8543e8f9 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Kenal pasti apa yang setiap nod dalam purpur.yml bermakna. +--- + +# 🏳️ 세계별 구성 diff --git a/ms/origin/plazma/administration/reference/configurations/spigot.md b/ms/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..77d093818 --- /dev/null +++ b/ms/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti apa yang setiap nod Spigot.yml bermaksud. +--- + +# 🚰 Spigot diff --git a/ms/origin/plazma/administration/reference/permissions.md b/ms/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..9fb4fa2c1 --- /dev/null +++ b/ms/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Ketahui mengenai kebenaran Plazma. +--- + +# 🛡️ Kebenaran + +Kebenaran adalah alat keselamatan sederhana yang menetapkan lingkungan di mana pemain di dalam server dapat berinteraksi. + +Untuk menggunakan dan mengubah kebenaran dengan baik, anda harus menggunakan plugin seperti [LuckPerms](https://luckperms.net). + +*** + +## Memahami Sistem Kebenaran Asas + +Minecraft menyediakan kumpulan kebenaran pengurusan asas. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Pemain**\ + Kumpulan kebenaran yang diberikan kepada semua pemain secara umum. +2. **Arbitrator**\ + Boleh mengabaikan perlindungan spawn. +3. **Pengurus Dunia**\ + Boleh menggunakan semua perintah dan blok perintah yang berkaitan dengan pengurusan dunia.\ + Kumpulan kebenaran yang dikenakan secara asas pada paket data dan blok perintah. +4. **Pentadbir**\ + Boleh menggunakan semua perintah yang berkaitan dengan pengurusan pemain. +5. **Pentadbir Utama**\ + Boleh menggunakan semua perintah termasuk pengurusan pelayan.\ + Kumpulan kebenaran yang dikenakan secara asas pada konsol dan pentadbir. + +*** + +## Menetapkan Kebenaran + +*** + +## Kebenaran Penuh + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk 'melipat' dan berinteraksi dengan entiti untuk menungganginya. + +Apabila menunggang entiti, pemain boleh mengawal pergerakan entiti dengan 'keutamaan pergerakan' dan melompat atau terbang dengan 'keutamaan melompat'. + +`(Namespaced Key)` merujuk kepada [ID Namespaced](#user-content-fn-2)[^2] entiti. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Asal**: `Tiada` + +Membenarkan pemain menggunakan kemahiran khas entiti semasa menunggangnya. + +Tidak semua kemahiran khas entiti boleh digunakan. Rujuk di bawah untuk senarai kemahiran khas yang boleh digunakan. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Silakan kongsi idea anda di [Plazma Discord](https://plazmamc.org/discord) atau [Perbincangan GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Lihat Kemahiran Khas yang Kini Tersedia + +- **`crepper`**\ + Apabila menekan 'keutamaan melompat', akan meletup.\ + Jika pemain mempunyai kebenaran `allow.powered.creeper`, boleh menekan lama 'keutamaan melompat' untuk mengecas. +- **`dolphin`**\ + Apabila menekan 'keutamaan melompat', akan berenang laju. +- **`phantom`**\ + Apabila menekan 'keutamaan melompat', akan menembak nyala. +- **`wither`**\ + Apabila 'berinteraksi', akan menembak kepala wither. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/credits (Pemain)`](commands.md#credits). + +Menyertakan `.lain` selepas nama kebenaran membenarkan penggunaan oleh pemain lain. + +#### `bukkit.command.demo` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/demo (Pemain)`](commands.md#demo). + +Menyertakan `.lain` selepas nama kebenaran membenarkan penggunaan oleh pemain lain. + +#### `bukkit.command.ping` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/ping (Pemain)`](commands.md#ping). + +Menyertakan `.lain` selepas nama kebenaran membenarkan penggunaan oleh pemain lain. + +#### `bukkit.command.ram` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/rambar (Pemain)`](commands.md#rambar). + +Menyertakan `.lain` selepas nama kebenaran membenarkan penggunaan oleh pemain lain. + +#### `bukkit.command.restart` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/tpsbar (Pemain)`](commands.md#tpsbar). + +Menyertakan `.lain` selepas nama kebenaran membenarkan penggunaan oleh pemain lain. + +#### `bukkit.command.timings` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Untuk maklumat mengenai perintah yang serupa, sila rujuk [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Asal**: `Pengurus Dunia` + +Membenarkan penggunaan [perintah `/gamemode (GameMode) (Pemain)`]. + +Menyertakan `.lain` selepas nama kebenaran membenarkan penggunaan oleh pemain lain. + +#### `paper.antixray.bypass` + +- **Asal**: `Tiada` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Ini akan meningkatkan prestasi untuk kedua-dua pihak. + +> Untuk maklumat lanjut mengenai tetapan X-Ray, sila rujuk halaman berikut. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Asal**: `Tiada` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Asal**: `Tiada` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Asal**: `Tiada` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Asal**: `Tiada` + +Membenarkan penggunaan [tag MiniMessage](https://docs.advntr.dev/minimessage/format.html) pada landasan. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Asal**: `Tiada` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Asal**: `Tiada` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Asal**: `Tiada` + +Mengecualikan pemain dari pilihan tendang ketika tidak aktif. + +#### `purpur.debug.f3n` + +- **Asal**: `Pengurus Dunia` + +Membenarkan pemain untuk menukar mod permainan dengan kekunci `F3 + N`. + +Ia tidak akan berfungsi jika tiada kebenaran untuk mod permainan tersebut. + +#### `purpur.drop.spawners` + +- **Asal**: `Tiada` + +Apabila menggali blok spawner dengan item yang ditetapkan dalam konfigurasi, ia akan menjatuhkan blok spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Asal**: `Tiada` + +Menukar saiz peti End. + +`(NumberString)` boleh menjadi `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Asal**: `Tiada` + +Membenarkan totem abadi berfungsi walaupun berada dalam inventori. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk mengabaikan had jumlah pemain yang menyambung. + +#### `purpur.mending_shift_click` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk membaiki item yang dipegang apabila `berjongkok dan berinteraksi`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk memasang pemberi spawn. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk terus bergerak ke destinasi setelah menggunakan portal Nether. + +#### `purpur.sign.color` + +- **Asal**: `Tiada` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `tanda.sihir.purpur` + +- **Asal**: `Tiada` + +Membenarkan penggunaan kod pengaburan pada papan tanda `(&o)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `gaya.tanda.purpur` + +- **Asal**: `Tiada` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `pelepasan.tnt.purpur` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk mencegah letupan TNT dengan `interaksi saling` menggunakan gunting. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Peranan yang dijadualkan + +#### `plazma.lalu-lalang.bypass-ncr` + +- **Asal**: `Tiada` + +Membenarkan pemain untuk menyertai walaupun mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) tidak dipasang. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Contoh: `ender_dragon` diff --git a/ms/origin/plazma/adminstration/README.md b/ms/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..f9ea6874a --- /dev/null +++ b/ms/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Cobalah membuat server Anda sendiri dengan menggunakan Plazma. +--- + +# ⚒️ Panduan Pengurusan Pelayan diff --git a/ms/origin/plazma/adminstration/expert/README.md b/ms/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..c38bc4242 --- /dev/null +++ b/ms/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara mengendalikan Plazma secara profesional. +--- + +# 🎓 Lanjutan diff --git a/ms/origin/plazma/adminstration/expert/fix-exploits.md b/ms/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..9bf0fa04f --- /dev/null +++ b/ms/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Ketahui tentang kerentanan yang diketahui dan cara menanganinya. +--- + +# ⚠️ Kerentanan yang diketahui dan cara penyelesaiannya diff --git a/ms/origin/plazma/adminstration/expert/optimize.md b/ms/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..d92c69cc0 --- /dev/null +++ b/ms/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara untuk mengoptimumkan Plazma. +--- + +# 🧹 Optimumkan diff --git a/ms/origin/plazma/adminstration/expert/vanillaize.md b/ms/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..4559c55a1 --- /dev/null +++ b/ms/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Ketahui cara untuk mengembalikan patch Paper dan vanilla. +--- + +# ↩️ Membuat menjadi seperti vanilla + +{% hint style="warning" %} + +### Paper tidak menyertakan pilihan untuk kebanyakan patch pemulihan vanilla. + +Plazma sedang mengembangkan konfigurasi untuk menonaktifkan pemulihan kesalahan tersebut. + +Oleh karena itu, panduan ini masih dalam proses penulisan dan informasi dapat berubah kapan saja. +{% endhint %} diff --git a/ms/origin/plazma/adminstration/faq.md b/ms/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..5fe71791e --- /dev/null +++ b/ms/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Ketahui tentang soalan lazim. +--- + +# ⁉️ Soalan Lazim + +{% hint style="info" %} + +### Tidak dapat mencari jawapan yang diinginkan? + +[Server Discord resmi](https://discord.gg/MmfC52K8A8) atau [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) untuk bertanya kepada komunitas! +{% endhint %} + +### Mesej muncul tetapi tidak berjalan + +Jika `tiada atribut manifest utama, dalam plazma-(versi).jar` dipaparkan di konsol,\ +fail yang dimuat turun adalah fail API pembangunan, anda perlu memuat turun **Reobf Paperweight** dari laman GitHub. + +Untuk maklumat lanjut, sila rujuk kepada halaman berikut. + +{% content-ref url="getting-started/" %} +[mula-mula](getting-started#id-2) +{% endcontent-ref %} + +### Amaran dipaparkan setiap kali pelayan dihidupkan + +Plazma mengandungi beberapa penyelesaian yang tidak stabil dan sentiasa berpotensi untuk berfungsi dengan tidak baik, oleh itu amaran berikut dipaparkan setiap kali pelayan dihidupkan. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Amaran tersebut boleh dimatikan menggunakan ciri sistem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Untuk maklumat lanjut, sila rujuk kepada halaman berikut. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Boleh digunakan mulai versi 1.20.1 diff --git a/ms/origin/plazma/adminstration/getting-started/README.md b/ms/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..a8a433712 --- /dev/null +++ b/ms/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Ketahui cara membuat server dengan Plazma. +--- + +# 👟 Mula + +Untuk menggunakan Plazma secara stabil, sistem perlu memenuhi keperluan berikut: + +| | Minimum | Disyorkan | +| :--------------: | ------: | --------: | +| Seni bina | x64 | - | +| RAM | 8GB | 16GB | +| Ruangan simpanan | 1GB | 8GB | +| JRE | 17 | 21 | + +Untuk mengedit fail konfigurasi dengan lancar, disarankan untuk memasang editor seperti [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Pemasangan JRE + +Seperti yang dinyatakan dalam namanya, Minecraft: **"Java"** Edition dibangunkan dengan Java, dan untuk menjalankannya, JRE[^1] diperlukan. + +Plazma adalah platform server rasmi Mojang Studios yang [berasaskan](#user-content-fn-2)[^2], oleh itu JRE juga perlu dipasang untuk menggunakan Plazma. + +### 1.1 Pemeriksaan Kewujudan JRE + +Untuk memeriksa sama ada JRE dipasang dalam sistem, masukkan [`cmd /k java --version`](#user-content-fn-4)[^4] dalam [tetingkap run](#user-content-fn-3)[^3] dan jalankan. + +Jika output adalah seperti berikut, langkau ke [langkah 2](setup.md#id-2). + +{% code title="Output yang betul" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Jika output tidak seperti di atas, atau seperti di bawah, bermakna tiada JRE atau terlalu lama; oleh itu, lakukan [langkah 1.2](setup.md#id-1.2). + +{% code title="JRE tidak dipasang" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE terlalu lama" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Pemasangan JRE + +Dalam panduan ini, kami akan menggunakan Azul Zulu sebagai [satu dari jenis](#user-content-fn-5)[^5] JRE. + +Selepas pemasangan, sila jalankan semula [Langkah 1.1](setup.md#id-1.1) untuk memastikan pemasangan telah berjaya. + +{% tabs %} +{% tab title="Windows" %} + +1. Pertama, muat turun **JDK 21** dari [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) dalam format `.msi`. +2. Jalankan penyelenggaraan muat turun dan klik `Next`. +3. Di tengah kiri tetingkap, aktifkan `Set JAVA_HOME variable` dan kemudian klik `Next`. +4. Tekan `Install` untuk menyelesaikan pemasangan JRE. + {% endtab %} + +{% tab title="macOS" %} +Muat turun pemasang **JDK 21** dari [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) dalam format `.dmg` dan jalankan untuk memasang JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Pertama, jalankan arahan berikut dalam terminal untuk menambahkan repositori Azul Zulu ke APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Kemudian, jalankan arahan berikut dalam terminal untuk memasang JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Anda boleh memasang JRE dengan menjalankan arahan berikut. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Muat Turun Plazma + +Plazma menyediakan pelbagai jenis fail eksekusi. + +{% hint style="warning" %} + +### Kebanyakan masa, gunakan `Reobf Paperclip`. + +Kandungan di bawah adalah untuk mereka yang ingin mengetahui tentang pembangun atau ciri-ciri setiap jenis.\ +Jika anda pengguna biasa, anda boleh terus ke [Langkah 3](setup.md#id-3) tanpa sebarang masalah. +{% endhint %} + +
+ +Ketahui lebih lanjut + +Nama fail eksekusi adalah `plazma-(pengurus versi)-1.20.4-R0.1-SNAPSHOT-(jenis pemetaan).jar` yang telah ditetapkan. + +- **Jenis Pemetaan**\ + Pemetaan adalah jenis peta yang menghubungkan kod sebenar Minecraft dengan kod yang telah digarap. + - **Reobf**\ + Pemetaan semula, juga dikenali sebagai pemetaan Spigot dan digunakan dalam kebanyakan plugin NMS.\ + Ia akan digantikan bermula dari 1.20.5. + - **Mojmap**\ + Pemetaan Mojang, pemetaan Minecraft Vanilla. +- **Pengurus Versi**\ + Pengurus versi adalah pustaka yang diperlukan untuk menjalankan pelayan dan berfungsi sebagai pelancar pelayan yang memuat turun pustaka dan memohonkan fail pelayan. + - **Paperclip**\ + Dicipta oleh pasukan PaperMC untuk Paper dan platform terbitan lain, berperanan dalam memuat turun pustaka dan menyelaraskan pelayan. + - **Bundler**\ + Pengurus versi Minecraft Vanilla. + +
+ +*** + +## 3. Cipta Skrip Mula + +Untuk memulakan Plazma dengan mudah dan membolehkan pelayan secara automatik mulakan semula, anda perlu membuat [skrip mula](#user-content-fn-6)[^6]. + +Anda boleh membuat skrip mula melalui [Flags.sh](https://flags.sh).\ +Hanya masukkan [jumlah memori yang hendak digunakan oleh Plazma](#user-content-fn-8)[^8] dan perintah akan dioptimumkan secara automatik. + +Anda boleh muat turun skrip mula melalui butang muat turun di bahagian kiri bawah.\ +**Pastikan skrip mula yang dimuat turun sepadan dengan sistem operasi anda.** + +*** + +## 4. Penyusunan Fail + +Pindahkan skrip mula yang dimuat turun dan Plazma ke folder baru sekarang. + +{% hint style="warning" %} + +### Nama folder mesti tidak mengandungi ruang dan dalam bahasa Inggeris. + +Jika tidak, Plazma atau JRE mungkin tidak berfungsi dengan betul. +{% endhint %} + +Kini jalankan skrip mula. Untuk Windows, pilih **Allow** dalam tetingkap Pilihan Benar Api firewall. + +*** + +## 5. Persetujuan EULA + +Apabila anda menjalankan skrip mula, fail `eula.txt` akan dicipta dalam folder. + +EULA[^9] adalah perjanjian lesen yang perlu anda setujui untuk menggunakan perkhidmatan [Mojang Studios](#user-content-fn-10)[^10]. + +Jika anda tidak bersetuju dengan EULA, anda tidak boleh memulakan pelayan dan mungkin akan dikenakan [sanksi jika melanggar EULA.](#user-content-fn-11)[^11] + +Untuk bersetuju dengan EULA, ubah `eula=false` kepada `eula=true` dalam fail `eula.txt` dan simpan. + +*** + +## 6. Membenarkan Sambungan Luar (Windows) + +Sistem operasi moden secara asasnya menghalang akses luaran melalui **firewall** dan **router** untuk melindungi daripada akses berbahaya. + +Untuk Windows, kerana anda telah membenarkan dalam [Langkah 3](setup.md#id-3), anda hanya perlu melakukan penerusan port. + +{% hint style="info" %} + +### Panduan ini diasumsikan untuk sistem operasi Windows dan [**UPnP**](#user-content-fn-12)[^12] yang menggunakan router. + +Jika router anda tidak menyokong UPnP, anda perlu mencari maklumat mengikut panel router yang berbeza. + +Atau anda boleh menggunakan [Ngrok](https://ngrok.com/) untuk mencipta alamat sementara. +{% endhint %} + +{% hint style="warning" %} + +### Sistem operasi (semi) UNIX seperti Linux atau macOS mempunyai cara konfigurasi firewall yang berbeza mengikut perkhidmatan, jadi anda perlu merujuk kepada maklumat yang berkaitan. + +{% endhint %} + +### 6.1 Semak Keperluan Penerusan Port + +Masukkan dan jalankan seperti yang berikut dalam tetingkap eksekusi. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jika output adalah `True`, anda boleh berhenti di sini, tetapi jika `False`, anda perlu tetapkan penerusan port. + +### 6.2 Menyambung ke Pelayan + +{% tabs %} +{% tab title="Sambungan Luar" %} +Jika penerusan port tidak diperlukan atau telah berjaya dilakukan, anda kini boleh menyambung ke pelayan. + +Alamat yang digunakan untuk menyambung ke pelayan boleh disemak [di sini](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Cuba UPnP untuk Penerusan Port" %} +Di dalam `purpur.yml` pelayan, aktifkan `network.upnp-port-forwarding` kepada `true`. + +Kemudian, mulakan semula pelayan dan Plazma akan cuba meneruskan port secara automatik. + +Kejayaan UPnP bergantung kepada mesej yang dipaparkan dalam konsol, di mana ia akan menunjukkan `[UPnP] (mesej)`. + +| Mesej | Makna | +| ----------------------------- | -------------------------------------------- | +| `Berjaya membuka port (port)` | Penerusan port berjaya. | +| `Port (port) sudah terbuka` | Port telah digunakan oleh perkhidmatan lain. | +| `Gagal membuka port (port)` | Penerusan port gagal. | +| `Perkhidmatan tidak tersedia` | Router tidak menyokong UPnP. | + +Apabila pelayan ditutup, Plazma akan menutup port secara automatik. +{% endtab %} + +{% tab title="Cipta Alamat Sementara dengan Ngrok" %} +Penggunaan Ngrok adalah berguna untuk ujian sementara, bermain bersama, atau bermain dengan rakan-rakan. + +1. Muat turun fail ZIP `Windows (64-bit)` dari [Laman Web Ngrok](https://ngrok.com/download). +2. Letakkan fail Ngrok yang dimuat turun ke dalam folder pelayan. +3. Di [Papan Pemuka Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), cipta [token pengesahan](#user-content-fn-13)[^13]. +4. Di dalam folder pelayan, jalankan arahan yang dipaparkan dalam `Command Line`. +5. Tambahkan `start /b ngrok tcp --region jp 25565` di bahagian atas skrip eksekusi, dan `taskkill /f /t /im ngrok.exe` di bahagian bawahnya. +6. Dari mesej yang dipaparkan di bahagian atas konsol `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, `0.tcp.jp.ngrok.io:12345` adalah alamat pelayan. +7. Sekarang anda boleh mengakses alamat tersebut dari luar. + {% endtab %} + +{% tab title="Mengakses dari Lokal" %} +Jika anda cuba untuk menyambung ke pelayan dari komputer tempatan, anda boleh menggunakan alamat `IPv4` yang dipaparkan apabila menjalankan `cmd /k ipconfig` di tetingkap run. + +Contohnya, apabila output seperti berikut dipaparkan selepas menjalankan arahan tersebut, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Anda boleh menyambung ke pelayan dari komputer tempatan dengan mencuba menyambung ke alamat `192.168.3.7` yang dipaparkan pada IPv4. + +Jika pelayan dan permainan dijalankan pada PC yang sama, anda boleh menyambung melalui `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Tahap Pembangunan + +Setelah berjaya memulakan pelayan dan pelayan berfungsi dengan betul, kini tiba masanya untuk menyesuaikan pelayan. + +Ketahui cara untuk menyesuaikan pelayan melalui panduan di bawah. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java execution environment. + +[^2]: Paper yang berasaskan Plazma dibina di atas Spigot, yang pada gilirannya berasaskan platform pelayan rasmi Spigot. + +[^3]: Tombol Windows + R + +[^4]: Untuk Linux, jalankan `java --version` di terminal + +[^5]: JRE merupakan salah satu projek sumber terbuka yang terdapat pelbagai jenis seperti platform pelayan Minecraft. + +[^6]: Biasanya dikenali sebagai **launcher**. + +[^7]: Aktifkan "Auto-restart" untuk pelayan akan restart secara automatik. Anda boleh menamatkan dengan memasukkan `Control + C`. + +[^8]: Tidak disarankan melebihi separuh kapasiti sistem. + + Sebagai contoh, apabila kapasiti memori keseluruhan sistem adalah 8GB, tidak disyorkan untuk mengaturnya melebihi 4GB. + +[^9]: Perjanjian Lesen Pengguna Akhir, Perjanjian Lesen Pengguna Akhir. Sila rujuk [Laman Web Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) untuk maklumat lanjut. + +[^10]: Korporasi Microsoft. + +[^11]: Di Korea, mengikut Seksyen 32(1)(9) Undang-Undang Pemajuan Industri Permainan, **Korea Microsoft Corporation** boleh mengambil tindakan undang-undang. + +[^12]: Plug & Play Universal. Purpur yang termasuk dalam Plazma secara automatik berkomunikasi dengan router melalui teknologi ini hanya membuka port apabila server sedang berjalan, oleh itu, tidak perlu meneruskan port secara manual. + +[^13]: Jika tiada akaun, daftar masuk ke Ngrok menggunakan akaun Google atau GitHub. diff --git a/ms/origin/plazma/adminstration/getting-started/customization.md b/ms/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..6e0103c6a --- /dev/null +++ b/ms/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Ketahui cara menggunaan semula pelayan. +--- + +# 🎨 Penggunaan semula diff --git a/ms/origin/plazma/adminstration/reference/arguments.md b/ms/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..9ed3fa70b --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: Ketahui tentang argumen permulaan dan sifat sistem. +--- + +# 🎛️ Argumen dan Sifat + +Argumen permulaan dan sifat sistem adalah nilai yang ditambahkan ke [perintah yang digunakan](#user-content-fn-1)[^1] dalam pelaksanaan Plazma,\ +membolehkan nilai yang tidak boleh diubah selepas Plazma dilaksanakan untuk diubah. + +Berdasarkan [lokasi nilai yang ditambahkan ke perintah](#user-content-fn-2)[^2], ia dibahagikan kepada **argumen permulaan** dan **sifat sistem**. + +*** + +## Sifat sistem + +Sifat sistem dimasukkan sebelum `-jar` dan diproses oleh JVM sebelum Plazma diinisialisasi. + +{% hint style="warning" %} + +### Mengubah sifat sistem boleh mengubah cara Plazma dan JVM berfungsi dan boleh memberi kesan besar kepada permainan! + +Jika anda tidak pasti peranan setiap sifat sistem, **jangan gunakannya sama sekali!** +{% endhint %} + +### Cara Penggunaan + +Sifat sistem dimasukkan sebagai argumen perintah Java antara `java` dan `-jar`. + +Contohnya, jika anda ingin menggunakan sifat sistem `Plazma.dummyProperty`,\ +masukkan nilai seterusnya sebagai `37` untuk inisialisasi Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` menandakan argumen tersebut adalah tambahan khas untuk Plazma dan tidak disertakan dalam JVM, + +Jika tidak ada nilai yang dimasukkan, nilai akan tetap [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platform Pemendatang Berat membezakan sifat sistem untuk setiap platform dengan menyertakan `.` dalam nama sifat. + +Beberapa terminal seperti Windows Powershell mungkin tidak menerima argumen ini, jadi, tambahkan `"` pada kedua hujung argumen. [sebagai langkah berjaga-jaga.](#user-content-fn-4)[^4] +{% endhint %} + +### Sifat Sistem Penuh + +#### `convertLegacySigns` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Mengemaskini format tanda yang telah digunakan. + +#### `debug.entities` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug berkaitan maklumat entiti. + +#### `debug.rewriteForIDE` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan semula revisi NMS untuk IDE,\ +memetakan semula maklumat versi dalaman secara automatik. + +#### `disable.watchdog` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan sistem amaran Watchdog Spigot. + +#### `letMeReload` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan mesej pengesahan semula perintah `/reload`. + +{% hint style="danger" %} + +### Perintah `/reload` sangat tidak stabil, oleh itu, semua masalah yang berlaku selepas menggunakan `/reload` adalah tanggungjawab pengguna sendiri. + +Untuk pembangun plugin yang perlu mengemaskini plugin, gunakan hotswap sebagai gantinya. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan plugin yang menggunakan sistem input/output standard. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Amaran jika format lama dikesan dalam komponen chat. + +#### `Paper.bypassHostCheck` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan pengesahan pola hos semasa pemain menyambung ke pelayan. + +#### `Paper.debugDynamicMissingKeys` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug untuk kunci yang hilang dalam objek NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug untuk profil kepala yang tidak sah. + +Log ini mencatat semua blok kepala yang salah dalam dunia bersama dengan lokasinya. + +#### `Paper.disableChannelLimit` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan had jumlah saluran plugin (128 saluran setiap pemain) yang dikenakan kepada setiap pemain. + +#### `Paper.disableClassPrioritization` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan sistem keutamaan kelas plugin. + +Berguna jika ada masalah dalam shading plugin. + +#### `Paper.disableFlushConsolidate` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan sistem konsolidasi flush Netty. + +#### `Paper.excessiveTELimit` + +- **Jenis**: `Integer` +- **Nilai Lalai**: `750` + +Jika entiti melebihi nilai yang ditetapkan, ia akan dihantar melalui paket berganda. + +#### `Paper.filterThreshold` + +- **Jenis**: `Integer` +- **Nilai Lalai**: `8192` + +Tetapkan saiz maksimum paket yang boleh diterima oleh pelayan pada satu masa. + +#### `Paper.ignoreJavaVersion` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Matikan pengesahan versi Java. + +{% hint style="danger" %} + +### Ini boleh menyebabkan JVM cuba mengakses kod yang tidak wujud! + +Ini boleh merosakkan fail dan dunia secara kekal, menyebabkan kegagalan mekanisme permainan. + +Semua masalah yang timbul daripada penggunaan ini adalah tanggungjawab pengguna dan Plamza tidak akan memberikan sebarang sokongan untuk itu. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Jenis**: `Integer` +- **Nilai Lalai**: `64` + +Tetapkan had nama saluran plugin. + +#### `Paper.maxSignLength` + +- **Jenis**: `Integer` +- **Nilai Lalai**: `80` + +Tetapkan panjang maksimum teks pada satu baris tanda. + +#### `Paper.minPrecachedDatafixVersion` + +- **Jenis**: `Integer` +- **Nilai Lalai**: `(versi dunia) + 1` + +Tetapkan versi maklumat pembetulan data yang perlu diinisialisasi terlebih dahulu. + +Berguna jika perlu mengemaskini banyak chunk, tetapi jarang digunakan dalam keadaan biasa. + +#### `Paper.parseYamlCommentsByDefault` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `True` + +Aktifkan pemprosesan komen YAML secara lalai. + +#### `Paper.playerConnection.keepAlive` + +- **Jenis**: `Integer` +- **Nilai Lalai**: `30` + +Pemain akan dikeluarkan jika tiada data diterima daripada mereka selama tempoh yang ditetapkan (dalam saat). + +Biasanya, permainan[^7] akan terus menghantar [isyarat jantung](#user-content-fn-8)[^8] ke pelayan, [mengelakkan pembanjiran,](#user-content-fn-9)[^9] tetapi jika permainan tidak memberi respons, pelayan menganggap permainan telah mengalami kegagalan dan mengeluarkan pemain tanpa lebih lanjut memproses mereka. + +#### `Paper.skipServerPropertiesComments` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Abaikan komen sifat pelayan. + +#### `Paper.debug-sync-loads` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan log debug penulisan chunk secara selari. + +#### `Paper.enable-sync-chunk-writes` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan [sistem penulisan chunk asas Minecraft](#user-content-fn-10)[^10]. + +Ini akan menyebabkan setiap chunk disimpan secara berurutan, menyebabkan penurunan prestasi yang ketara. + +#### `Paper.explicit-flush` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Aktifkan Pengepaman Eksplisit saluran rangkaian. + +#### `Paper.strict-thread-checks` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Log ralat yang berlaku di luar utama sentiasa. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Paparkan amaran jika tugas yang dirancang mempunyai kelewatan yang terlalu lama. + +#### `Paperclip.patchOnly` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `False` + +Jika menggunakan fail eksekusi yang disediakan secara lalai, hanya lakukan pengepaman tanpa memulakan pelayan. + +#### `Plazma.aggressiveOptimize` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` + +{% hint style="warning" %} + +### Sifat ini akan dipindahkan sebagai argumen permulaan selepas 1.20.5. + +{% endhint %} + +Optimumkan konfigurasi yang digunakan pada permulaan dengan lebih ketat. + +Apabila diaktifkan, server akan menjadi lebih cepat dan selamat, tetapi boleh menghalang beberapa mekanisme atau memberi kesan besar kepada permainan. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` + +Menekan mesej amaran[^11] yang dipaparkan semasa Plazma diinisialisasi. + +### Harta tanah yang telah dihentikan penggunaannya + +Ciri-ciri sistem di bawah ini adalah ciri-ciri yang telah dihentikan penggunaannya. + +#### `timings.bypassMax` + +- **Jenis**: `Boolean` +- **Nilai Lalai**: `false` +- **Dihentikan**: Selepas Plazma mengeluarkan Timings secara keseluruhan dari penggunaan + +Menentukan sama ada nilai yang melebihi had yang boleh dihantar ke API Timings Aikar. + +Walaupun begitu, sekiranya tidak diuruskan dalam API, had kadar akan dikenakan. + +*** + +## Argumen Permulaan + +Argumen Permulaan dimasukkan selepas `-jar *.jar` untuk inisialisasi Plazma dan nilainya diproses bersama. + +### Cara Penggunaan + +Ciri sistem dimasukkan sebagai argumen arahan program selepas `-jar *.jar`. + +Contohnya, jika ingin menggunakan argumen permulaan `nogui`,\ +masukkan seperti berikut untuk membolehkan Plazma memproses argumen `nogui` semasa inisialisasi. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumen Permulaan Penuh + +#### `bukkit-settings` + +- **Alias**: `b` +- **Nilai Asas**: `bukkit.yml` + +Menetapkan nama dan lokasi [Fail Konfigurasi Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Nilai Asas**: `commands.yml` + +Menetapkan nama dan lokasi [Fail Konfigurasi Perintah Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Nilai Asas**: `server.properties` + +Menetapkan nama dan lokasi [Fail Sifat Pelayan](../reference/configurations/property.md). + +#### `demo` + +Memulakan pelayan dengan dunia demo. + +#### `eraseCache` + +Menghapus fail cache yang tinggal selepas menaik taraf dunia. + +#### `forceUpgrade` + +Memaksa [menaik taraf](#user-content-fn-12)[^12] dunia tanpa mengira versi. + +#### `help` + +- **Alias**: `?` + +Mencetak argumen permulaan dan penerangan penuh Plazma. + +#### `initSettings` + +Mencipta fail konfigurasi sahaja dan menamatkan pelayan. + +#### `jfrProfile` + +Aktifkan profil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Nilai Asas**: `(Sifat Pelayan)` + +Menetapkan jumlah maksimum [pemain](#user-content-fn-14)[^14] yang dibenarkan. + +#### `nogui` + +Matikan panel antara muka grafik. + +#### `nojline` + +Matikan JLine dan gunakan konsol biasa. + +#### `online-mode` + +- **Alias**: `o` +- **Nilai Asas**: `(Sifat Pelayan)` + +Pilih untuk mengesahkan pemain dengan pelayan pengesahan Mojang. + +**Jika tidak menggunakan Velocity atau proksi, boleh dikenakan tindakan disiplin mengikut [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Nilai Asas**: `paper.yml` + +{% hint style="warning" %} + +### Argumen ini tidak lagi digunakan selepas versi 1.19.4 + +{% endhint %} + +Menetapkan lokasi [Fail Konfigurasi PaperSpigot](../reference/configurations/paper/README.md) yang tidak lagi digunakan. + +Digunakan untuk memindahkan konfigurasi sedia ada ke fail konfigurasi baru dan tidak digunakan selepas itu. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Nilai Asas**: `config` + +Menetapkan nama dan lokasi folder yang mengandungi [Fail Konfigurasi Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Menetapkan nama dan lokasi folder yang mengandungi [Fail Konfigurasi Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Nilai Asas**: `plugins` + +Menetapkan lokasi folder plugin. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Nilai Asas**: `pufferfish.yml` + +Menetapkan nama dan lokasi [Fail Konfigurasi Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Nilai Asas**: `purpur.yml` + +Menetapkan nama dan lokasi [Fail Konfigurasi Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Memulakan pelayan dalam keadaan vanilla penuh. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Nilai Asas**: `(Sifat Pelayan)` + +Menetapkan nama hos pelayan atau alamat [protokol internet](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Nilai Asas**: `(Sifat Pelayan)` + +Menetapkan port pelayan. + +#### `server-name` + +- **Nilai Asas**: `A Pelayan Plazma` + +Menetapkan nama pelayan. + +#### `spigot-settings` + +- **Alias**: `S` +- **Nilai Asas**: `spigot.yml` + +Menetapkan nama dan lokasi [Fail Konfigurasi Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Mencetak versi Plazma. + +#### `world-dir` + +- **Alias**: `W`, `alam semesta`, `bekas alam semesta` +- **Nilai Asas**: `(Folder Pelayan)` + +Menetapkan lokasi di mana fail dunia disimpan. + +#### `world-name` + +- **Alias**: `w`, `dunia` +- **Nilai Asas**: `(Sifat Pelayan)` + +Menetapkan nama fail dunia. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Lokasi tambahan yang menentukan bagaimana argumen diproses berubah. + +[^3]: Sebagai contoh, jika ingin menetapkan `Plazma.iKnowWhatIAmDoing` kepada `true`, menggantikan `-DPlazma.iKnowWhatIAmDoing=true` dengan `-DPlazma.iKnowWhatIAmDoing` akan berfungsi sama. + +[^4]: Sebagai contoh, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Pendeteksi acara. + +[^6]: Pendeteksi acara. + +[^7]: Pelayan. + +[^8]: Isyarat yang mengesahkan bahawa pelayan berhubung dengan betul seperti denyutan jantung. + +[^9]: Dengan menggunakan ciri pembersihan AFK Purpur, anda boleh mengeluarkan pemain yang tidak hadir. + +[^10]: Sistem Penulisan Cebisan Serentak, Sync Chunk Write System. + +[^11]: `AMARAN! Plazma mungkin menyebabkan masalah yang tidak dijangka, jadi pastikan untuk mengujinya dengan teliti sebelum menggunakannya di server awam.` + +[^12]: Dalam permainan, `pengoptimuman dunia` beroperasi dengan prinsip yang sama. + +[^13]: Protokol Internet, IP. + +[^14]: Pentadbir `Tahap 2` atau yang lebih tinggi dikecualikan. diff --git a/ms/origin/plazma/adminstration/reference/commands.md b/ms/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..868c7fdfe --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Ketahui perintah yang boleh digunakan di Plazma. +--- + +# 🖥️ Perintah diff --git a/ms/origin/plazma/adminstration/reference/configurations/bukkit.md b/ms/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e90d8c061 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang dimaksudkan oleh setiap nod dalam bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ms/origin/plazma/adminstration/reference/configurations/paper/README.md b/ms/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b4a316f2e --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti tujuan setiap fail dalam folder config. +--- + +# 🛩️ Kertas diff --git a/ms/origin/plazma/adminstration/reference/configurations/paper/global.md b/ms/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..739633d3f --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod dalam paper-global.yml bermaksud. +--- + +# 🛩️ Kertas (Global Configuration) diff --git a/ms/origin/plazma/adminstration/reference/configurations/paper/world.md b/ms/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..878e54291 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap node dalam paper-world.yml bermakna. +--- + +# 🛩️ Kertas (Susunan Mengikut Dunia) diff --git a/ms/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ms/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..55f28028a --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti tujuan setiap fail dalam folder config. +--- + +# ✨ Plazma diff --git a/ms/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ms/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..369c1f18c --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod dalam plazma-global.yml bermaksud. +--- + +# ✨ Plazma (Konfigurasi Global) diff --git a/ms/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ms/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..cb81c695c --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Susunan Mengikut Dunia diff --git a/ms/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ms/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..31b0fe580 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti apa yang setiap nod dalam plazma-world.yml bermaksud. +--- + +# ✨ Plazma (Susunan Mengikut Dunia) diff --git a/ms/origin/plazma/adminstration/reference/configurations/property.md b/ms/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..87e7eaaea --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod di server.properties maksudkan. +--- + +# 🪨 Server.properties diff --git a/ms/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ms/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..e6a2f8db4 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Ketahui apa yang setiap nod dalam pufferfish.yml bermakna. +--- + +# 🐡 Ikan Buntal diff --git a/ms/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ms/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..cd15c1045 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Kenal pasti apa yang setiap nod dalam purpur.yml bermakna. +--- + +# 🦑 Purpur diff --git a/ms/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ms/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..6f8898a4c --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Kenal pasti apa yang setiap nod dalam purpur.yml bermakna. +--- + +# 🦑 Purpur (komposisi global) diff --git a/ms/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ms/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..eff23d2a6 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Kenal pasti apa yang setiap nod dalam purpur.yml bermakna. +--- + +# 🦑 Purpur (susunan dunia) diff --git a/ms/origin/plazma/adminstration/reference/configurations/spigot.md b/ms/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..77d093818 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Kenalpasti apa yang setiap nod Spigot.yml bermaksud. +--- + +# 🚰 Spigot diff --git a/ms/origin/plazma/adminstration/reference/permissions.md b/ms/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..e8932e696 --- /dev/null +++ b/ms/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Ketahui mengenai kebenaran Plazma. +--- + +# 🛡️ Kebenaran diff --git a/ms/origin/plazma/developers.md b/ms/origin/plazma/developers.md new file mode 100644 index 000000000..a9856572d --- /dev/null +++ b/ms/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Coba kembangkan proyek pihak ketiga dengan menggunakan Plazma. +--- + +# ⚙️ Panduan Pembangun diff --git a/ms/origin/thunderbolt/README.md b/ms/origin/thunderbolt/README.md new file mode 100644 index 000000000..3717d40ed --- /dev/null +++ b/ms/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt adalah platform server berasaskan Plazma yang membenarkan penggunaan patch eksperimental dibezakan sebagai Flavor untuk digunakan secara langsung. +--- + +# 🌩️ Panduan Penggunaan Thunderbolt diff --git a/ms/origin/volt/README.md b/ms/origin/volt/README.md new file mode 100644 index 000000000..3437aec05 --- /dev/null +++ b/ms/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt adalah templat sumber terbuka yang membolehkan anda membangunkan platform pelayan Paperweight anda sendiri berdasarkan Plazma. +--- + +# ⚡ Panduan Pembangunan Volt diff --git a/nl/origin/README.md b/nl/origin/README.md new file mode 100644 index 000000000..30804b3f0 --- /dev/null +++ b/nl/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Als u vragen heeft, stel ze dan via Discord of GitHub Discussies. +--- + +# 🏠 Welkom bij de Docs Portal + +{% hint style="info" %} + +**De documenten van Plazma zijn momenteel in machinale vertaalde staat.** + +[![Vertalingsstatus](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Doe mee aan de documentvertaling op [https://translate.plazmamc.org/](https://translate.plazmamc.org/) en help bij het verbeteren van de documenten. + +{% endhint %} + +### Als er een probleem is opgetreden tijdens het gebruik van Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Als u geïnteresseerd bent in Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Als u uw eigen serverplatform met Volt wilt maken, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Als u meer informatie over Minecraft nodig heeft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/nl/origin/SUMMARY.md b/nl/origin/SUMMARY.md new file mode 100644 index 000000000..50e383782 --- /dev/null +++ b/nl/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Inhoudsopgave + +- [🏠 Welkom bij de Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Gebruik Documenten](plazma/README.md) +- [❓ Wat is Plazma?](plazma/about/README.md) + - [⬇️ Downloaden](plazma/about/downloads.md) + - [✅ Ondersteunde Versies](plazma/about/supported-versions.md) +- [⚒️ Serverbeheergids](plazma/administration/README.md) + - [👟 Aan de slag](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referentie](plazma/administration/reference/README.md) + - [🖥️ Opdrachten](plazma/administration/reference/commands.md) + - [🛡️ Rechten](plazma/administration/reference/permissions.md) + - [🎛️ Argumenten en eigenschappen](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Eigenschap](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globale configuratie](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Wereldwijde configuratie](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globale configuratie](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Wereldwijde configuratie](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globale configuratie](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Wereldwijde configuratie](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Geavanceerd](plazma/administration/expert/README.md) + - [🧹 Optimalisatie](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Terug naar standaard](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blokkering](plazma/administration/expert/xray.md) + - [⚠️ Kwetsbaarheden en oplossingen](plazma/administration/expert/fix-exploits.md) + - [⁉️ Veelgestelde vragen](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Ontwikkelaars Gids](plazma/developers.md) + - [✏️ Bijdragen](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Gebruik Gids](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Ontwikkelings Gids](volt/README.md) + +## Diversen + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Download alles](plazma/about/downloads-all.md) diff --git a/nl/origin/miscellaneous/README.md b/nl/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/nl/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/nl/origin/plazma/README.md b/nl/origin/plazma/README.md new file mode 100644 index 000000000..0b6ffb3a4 --- /dev/null +++ b/nl/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma is een open-source serverplatform voor Minecraft: Java Edition dat experimentele optimalisatie op basis van papier en diverse game-mechanismen personalisatie mogelijkheden toevoegt." +--- + +# ✨ Plazma Gebruik Documenten + +## 👋 Welkom bij Plazma Documenten + +Welkom bij de Plazma gebruikershandleiding! + +{% hint style="info" %} + +**Kan het probleem niet worden opgelost via de handleiding?** + +Stel je vragen aan de community via de [officiële Discord-server](https://discord.gg/MmfC52K8A8) of [GitHub-discussies](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Over Plazma + +> Ontdek wat Plazma voor een serverplatform is. + +{% content-ref url="about/" %} +[over](about/) +{% endcontent-ref %} + +### Voor beheerders + +> Creëer uw eigen server met behulp van Plazma. + +{% content-ref url="administration/" %} +[administratie](administration/) +{% endcontent-ref %} + +### Voor ontwikkelaars + +> Ontwikkel third-party projecten met behulp van Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/nl/origin/plazma/about/README.md b/nl/origin/plazma/about/README.md new file mode 100644 index 000000000..63f0def3a --- /dev/null +++ b/nl/origin/plazma/about/README.md @@ -0,0 +1,71 @@ +--- +description: Ontdek wat Plazma voor een serverplatform is. +--- + +# ❓ Wat is Plazma? + +- **Plazma** is een serverplatform gebaseerd op [Paper](https://github.com/PaperMC/Paper) dat alleen de voordelen van [Andromeda](https://github.com/EarendelArchived/Andromeda) en [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) overneemt. +- We streven altijd naar hoge stabiliteit, krachtige prestaties, snelle updates en uitgebreide functionaliteit. + +## 📋 Doelstellingen van Plazma + +- We streven ernaar een serverplatform te zijn met snelle updates en hoge stabiliteit. +- We streven ernaar om uitgebreide functionaliteit en krachtige prestaties te bieden die niet onderdoen voor modplatforms. +- We streven ernaar een vrij platform te creëren waarop ook vanilla patches kunnen worden aangepast. + +## ⚙️ Belangrijkste kenmerken + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Snelste updates**\ + Met [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) blijven de patches van Plazma altijd up-to-date, waardoor het het snelste updateproces biedt onder de op Paper gebaseerde serverplatforms. +6. **Geoptimaliseerde standaard configuratiebestanden**\ + De standaard toegepaste configuratiebestanden zijn geoptimaliseerd, zodat u ze niet zelf hoeft te optimaliseren. +7. **Efficiënt werkende multithreading**\ + Door systeemmechanismen die niet gerelateerd zijn aan het spelmechanisme asynchroon te maken, wordt de server geoptimaliseerd om de vertraging te verminderen. +8. **Voorkomen van onnodig geheugengebruik**\ + Door vergelijkbare waarden samen te voegen, wordt de geheugenconsumptie verminderd. + +## ✨ Gebruiksscenario's + +- **Platform dat zelfs complexe plug-ins correct verwerkt**\ + Plazma wordt gebruikt op de server van ontwikkelaar [IPECTER](https://github.com/IPECTER). Ondanks de zelf ontwikkelde plug-ins die werken met NMS en reflectie, en het grote aantal uitgebreide datapacks, kan het meer dan 100 spelers ontvangen zonder prestatieverlies. +- **Platform dat snelle prestaties behoudt, zelfs op een RPG-server**\ + Op een enkel cluster konden 100 spelers stabiel blijven zonder TPS-verlaging, en op 4 clusters konden in totaal 250 spelers comfortabel spelen. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Veel gekozen platform door veel streamers**\ + Wordt gebruikt als een emmer voor kijkersparticipatie van veel streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +U kunt Plazma downloaden vanaf de onderstaande pagina. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Meer informatie over ondersteunde versies? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plug-ins en Paper, Pufferfish, Purpur plug-ins. + +[^2]: Door Microsoft Corporation. + +[^3]: Door het uitschakelen van het chatsysteem wordt de chat volledig op de server verwerkt en wordt het chattrackingmechanisme van Mojang geblokkeerd. + +[^4]: Tijd die nodig is voor het systeemmechanisme om te werken, waarbij het spel tijdelijk wordt onderbroken. diff --git a/nl/origin/plazma/about/downloads-all.md b/nl/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..cd2277e79 --- /dev/null +++ b/nl/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma uitvoerbare bestand downloaden volledig bekijken +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versie | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/nl/origin/plazma/about/downloads.md b/nl/origin/plazma/about/downloads.md new file mode 100644 index 000000000..eb1e3195e --- /dev/null +++ b/nl/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Download Plazma nu meteen en probeer het zelf uit. +--- + +# ⬇️ Download + +#### Meer informatie over ondersteunde versies? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**De onderstaande download is het uitvoerbare bestand voor gewone gebruikers.** + +Als u een ontwikkelaar bent en een ander type bestand nodig heeft, raadpleeg dan de onderstaande pagina. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersieDownload
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/nl/origin/plazma/about/patches-list.md b/nl/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..092406cc9 --- /dev/null +++ b/nl/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Leer alles over de toegevoegde functies in Plazma. +--- + +# 📑 Inbegrepen patches diff --git a/nl/origin/plazma/about/supported-versions.md b/nl/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..1fdd41bbe --- /dev/null +++ b/nl/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Ontdek welke versie van Minecraft: Java Edition wordt ondersteund door Plazma." +--- + +# ✅ Ondersteunde versie + +{% hint style="info" %} + +**Plazma wordt ontwikkeld vanaf 1.19.4 en versies onder 1.19.4 worden niet meer ondersteund.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: +[atv]: https://badge.plazmamc.org/2/Ondersteund +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Geen%20informatie +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Gemiddeld +[100]: https://badge.plazmamc.org/percent/100 + +![Wachten op release][wtr] ![In ontwikkeling][idv] ![Ondersteund][atv] ![Ondersteuning van functies gestopt][fse] ![Ondersteuning beëindigd][eol] + +| Versie | Stabiliteit en functionaliteit ondersteuning | Buildstatus | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Bouwstatus](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Bouwstatus](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Bouwstatus](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/nl/origin/plazma/administration/README.md b/nl/origin/plazma/administration/README.md new file mode 100644 index 000000000..fda40bd25 --- /dev/null +++ b/nl/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Creëer uw eigen server met behulp van Plazma. +--- + +# ⚒️ Serverbeheergids diff --git a/nl/origin/plazma/administration/diagnosis/README.md b/nl/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..d5ead0bb1 --- /dev/null +++ b/nl/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek hoe je moet omgaan met problemen die zich voordoen. +--- + +# 🧾 진단 diff --git a/nl/origin/plazma/administration/diagnosis/plugins.md b/nl/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..c2f97adf7 --- /dev/null +++ b/nl/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Ontdek hoe je problemen oplost wanneer de plug-in niet goed werkt. +--- + +# 📜 플러그인 diff --git a/nl/origin/plazma/administration/expert/README.md b/nl/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..0f020e263 --- /dev/null +++ b/nl/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek hoe je op een professionele manier met Plazma omgaat. +--- + +# 🎓 Diepgaand diff --git a/nl/origin/plazma/administration/expert/fix-exploits.md b/nl/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..70e4a1967 --- /dev/null +++ b/nl/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Leer over bekende kwetsbaarheden en hoe ze op te lossen. +--- + +# ⚠️ Bekende kwetsbaarheden en oplossingsmethoden diff --git a/nl/origin/plazma/administration/expert/optimize.md b/nl/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..7bd621452 --- /dev/null +++ b/nl/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Ontdek hoe je Plazma optimaliseert. +--- + +# 🧹 Optimalisatie diff --git a/nl/origin/plazma/administration/expert/proxy.md b/nl/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..c6b1ed50b --- /dev/null +++ b/nl/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Leer hoe je het proxyplatform "Velocity" veilig kunt configureren. +--- + +# 🔀 Proxy diff --git a/nl/origin/plazma/administration/expert/vanillaize.md b/nl/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..dd9f5d6b2 --- /dev/null +++ b/nl/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Leer hoe je de patch van Paper en Vanilla kunt herstellen. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper voegt geen opties toe aan de meeste patches die Vanilla's fouten oplossen.** + +Plazma is momenteel bezig met het ontwikkelen van een configuratie om dergelijke foutoplossingen uit te schakelen. + +Daarom is deze gids nog in ontwikkeling en de informatie kan altijd veranderen. + +{% endhint %} diff --git a/nl/origin/plazma/administration/expert/xray.md b/nl/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..f1ec9b3d3 --- /dev/null +++ b/nl/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Ontdek verschillende ingebouwde methoden om X-Ray te blokkeren. +--- + +# 🩻 X-Ray blokkering diff --git a/nl/origin/plazma/administration/faq.md b/nl/origin/plazma/administration/faq.md new file mode 100644 index 000000000..ded321bc6 --- /dev/null +++ b/nl/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Leer meer over veelgestelde vragen. +--- + +# ⁉️ Veelgestelde vragen + +{% hint style="info" %} + +**Kunt u het gewenste antwoord niet vinden?** + +Stel je vragen aan de community via de [officiële Discord-server](https://discord.gg/MmfC52K8A8) of [GitHub-discussies](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma start niet op + +Als er een bericht wordt weergegeven met `geen hoofdmanifestattribuut in plazma-(versie).jar`,\ +dan is het gedownloade bestand een ontwikkelings-API-bestand en moet u **Reobf Paperweight** downloaden vanaf de GitHub-pagina. + +Raadpleeg de volgende pagina voor meer informatie. + +{% content-ref url="getting-started/" %} +[starten](getting-started#id-2) +{% endcontent-ref %} + +### Er wordt bij elke start van de server een waarschuwing weergegeven + +Plazma bevat enkele onstabiele patches en heeft daarom altijd het risico op storingen. Daarom wordt de volgende waarschuwing weergegeven wanneer de server wordt gestart. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Deze waarschuwing kan worden uitgeschakeld met behulp van de [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] systeemeigenschap. + +Raadpleeg de volgende pagina voor meer informatie. + +{% content-ref url="reference/arguments.md" %} +[argumenten.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Beschikbaar vanaf 1.20.1 diff --git a/nl/origin/plazma/administration/getting-started/README.md b/nl/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..8eb7e9f62 --- /dev/null +++ b/nl/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Leer hoe je een server maakt met Plazma. +--- + +# 👟 Aan de slag + +Om Plazma stabiel te gebruiken, moet het systeem aan de volgende vereisten voldoen. + +| | Minimum | Aanbevolen | +| :----------: | ------- | ---------- | +| Architectuur | x64 | - | +| RAM | 8GB | 16GB | +| Opslagruimte | 1GB | 8GB | +| JDK | 17 | 21 | + +Voor soepel bestandsbewerkingen, is het ook goed om een editor zoals [Visual Studio Code](https://code.visualstudio.com/download) te installeren. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Juiste uitvoer" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' is geen interne of externe opdracht, uitvoerbaar programma of +batchbestand. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Download eerst **JDK 21** in `.msi` formaat van [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Voer de gedownloade installatiewizard uit en klik op 'Volgende'. +3. Activeer 'Set JAVA_HOME variable' in het menu links van het midden van het venster en klik op 'Volgende'. +4. Voltooi de JRE-installatie door op 'Installeren' te klikken. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Installeer vervolgens JRE door de volgende opdrachten in de terminal uit te voeren. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma downloaden + +Plazma biedt verschillende soorten uitvoerbare bestanden aan. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Meer informatie + +De naam van het uitvoerbare bestand is `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping type**\ + Mapping is een soort kaart die het echte code van Minecraft verbindt met de geobfusceerde code. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-gemapt, is de mapping voor Vanilla Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Version manager**\ + De versiebeheerder is een soort launcher die nodig is voor het draaien van de server en het patchen van serverbestanden. + - **Paperclip**\ + Ontwikkeld door het PaperMC-team voor Paper en andere afgeleide platforms, downloadt bibliotheken en past patches toe op de server. + - **Bundler**\ + De Vanilla Minecraft-versiebeheerder. + +
+ +*** + +## 3. Startscript maken + +Om Plazma eenvoudig te starten en de server automatisch opnieuw te starten, moet u een [startscript](#user-content-fn-6)[^6] maken. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +U kunt het startscript downloaden via de knop linksonder.\ +**Controleer of het gedownloade startscript overeenkomt met uw besturingssysteem.** + +*** + +## 4. Bestandsopruiming + +Verplaats nu het gedownloade startscript en Plazma naar een nieuwe map. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Voer nu het startscript uit. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA accepteren + +Na het uitvoeren van het startscript wordt er een 'eula.txt' bestand in de map gemaakt. + +EULA[^9] is een gebruiksrechtovereenkomst waarbij u akkoord moet gaan met het gebruik van de diensten van [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Om akkoord te gaan met de EULA, wijzigt u `eula=false` naar `eula=true` in het `eula.txt` bestand en slaat u het op. + +*** + +## 6. Extern toegang toestaan (Windows) + +Moderne besturingssystemen blokkeren standaard externe toegang met behulp van de **firewall** en **router**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Als uw router UPnP niet ondersteunt, heeft elke router een ander paneel, dus u moet zelf informatie opzoeken. + +U kunt ook [Ngrok](https://ngrok.com/) gebruiken om een tijdelijk adres te genereren. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Controleer of port forwarding nodig is + +Voer het volgende in het uitvoervenster in en voer het uit. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Als de uitvoer 'True' is, is het goed, maar als het 'False' is, moet u port forwarding instellen. + +### 6.2 Verbinding maken met de server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Het adres dat wordt gebruikt om verbinding te maken met de server, kan hier worden gecontroleerd: [hier](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Na het opnieuw starten van de server zal Plazma automatisch proberen port forwarding te doen. + +Hieronder staat of UPnP succesvol was op basis van de berichten die op de console worden weergegeven, op de console wordt het als `[UPnP] (bericht)` weergegeven. + +| Bericht | Betekenis | +| --------------------------------- | -------------------------------------------------------- | +| `Poort succesvol geopend (poort)` | Port forwarding succesvol. | +| `Poort (poort) is al geopend` | Een andere service gebruikt de poort al. | +| `Kon poort niet openen (poort)` | Port forwarding mislukt. | +| `Service is niet beschikbaar` | De router ondersteunt geen UPnP. | + +Wanneer de server wordt afgesloten, sluit Plazma automatisch de poort. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Download het ZIP-bestand `Windows (64-bit)` van de [Ngrok-website](https://ngrok.com/download). +2. Plaats de gedownloade Ngrok in de servermap. +3. Genereer een [verificatietoken](#user-content-fn-13) op [Ngrok-dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Voer de opdrachten uit die worden weergegeven in de `Command Line` van de servermap. +5. Voeg `start /b ngrok tcp --region jp 25565` toe aan het bovenste gedeelte van het uitvoeringsscript en `taskkill /f /t /im ngrok.exe` aan de onderkant. +6. Het adres van de server wordt `0.tcp.jp.ngrok.io:12345` zoals weergegeven in `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` in de console. +7. Nu kunt u via dit adres van buitenaf verbinding maken. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Bijvoorbeeld, als het volgende wordt weergegeven na het uitvoeren van de opdracht, + +```log +Windows IP-configuratie + +Ethernet-adapter Ethernet: + + Verbindingsspecifieke DNS-achtervoegsel. . . . : + IPv4-adres. . . . . . . . . : 192.168.3.7 + Subnetmasker. . . . . . . . : 255.255.255.0 + Standaardgateway. . . . . . : 192.168.3.1 + +``` + +U kunt verbinding maken met de server vanaf uw lokale machine door verbinding te maken met het `192.168.3.7` dat wordt weergegeven als IPv4-adres. + +Als de server en het spel op dezelfde pc worden uitgevoerd, kunt u verbinding maken met `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Ontwikkelen + +Als de server succesvol is gestart en correct werkt, is het nu tijd om de server aan te passen. + +Leer hoe u de server kunt aanpassen met behulp van de volgende handleiding. + +{% content-ref url="volgende-stap.md" %} +[volgende-stap.md](volgende-stap.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, de basis van Plazma, is gebaseerd op Spigot, dat op zijn beurt is gebaseerd op het officiële serverplatform van Spigot. + +[^3]: Windows-toets + R + +[^4]: Voor Linux, voer `java --version` uit in de terminal. + +[^5]: JRE is een van de open-source projecten, vergelijkbaar met Minecraft-serverplatforms. + +[^6]: Het staat bekend als een **launcher**. + +[^7]: Als u 'Automatisch opnieuw opstarten' inschakelt, wordt de server automatisch opnieuw opgestart. U kunt afsluiten door `Control + C` in te voeren. + +[^8]: Het wordt niet aanbevolen om meer dan de helft van het systeemgeheugen toe te wijzen. + + Bijvoorbeeld, als het totale geheugen van het systeem 8 GB is, wordt het niet aanbevolen om meer dan 4 GB toe te wijzen. + +[^9]: Eindgebruikerslicentieovereenkomst, EULA. Raadpleeg de [Minecraft-website](https://www.minecraft.net/ko-kr/usage-guidelines) voor meer informatie. + +[^10]: Microsoft Corporation. + +[^11]: Volgens artikel 32, lid 1, punt 9 van de Wet op de bevordering van de game-industrie in Zuid-Korea, kan **Korea Microsoft Corporation** juridische stappen ondernemen. + +[^12]: Universal Plug & Play. Plazma bevat Purpur die automatisch communiceert met de router via deze technologie en alleen poorten opent wanneer de server actief is, waardoor directe port forwarding niet nodig is. + +[^13]: Als je geen account hebt, meld je dan aan bij Ngrok met een Google- of GitHub-account. diff --git a/nl/origin/plazma/administration/getting-started/customization.md b/nl/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..30699b372 --- /dev/null +++ b/nl/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,120 @@ +--- +description: Leer hoe je de server kunt aanpassen aan de gebruiker. +--- + +# 🎨 Gebruiksaanpassing + +De reden om aangepaste serverplatforms zoals Plazma te gebruiken in plaats van de officiële serverplatforms van Mojang Studios is dat het zeer **aanpasbaar** is. + +Hier zijn verschillende manieren om Plazma aan te passen en te gebruiken. + +## Configuratieaanpassingen + +De meest fundamentele manier om Plazma aan te passen is door de configuratie aan te passen. + +Plazma biedt krachtige configuratie-instellingen, van game-mechanismen tot eigenschappen van mobs. + +Raadpleeg de onderstaande pagina voor uitleg over de configuratie van Plazma. + +{% content-ref url="../reference/configurations/" %} +[configuraties](../reference/configurations/) +{% endcontent-ref %} + +## Gebruik van plug-ins + +{% hint style="success" %} + +**Plazma ondersteunt alle op papier gebaseerde plug-ins.** + +Voor Spigot-plug-ins kan het zijn dat sommige vanaf 1.20.5 vanwege de mappingveranderingen van Paper niet goed werken, +Maar de meeste plug-ins die zijn gebaseerd op Paper, Pufferfish en Purpur werken allemaal op Plazma, +Als een plug-in niet goed werkt, meld dit dan onmiddellijk als een fout van Plazma [hier.](../diagnosis/plugins.md) + +{% endhint %} + +Dit is de belangrijkste reden om Plazma te gebruiken en de krachtigste manier om Plazma aan te passen. +Het sterke plug-in ecosysteem van Plazma maakt het gemakkelijk om de server aan te passen. + +Er zijn verschillende manieren om plug-ins te vinden en te downloaden. Sommige plug-ins worden geüpload naar openbare opslagservices, terwijl andere plug-ins worden geüpload naar GitHub of hun eigen websites. + +{% hint style="caution" %} + +**Plug-ins kunnen direct toegang krijgen tot het systeem!** + +Controleer altijd of een plug-in veilig is voordat je deze toepast met behulp van services zoals VirusTotal, +Of download plug-ins van betrouwbare services. + +{% endhint %} + +Er zijn verschillende services beschikbaar om plug-ins te downloaden. Onder andere [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) bieden services waar plug-ins worden beoordeeld voordat ze worden geüpload, zodat alleen veilige plug-ins worden verspreid. + +### Plug-ins toepassen + +Als je een plug-in hebt gedownload, is het nu tijd om de plug-in toe te passen. + +1. Plug-ins zijn beschikbaar als `.jar` of `Java Executable File`.\ + Sommige plug-ins zijn gecomprimeerd en moeten worden uitgepakt. In dat geval + Als er een bestand met `bukkit`, `spigot` of `paper` in de naam zit en + er is een bestand met `fat`, gebruik dan het `fat`-bestand. +2. Plaats het gedownloade bestand in de `plugins`-map van de server en start de server opnieuw op. +3. Wanneer Plazma start, zal er nieuwe inhoud op de console verschijnen. + Dit betekent dat Plazma de plug-in succesvol heeft geladen. +4. Zelfs als Plazma de plug-in succesvol heeft geladen, kan het zijn dat de plug-in niet start. + Met het commando `/plugins` kun je de momenteel geladen plug-ins op de server zien. + Als de naam van de geïnstalleerde plug-in niet in rood maar in groen wordt weergegeven, is de plug-in succesvol geladen. + +Als de plug-in niet succesvol is geladen, kun je op de volgende pagina oplossingen vinden voor het probleem. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Gebruik van datapacks + +Datapacks zijn een manier om Minecraft aan te passen, vergelijkbaar met [Resource Packs](#user-content-fn-1). + +Met datapacks kun je nieuwe entiteiten en uitdagingen toevoegen aan het spel en delen van het spel aanpassen. + +{% hint style="caution" %} + +**Datapacks kunnen werelden beschadigen!** + +Sommige defecte datapacks kunnen werelden beschadigen en dit is onomkeerbaar. + +Daarom wordt aanbevolen om een back-up te maken van de wereld voordat je datapacks toepast. + +{% endhint %} + +Datapacks zijn beschikbaar op verschillende services zoals [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) en andere services. + +Als je een datapack hebt gedownload, kun je deze toepassen door deze in de `datapacks`-map van de server te plaatsen. +Maak de map aan als deze niet bestaat. + +{% hint style="warning" %} + +**Sommige [datapacks](#user-content-fn-2) werken mogelijk niet correct bij de eerste toepassing.** + +In dat geval wordt aanbevolen de server **2 keer** opnieuw op te starten. + +{% endhint %} + +Datapacks kunnen gemakkelijk beschadigd raken bij elke update van Minecraft. + +Vooral als een datapack ernstig beschadigd is, kan dit leiden tot servercrashes, +Daarom is het belangrijk om de server grondig te testen voordat je deze update. + +{% hint style="info" %} + +**Voeg `safeMode` toe achter het startcommando van de server om alle datapacks uit te schakelen voordat je de server start.** + +Zie `Referentie > Argumenten en Eigenschappen` voor meer informatie.](../reference/arguments.md) + +{% endhint %} + +Je kunt de toegepaste datapacks controleren met het commando `/datapack list`. + +*** + +[^1]: Of in Minecraft: Bedrock Edition met add-ons. + +[^2]: Toevoeging van entiteiten en meer. diff --git a/nl/origin/plazma/administration/getting-started/next-step.md b/nl/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..68321dc72 --- /dev/null +++ b/nl/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Leer hoe je de server kunt aanpassen aan de gebruiker. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Hier zijn verschillende manieren om Plazma aan te passen en te gebruiken. + +## Configuratieaanpassingen + +De meest fundamentele manier om Plazma aan te passen is door de configuratie aan te passen. + +Plazma biedt krachtige configuratie-instellingen, van game-mechanismen tot eigenschappen van mobs. + +Raadpleeg de onderstaande pagina voor uitleg over de configuratie van Plazma. + +{% content-ref url="../reference/configurations/" %} +[configuraties](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Gebruik van plug-ins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Dit is de belangrijkste reden om Plazma te gebruiken en de krachtigste manier om Plazma aan te passen. Het sterke plug-in ecosysteem van Plazma maakt het gemakkelijk om de server aan te passen. + +Er zijn verschillende manieren om plug-ins te vinden en te downloaden. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Er zijn verschillende services beschikbaar om plug-ins te downloaden. Onder andere [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) bieden services waar plug-ins worden beoordeeld voordat ze worden geüpload, zodat alleen veilige plug-ins worden verspreid. + +### Plug-ins toepassen + +Als je een plug-in hebt gedownload, is het nu tijd om de plug-in toe te passen. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Plaats het gedownloade bestand in de `plugins`-map van de server en start de server opnieuw op. +3. Wanneer Plazma start, zal er nieuwe inhoud op de console verschijnen. Dit betekent dat Plazma de plug-in succesvol heeft geladen. +4. Zelfs als Plazma de plug-in succesvol heeft geladen, kan het zijn dat de plug-in niet start. Met het commando `/plugins` kun je de momenteel geladen plug-ins op de server zien. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Als de plug-in niet succesvol is geladen, kun je op de volgende pagina oplossingen vinden voor het probleem. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Gebruik van datapacks + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Met datapacks kun je nieuwe entiteiten en uitdagingen toevoegen aan het spel en delen van het spel aanpassen. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Sommige defecte datapacks kunnen werelden beschadigen en dit is onomkeerbaar. + +Daarom wordt aanbevolen om een back-up te maken van de wereld voordat je datapacks toepast. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Als je een datapack hebt gedownload, kun je deze toepassen door deze in de `datapacks`-map van de server te plaatsen. Maak de map aan als deze niet bestaat. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +In dat geval wordt aanbevolen de server **2 keer** opnieuw op te starten. +{% endhint %} + +Datapacks kunnen gemakkelijk beschadigd raken bij elke update van Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Je kunt de toegepaste datapacks controleren met het commando `/datapack list`. + +*** + +## Optimalisatie + +Plazma heeft veel optimalisatie patches toegepast. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Raadpleeg de onderstaande pagina voor informatie over veilige en juiste proxy-instellingen. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Veiligheid + +Met de ontwikkeling van mods kan Minecraft gemakkelijk kwetsbaarheden vinden en aanvallen met een [exploit engine](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Machtigingsinstellingen + +Sommige beheerdersopdrachten van plugins hebben kwetsbaarheden als de machtigingen niet correct zijn ingesteld. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray blokkering + +X-Ray is een van de kwetsbaarheden die gemakkelijk kunnen worden gebruikt, zelfs met een basisoptimalisatieclient. + +Plazma biedt een configuratie die standaard X-Ray kan blokkeren. + +Raadpleeg de onderstaande pagina voor informatie over het blokkeren van X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Gebruik `/whitelist query` om te zien welke spelers toegang hebben. + +*** + +[^1]: Of in Minecraft: Bedrock Edition met add-ons. + +[^2]: Toevoeging van entiteiten en meer. + +[^3]: Over het algemeen wordt dit aangeduid als "cheaten". + +[^4]: In geval van niet-geoptimaliseerde configuratie, verouderde Plazma of nieuwe ontdekte kwetsbaarheden, kan het zijn dat niet alle kwetsbaarheden zijn geblokkeerd. + +[^5]: Wanneer een speler verbinding maakt met de server, gebeurt dit via de Ngrok proxyserver, en het Ngrok-adres dat bij elke herstart wordt uitgegeven, zal verschillend zijn. diff --git a/nl/origin/plazma/administration/reference/README.md b/nl/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..4bc62b886 --- /dev/null +++ b/nl/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Ontdek de standaard aanpasmethoden die Plazma biedt. +--- + +# 📜 리퍼런스 + +Plazma biedt verschillende aanpasmethoden. + +Onder deze methoden zijn er 4 die direct kunnen worden gebruikt zonder extra werk. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +Stel je vragen aan de community via de [officiële Discord-server](https://discord.gg/MmfC52K8A8) of [GitHub-discussies](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Opdrachten + +> Opdrachten stellen spelers in staat om informatie te verzamelen of de spelomgeving aan te passen. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Machtigingen + +> Machtigingen bepalen het bereik waarin spelers kunnen interacteren. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenten en eigenschappen + +> Argumenten en eigenschappen hebben een algemene invloed op de werking van Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configuratie + +> Configuratie is de meest fundamentele manier om Plazma aan te passen. + +{% content-ref url="configurations/" %} +[configuraties](configuraties/) +{% endcontent-ref %} + +*** diff --git a/nl/origin/plazma/administration/reference/arguments.md b/nl/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..2eda0a52f --- /dev/null +++ b/nl/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Leer over de startargumenten en systeemeigenschappen. +--- + +# 🎛️ Argumenten en eigenschappen + +De startparameters en systeemeigenschappen zijn waarden die worden toegevoegd aan de [opdracht die wordt gebruikt](#user-content-fn-1)[^1] voor het uitvoeren van Plazma, en hebben over het algemeen invloed op de werking van Plazma. + +[De argumenten](#user-content-fn-2)[^2] worden verdeeld in **startparameters** en **systeemeigenschappen** volgens de toegevoegde positie van de opdracht. + +*** + +## Systeemeigenschappen + +Systeemeigenschappen worden voorafgaand aan de initialisatie van Plazma verwerkt in de JVM vóór `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Gebruik + +Systeemeigenschappen worden ingevoerd als Java-opdrachtargumenten tussen `java` en `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` geeft aan dat dit argument geen ingebouwd JVM-argument is maar een specifiek argument toegevoegd aan Plazma, + +Als er geen waarden voor eigenschappen worden ingevoerd, wordt de waarde standaard ingesteld op [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Alle systeemeigenschappen + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Bijwerken van stopgezette bordopmaak. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeer debuglogs voor entiteitsinformatie. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt NMS-revisie uit voor correct laden van debuginformatie in IDE en remapt automatisch interne versie-informatie. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt het Watchdog-waarschuwingssysteem van Spigot uit. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt de bevestigingsberichten voor de `/reload`-opdracht uit. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Als u een plug-inontwikkelaar bent en uw plug-ins moet bijwerken, gebruik dan hotswapping in plaats van `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt plug-ins die standaard in- en uitvoer gebruiken uit. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Waarschuwt wanneer verouderde opmaak wordt gedetecteerd in chatcomponenten. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt de serverpatroonvalidatie uit wanneer een speler verbinding maakt met de server. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert debuglogs voor ontbrekende sleutels in NBT-objecten. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert debuglogs voor hoofdblokken met ongeldige profielinformatie. + +Logt alle ongeldige hoofdblokken in de wereld samen met hun locatie. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt het prioriteren van plug-inklassen uit. + +Handig bij problemen met plug-inshades. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt Netty flush consolidation uit. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Standaardwaarde**: `750` + +Verdeelt entiteiten in meerdere pakketten als er meer zijn dan de ingestelde limiet. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Standaardwaarde**: `8192` + +Stelt de maximale grootte van pakketten in die de server tegelijk kan ontvangen. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt Java-versiecontrole uit. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Dit kan leiden tot permanente schade aan de wereld en andere bestanden, en kan de werking van het spel volledig verstoren. + +Alle problemen die voortvloeien uit het gebruik hiervan zijn de verantwoordelijkheid van de gebruiker en Plamza biedt geen ondersteuning hiervoor. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Standaardwaarde**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Standaardwaarde**: `80` + +Stelt de maximale lengte in van tekst op een regel van een bord. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Standaardwaarde**: `(wereldversie) + 1` + +Stelt de versie in van de wereldupdate-informatie die vooraf moet worden geïnitialiseerd. + +Handig bij het updaten van grote hoeveelheden chunks maar anders niet gebruikt. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Standaardwaarde**: `True` + +Activeert het verwerken van opmerkingen in YAML-bestanden standaard. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Standaardwaarde**: `30` + +Als er gedurende de opgegeven tijd (in seconden) geen gegevens van de speler worden ontvangen, wordt de speler verwijderd. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Negeert opmerkingen in servereigenschappen. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert debuglogs voor synchronisatie van chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert het standaard chunk-schrijfsysteem van Minecraft.]\(#user-content-fn-10)[^10] + +Dit slaat elk chunk op in volgorde van verwerking, wat resulteert in aanzienlijke prestatievermindering. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert Explicit Flushing voor netwerkkanalen. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Registreert altijd fouten die niet op de hoofdthread optreden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Geeft een waarschuwing als geplande taken te lang moeten wachten. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Wanneer u de standaard uitvoerbaar gebruikt, past u alleen patches toe zonder de server te starten. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` +- **Conflict**: `Plazma.disableConfigOptimization` + +Optimaliseer de initiële configuratie sterker. + +Als geactiveerd, zal de server sneller en veiliger worden, maar kan het een grote impact hebben op het spelplezier. + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` +- **Conflict**: `Plazma.aggressiveOptimize` + +Optimaliseer de initiële configuratie niet. + +Gebruik de standaardconfiguratie van Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` + +Schakel de Plazma branding uit en gebruik de standaard server favicon van Vanilla. + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` +- **Conflict**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Dit kan aanzienlijke invloed hebben op de veiligheid en prestaties van de server. + +Alle problemen die ontstaan door het gebruik van deze eigenschap zijn de verantwoordelijkheid van de serverbeheerder. +{% endhint %} + +Voorzie de initiële configuratie van standaardwaarden verstrekt door Mojang. + +Schakel alle kwetsbaarheidspatches die door Paper zijn toegepast uit. + +Kwetsbaarheidspatches kunnen opnieuw worden geactiveerd in Paper-configuratie of Plazma-configuratie. + +#### `Plazma.vanillaize` + +- **Type**: `Boolean` +- **Standaardwaarde**: `true` +- **Conflict**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Configureer de initiële configuratie om dichter bij Vanilla te zijn. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Gebruikte eigenschap is stopgezet + +De volgende systeemeigenschappen zijn stopgezet. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` +- **Stopgezet**: Timings is verwijderd uit Plazma sinds + +Beslist of de waarde die naar Aikar's Timings API wordt gestuurd de maximale waarde mag overschrijden. + +Als dit niet wordt afgehandeld in de API, wordt er een snelheidslimiet toegepast. + +*** + +## Startargument + +Het startargument wordt na `-jar *.jar` ingevoerd om Plazma te initialiseren en samen te verwerken. + +### Gebruiksaanwijzing + +Systeemeigenschappen worden ingevoerd als programmacommando-argumenten achter `-jar *.jar`. + +Bijvoorbeeld, als u het startargument `nogui` wilt toepassen,\ +voert u het als volgt in, zodat Plazma het argument `nogui` verwerkt tijdens de initialisatie. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Volledig startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standaardwaarde**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Standaardwaarde**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Standaardwaarde**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Start de server in demomodus. + +#### `eraseCache` + +Verwijdert overgebleven cachebestanden na een wereldupgrade. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Geeft alle startargumenten en beschrijvingen van Plazma weer. + +#### `initSettings` + +Maakt alleen de configuratiebestanden aan en sluit de server af. + +#### `jfrProfile` + +Activeert JFR-profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standaardwaarde**: `(servereigenschap)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Schakelt het grafische gebruikersinterfacepaneel uit. + +#### `nojline` + +Schakelt JLine uit en gebruikt de standaardconsole. + +#### `online-mode` + +- **Alias**: `o` +- **Standaardwaarde**: `(servereigenschap)` + +Kiest of spelers moeten worden geverifieerd via de Mojang-verificatieserver. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standaardwaarde**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Stelt de locatie in van het stopgezette PaperSpigot configuratiebestand. + +Dit wordt gebruikt om oude configuratie naar een nieuw bestand te migreren en wordt daarna niet meer gebruikt. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standaardwaarde**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Standaardwaarde**: `plugins` + +Stelt de locatie van de plug-inmap in. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standaardwaarde**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standaardwaarde**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Start de server in de veilige modus, in een volledig standaardstatus. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standaardwaarde**: `(servereigenschap)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standaardwaarde**: `(servereigenschap)` + +Stelt de poort van de server in. + +#### `server-name` + +- **Standaardwaarde**: `Een Plazma Server` + +Stelt de naam van de server in. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standaardwaarde**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Geeft de Plazma-versie weer. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standaardwaarde**: `(servermap)` + +Stelt de locatie in waar wereldbestanden worden opgeslagen. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standaardwaarde**: `(servereigenschap)` + +Stelt de naam van het wereldbestand in. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Afhankelijk van de toegevoegde locatie zal de locatie die de overname verwerkt veranderen. + +[^3]: Bijvoorbeeld, als u `Plazma.iKnowWhatIAmDoing` op `true` wilt instellen (activeren), werkt het invoeren van `-DPlazma.iKnowWhatIAmDoing` in plaats van `-DPlazma.iKnowWhatIAmDoing=true` hetzelfde. + +[^4]: Bijvoorbeeld, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: Een signaal dat aangeeft dat de server normaal verbonden is, zoals een hartslag. + +[^9]: Met de AFK-kickfunctie van Purpur kunt u zelfs afwezige spelers verwijderen. + +[^10]: Synchronisatie van chunk schrijfsysteem, Sync Chunk Write System. + +[^11]: `WAARSCHUWING! Plazma kan onverwachte problemen veroorzaken, dus zorg ervoor dat u het grondig test voordat u het op een openbare server gebruikt.` + +[^12]: In het spel werkt 'wereldoptimalisatie' op dezelfde manier. + +[^13]: Beheerders van niveau 2 en hoger zijn uitgesloten. + +[^14]: Internet Protocol, IP. diff --git a/nl/origin/plazma/administration/reference/commands.md b/nl/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..17ab0edff --- /dev/null +++ b/nl/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Leer over de commando's die beschikbaar zijn in Plazma. +--- + +# 🖥️ Commando's diff --git a/nl/origin/plazma/administration/reference/configurations/README.md b/nl/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..48855b250 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Configuratie is de meest fundamentele manier om Plazma aan te passen. +--- + +# 🧾 구성 + +*** + +## 🪨 Eigenschap + +> Eigenschap is het meest fundamentele configuratiebestand dat Minecraft biedt. Met eigenschappen kun je de basismechanismen van het spel veranderen. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Configuratie + +> Bukkit configuratie is het meest fundamentele configuratiebestand dat Plazma biedt. Met Bukkit configuratie kun je de basismechanismen van een Minecraft-server veranderen. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Configuratie + +> Spigot configuratie stelt je in staat om de gedetailleerde mechanismen van het spel, spelerinteracties, werking van commando's en berichten aan te passen. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Configuratie + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish configuratie stelt je in staat om de verwerking van werelden en entiteiten in Plazma te wijzigen. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Configuratie + +> Purpur eigenschappen stellen je in staat om de algemene basisgegevens van het spel aan te passen. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Configuratie + +> Plazma configuratie stelt je in staat om de functionaliteit van Plazma aan te passen. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/nl/origin/plazma/administration/reference/configurations/bukkit.md b/nl/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..77d0e01ea --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in bukkit.yml betekent. +--- + +# 🪣 Bukkit diff --git a/nl/origin/plazma/administration/reference/configurations/paper/README.md b/nl/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..e5511656d --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek het doel van elk bestand in de config-map. +--- + +# 🛩️ Papier diff --git a/nl/origin/plazma/administration/reference/configurations/paper/global.md b/nl/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..e8cb69f08 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop van paper-global.yml betekent. +--- + +# 🌏 전역 구성 diff --git a/nl/origin/plazma/administration/reference/configurations/paper/world.md b/nl/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..85f2bb3e5 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Ontdek wat elke knoop in paper-world.yml betekent. +--- + +# 🏳️ 세계별 구성 + +Wereldwijd diff --git a/nl/origin/plazma/administration/reference/configurations/plazma/README.md b/nl/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..ecb8f4b34 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek het doel van elk bestand in de config-map. +--- + +# ✨ Plazma diff --git a/nl/origin/plazma/administration/reference/configurations/plazma/global.md b/nl/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..3a3d2083f --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knooppunt in plazma-global.yml betekent. +--- + +# 🌏 전역 구성 diff --git a/nl/origin/plazma/administration/reference/configurations/plazma/world.md b/nl/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..ee8b11ced --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in plazma-world.yml betekent. +--- + +# 🏳️ 세계별 구성 diff --git a/nl/origin/plazma/administration/reference/configurations/plazma/worlds.md b/nl/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..cf1afe35e --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in plazma-world.yml betekent. +--- + +# ✨ Plazma (samengesteld per wereld) diff --git a/nl/origin/plazma/administration/reference/configurations/property.md b/nl/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..2ddd24187 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop van server.properties betekent. +--- + +# 🪨 Server.properties diff --git a/nl/origin/plazma/administration/reference/configurations/pufferfish.md b/nl/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7c4df70b6 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in pufferfish.yml betekent. +--- + +# 🐡 Kogelvis diff --git a/nl/origin/plazma/administration/reference/configurations/purpur/README.md b/nl/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..71a0aa50e --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in purpur.yml betekent. +--- + +# 🦑 Purpur diff --git a/nl/origin/plazma/administration/reference/configurations/purpur/global.md b/nl/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..5fa4afd13 --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in purpur.yml betekent. +--- + +# 🌏 전역 구성 diff --git a/nl/origin/plazma/administration/reference/configurations/purpur/world.md b/nl/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..f3ab587fd --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in purpur.yml betekent. +--- + +# 🏳️ 세계별 구성 diff --git a/nl/origin/plazma/administration/reference/configurations/spigot.md b/nl/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..37c73d5cd --- /dev/null +++ b/nl/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop van spigot.yml betekent. +--- + +# 🚰 Spigot diff --git a/nl/origin/plazma/administration/reference/permissions.md b/nl/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..794de7242 --- /dev/null +++ b/nl/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Ontdek de rechten van Plazma. +--- + +# 🛡️ Rechten + +Machtigingen zijn eenvoudige beveiligingstools die de reikwijdte van interactie van spelers binnen de server instellen. + +Om machtigingen goed te gebruiken en gemakkelijk aan te passen, moet je plug-ins zoals [LuckPerms](https://luckperms.net) gebruiken. + +*** + +## Begrijp het standaard machtigingssysteem + +Minecraft biedt standaard beheermachtigingsgroepen. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Speler**\ + Dit is de standaard machtigingsgroep die aan alle spelers wordt gegeven. +2. **Bemiddelaar**\ + Kan spawnbescherming negeren. +3. **Wereldbeheerder**\ + Kan alle opdrachten en commandoblokken met betrekking tot wereldbeheer gebruiken.\ + Dit is de standaard toegepaste machtigingsgroep voor datapacks en commandoblokken. +4. **Beheerder**\ + Kan alle opdrachten met betrekking tot spelerbeheer gebruiken. +5. **Hoofdbeheerder**\ + Kan alle opdrachten, inclusief serverbeheer, gebruiken.\ + Dit is de standaard toegepaste machtigingsgroep voor consoles en beheerders. + +*** + +## Machtigingen instellen + +*** + +## Volledige machtigingen + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Standaard**: `Geen` + +Staat spelers toe om te hurken en te interageren met entiteiten om ze te berijden. + +Als je een entiteit berijdt, kun je met de beweegtoetsen de beweging van de entiteit besturen en met de springtoets springen of vliegen. + +De [Namespaced ID](#user-content-fn-2)[^2] van de entiteit wordt ingevoerd in `(Namespaced Key)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Standaard**: `Geen` + +Staat spelers toe om de speciale vaardigheden van een entiteit te gebruiken terwijl ze deze berijden. + +Niet alle speciale vaardigheden van entiteiten zijn beschikbaar. Raadpleeg hieronder voor een lijst van alle beschikbare speciale vaardigheden. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Plaats je ideeën op [Plazma Discord](https://plazmamc.org/discord) of [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions) a.u.b.! +{% endhint %} + +
+ +Bekijk momenteel beschikbare speciale vaardigheden + +- **`crepper`**\ + Als je op de springtoets drukt, explodeert het.\ + Als een speler de `allow.powered.creeper` machtiging heeft, kan hij de springtoets ingedrukt houden om op te laden. +- **`dolphin`**\ + Als je op de springtoets drukt, sprint je. +- **`phantom`**\ + Als je op de springtoets drukt, vuur je vlammen af. +- **`wither`**\ + Als je interactie hebt, schiet je Wither-schedels af. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/compass` commando](commands.md#compass) toe. + +#### `bukkit.command.credits` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/credits (Speler)` commando](commands.md#credits) toe. + +Als je `.other` achter de machtigingsnaam invoert, kun je andere spelers toestaan dit te gebruiken. + +#### `bukkit.command.demo` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/demo (Speler)` commando](commands.md#demo) toe. + +Als je `.other` achter de machtigingsnaam invoert, kun je andere spelers toestaan dit te gebruiken. + +#### `bukkit.command.ping` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/ping (Speler)` commando](commands.md#ping) toe. + +Als je `.other` achter de machtigingsnaam invoert, kun je andere spelers toestaan dit te gebruiken. + +#### `bukkit.command.ram` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/ram` commando](commands.md#ram) toe. + +#### `bukkit.command.rambar` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/rambar (Speler)` commando](commands.md#rambar) toe. + +Als je `.other` achter de machtigingsnaam invoert, kun je andere spelers toestaan dit te gebruiken. + +#### `bukkit.command.restart` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/restart` commando](commands.md#restart) toe. + +#### `bukkit.command.tps` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/tps` commando](commands.md#tps) toe. + +#### `bukkit.command.tpsbar` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/tpsbar (Speler)` commando](commands.md#tpsbar) toe. + +Als je `.other` achter de machtigingsnaam invoert, kun je andere spelers toestaan dit te gebruiken. + +#### `bukkit.command.timings` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/timings` commando](commands.md#timings) toe. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Raadpleeg [Spark](https://spark.lucko.me/docs/Command-Usage) voor vergelijkbare commando's. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/uptime` commando](commands.md#uptime) toe. + +#### `minecraft.command.gamemode.(GameMode)` + +- **Standaard**: `Wereldbeheerder` + +Staat het gebruik van de [`/gamemode (GameMode) (Speler)` commando](commands.md#gamemode) toe. + +Als je `.other` achter de machtigingsnaam invoert, kun je andere spelers toestaan dit te gebruiken. + +#### `paper.antixray.bypass` + +- **Standaard**: `Geen` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Dit zorgt voor prestatieverbeteringen aan beide kanten. + +> Raadpleeg de onderstaande pagina voor informatie over X-Ray-instellingen. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Standaard**: `Geen` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Standaard**: `Geen` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Standaard**: `Geen` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Standaard**: `Geen` + +Staat het gebruik van [MiniMessage-tags](https://docs.advntr.dev/minimessage/format.html) op een aambeeld toe. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Standaard**: `Geen` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Standaard**: `Geen` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Standaard**: `Geen` + +Voorkomt dat spelers worden uitgegooid vanwege inactiviteit. + +#### `purpur.debug.f3n` + +- **Standaard**: `Wereldbeheerder` + +Staat spelers toe om met de toetscombinatie `F3 + N` de spelmodus te wijzigen. + +Dit werkt alleen als de speler de juiste machtiging heeft. + +#### `purpur.drop.spawners` + +- **Standaard**: `Geen` + +Als je een spawnerblok met het geconfigureerde item afbreekt, valt het spawnerblok naar beneden. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Standaard**: `Geen` + +Verandert de grootte van de ender-kist. + +Je kunt `one`, `two`, `three`, `four`, `five`, `six` invoeren voor `(NumberString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Standaard**: `Geen` + +Staat toe dat de totem van onsterfelijkheid werkt, zelfs als deze in het inventaris van de speler zit. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Standaard**: `Geen` + +De speler wordt toegestaan om de limiet van het aantal verbindingen te negeren. + +#### `purpur.mending_shift_click` + +- **Standaard**: `Geen` + +De speler wordt toegestaan om een voorwerp te repareren wanneer hij `gebukt gaat en interageert`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Standaard**: `Geen` + +De speler wordt toegestaan om spawners te plaatsen. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Standaard**: `Geen` + +De speler wordt toegestaan om direct te teleporteren wanneer hij de Nether portal gebruikt. + +#### `purpur.sign.color` + +- **Standaard**: `Geen` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Standaard**: `Geen` + +Toestaan dat het ontcijferingscode`(&o)` op borden wordt gebruikt. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Standaard**: `Geen` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Standaard**: `Geen` + +Toestaan dat spelers met een schaar `wederzijds interactie` TNT-explosies kunnen voorkomen. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Geplande toestemmingen + +#### `plazma.bypass.ncr-require` + +- **Standaard**: `Geen` + +Toestaan dat spelers kunnen verbinden zonder dat de [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) mod is geïnstalleerd. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Bijv.: `ender_dragon` diff --git a/nl/origin/plazma/adminstration/README.md b/nl/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..fda40bd25 --- /dev/null +++ b/nl/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Creëer uw eigen server met behulp van Plazma. +--- + +# ⚒️ Serverbeheergids diff --git a/nl/origin/plazma/adminstration/expert/README.md b/nl/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..0f020e263 --- /dev/null +++ b/nl/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek hoe je op een professionele manier met Plazma omgaat. +--- + +# 🎓 Diepgaand diff --git a/nl/origin/plazma/adminstration/expert/fix-exploits.md b/nl/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..70e4a1967 --- /dev/null +++ b/nl/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Leer over bekende kwetsbaarheden en hoe ze op te lossen. +--- + +# ⚠️ Bekende kwetsbaarheden en oplossingsmethoden diff --git a/nl/origin/plazma/adminstration/expert/optimize.md b/nl/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..7bd621452 --- /dev/null +++ b/nl/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Ontdek hoe je Plazma optimaliseert. +--- + +# 🧹 Optimalisatie diff --git a/nl/origin/plazma/adminstration/expert/vanillaize.md b/nl/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..4b8e05498 --- /dev/null +++ b/nl/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Leer hoe je de patch van Paper en Vanilla kunt herstellen. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper biedt momenteel geen opties voor het oplossen van de meeste patches van Vanilla. + +Plazma is momenteel bezig met het ontwikkelen van een configuratie om dergelijke foutoplossingen uit te schakelen. + +Daarom is deze gids nog in ontwikkeling en de informatie kan altijd veranderen. +{% endhint %} diff --git a/nl/origin/plazma/adminstration/faq.md b/nl/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..76df61c2c --- /dev/null +++ b/nl/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Leer meer over veelgestelde vragen. +--- + +# ⁉️ Veelgestelde vragen + +{% hint style="info" %} + +### Kunt u het antwoord dat u zoekt niet vinden? + +Stel uw vragen aan de community via de [officiële Discord-server](https://discord.gg/MmfC52K8A8) of [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### De uitvoering mislukt met een bericht + +Als er een bericht wordt weergegeven met `geen hoofdmanifestattribuut in plazma-(versie).jar`,\ +dan is het gedownloade bestand een ontwikkelings-API-bestand en moet u **Reobf Paperweight** downloaden vanaf de GitHub-pagina. + +Raadpleeg de volgende pagina voor meer informatie. + +{% content-ref url="getting-started/" %} +[starten](getting-started#id-2) +{% endcontent-ref %} + +### Er wordt bij elke start van de server een waarschuwing weergegeven + +Plazma bevat enkele onstabiele patches en heeft daarom altijd het risico op storingen. Daarom wordt de volgende waarschuwing weergegeven wanneer de server wordt gestart. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Deze waarschuwing kan worden uitgeschakeld met behulp van de [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] systeemeigenschap. + +Raadpleeg de volgende pagina voor meer informatie. + +{% content-ref url="reference/arguments.md" %} +[argumenten.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Beschikbaar vanaf 1.20.1 diff --git a/nl/origin/plazma/adminstration/getting-started/README.md b/nl/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..4f66af15a --- /dev/null +++ b/nl/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Leer hoe je een server maakt met Plazma. +--- + +# 👟 Aan de slag + +Om Plazma stabiel te gebruiken, moet het systeem aan de volgende vereisten voldoen. + +| | Minimum | Aanbevolen | +| :----------: | ------: | ---------: | +| Architectuur | x64 | - | +| RAM | 8GB | 16GB | +| Opslagruimte | 1GB | 8GB | +| JRE | 17 | 21 | + +Voor soepel bestandsbewerkingen, is het ook goed om een editor zoals [Visual Studio Code](https://code.visualstudio.com/download) te installeren. + +*** + +## 1. JRE installatie + +Zoals de naam al aangeeft, is Minecraft: **"Java"** Edition ontwikkeld in Java en heeft het JRE[^1] nodig om uit te voeren. + +Omdat Plazma gebaseerd is op het officiële serverplatform van Mojang Studios, moet ook JRE worden geïnstalleerd om Plazma te gebruiken. + +### 1.1 Controleer JRE + +Om te controleren of JRE op het systeem is geïnstalleerd, voert u [`cmd /k java --version`](#user-content-fn-4)[^4] uit in het uitvoervenster. + +Als het volgende wordt weergegeven, ga dan naar [Stap 2](setup.md#id-2). + +{% code title="Juiste uitvoer" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Als dit niet wordt weergegeven, of als het volgende wordt weergegeven, ontbreekt JRE of is het te oud, dus moet [Stap 1.2](setup.md#id-1.2) worden uitgevoerd. + +{% code title="JRE niet geïnstalleerd" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE te oud" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE installatie + +In deze handleiding wordt Azul Zulu gebruikt als een van de soorten JRE. + +Na installatie, controleer opnieuw met [Stap 1.1](setup.md#id-1.1) om te zien of de installatie correct is voltooid. + +{% tabs %} +{% tab title="Windows" %} + +1. Download eerst **JDK 21** in `.msi` formaat van [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Voer de gedownloade installatiewizard uit en klik op 'Volgende'. +3. Activeer 'Set JAVA_HOME variable' in het menu links van het midden van het venster en klik op 'Volgende'. +4. Voltooi de JRE-installatie door op 'Installeren' te klikken. + {% endtab %} + +{% tab title="macOS" %} +Download **JDK 21** in `.dmg` formaat van [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) en installeer JRE door de gedownloade installatiewizard uit te voeren. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Voeg eerst de Azul Zulu repository toe aan APT door de volgende opdrachten in de terminal uit te voeren. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Installeer vervolgens JRE door de volgende opdrachten in de terminal uit te voeren. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +U kunt JRE installeren door de volgende opdrachten in te voeren. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma downloaden + +Plazma biedt verschillende soorten uitvoerbare bestanden aan. + +{% hint style="warning" %} + +### In de meeste gevallen wordt `Reobf Paperclip` gebruikt. + +De volgende informatie is voor ontwikkelaars of degenen die geïnteresseerd zijn in de kenmerken van elk type.\ +Voor gewone gebruikers is het overslaan naar [Stap 3](setup.md#id-3) geen probleem. +{% endhint %} + +
+ +Meer informatie + +De naam van het uitvoerbare bestand is `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar`. + +- **Mapping type**\ + Mapping is een soort kaart die het echte code van Minecraft verbindt met de geobfusceerde code. + - **Reobf**\ + Reobfuscation, ook wel bekend als Spigot mapping, wordt voornamelijk gebruikt in de meeste NMS-plugins.\ + Vanaf 1.20.5 zal het niet meer worden gebruikt. + - **Mojmap**\ + Mojang mapping, de mapping van Vanilla Minecraft. +- **Version manager**\ + De versiebeheerder is een soort launcher die nodig is voor het draaien van de server en het patchen van serverbestanden. + - **Paperclip**\ + Ontwikkeld door het PaperMC-team voor Paper en andere afgeleide platforms, downloadt bibliotheken en past patches toe op de server. + - **Bundler**\ + De Vanilla Minecraft-versiebeheerder. + +
+ +*** + +## 3. Startscript maken + +Om Plazma eenvoudig te starten en de server automatisch opnieuw te starten, moet u een [startscript](#user-content-fn-6)[^6] maken. + +U kunt een startscript maken via [Flags.sh](https://flags.sh). Voer alleen de [geheugenlimiet](#user-content-fn-8)[^8] in en de opdracht wordt automatisch geoptimaliseerd. + +U kunt het startscript downloaden via de knop linksonder.\ +**Controleer of het gedownloade startscript overeenkomt met uw besturingssysteem.** + +*** + +## 4. Bestandsopruiming + +Verplaats nu het gedownloade startscript en Plazma naar een nieuwe map. + +{% hint style="warning" %} + +### De mapnaam moet geen spaties bevatten en in het Engels zijn ingesteld. + +Anders werken Plazma of JRE mogelijk niet correct. +{% endhint %} + +Voer nu het startscript uit. Voor Windows, moet u bij het selectiescherm voor firewalltoestemming absoluut **Toestaan** selecteren. + +*** + +## 5. EULA accepteren + +Na het uitvoeren van het startscript wordt er een 'eula.txt' bestand in de map gemaakt. + +EULA[^9] is een gebruiksrechtovereenkomst waarbij u akkoord moet gaan met het gebruik van de diensten van [Mojang Studios](#user-content-fn-10)[^10]. + +Zonder akkoord te gaan met de EULA kunt u de server niet starten en bij schending van de EULA kunt u sancties zoals accountopschorting krijgen, enzovoort.]\(#user-content-fn-11)[^11] + +Om akkoord te gaan met de EULA, wijzigt u `eula=false` naar `eula=true` in het `eula.txt` bestand en slaat u het op. + +*** + +## 6. Extern toegang toestaan (Windows) + +Moderne besturingssystemen blokkeren standaard externe toegang met behulp van de **firewall** en **router**. + +Voor Windows, omdat u in [Stap 3](setup.md#id-3) de firewall hebt toegestaan, hoeft u alleen nog maar port forwarding te doen. + +{% hint style="info" %} + +### Deze handleiding is geschreven onder de veronderstelling dat u een Windows-besturingssysteem en [**UPnP**](#user-content-fn-12)[^12]-router gebruikt. + +Als uw router UPnP niet ondersteunt, heeft elke router een ander paneel, dus u moet zelf informatie opzoeken. + +U kunt ook [Ngrok](https://ngrok.com/) gebruiken om een tijdelijk adres te genereren. +{% endhint %} + +{% hint style="warning" %} + +### Voor Linux of macOS en andere (semi-)UNIX-besturingssystemen, omdat de instellingen voor firewall-services per service verschillen, moet u zelf informatie opzoeken. + +{% endhint %} + +### 6.1 Controleer of port forwarding nodig is + +Voer het volgende in het uitvoervenster in en voer het uit. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Als de uitvoer 'True' is, is het goed, maar als het 'False' is, moet u port forwarding instellen. + +### 6.2 Verbinding maken met de server + +{% tabs %} +{% tab title="Extern verbinden" %} +Als port forwarding niet nodig is of al is ingesteld, kunt u nu verbinding maken met de server. + +Het adres dat wordt gebruikt om verbinding te maken met de server, kan hier worden gecontroleerd: [hier](https://ip.pe.kr/) +{% endtab %} + +{% tab title="Poging tot port forwarding via UPnP" %} +Activeer in het `purpur.yml`-bestand van de serversmap `network.upnp-port-forwarding` door het op `true` te zetten. + +Na het opnieuw starten van de server zal Plazma automatisch proberen port forwarding te doen. + +Hieronder staat of UPnP succesvol was op basis van de berichten die op de console worden weergegeven, op de console wordt het als `[UPnP] (bericht)` weergegeven. + +| Bericht | Betekenis | +| --------------------------------- | ---------------------------------------- | +| `Poort succesvol geopend (poort)` | Port forwarding succesvol. | +| `Poort (poort) is al geopend` | Een andere service gebruikt de poort al. | +| `Kon poort niet openen (poort)` | Port forwarding mislukt. | +| `Service is niet beschikbaar` | De router ondersteunt geen UPnP. | + +Wanneer de server wordt afgesloten, sluit Plazma automatisch de poort. +{% endtab %} + +{% tab title="Tijdelijk adres genereren met Ngrok" %} +Het gebruik van Ngrok is handig voor kortetermijntests, samen spelen of spelen met vrienden. + +1. Download het ZIP-bestand `Windows (64-bit)` van de [Ngrok-website](https://ngrok.com/download). +2. Plaats de gedownloade Ngrok in de servermap. +3. Genereer een [verificatietoken](#user-content-fn-13) op [Ngrok-dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Voer de opdrachten uit die worden weergegeven in de `Command Line` van de servermap. +5. Voeg `start /b ngrok tcp --region jp 25565` toe aan het bovenste gedeelte van het uitvoeringsscript en `taskkill /f /t /im ngrok.exe` aan de onderkant. +6. Het adres van de server wordt `0.tcp.jp.ngrok.io:12345` zoals weergegeven in `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` in de console. +7. Nu kunt u via dit adres van buitenaf verbinding maken. + {% endtab %} + +{% tab title="Verbinding maken vanaf lokaal" %} +Als u verbinding wilt maken met de server vanaf uw lokale machine, kunt u het `IPv4-adres` gebruiken dat wordt weergegeven na het uitvoeren van `cmd /k ipconfig` in de uitvoer. + +Bijvoorbeeld, als het volgende wordt weergegeven na het uitvoeren van de opdracht, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +U kunt verbinding maken met de server vanaf uw lokale machine door verbinding te maken met het `192.168.3.7` dat wordt weergegeven als IPv4-adres. + +Als de server en het spel op dezelfde pc worden uitgevoerd, kunt u verbinding maken met `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Development Stage + +Als de server succesvol is gestart en correct werkt, is het nu tijd om de server aan te passen. + +Leer hoe u de server kunt aanpassen via de onderstaande gids. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java uitvoeringsomgeving. + +[^2]: Paper, de basis van Plazma, is gebaseerd op Spigot, dat op zijn beurt is gebaseerd op het officiële serverplatform van Spigot. + +[^3]: Windows-toets + R + +[^4]: Voor Linux, voer `java --version` uit in de terminal. + +[^5]: JRE is een van de open-source projecten, vergelijkbaar met Minecraft-serverplatforms. + +[^6]: Het staat bekend als een **launcher**. + +[^7]: Als u 'Automatisch opnieuw opstarten' inschakelt, wordt de server automatisch opnieuw opgestart. U kunt afsluiten door `Control + C` in te voeren. + +[^8]: Het wordt niet aanbevolen om meer dan de helft van het systeemgeheugen toe te wijzen. + + Bijvoorbeeld, als het totale geheugen van het systeem 8 GB is, wordt het niet aanbevolen om meer dan 4 GB toe te wijzen. + +[^9]: Eindgebruikerslicentieovereenkomst, EULA. Raadpleeg de [Minecraft-website](https://www.minecraft.net/ko-kr/usage-guidelines) voor meer informatie. + +[^10]: Microsoft Corporation. + +[^11]: Volgens artikel 32, lid 1, punt 9 van de Wet op de bevordering van de game-industrie in Zuid-Korea, kan **Korea Microsoft Corporation** juridische stappen ondernemen. + +[^12]: Universal Plug & Play. Plazma bevat Purpur die automatisch communiceert met de router via deze technologie en alleen poorten opent wanneer de server actief is, waardoor directe port forwarding niet nodig is. + +[^13]: Als je geen account hebt, meld je dan aan bij Ngrok met een Google- of GitHub-account. diff --git a/nl/origin/plazma/adminstration/getting-started/customization.md b/nl/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..4f533f634 --- /dev/null +++ b/nl/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Leer hoe je de server kunt aanpassen aan de gebruiker. +--- + +# 🎨 Gebruiksaanpassing diff --git a/nl/origin/plazma/adminstration/reference/arguments.md b/nl/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..1a123ae2e --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Leer over de startargumenten en systeemeigenschappen. +--- + +# 🎛️ Argumenten en eigenschappen + +Startvariabelen en systeemeigenschappen zijn waarden die worden toegevoegd aan de [opdrachten](#user-content-fn-1)[^1] die worden gebruikt bij het uitvoeren van Plazma, waardoor het mogelijk is om waarden te wijzigen die niet kunnen worden gewijzigd nadat Plazma is gestart. + +Afhankelijk van de [locatie waar de opdracht wordt toegevoegd](#user-content-fn-2)[^2], worden ze verdeeld in **startargumenten** en **systeemeigenschappen**. + +*** + +## Systeemeigenschappen + +Systeemeigenschappen worden voorafgaand aan de initialisatie van Plazma verwerkt in de JVM vóór `-jar`. + +{% hint style="warning" %} + +### Het aanpassen van systeemeigenschappen kan de werking van Plazma en de JVM veranderen en kan een grote invloed hebben op het spel! + +Als u niet zeker weet welke rol elke systeemeigenschap speelt, **gebruik deze dan absoluut niet!** +{% endhint %} + +### Gebruik + +Systeemeigenschappen worden ingevoerd als Java-opdrachtargumenten tussen `java` en `-jar`. + +Bijvoorbeeld, als u de systeemeigenschap `Plazma.dummyProperty` wilt toepassen, wordt de volgende eigenschap als `37` ingevoerd en wordt Plazma geïnitialiseerd. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` geeft aan dat dit argument geen ingebouwd JVM-argument is maar een specifiek argument toegevoegd aan Plazma, + +als er geen waarde voor de eigenschap wordt ingevoerd, wordt de waarde [`true` vastgezet.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### De Paperweight-serverplatformen hebben een punt in de eigenschapsnaam om systeemeigenschappen voor elk platform te onderscheiden. + +In sommige terminals zoals Windows Powershell kunnen deze argumenten niet worden geaccepteerd, dus moeten aanhalingstekens aan beide uiteinden worden toegevoegd.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Alle systeemeigenschappen + +#### `convertLegacySigns` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Bijwerken van stopgezette bordopmaak. + +#### `debug.entities` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeer debuglogs voor entiteitsinformatie. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt NMS-revisie uit voor correct laden van debuginformatie in IDE en remapt automatisch interne versie-informatie. + +#### `disable.watchdog` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt het Watchdog-waarschuwingssysteem van Spigot uit. + +#### `letMeReload` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt de bevestigingsberichten voor de `/reload`-opdracht uit. + +{% hint style="danger" %} + +### De `/reload`-opdracht is zeer onstabiel, dus alle problemen die optreden na het gebruik van `/reload` zijn de verantwoordelijkheid van de gebruiker zelf. + +Als u een plug-inontwikkelaar bent en uw plug-ins moet bijwerken, gebruik dan hotswapping in plaats van `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt plug-ins die standaard in- en uitvoer gebruiken uit. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Waarschuwt wanneer verouderde opmaak wordt gedetecteerd in chatcomponenten. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt de serverpatroonvalidatie uit wanneer een speler verbinding maakt met de server. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert debuglogs voor ontbrekende sleutels in NBT-objecten. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert debuglogs voor hoofdblokken met ongeldige profielinformatie. + +Logt alle ongeldige hoofdblokken in de wereld samen met hun locatie. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt de limiet van 128 plug-inkanalen per speler uit. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt het prioriteren van plug-inklassen uit. + +Handig bij problemen met plug-inshades. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt Netty flush consolidation uit. + +#### `Paper.excessiveTELimit` + +- **Type**: `Integer` +- **Standaardwaarde**: `750` + +Verdeelt entiteiten in meerdere pakketten als er meer zijn dan de ingestelde limiet. + +#### `Paper.filterThreshold` + +- **Type**: `Integer` +- **Standaardwaarde**: `8192` + +Stelt de maximale grootte van pakketten in die de server tegelijk kan ontvangen. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Schakelt Java-versiecontrole uit. + +{% hint style="danger" %} + +### Hierdoor kan de JVM proberen toegang te krijgen tot niet-bestaande code! + +Dit kan leiden tot permanente schade aan de wereld en andere bestanden, en kan de werking van het spel volledig verstoren. + +Alle problemen die voortvloeien uit het gebruik hiervan zijn de verantwoordelijkheid van de gebruiker en Plamza biedt geen ondersteuning hiervoor. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Integer` +- **Standaardwaarde**: `64` + +Stelt de limiet in voor de naam van plug-inkanalen. + +#### `Paper.maxSignLength` + +- **Type**: `Integer` +- **Standaardwaarde**: `80` + +Stelt de maximale lengte in van tekst op een regel van een bord. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Integer` +- **Standaardwaarde**: `(wereldversie) + 1` + +Stelt de versie in van de wereldupdate-informatie die vooraf moet worden geïnitialiseerd. + +Handig bij het updaten van grote hoeveelheden chunks maar anders niet gebruikt. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolean` +- **Standaardwaarde**: `True` + +Activeert het verwerken van opmerkingen in YAML-bestanden standaard. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Integer` +- **Standaardwaarde**: `30` + +Als er gedurende de opgegeven tijd (in seconden) geen gegevens van de speler worden ontvangen, wordt de speler verwijderd. + +Normaal gesproken blijft het spel[^7] hartslagsignalen naar de server sturen, dus [wordt de speler niet verwijderd,](#user-content-fn-8)[^8] maar als het spel niet reageert, wordt aangenomen dat het is vastgelopen en wordt de speler verwijderd zonder verdere verwerking op de server. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Negeert opmerkingen in servereigenschappen. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert debuglogs voor synchronisatie van chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert het standaard chunk-schrijfsysteem van Minecraft.]\(#user-content-fn-10)[^10] + +Dit slaat elk chunk op in volgorde van verwerking, wat resulteert in aanzienlijke prestatievermindering. + +#### `Paper.explicit-flush` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Activeert Explicit Flushing voor netwerkkanalen. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Registreert altijd fouten die niet op de hoofdthread optreden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Geeft een waarschuwing als geplande taken te lang moeten wachten. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolean` +- **Standaardwaarde**: `False` + +Wanneer u de standaard uitvoerbaar gebruikt, past u alleen patches toe zonder de server te starten. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` + +{% hint style="warning" %} + +### Deze eigenschap zal naar verwachting worden verplaatst naar startargumenten na 1.20.5. + +{% endhint %} + +Past strengere configuratie-optimalisaties toe bij de eerste start. + +Als u het activeert, zal de server sneller en veiliger worden, maar het kan sommige glitches blokkeren of een grote invloed hebben op het gamen. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` + +Onderdrukt de waarschuwing[^11] die wordt weergegeven wanneer Plazma wordt geïnitialiseerd. + +### Gebruikte eigenschap is stopgezet + +De volgende systeemeigenschappen zijn stopgezet. + +#### `timings.bypassMax` + +- **Type**: `Boolean` +- **Standaardwaarde**: `false` +- **Stopgezet**: Timings is verwijderd uit Plazma sinds + +Beslist of de waarde die naar Aikar's Timings API wordt gestuurd de maximale waarde mag overschrijden. + +Als dit niet wordt afgehandeld in de API, wordt er een snelheidslimiet toegepast. + +*** + +## Startargument + +Het startargument wordt na `-jar *.jar` ingevoerd om Plazma te initialiseren en samen te verwerken. + +### Gebruiksaanwijzing + +Systeemeigenschappen worden ingevoerd als programmacommando-argumenten achter `-jar *.jar`. + +Bijvoorbeeld, als u het startargument `nogui` wilt toepassen,\ +voert u het als volgt in, zodat Plazma het argument `nogui` verwerkt tijdens de initialisatie. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Volledig startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standaardwaarde**: `bukkit.yml` + +Stelt de naam en locatie van het [Bukkit configuratiebestand](../reference/configurations/bukkit.md) in. + +#### `command-settings` + +- **Alias**: `c` +- **Standaardwaarde**: `commands.yml` + +Stelt de naam en locatie van het [Bukkit commando configuratiebestand](../reference/configurations/bukkit.md) in. + +#### `config` + +- **Alias**: `c` +- **Standaardwaarde**: `server.properties` + +Stelt de naam en locatie van het [servereigenschappen](../reference/configurations/property.md) bestand in. + +#### `demo` + +Start de server in demomodus. + +#### `eraseCache` + +Verwijdert overgebleven cachebestanden na een wereldupgrade. + +#### `forceUpgrade` + +Forceert een [upgrade](#user-content-fn-12)[^12] van de wereld, ongeacht de versie. + +#### `help` + +- **Alias**: `?` + +Geeft alle startargumenten en beschrijvingen van Plazma weer. + +#### `initSettings` + +Maakt alleen de configuratiebestanden aan en sluit de server af. + +#### `jfrProfile` + +Activeert JFR-profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standaardwaarde**: `(servereigenschap)` + +Stelt het maximale aantal [spelers](#user-content-fn-14)[^14] in dat is toegestaan. + +#### `nogui` + +Schakelt het grafische gebruikersinterfacepaneel uit. + +#### `nojline` + +Schakelt JLine uit en gebruikt de standaardconsole. + +#### `online-mode` + +- **Alias**: `o` +- **Standaardwaarde**: `(servereigenschap)` + +Kiest of spelers moeten worden geverifieerd via de Mojang-verificatieserver. + +**Als u geen Velocity of andere proxy gebruikt, kunt u worden gestraft voor het schenden van de [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standaardwaarde**: `paper.yml` + +{% hint style="warning" %} + +### Deze optie is stopgezet na 1.19.4 + +{% endhint %} + +Stelt de locatie in van het stopgezette PaperSpigot configuratiebestand. + +Dit wordt gebruikt om oude configuratie naar een nieuw bestand te migreren en wordt daarna niet meer gebruikt. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standaardwaarde**: `config` + +Stelt de naam en locatie in van de map waarin [Paper configuratiebestanden](../reference/configurations/paper/README.md) zich bevinden. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Stelt de naam en locatie in van de map waarin [Plazma configuratiebestanden](../reference/configurations/plazma/README.md) zich bevinden. + +#### `plugins` + +- **Alias**: `p` +- **Standaardwaarde**: `plugins` + +Stelt de locatie van de plug-inmap in. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standaardwaarde**: `pufferfish.yml` + +Stelt de naam en locatie in van het [Pufferfish configuratiebestand](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standaardwaarde**: `purpur.yml` + +Stelt de naam en locatie in van het [Purpur configuratiebestand](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Start de server in de veilige modus, in een volledig standaardstatus. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standaardwaarde**: `(servereigenschap)` + +Stelt de hostnaam van de server of het [Internet Protocol](#user-content-fn-13)[^13] adres in. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standaardwaarde**: `(servereigenschap)` + +Stelt de poort van de server in. + +#### `server-name` + +- **Standaardwaarde**: `Een Plazma Server` + +Stelt de naam van de server in. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standaardwaarde**: `spigot.yml` + +Stelt de naam en locatie in van het [Spigot configuratiebestand](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Geeft de Plazma-versie weer. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standaardwaarde**: `(servermap)` + +Stelt de locatie in waar wereldbestanden worden opgeslagen. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standaardwaarde**: `(servereigenschap)` + +Stelt de naam van het wereldbestand in. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Afhankelijk van de toegevoegde locatie zal de locatie die de overname verwerkt veranderen. + +[^3]: Bijvoorbeeld, als u `Plazma.iKnowWhatIAmDoing` op `true` wilt instellen (activeren), werkt het invoeren van `-DPlazma.iKnowWhatIAmDoing` in plaats van `-DPlazma.iKnowWhatIAmDoing=true` hetzelfde. + +[^4]: Bijvoorbeeld, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event detector. + +[^6]: Event detector. + +[^7]: Client. + +[^8]: Een signaal dat aangeeft dat de server normaal verbonden is, zoals een hartslag. + +[^9]: Met de AFK-kickfunctie van Purpur kunt u zelfs afwezige spelers verwijderen. + +[^10]: Synchronisatie van chunk schrijfsysteem, Sync Chunk Write System. + +[^11]: `WAARSCHUWING! Plazma kan onverwachte problemen veroorzaken, dus zorg ervoor dat u het grondig test voordat u het op een openbare server gebruikt.` + +[^12]: In het spel werkt 'wereldoptimalisatie' op dezelfde manier. + +[^13]: Internet Protocol, IP. + +[^14]: Beheerders van niveau 2 en hoger zijn uitgesloten. diff --git a/nl/origin/plazma/adminstration/reference/commands.md b/nl/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..17ab0edff --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Leer over de commando's die beschikbaar zijn in Plazma. +--- + +# 🖥️ Commando's diff --git a/nl/origin/plazma/adminstration/reference/configurations/bukkit.md b/nl/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..77d0e01ea --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in bukkit.yml betekent. +--- + +# 🪣 Bukkit diff --git a/nl/origin/plazma/adminstration/reference/configurations/paper/README.md b/nl/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..e5511656d --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek het doel van elk bestand in de config-map. +--- + +# 🛩️ Papier diff --git a/nl/origin/plazma/adminstration/reference/configurations/paper/global.md b/nl/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..babfc4d72 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop van paper-global.yml betekent. +--- + +# 🛩️ Paper (globale configuratie) diff --git a/nl/origin/plazma/adminstration/reference/configurations/paper/world.md b/nl/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..33da4e66b --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in paper-world.yml betekent. +--- + +# 🛩️ Papier (opbouw per wereld) diff --git a/nl/origin/plazma/adminstration/reference/configurations/plazma/README.md b/nl/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..ecb8f4b34 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek het doel van elk bestand in de config-map. +--- + +# ✨ Plazma diff --git a/nl/origin/plazma/adminstration/reference/configurations/plazma/global.md b/nl/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..0ea41f464 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knooppunt in plazma-global.yml betekent. +--- + +# ✨ Plazma (globale configuratie) diff --git a/nl/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/nl/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..7feafa7b4 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Wereldwijde samenstelling diff --git a/nl/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/nl/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..cf1afe35e --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in plazma-world.yml betekent. +--- + +# ✨ Plazma (samengesteld per wereld) diff --git a/nl/origin/plazma/adminstration/reference/configurations/property.md b/nl/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..2ddd24187 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop van server.properties betekent. +--- + +# 🪨 Server.properties diff --git a/nl/origin/plazma/adminstration/reference/configurations/pufferfish.md b/nl/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7c4df70b6 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in pufferfish.yml betekent. +--- + +# 🐡 Kogelvis diff --git a/nl/origin/plazma/adminstration/reference/configurations/purpur/README.md b/nl/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..71a0aa50e --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in purpur.yml betekent. +--- + +# 🦑 Purpur diff --git a/nl/origin/plazma/adminstration/reference/configurations/purpur/global.md b/nl/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..1874700bf --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in purpur.yml betekent. +--- + +# 🦑 Purper (globale opmaak) diff --git a/nl/origin/plazma/adminstration/reference/configurations/purpur/world.md b/nl/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..a2427b173 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop in purpur.yml betekent. +--- + +# 🦑 Purper (samenstelling per wereld) diff --git a/nl/origin/plazma/adminstration/reference/configurations/spigot.md b/nl/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..37c73d5cd --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ontdek wat elke knoop van spigot.yml betekent. +--- + +# 🚰 Spigot diff --git a/nl/origin/plazma/adminstration/reference/permissions.md b/nl/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..b6a15b0a4 --- /dev/null +++ b/nl/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Ontdek de rechten van Plazma. +--- + +# 🛡️ Rechten diff --git a/nl/origin/plazma/developers.md b/nl/origin/plazma/developers.md new file mode 100644 index 000000000..22acee099 --- /dev/null +++ b/nl/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Ontwikkel third-party projecten met behulp van Plazma. +--- + +# ⚙️ Ontwikkelaarsgids diff --git a/nl/origin/thunderbolt/README.md b/nl/origin/thunderbolt/README.md new file mode 100644 index 000000000..1c4a6914a --- /dev/null +++ b/nl/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt is een Plazma-gebaseerd serverplatform dat experimentele patches onderscheidt als Flavor, zodat ze direct kunnen worden gebruikt. +--- + +# 🌩️ Thunderbolt Gebruiksaanwijzing diff --git a/nl/origin/volt/README.md b/nl/origin/volt/README.md new file mode 100644 index 000000000..95b592f06 --- /dev/null +++ b/nl/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt is een open source template op basis van Plazma waarmee je je eigen Paperweight serverplatform kunt ontwikkelen. +--- + +# ⚡ Volt Ontwikkelingsgids diff --git a/no/origin/README.md b/no/origin/README.md new file mode 100644 index 000000000..d8101a146 --- /dev/null +++ b/no/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Hvis du har spørsmål, vennligst spør på Discord eller GitHub-diskusjoner. +--- + +# 🏠 Velkommen til Docs Portal + +{% hint style="info" %} + +**Dokumentene til Plazma er for øyeblikket maskinoversatt.** + +[![Oversettelsesstatus](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) på nettstedet for utvikling av dokumentoversettelse og forbedre dokumentene. + +{% endhint %} + +### Har du problemer mens du bruker Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Er du interessert i Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Vil du lage din egen serverplattform med Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Hvis du trenger mer informasjon om Minecraft, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/no/origin/SUMMARY.md b/no/origin/SUMMARY.md new file mode 100644 index 000000000..dd8d0f7e0 --- /dev/null +++ b/no/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Innholdsfortegnelse + +- [🏠 Velkommen til Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Bruksanvisning](plazma/README.md) +- [❓ Hva er Plazma?](plazma/about/README.md) + - [⬇️ Nedlasting](plazma/about/downloads.md) + - [✅ Støttede versjoner](plazma/about/supported-versions.md) +- [⚒️ Serveradministrasjonsguide](plazma/administration/README.md) + - [👟 Komme i gang](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referanse](plazma/administration/reference/README.md) + - [🖥️ Kommandoer](plazma/administration/reference/commands.md) + - [🛡️ Tillatelser](plazma/administration/reference/permissions.md) + - [🎛️ Argumenter og egenskaper](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Egenskap](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global konfigurasjon](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Verdensvis konfigurasjon](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global konfigurasjon](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Verdensvis konfigurasjon](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global konfigurasjon](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Verdensvis konfigurasjon](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Ekspert](plazma/administration/expert/README.md) + - [🧹 Optimalisering](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Gjøre om til vanilje](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blokkering](plazma/administration/expert/xray.md) + - [⚠️ Sårbarheter og løsninger](plazma/administration/expert/fix-exploits.md) + - [⁉️ Ofte stilte spørsmål](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Utviklerguide](plazma/developers.md) + - [✏️ Bidra](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Bruksanvisning](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Utviklingsguide](volt/README.md) + +## Diverse + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Last ned alle](plazma/about/downloads-all.md) diff --git a/no/origin/miscellaneous/README.md b/no/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/no/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/no/origin/plazma/README.md b/no/origin/plazma/README.md new file mode 100644 index 000000000..3c53096e3 --- /dev/null +++ b/no/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma er en åpen kildekode serverplattform for Minecraft: Java Edition som legger til eksperimentell optimalisering basert på papir og tilpassede spillmekanismer." +--- + +# ✨ Plazma Bruksdokumentasjon + +## 👋 Velkommen til Plazma Docs + +Velkommen til Plazma brukerhåndbok! + +{% hint style="info" %} + +**Kan du ikke løse problemet via brukerveiledningen?** + +[Offisiell Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub-diskusjoner](https://github.com/PlazmaMC/PlazmaBukkit/discussions) for å stille spørsmål til fellesskapet! + +{% endhint %} + +### Om Plazma + +> Finn ut hva Plazma serverplattformen er. + +{% content-ref url="about/" %} +[om](about/) +{% endcontent-ref %} + +### For administratorer + +> Lag din egen server ved hjelp av Plazma. + +{% content-ref url="administration/" %} +[administrasjon](administration/) +{% endcontent-ref %} + +### For utviklere + +> Utvikle tredjepartsprosjekter med Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/no/origin/plazma/about/README.md b/no/origin/plazma/about/README.md new file mode 100644 index 000000000..cd3b10026 --- /dev/null +++ b/no/origin/plazma/about/README.md @@ -0,0 +1,71 @@ +--- +description: Finn ut hva Plazma serverplattformen er. +--- + +# ❓ Hva er Plazma? + +- **Plazma** er en serverplattform basert på [Paper](https://github.com/PaperMC/Paper) som bare tar med seg fordelene fra [Andromeda](https://github.com/EarendelArchived/Andromeda) og [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Vi streber alltid etter å tilby høy stabilitet, kraftig ytelse, raske oppdateringer og et omfattende sett med funksjoner. + +## 📋 Målene til Plazma + +- Vi jobber hardt for å bli en serverplattform med raske oppdateringer og høy stabilitet. +- Vi jobber hardt for å tilby et omfattende sett med funksjoner og kraftig ytelse som ikke står tilbake for mod-plattformer. +- Vi jobber hardt for å lage en fri plattform hvor selv vaniljepakker kan tilpasses. + +## ⚙️ Viktige funksjoner + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Raskeste oppdateringer**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) sørger for at Plazmas inkluderte patcher alltid er oppdatert, og tilbyr dermed de raskeste oppdateringene blant serverplattformene basert på Paper. +6. **Optimaliserte standardkonfigurasjonsfiler**\ + Standardkonfigurasjonsfilene er optimalisert slik at du ikke trenger å optimalisere dem manuelt. +7. **Systematisk flertrådsdrift**\ + Asynkroniserer systemmekanikk som ikke er relatert til spillmekanikken for å optimalisere serveren og redusere [ventetiden](#user-content-fn-4)[^4]. +8. **Blokkerer unødvendig bruk av plass**\ + Samler sammen data med lignende verdier for å redusere minnebruken. + +## ✨ Brukstilfeller + +- **Behandler selv komplekse plugins riktig**\ + Plazma brukes på servere av utvikleren [IPECTER](https://github.com/IPECTER). Selv med egne plugins som fungerer med NMS og refleksjon, samt en stor mengde komplekse datapakker, kan den håndtere over 100 spillere uten ytelsesfall. +- **Opprettholder rask ytelse selv på RPG-servere**\ + Klarte å opprettholde 100 spillere på en enkelt kluster uten TPS-fall, og totalt 250 spillere på 4 klustre kunne spille komfortabelt uten problemer. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Mange strømmere har valgt plattformen**\ + Mange strømmere bruker den som en bøtte for seerengasjement. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Nedlasting + +Du kan laste ned Plazma fra siden nedenfor. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Ønsker du mer informasjon om støttede versjoner? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot-plugins og Paper, Pufferfish, Purpur-plugins. + +[^2]: Eies av Microsoft Corporation. + +[^3]: Ved å deaktivere chat report system vil chatten kun behandles på serveren og Mojangs chat-sporing vil bli stoppet. + +[^4]: Tiden det tar for systemmekanikken å fungere og for spillet å midlertidig fryse. diff --git a/no/origin/plazma/about/downloads-all.md b/no/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..70627cdcb --- /dev/null +++ b/no/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma kjørbar fil nedlasting full visning +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versjon | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/no/origin/plazma/about/downloads.md b/no/origin/plazma/about/downloads.md new file mode 100644 index 000000000..525be4623 --- /dev/null +++ b/no/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Last ned Plazma nå og prøv det selv. +--- + +# ⬇️ Nedlasting + +#### Ønsker du mer informasjon om støttede versjoner? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Nedenfor finner du en kjørbar fil for vanlige brukere.** + +Hvis du er en utvikler og trenger en annen type fil, vennligst se nedenfor. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersjonNedlasting
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/no/origin/plazma/about/patches-list.md b/no/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..754135812 --- /dev/null +++ b/no/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Få mer informasjon om alle funksjonene som er lagt til i Plazma. +--- + +# 📑 Inkluderte oppdateringer diff --git a/no/origin/plazma/about/supported-versions.md b/no/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..af95cf8f0 --- /dev/null +++ b/no/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Finn ut hvilken Minecraft: Java Edition-versjon som støttes av Plazma." +--- + +# ✅ Støttet versjonstatus + +{% hint style="info" %} + +**Plazma er utviklet siden 1.19.4, versjoner under 1.19.4 er ikke lenger utviklet.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: https://badge.plazmamc.org/1/under%20utvikling +[atv]: https://badge.plazmamc.org/2/pågående%20støtte +[fse]: https://badge.plazmamc.org/6/funksjonalitet%20støtte%20stoppet +[eol]: https://badge.plazmamc.org/4/støtte%20avsluttet +[ukn]: https://badge.plazmamc.org/0/ingen%20informasjon +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/vanlig +[100]: https://badge.plazmamc.org/prosent/100 + +![Venter på utgivelse][wtr] ![Under utvikling][idv] ![Pågående støtte][atv] ![Funksjonalitet støtte stoppet][fse] ![Støtte avsluttet][eol] + +| Versjon | Stabilitet og funksjonalitetsstøtte | Byggstatus | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Byggestatus](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![byggestatus](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![byggestatus](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/no/origin/plazma/administration/README.md b/no/origin/plazma/administration/README.md new file mode 100644 index 000000000..52e5c958e --- /dev/null +++ b/no/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Lag din egen server ved hjelp av Plazma. +--- + +# ⚒️ Serverhåndbok diff --git a/no/origin/plazma/administration/diagnosis/README.md b/no/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..5400981ac --- /dev/null +++ b/no/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hvordan du skal håndtere det når et problem oppstår. +--- + +# 🧾 진단 diff --git a/no/origin/plazma/administration/diagnosis/plugins.md b/no/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..59a66ea00 --- /dev/null +++ b/no/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hvordan du løser det når pluginet ikke fungerer som det skal. +--- + +# 📜 플러그인 diff --git a/no/origin/plazma/administration/expert/README.md b/no/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..96b0291fa --- /dev/null +++ b/no/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du profesjonelt håndterer Plazma. +--- + +# 🎓 Avansert diff --git a/no/origin/plazma/administration/expert/fix-exploits.md b/no/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..b0ce36cbd --- /dev/null +++ b/no/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Finn ut om kjente sårbarheter og hvordan du løser dem. +--- + +# ⚠️ Kjente sårbarheter og løsningsmetoder diff --git a/no/origin/plazma/administration/expert/optimize.md b/no/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..e4334f31a --- /dev/null +++ b/no/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hvordan du optimaliserer Plazma. +--- + +# 🧹 Optimalisering diff --git a/no/origin/plazma/administration/expert/proxy.md b/no/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..9d83b245c --- /dev/null +++ b/no/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du trygt konfigurerer proxyplattformen "Velocity". +--- + +# 🔀 Proxy diff --git a/no/origin/plazma/administration/expert/vanillaize.md b/no/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..69e33d5bb --- /dev/null +++ b/no/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Lær hvordan du gjenoppretter Paper og vaniljepatchen. +--- + +# ↩️ Vanillize + +{% hint style="warning" %} + +**Paper legger ikke til valgmuligheter i de fleste patchene som løser feil med vanilje.** + +Plazma jobber med å utvikle en konfigurasjon for å deaktivere slike feilrettinger for øyeblikket. + +Derfor er denne veiledningen fortsatt under utvikling og informasjonen kan endres når som helst. + +{% endhint %} diff --git a/no/origin/plazma/administration/expert/xray.md b/no/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..6595296a5 --- /dev/null +++ b/no/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Lær om ulike innebygde metoder for å blokkere X-Ray. +--- + +# 🩻 Blokkering av X-Ray diff --git a/no/origin/plazma/administration/faq.md b/no/origin/plazma/administration/faq.md new file mode 100644 index 000000000..5c7900998 --- /dev/null +++ b/no/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Finn ut mer om vanlige spørsmål. +--- + +# ⁉️ Vanlige spørsmål + +{% hint style="info" %} + +**Finner du ikke svaret du leter etter?** + +[Offisiell Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub-diskusjoner](https://github.com/PlazmaMC/PlazmaBukkit/discussions) for å stille spørsmål til fellesskapet! + +{% endhint %} + +### Plazma starter ikke + +Hvis du ser `no main manifest attribute, in plazma-(versjon).jar` i konsollen,\ +filen du lastet ned er en utvikler-API-fil, du må laste ned **Reobf Paperweight** fra GitHub-siden. + +Se følgende side for mer informasjon. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### En advarsel vises hver gang serveren starter + +Plazma inneholder noen ustabile patcher og kan alltid ha en risiko for feilfunksjon, derfor viser den følgende advarselen hver gang serveren starter. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Denne advarselen kan deaktiveres ved å bruke [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1) systemegenskap. + +Se følgende side for mer informasjon. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tilgjengelig fra 1.20.1 diff --git a/no/origin/plazma/administration/getting-started/README.md b/no/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..a0f085897 --- /dev/null +++ b/no/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Lær hvordan du oppretter en server med Plazma. +--- + +# 👟 Kom i gang + +For å bruke Plazma på en stabil måte, må systemet oppfylle følgende krav: + +| | Minimum | Anbefalt | +| :-----------: | ------- | -------- | +| Arkitektur | x64 | - | +| RAM | 8GB | 16GB | +| Lagringsplass | 1GB | 8GB | +| JDK | 17 | 21 | + +For en smidig konfigurasjonsfilredigering, er det også bra å installere en redaktør som [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Riktig utskrift" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' er ikke et internt eller eksternt kommando, et kjørbart program eller en batchfil. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Først laster du ned **JDK 21** fra [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) i `.msi`-format. +2. Kjør den nedlastede installasjonsveiviseren og klikk `Next`. +3. Aktiver `Set JAVA_HOME variable` fra menyen som vises midt på venstre side av vinduet, og klikk deretter `Next`. +4. Trykk på `Install` for å fullføre JRE-installasjonen. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Deretter installerer du JRE ved å kjøre følgende kommando i terminalen. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma nedlasting + +Plazma tilbyr forskjellige typer kjørbare filer. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Les mer + +Navnet på kjørefilen er `plazma-(versjonsbehandler)-1.20.4-R0.1-SNAPSHOT-(mappingtype).jar`. + +- **Mappingtype**\ + Mapping er en slags veikart som knytter Minecrafts faktiske kode til obfuskert kode. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mappet, vanlig Minecraft-mapping. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Versjonsbehandler**\ + En versjonsbehandler er en launcher for serveren som trengs for å kjøre serveren og patche serverfiler. + - **Paperclip**\ + Utviklet av PaperMC-teamet for Paper og andre avledede plattformer, laster ned biblioteker og bruker patcher på serveren. + - **Bundler**\ + Vanilla Minecraft-versjonsbehandler. + +
+ +*** + +## 3. Opprettelse av startskript + +For enkel oppstart og automatisert omstart av serveren med Plazma, må du lage et [startskript](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Du kan laste ned startskriptet ved å klikke på nedlastingsknappen nederst til venstre.\ +**Sjekk om det nedlastede startskriptet samsvarer med operativsystemet ditt.** + +*** + +## 4. Filopprydding + +Flytt det nedlastede startskriptet og Plazma til en ny mappe. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Kjør startskriptet nå. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA-samtykke + +Når du kjører startskriptet, opprettes en `eula.txt`-fil i mappen. + +EULA[^9] er en lisensavtale du må godta for å bruke tjenestene til [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Hvis du godtar EULA-en, endre `eula=false` til `eula=true` i `eula.txt`-filen og lagre endringene. + +*** + +## 6. Tillat ekstern tilkobling (Windows) + +Moderne operativsystemer blokkerer som standard ekstern tilgang for å forhindre farlige tilnærminger via brannmur og rutere. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Hvis ruteren ikke støtter UPnP, må du søke etter informasjon om konfigurering for ulike rutere. + +Alternativt kan du bruke [Ngrok](https://ngrok.com/) for å opprette en midlertidig adresse. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Sjekk om portvideresending er nødvendig + +Skriv inn følgende i Kjør-vinduet og kjør det. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Hvis utdataen er `True`, er du ferdig her. Hvis den er `False`, må du konfigurere portvideresending. + +### 6.2 Koble til serveren + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Du kan finne adressen som brukes for å koble til serveren [her](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Deretter, når serveren startes på nytt, vil Plazma automatisk prøve å videresende porten. + +Nedenfor er betydningen av meldingene som vises på konsollen for å indikere om UPnP var vellykket, og de vises som `[UPnP] (melding)` på konsollen. + +| Melding | Betydning | +| ----------------------------------- | ------------------------------------------------------------- | +| `Porten ble åpnet vellykket (port)` | Videresending av porten var vellykket. | +| `Porten (port) er allerede åpen` | En annen tjeneste bruker allerede den porten. | +| `Kunne ikke åpne porten (port)` | Videresending av porten mislyktes. | +| `Tjenesten er utilgjengelig` | Ruteren støtter ikke UPnP. | + +Når serveren er stoppet, lukker Plazma automatisk porten. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Last ned ZIP-filen for `Windows (64-bit)` fra [Ngrok-nettsiden](https://ngrok.com/download). +2. Legg den nedlastede Ngrok-filen i servermappen. +3. Generer en godkjennelsestoken fra [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Kjør kommandoen som vises i `Command Line` i servermappen. +5. Legg til `start /b ngrok tcp --region jp 25565` øverst i kjøreskriptet, og `taskkill /f /t /im ngrok.exe` nederst. +6. Fra meldingen som vises øverst i konsollen, vil `0.tcp.jp.ngrok.io:12345` være serverens adresse. +7. Du kan nå koble til serveren eksternt ved hjelp av denne adressen. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +For eksempel, når du kjører kommandoen og får følgende utdata, + +```log +Windows IP-konfigurasjon + +Ethernet-adapter Ethernet: + + Tilkoblings-spesifikt DNS-suffiks. . . . : + IPv4-adresse. . . . . . . . . : 192.168.3.7 + Nettverksmaske. . . . . . . . : 255.255.255.0 + Standard gateway. . . . . . . : 192.168.3.1 + +``` + +Du kan koble til serveren lokalt ved å bruke `192.168.3.7` som vises i IPv4-adressen her. + +Hvis serveren og spillet kjører på samme PC, kan du koble til med `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Utvikle seg + +Når serveren er startet vellykket og fungerer som den skal, er det på tide å tilpasse serveren. + +Se gjennom følgende veiledning for å lære hvordan du tilpasser serveren. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma, basert på Paper, som igjen er basert på Spigot, som er basert på den offisielle serverplattformen. + +[^3]: Windows-tast + R + +[^4]: For Linux, bruk `java --version` i terminalen. + +[^5]: JRE er en av mange åpen kildekodeprosjekter, som Minecraft-serverplattformen. + +[^6]: Det er vanligvis kjent som en **launcher**. + +[^7]: Hvis du aktiverer "Auto-restart", vil serveren starte på nytt automatisk. Du kan avslutte ved å trykke `Control + C`. + +[^8]: Det anbefales ikke å overskride halvparten av systemets minnekapasitet. + + For eksempel, hvis systemets totale minnekapasitet er 8GB, bør du ikke sette det høyere enn 4GB. + +[^9]: End-User License Agreement, sluttbrukerlisensavtale. Se [Minecrafts nettsted](https://www.minecraft.net/ko-kr/usage-guidelines) for mer informasjon. + +[^10]: Microsoft Corporation. + +[^11]: I henhold til lov om fremme av spillindustrien i Korea, paragraf 32, punkt 9, kan du saksøke **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur inkludert i Plazma kommuniserer automatisk med ruteren via denne teknologien for å åpne porten bare når serveren kjører, så du trenger ikke å videresende porten manuelt. + +[^13]: Hvis du ikke har en konto, kan du registrere deg på Ngrok med Google- eller GitHub-kontoen din. diff --git a/no/origin/plazma/administration/getting-started/customization.md b/no/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..29335a868 --- /dev/null +++ b/no/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Lær hvordan du tilpasser serveren. +--- + +# 🎨 Tilpasning + +Årsaken til å bruke en tilpasset serverplattform som Plazma i stedet for den offisielle serverplattformen fra Mojang Studios er at det gir mulighet for kraftig **tilpasning**. + +Her er flere måter å tilpasse og bruke Plazma på. + +## Konfigurasjonsendringer + +Den mest grunnleggende måten å tilpasse Plazma på er å endre konfigurasjonen. + +Plazma tilbyr kraftige konfigurasjonsinnstillinger fra spillmekanikker til egenskaper for mobber. + +Se nedenfor for en forklaring av Plazmas konfigurasjon. + +{% content-ref url="../reference/configurations/" %} +[konfigurasjoner](../reference/configurations/) +{% endcontent-ref %} + +## Bruk av tillegg + +{% hint style="success" %} + +**Plazma støtter alle pluginer basert på Paper fullt ut.** + +For Spigot-plugins kan det hende at noen ikke fungerer på grunn av endringer i kartleggingen fra Paper 1.20.5, men de fleste pluginer basert på Paper, Pufferfish og Purpur fungerer også på Plazma. Hvis de ikke fungerer som de skal, er det en feil med Plazma, så vennligst [meld fra umiddelbart.](../diagnosis/plugins.md) + +{% endhint %} + +Dette er hovedgrunnen til å bruke Plazma og den kraftigste måten å tilpasse Plazma på for brukerne. +Plazmas sterke plugin-økosystem gjør det enkelt å tilpasse serveren. + +Det er flere måter å finne og laste ned pluginer på. Noen pluginer lastes opp til offentlige lagringstjenester, mens andre lastes opp på GitHub eller egne nettsteder. + +{% hint style="caution" %} + +**Pluginer kan få direkte tilgang til systemet ditt!** + +Bruk tjenester som VirusTotal for å alltid sjekke om en plugin er trygg å bruke før du installerer den, eller last ned pluginer fra pålitelige tjenester. + +{% endhint %} + +Det er flere tjenester som brukes til nedlasting av pluginer. Blant disse, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) og andre tjenester krever godkjenning før pluginer lastes opp for å sikre at bare trygge pluginer distribueres. + +### Anvendelse av pluginer + +Når du har lastet ned en plugin, er det på tide å bruke den. + +1. Pluginer er i form av `.jar`-filer eller `Java Executable File`. Noen pluginer kan være komprimert, og i så fall må du pakke ut filen. Hvis filen inneholder `bukkit`, `spigot` eller `paper` i navnet, og det er en fil med `fat`, må du bruke `fat`-filen. +2. Legg den nedlastede filen i mappen 'plugins' i servermappen og start (på nytt) serveren. +3. Når Plazma starter, vil det vises ny informasjon på konsollen. + Dette betyr at Plazma har lastet inn pluginene riktig. +4. Selv om Plazma har lastet inn pluginene riktig, kan det hende at de ikke starter. + Du kan bruke kommandoen `/plugins` for å se hvilke pluginer som er lastet inn på serveren. + Hvis navnet på en installert plugin ikke er rødt, men grønt, betyr det at pluginet er lastet inn riktig. + +Hvis en plugin ikke lastes inn riktig, kan du finne løsninger på problemet på følgende side. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Bruk av datapakker + +Datapakker er en måte å tilpasse Minecraft på, lignende ressurspakker. + +Med datapakker kan du legge til nye skapninger og utfordringer i spillet. + +{% hint style="caution" %} + +**Datapakker kan skade verdener!** + +Noen feilaktige datapakker kan skade verdener irreversibelt. + +Derfor anbefales det å ta sikkerhetskopi av verdener før du bruker datapakker. + +{% endhint %} + +Datapakker kan lastes ned fra ulike tjenester som [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) og andre tjenester. + +Når du har lastet ned en datapakke, kan du legge den til i mappen 'datapacks' i serverens verden. +Hvis mappen ikke finnes, kan du opprette den selv. + +{% hint style="warning" %} + +**Noen [datapakker](#user-content-fn-2) fungerer kanskje ikke riktig ved første påføring.** + +I slike tilfeller anbefales det å starte serveren **2 ganger** for å sikre riktig påføring. + +{% endhint %} + +Datapakker kan lett bli ødelagt når Minecraft oppdateres. + +Spesielt når datapakker er fullstendig ødelagt, kan serveren krasje, så det er viktig å teste grundig før du oppdaterer serveren. + +{% hint style="info" %} + +**Etter serverstartkommandoen kan du skrive `safeMode` for å deaktivere alle datapakker før du starter serveren på nytt.** + +[Se 'Referanse > Argumenter og egenskaper' for mer informasjon.](../reference/arguments.md) + +{% endhint %} + +Du kan bekrefte at datapakkene er lagt til ved å bruke kommandoen `/datapack list`. + +*** + +[^1]: Eller Minecraft: Bedrock Editions tillegg. + +[^2]: Legg til nye skapninger osv. diff --git a/no/origin/plazma/administration/getting-started/next-step.md b/no/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..8a3cf41c8 --- /dev/null +++ b/no/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Lær hvordan du tilpasser serveren. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Her er flere måter å tilpasse og bruke Plazma på. + +## Konfigurasjonsendringer + +Den mest grunnleggende måten å tilpasse Plazma på er å endre konfigurasjonen. + +Plazma tilbyr kraftige konfigurasjonsinnstillinger fra spillmekanikker til egenskaper for mobber. + +Se nedenfor for en forklaring av Plazmas konfigurasjon. + +{% content-ref url="../reference/configurations/" %} +[konfigurasjoner](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Bruk av tillegg + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Dette er hovedgrunnen til å bruke Plazma og den kraftigste måten å tilpasse Plazma på for brukerne. Plazmas sterke plugin-økosystem gjør det enkelt å tilpasse serveren. + +Det er flere måter å finne og laste ned pluginer på. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Det er flere tjenester som brukes til nedlasting av pluginer. Blant disse, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) og andre tjenester krever godkjenning før pluginer lastes opp for å sikre at bare trygge pluginer distribueres. + +### Anvendelse av pluginer + +Når du har lastet ned en plugin, er det på tide å bruke den. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Legg den nedlastede filen i mappen 'plugins' i servermappen og start (på nytt) serveren. +3. Når Plazma starter, vil det vises ny informasjon på konsollen. Dette betyr at Plazma har lastet inn pluginene riktig. +4. Selv om Plazma har lastet inn pluginene riktig, kan det hende at de ikke starter. Du kan bruke kommandoen `/plugins` for å se hvilke pluginer som er lastet inn på serveren. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Hvis en plugin ikke lastes inn riktig, kan du finne løsninger på problemet på følgende side. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Bruk av datapakker + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Med datapakker kan du legge til nye skapninger og utfordringer i spillet. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Noen feilaktige datapakker kan skade verdener irreversibelt. + +Derfor anbefales det å ta sikkerhetskopi av verdener før du bruker datapakker. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Når du har lastet ned en datapakke, kan du legge den til i mappen 'datapacks' i serverens verden. Hvis mappen ikke finnes, kan du opprette den selv. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +I slike tilfeller anbefales det å starte serveren **2 ganger** for å sikre riktig påføring. +{% endhint %} + +Datapakker kan lett bli ødelagt når Minecraft oppdateres. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Du kan bekrefte at datapakkene er lagt til ved å bruke kommandoen `/datapack list`. + +*** + +## Optimalisering + +Plazma har fått mange optimaliseringsoppdateringer. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Se nedenstående side for informasjon om sikker og riktig proxykonfigurasjon. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Sikkerhet + +Minecraft har utviklet seg til å enkelt kunne skaffe [sårbarhetsangrepsmotorer](#user-content-fn-3)[^3] online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Tilgangskontroll + +Noen administrasjonskommandoer for plugins har sårbarheter hvis tillatelsene ikke er riktig satt opp. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray-blokkering + +X-Ray er en av sårbarhetene som er enkelt tilgjengelig selv i grunnleggende optimaliseringsklienter. + +Plazma tilbyr en konfigurasjon som kan blokkere X-Ray som standard. + +Se nedenstående side for instruksjoner om X-Ray-blokkering. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Hvitelistning + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Bruk `/whitelist query` for å se hvilke spillere som har tillatelse til å koble seg til. + +*** + +[^1]: Eller Minecraft: Bedrock Editions tillegg. + +[^2]: Legg til nye skapninger osv. + +[^3]: Vanligvis referert til som "hacking". + +[^4]: Hvis konfigurasjonen ikke er optimalisert, eller hvis Plazma er utdatert, eller hvis det er nye sårbarheter som ikke er blokkert, kan det hende at de ikke er blokkert. + +[^5]: Når spillere kobler seg til serveren, skjer det via Ngrok proxyserveren, og den tildelte Ngrok-adressen endres ved hver omstart. diff --git a/no/origin/plazma/administration/reference/README.md b/no/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..ab28b4fdd --- /dev/null +++ b/no/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Finn ut hvordan du kan tilpasse Plazma som standard. +--- + +# 📜 리퍼런스 + +Plazma tilbyr flere tilpasningsmetoder. + +Blant disse er fire metoder som kan brukes umiddelbart uten ekstra arbeid. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Offisiell Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub-diskusjoner](https://github.com/PlazmaMC/PlazmaBukkit/discussions) for å stille spørsmål til fellesskapet! +{% endhint %} + +*** + +## 🖥️ Kommandoer + +> Kommandoer lar deg samle informasjon i spillet eller tilpasse spillopplevelsen. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Tillatelser + +> Tillatelser definerer omfanget av interaksjon en spiller kan ha. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenter og egenskaper + +> Argumenter og egenskaper påvirker Plazmas funksjon. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigurasjon + +> Konfigurasjon er den mest grunnleggende måten å tilpasse Plazma på. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/no/origin/plazma/administration/reference/arguments.md b/no/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..163c36bcd --- /dev/null +++ b/no/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Lær om startargumenter og systemegenskaper. +--- + +# 🎛️ Argumenter og egenskaper + +Startargumenter og systemegenskaper er verdier som legges til kommandoene som brukes til å kjøre Plazma[^1], og de har generell innvirkning på Plazmas funksjon. + +[Plassering av tilleggskommandoer](#user-content-fn-2)[^2] vil dele dem inn i **startargumenter** og **systemegenskaper** i henhold til. + +*** + +## Systemegenskaper + +Systemegenskaper legges til foran `-jar` og behandles av JVM før Plazma initialiseres. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Bruksanvisning + +Systemegenskaper legges til som Java-kommandoargumenter mellom `java` og `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indikerer at dette argumentet ikke er innebygd i JVM, men er et tilpasset argument for Plazma, + +Hvis ingen verdier er angitt for egenskapene, vil verdiene være [`true` som standard](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Alle systemegenskaper + +#### `convertLegacySigns` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Oppdaterer utdaterte skiltformater. + +#### `debug.entities` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for entitetsinformasjon. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer NMS-revisjonen for å tillate riktig lasting av debuginformasjon i IDE,\ +og remapper automatisk interne versjonsinformasjoner. + +#### `disable.watchdog` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer Spigots Watchdog-varslingssystem. + +#### `letMeReload` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer bekreftelsesmeldingen for `/reload`-kommandoen. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Hvis du er pluginutvikler og må oppdatere pluginen din, bruk heller hotswapping i stedet for `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer plugins som bruker standard inndata/utdata-system. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Advarer når utdaterte formater oppdages i chatkomponenter. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer serverens vertskontroll ved tilkobling av spillere. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for manglende nøkler i NBT-objekter. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for ugyldige hodeskalleprofiler. + +Logger alle feilaktige hodeskalleblokker i verden med posisjon. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer prioriteringssystemet for plugin-klasser. + +Nyttig ved problemer med pluginskygging. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer Netty-flush-konsolideringssystemet. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Standardverdi**: `750` + +Del opp enheter i flere pakker for overføring hvis antallet overstiger denne verdien. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Standardverdi**: `8192` + +Setter maksimal størrelse på pakker som serveren kan motta. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer Java-versjonskontrollen. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Dette kan permanent skade filer i verden og ødelegge spillets mekanikk. + +Enhver skade forårsaket av dette er brukerens ansvar, og Plamza gir ingen støtte for det. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Standardverdi**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Standardverdi**: `80` + +Setter maksimal lengde for tekst på et skilt. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Standardverdi**: `(verden versjon) + 1` + +Setter versjonen for informasjon om verden som skal initialiseres først. + +Nyttig for store mengder blokker som må oppdateres, men sjelden brukt ellers. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolsk` +- **Standardverdi**: `True` + +Aktiverer behandling av kommentarer i YAML-filer som standard. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Standardverdi**: `30` + +Kaster ut spillere som ikke sender data innen angitt tid (i sekunder). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Ignorerer kommentarer i serverens egenskaper. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for synkrone chunk-operasjoner. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer Minecrafts [standard chunk-writing-system](#user-content-fn-10)[^10]. + +Dette lagrer hver chunk i en sekvensiell rekkefølge, noe som kan forårsake betydelig ytelsesnedgang. + +#### `Paper.explicit-flush` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer eksplisitt tømming av nettverkskanaler. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Logger alltid feil som ikke oppstår i hovedtråden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Advarer hvis planlagte oppgaver har overdreven ventetid. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Når du bruker standard kjørbare filer, vil den bare bruke patching uten å starte serveren. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +Styrker den initielle konfigurasjonsoptimaliseringen. + +Når aktivert, kan serveren bli raskere og sikrere, men det kan ha stor innvirkning på spillopplevelsen. + +#### `Plazma.disableConfigOptimization` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` +- **Konflikt**: `Plazma.aggressiveOptimize` + +Unngår optimalisering av den initielle konfigurasjonen. + +Dette setter opp bruken av Paper's standardkonfigurasjon. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` + +Deaktiverer Plazma-merkevaren og bruker vanlig serverfaneikon. + +#### `Plazma.useVanillaConfiguration` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Dette kan ha stor innvirkning på serverens sikkerhet og ytelse. + +Alle problemer som oppstår ved bruk av denne egenskapen, er landsbygd vaktmesterens ansvar. +{% endhint %} + +Setter opp den initiale konfigurasjonen til standardverdiene som tilbys av Mojang. + +Deaktiverer alle sårbarhetsfiksene implementert av Paper. + +Sårbarhetsfikser kan reaktiveres i Paper- eller Plazma-konfigurasjonen. + +#### `Plazma.vanillaize` + +- **Type**: `Boolsk` +- **Standardverdi**: `true` +- **Konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Setter den initiale konfigurasjonen nærmere til vanilje. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Egenskapen er ikke lenger i bruk + +Følgende systemegenskaper er ikke lenger i bruk. + +#### `timings.bypassMax` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` +- **Ikke lenger i bruk**: Timings ble fjernet fra Plazma + +Bestemmer om verdier som sendes til Aikar's Timings API kan overskride maksimumsgrensen. + +Selv om dette er tilfelle, vil en hastighetsbegrensning bli pålagt hvis det ikke håndteres som et unntak i API-en. + +*** + +## Startargument + +Startargumentet legges inn etter `-jar *.jar` for å initialisere Plazma og behandles sammen med det. + +### Bruksanvisning + +Systemegenskaper legges inn som programkommandoargumenter etter `-jar *.jar`. + +For eksempel, hvis du vil bruke startargumentet `nogui`,\ +kan du skrive det på følgende måte for at Plazma skal behandle `nogui`-argumentet under initialiseringen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Fullstendig startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standardverdi**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Standardverdi**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Standardverdi**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Starter serveren i demomodus. + +#### `eraseCache` + +Fjerner gjenværende hurtigbufferfiler etter verdenoppgradering. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Skriver ut alle startargumentene og beskrivelsene for Plazma. + +#### `initSettings` + +Oppretter kun konfigurasjonsfilen og avslutter serveren. + +#### `jfrProfile` + +Aktiverer JFR-profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standardverdi**: `(serveregenskap)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Deaktiverer det grafiske grensesnittspanelet. + +#### `nojline` + +Deaktiver JLine og bruk vanlig konsoll. + +#### `online-mode` + +- **Alias**: `o` +- **Standardverdi**: `(serveregenskap)` + +Velg om spillerne skal valideres mot Mojangs autentiseringsserver. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardverdi**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Setter plasseringen av den utdaterte PaperSpigot konfigurasjonsfilen. + +Denne brukes til å flytte eksisterende konfigurasjon til en ny fil, og brukes ikke etter dette. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardverdi**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Standardverdi**: `plugins` + +Setter plasseringen av plugin-mappen. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardverdi**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardverdi**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Starter serveren i fullstendig vaniljemodus. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standardverdi**: `(serveregenskap)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standardverdi**: `(serveregenskap)` + +Setter porten for serveren. + +#### `server-name` + +- **Standardverdi**: `A Plazma Server` + +Setter navnet på serveren. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardverdi**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Viser Plazma-versjonen. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardverdi**: `(servermappen)` + +Setter plasseringen der verdensfilene lagres. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standardverdi**: `(serveregenskap)` + +Setter navnet på verdensfilen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Endrer argumentbehandling avhengig av tilleggslokasjonen. + +[^3]: For eksempel, hvis du vil aktivere `Plazma.iKnowWhatIAmDoing` til `true`, trenger du bare å skrive `-DPlazma.iKnowWhatIAmDoing` i stedet for `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: For eksempel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event Detector. + +[^6]: Event Detector. + +[^7]: Client. + +[^8]: Signal som indikerer at serveren er korrekt tilkoblet, som et hjerteslag. + +[^9]: Med Purpurs AFK-kick-funksjon kan du kicke spillere som er inaktive. + +[^10]: Sync Chunk Write System. + +[^11]: `WARNING! Plazma kan forårsake uventede problemer, så sørg for å teste grundig før du bruker det på en offentlig server.` + +[^12]: I spillet fungerer `world optimization` på samme måte. + +[^13]: Administratorer på `nivå 2` eller høyere er unntatt. + +[^14]: Internet Protocol, IP. diff --git a/no/origin/plazma/administration/reference/commands.md b/no/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..a38ea4a7a --- /dev/null +++ b/no/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Finn ut om kommandoene som er tilgjengelige på Plazma. +--- + +# 🖥️ Kommandoer diff --git a/no/origin/plazma/administration/reference/configurations/README.md b/no/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..7cc695e76 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigurasjon er den mest grunnleggende måten å tilpasse Plazma på. +--- + +# 🧾 구성 + +*** + +## 🪨 Egenskaper + +> Egenskaper er den mest grunnleggende konfigurasjonsfilen som tilbys i Minecraft. Ved å bruke egenskaper kan du endre grunnleggende mekanismer i spillet. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit konfigurasjon + +> Bukkit konfigurasjon er den mest grunnleggende konfigurasjonsfilen som tilbys av Plazma. Ved å bruke Bukkit konfigurasjon kan du endre grunnleggende mekanismer i Minecraft-serveren. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot konfigurasjon + +> Spigot konfigurasjon lar deg endre detaljerte mekanismer i spillet, spilleres håndtering, kommandoer og meldinger. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper konfigurasjon + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish konfigurasjon lar deg endre Plazmas behandling av verdener og enheter. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur konfigurasjon + +> Purpur egenskaper lar deg endre spillens overordnede grunnleggende data. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfigurasjon + +> Plazma konfigurasjon lar deg tilpasse Plazmas funksjoner. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/no/origin/plazma/administration/reference/configurations/bukkit.md b/no/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..94b84ce83 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i bukkit.yml betyr. +--- + +# 🪣 Bukkit diff --git a/no/origin/plazma/administration/reference/configurations/paper/README.md b/no/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..133f5a134 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut formålet med hver fil i konfigurasjonsmappen. +--- + +# 🛩️ Papir diff --git a/no/origin/plazma/administration/reference/configurations/paper/global.md b/no/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..50955c363 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node av paper-global.yml betyr. +--- + +# 🌏 전역 구성 diff --git a/no/origin/plazma/administration/reference/configurations/paper/world.md b/no/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..55e5f997d --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Finn ut hva hver node i paper-world.yml betyr. +--- + +# 🏳️ 세계별 구성 + +Verdensomspennende diff --git a/no/origin/plazma/administration/reference/configurations/plazma/README.md b/no/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..30fbee7d9 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut formålet med hver fil i konfigurasjonsmappen. +--- + +# ✨ Plazma diff --git a/no/origin/plazma/administration/reference/configurations/plazma/global.md b/no/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..64cb55bef --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i plazma-global.yml betyr. +--- + +# 🌏 전역 구성 diff --git a/no/origin/plazma/administration/reference/configurations/plazma/world.md b/no/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..bf5cf615f --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i plazma-world.yml betyr. +--- + +# 🏳️ 세계별 구성 diff --git a/no/origin/plazma/administration/reference/configurations/plazma/worlds.md b/no/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..ed722a16b --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i plazma-world.yml betyr. +--- + +# ✨ Plazma (sammensetning av verdener) diff --git a/no/origin/plazma/administration/reference/configurations/property.md b/no/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..51268ca1f --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i server.properties betyr. +--- + +# 🪨 Server.properties diff --git a/no/origin/plazma/administration/reference/configurations/pufferfish.md b/no/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..5413348c6 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i pufferfish.yml betyr. +--- + +# 🐡 Pufferfisk diff --git a/no/origin/plazma/administration/reference/configurations/purpur/README.md b/no/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..705a9f2c8 --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i purpur.yml betyr. +--- + +# 🦑 Purpur diff --git a/no/origin/plazma/administration/reference/configurations/purpur/global.md b/no/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..e17052f4a --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i purpur.yml betyr. +--- + +# 🌏 전역 구성 diff --git a/no/origin/plazma/administration/reference/configurations/purpur/world.md b/no/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..b249187fa --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i purpur.yml betyr. +--- + +# 🏳️ 세계별 구성 diff --git a/no/origin/plazma/administration/reference/configurations/spigot.md b/no/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..4586890ad --- /dev/null +++ b/no/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i spigot.yml betyr. +--- + +# 🚰 Spigot diff --git a/no/origin/plazma/administration/reference/permissions.md b/no/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..fe459f7d2 --- /dev/null +++ b/no/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Få informasjon om tillatelsene til Plazma. +--- + +# 🛡️ Tillatelser + +Tillatelse er et enkelt sikkerhetsverktøy som setter omfanget av samhandling mellom spillere på serveren. + +For å bruke tillatelser skikkelig og enkelt endre dem, må du bruke tillegg som [LuckPerms](https://luckperms.net). + +*** + +## Forstå grunnleggende tillatelsessystem + +Minecraft tilbyr grunnleggende administrasjonsgrupper for tillatelser. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Spiller**\ + En grunnleggende tillatelsesgruppe som vanligvis gis til alle spillere. +2. **Moderator**\ + Kan ignorere spawnbeskyttelse. +3. **Verdensadministrator**\ + Kan bruke alle kommandoer og kommandoblokker relatert til verdensadministrasjon.\ + En grunnleggende tillatelsesgruppe som brukes som standard for datapakker og kommandoblokker. +4. **Administrator**\ + Kan bruke alle kommandoer relatert til spilleradministrasjon. +5. **Hovedadministrator**\ + Kan bruke alle kommandoer, inkludert serveradministrasjon.\ + En grunnleggende tillatelsesgruppe som brukes som standard for konsollen og administratorer. + +*** + +## Sette tillatelser + +*** + +## Fullstendige tillatelser + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Standard**: `Ingen` + +Tillater at spillere kan `bøye seg ned og samhandle` med enheter for å ri dem. + +Når du rir enheten, kan du bruke `bevegelsesknapper` til å styre enhetens bevegelse og bruke `hoppetasten` for å hoppe eller fly. + +`(Namespaced Key)` er den [Namespaced ID](#user-content-fn-2)[^2] til enheten. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Standard**: `Ingen` + +Tillater at spillere kan bruke enhetens spesialferdigheter mens de rir enheten. + +Ikke alle enheters spesialferdigheter er tilgjengelige. Se nedenfor for en liste over tilgjengelige spesialferdigheter. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Legg ut ideene dine på [Plazma Discord](https://plazmamc.org/discord) eller [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Se tilgjengelige spesialferdigheter nå + +- **`crepper`**\ + Når du trykker på `hoppetasten`, eksploderer den.\ + Hvis spilleren har tillatelsen `allow.powered.creeper`, kan du holde nede `hoppetasten` for å lade den opp. +- **`dolphin`**\ + Når du trykker på `hoppetasten`, sprinter den. +- **`phantom`**\ + Når du trykker på `hoppetasten`, skyter den ut flammer. +- **`wither`**\ + Når du `samhandler` med den, skyter den ut wither-hoder. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/compass` kommandoen](commands.md#compass). + +#### `bukkit.command.credits` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/credits (Spiller)` kommandoen](commands.md#credits). + +Legger til `.other` bak tillatelsesnavnet for å tillate andre spillere å bruke det. + +#### `bukkit.command.demo` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/demo (Spiller)` kommandoen](commands.md#demo). + +Legger til `.other` bak tillatelsesnavnet for å tillate andre spillere å bruke det. + +#### `bukkit.command.ping` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/ping (Spiller)` kommandoen](commands.md#ping). + +Legger til `.other` bak tillatelsesnavnet for å tillate andre spillere å bruke det. + +#### `bukkit.command.ram` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/ram` kommandoen](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/rambar (Spiller)` kommandoen](commands.md#rambar). + +Legger til `.other` bak tillatelsesnavnet for å tillate andre spillere å bruke det. + +#### `bukkit.command.restart` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/restart` kommandoen](commands.md#restart). + +#### `bukkit.command.tps` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/tps` kommandoen](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/tpsbar (Spiller)` kommandoen](commands.md#tpsbar). + +Legger til `.other` bak tillatelsesnavnet for å tillate andre spillere å bruke det. + +#### `bukkit.command.timings` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/timings` kommandoen](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Se [Spark](https://spark.lucko.me/docs/Command-Usage) for lignende funksjoner. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/uptime` kommandoen](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Standard**: `Verdensadministrator` + +Tillater bruk av [`/gamemode (GameMode) (Spiller)` kommandoen](commands.md#gamemode). + +Legger til `.other` bak tillatelsesnavnet for å tillate andre spillere å bruke det. + +#### `paper.antixray.bypass` + +- **Standard**: `Ingen` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Dette gir fordeler for begge parter i form av ytelsesforbedringer. + +> Se siden nedenfor for informasjon om hvordan du konfigurerer X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Standard**: `Ingen` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Standard**: `Ingen` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Standard**: `Ingen` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Standard**: `Ingen` + +Tillater bruk av [MiniMessage tags](https://docs.advntr.dev/minimessage/format.html) på ambolter. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Standard**: `Ingen` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Standard**: `Ingen` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Standard**: `Ingen` + +Ekskluderer spillere fra å bli kastet ut for inaktivitet. + +#### `purpur.debug.f3n` + +- **Standard**: `Verdensadministrator` + +Tillater spillere å endre spillmodus ved å bruke tastekombinasjonen `F3 + N`. + +Fungerer bare hvis spilleren har tillatelse for den aktuelle spillmodusen. + +#### `purpur.drop.spawners` + +- **Standard**: `Ingen` + +Hvis aktivert i konfigurasjonen, vil gruving av spawnerblokker med de angitte elementene slippe spawnerblokken. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Standard**: `Ingen` + +Endrer størrelsen på enderbrystet. + +Mulige verdier for `(NumberString)` er `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Standard**: `Ingen` + +Tillater at totem av udødelighet fungerer selv om den er i inventaret. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Standard**: `Ingen` + +Spilleren tillates å ignorere begrensningen for antall tilkoblede brukere. + +#### `purpur.mending_shift_click` + +- **Standard**: `Ingen` + +Spilleren tillates å reparere det holdte elementet ved å `snu seg ned og samhandle`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Standard**: `Ingen` + +Spilleren tillates å installere spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Standard**: `Ingen` + +Spilleren tillates å teleportere umiddelbart når de bruker Nether portal. + +#### `purpur.sign.color` + +- **Standard**: `Ingen` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Standard**: `Ingen` + +Tillat bruk av obfuskasjonskoden `(&o)` på skilt. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.skilt.stil` + +- **Standard**: `Ingen` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.desarmere` + +- **Standard**: `Ingen` + +Tillat spillere å forhindre TNT-eksplosjoner ved å `samhandle` med saks. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Forventede tillatelser + +#### `plazma.omgå.ncr-krav` + +- **Standard**: `Ingen` + +Tillat spillere å koble til selv om de ikke har installert modulen [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operatør. + +[^2]: Eksempel: `ender_dragon` diff --git a/no/origin/plazma/adminstration/README.md b/no/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..52e5c958e --- /dev/null +++ b/no/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Lag din egen server ved hjelp av Plazma. +--- + +# ⚒️ Serverhåndbok diff --git a/no/origin/plazma/adminstration/expert/README.md b/no/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..96b0291fa --- /dev/null +++ b/no/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du profesjonelt håndterer Plazma. +--- + +# 🎓 Avansert diff --git a/no/origin/plazma/adminstration/expert/fix-exploits.md b/no/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..b0ce36cbd --- /dev/null +++ b/no/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Finn ut om kjente sårbarheter og hvordan du løser dem. +--- + +# ⚠️ Kjente sårbarheter og løsningsmetoder diff --git a/no/origin/plazma/adminstration/expert/optimize.md b/no/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..e4334f31a --- /dev/null +++ b/no/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hvordan du optimaliserer Plazma. +--- + +# 🧹 Optimalisering diff --git a/no/origin/plazma/adminstration/expert/vanillaize.md b/no/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..b7a6a7f1e --- /dev/null +++ b/no/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Lær hvordan du gjenoppretter Paper og vaniljepatchen. +--- + +# ↩️ Vanillize + +{% hint style="warning" %} + +### Paper har ikke valgmuligheter for de fleste patchene som løser feil i vanilja. + +Plazma jobber med å utvikle en konfigurasjon for å deaktivere slike feilrettinger for øyeblikket. + +Derfor er denne veiledningen fortsatt under utvikling og informasjonen kan endres når som helst. +{% endhint %} diff --git a/no/origin/plazma/adminstration/faq.md b/no/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..788f11d7d --- /dev/null +++ b/no/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Finn ut mer om vanlige spørsmål. +--- + +# ⁉️ Vanlige spørsmål + +{% hint style="info" %} + +### Kan du ikke finne svaret du leter etter? + +Spør fellesskapet via [offisiell Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### En melding vises, men kjøringen skjer ikke + +Hvis du ser `no main manifest attribute, in plazma-(versjon).jar` i konsollen,\ +filen du lastet ned er en utvikler-API-fil, du må laste ned **Reobf Paperweight** fra GitHub-siden. + +Se følgende side for mer informasjon. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### En advarsel vises hver gang serveren starter + +Plazma inneholder noen ustabile patcher og kan alltid ha en risiko for feilfunksjon, derfor viser den følgende advarselen hver gang serveren starter. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Denne advarselen kan deaktiveres ved å bruke [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1) systemegenskap. + +Se følgende side for mer informasjon. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tilgjengelig fra 1.20.1 diff --git a/no/origin/plazma/adminstration/getting-started/README.md b/no/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..d3a75f0d0 --- /dev/null +++ b/no/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Lær hvordan du oppretter en server med Plazma. +--- + +# 👟 Kom i gang + +For å bruke Plazma på en stabil måte, må systemet oppfylle følgende krav: + +| | Minimum | Anbefalt | +| :-----------: | ------: | -------: | +| Arkitektur | x64 | - | +| RAM | 8GB | 16GB | +| Lagringsplass | 1GB | 8GB | +| JRE | 17 | 21 | + +For en smidig konfigurasjonsfilredigering, er det også bra å installere en redaktør som [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JRE-installasjon + +Som navnet antyder, er Minecraft: **"Java"** Edition utviklet i Java, så for å kjøre den trenger du JRE[^1]. + +Siden Plazma er basert på Mojang Studios' offisielle serverplattform[^2], må du også installere JRE for å bruke Plazma. + +### 1.1 Kontroller om JRE er installert + +For å sjekke om JRE er installert på systemet, skriv inn [`cmd /k java --version`](#user-content-fn-4)[^4] i Kjør-vinduet og kjør det. + +Hvis du ser følgende utdata, hopp til [trinn 2](setup.md#id-2). + +{% code title="Riktig utdata" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Hvis du ikke ser det ovennevnte, eller ser noe som nedenfor, betyr det at JRE ikke er installert eller er for gammel, og du må utføre [trinn 1.2](setup.md#id-1.2). + +{% code title="JRE er ikke installert" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE er for gammel" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Installer JRE + +I denne veiledningen bruker vi Azul Zulu som en av JRE-variantene[^5]. + +Etter at du har installert det, utfør [trinn 1.1](setup.md#id-1.1) på nytt for å bekrefte at installasjonen var vellykket. + +{% tabs %} +{% tab title="Windows" %} + +1. Først laster du ned **JDK 21** fra [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) i `.msi`-format. +2. Kjør den nedlastede installasjonsveiviseren og klikk `Next`. +3. Aktiver `Set JAVA_HOME variable` fra menyen som vises midt på venstre side av vinduet, og klikk deretter `Next`. +4. Trykk på `Install` for å fullføre JRE-installasjonen. + {% endtab %} + +{% tab title="macOS" %} +Last ned **JDK 21** som en `.dmg`-installasjonsveiviser fra [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu), og kjør JRE-installasjonen. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Først legger du til Azul Zulu-repositoriet i APT ved å kjøre følgende kommando i terminalen. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Deretter installerer du JRE ved å kjøre følgende kommando i terminalen. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Du kan installere JRE ved å kjøre følgende kommando. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma nedlasting + +Plazma tilbyr forskjellige typer kjørbare filer. + +{% hint style="warning" %} + +### I de fleste tilfeller brukes `Reobf Paperclip`. + +Nedenfor informasjonen er for utviklere eller de som er interessert i egenskapene til hver type.\ +Hvis du er en vanlig bruker, kan du hoppe til [trinn 3](setup.md#id-3) uten problemer. +{% endhint %} + +
+ +Les mer + +Navnet på kjørefilen er `plazma-(versjonsbehandler)-1.20.4-R0.1-SNAPSHOT-(mappingtype).jar`. + +- **Mappingtype**\ + Mapping er en slags veikart som knytter Minecrafts faktiske kode til obfuskert kode. + - **Reobf**\ + Reobfuscation, også kjent som Spigot-mapping, brukes i de fleste NMS-plug-ins.\ + Det vil bli avsluttet fra 1.20.5. + - **Mojmap**\ + Mojang-mapping, Vanilla Minecraft-mapping. +- **Versjonsbehandler**\ + En versjonsbehandler er en launcher for serveren som trengs for å kjøre serveren og patche serverfiler. + - **Paperclip**\ + Utviklet av PaperMC-teamet for Paper og andre avledede plattformer, laster ned biblioteker og bruker patcher på serveren. + - **Bundler**\ + Vanilla Minecraft-versjonsbehandler. + +
+ +*** + +## 3. Opprettelse av startskript + +For enkel oppstart og automatisert omstart av serveren med Plazma, må du lage et [startskript](#user-content-fn-6)[^6]. + +Du kan generere et startskript via [Flags.sh](https://flags.sh). Når du har oppgitt [minnebruken til Plazma](#user-content-fn-8)[^8], vil kommandoen optimaliseres automatisk. + +Du kan laste ned startskriptet ved å klikke på nedlastingsknappen nederst til venstre.\ +**Sjekk om det nedlastede startskriptet samsvarer med operativsystemet ditt.** + +*** + +## 4. Filopprydding + +Flytt det nedlastede startskriptet og Plazma til en ny mappe. + +{% hint style="warning" %} + +### Mappen må ikke inneholde mellomrom og må være på engelsk. + +Ellers kan Plazma eller JRE kanskje ikke fungere riktig. +{% endhint %} + +Kjør startskriptet nå. For Windows, du må velge **Tillat** i brannmurtilgangsvinduet. + +*** + +## 5. EULA-samtykke + +Når du kjører startskriptet, opprettes en `eula.txt`-fil i mappen. + +EULA[^9] er en lisensavtale du må godta for å bruke tjenestene til [Mojang Studios](#user-content-fn-10)[^10]. + +Hvis du ikke godtar EULA-en, kan du ikke starte serveren, og brudd på EULA-en kan føre til sanksjoner som suspensjon av kontoen, osv. [Les mer.](#user-content-fn-11)[^11] + +Hvis du godtar EULA-en, endre `eula=false` til `eula=true` i `eula.txt`-filen og lagre endringene. + +*** + +## 6. Tillat ekstern tilkobling (Windows) + +Moderne operativsystemer blokkerer som standard ekstern tilgang for å forhindre farlige tilnærminger via brannmur og rutere. + +For Windows, siden du har tillatt det i [trinn 3](setup.md#id-3), trenger du bare å konfigurere portvideresending. + +{% hint style="info" %} + +### Denne veiledningen antar at du bruker Windows-operativsystemet og har en ruter som støtter [**UPnP**](#user-content-fn-12)[^12]. + +Hvis ruteren ikke støtter UPnP, må du søke etter informasjon om konfigurering for ulike rutere. + +Alternativt kan du bruke [Ngrok](https://ngrok.com/) for å opprette en midlertidig adresse. +{% endhint %} + +{% hint style="warning" %} + +### For Linux eller macOS (og lignende UNIX-baserte operativsystemer) er konfigurasjonsmetodene for brannmurtjenester forskjellige, så du må søke etter informasjon selv. + +{% endhint %} + +### 6.1 Sjekk om portvideresending er nødvendig + +Skriv inn følgende i Kjør-vinduet og kjør det. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Hvis utdataen er `True`, er du ferdig her. Hvis den er `False`, må du konfigurere portvideresending. + +### 6.2 Koble til serveren + +{% tabs %} +{% tab title="Ekstern tilkobling" %} +Hvis du ikke trenger portvideresending, eller allerede har lykkes med portvideresending, kan du nå koble til serveren. + +Du kan finne adressen som brukes for å koble til serveren [her](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Prøv portvideresending med UPnP" %} +I `purpur.yml` i servermappen, aktiver `network.upnp-port-forwarding` til `true`. + +Deretter, når serveren startes på nytt, vil Plazma automatisk prøve å videresende porten. + +Nedenfor er betydningen av meldingene som vises på konsollen for å indikere om UPnP var vellykket, og de vises som `[UPnP] (melding)` på konsollen. + +| Melding | Betydning | +| ----------------------------------- | --------------------------------------------- | +| `Porten ble åpnet vellykket (port)` | Videresending av porten var vellykket. | +| `Porten (port) er allerede åpen` | En annen tjeneste bruker allerede den porten. | +| `Kunne ikke åpne porten (port)` | Videresending av porten mislyktes. | +| `Tjenesten er utilgjengelig` | Ruteren støtter ikke UPnP. | + +Når serveren er stoppet, lukker Plazma automatisk porten. +{% endtab %} + +{% tab title="Opprett midlertidig adresse med Ngrok" %} +Metoden med Ngrok er nyttig for kortsiktige tester, samarbeid eller spill med venner. + +1. Last ned ZIP-filen for `Windows (64-bit)` fra [Ngrok-nettsiden](https://ngrok.com/download). +2. Legg den nedlastede Ngrok-filen i servermappen. +3. Generer en godkjennelsestoken fra [Ngrok Dashboard](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Kjør kommandoen som vises i `Command Line` i servermappen. +5. Legg til `start /b ngrok tcp --region jp 25565` øverst i kjøreskriptet, og `taskkill /f /t /im ngrok.exe` nederst. +6. Fra meldingen som vises øverst i konsollen, vil `0.tcp.jp.ngrok.io:12345` være serverens adresse. +7. Du kan nå koble til serveren eksternt ved hjelp av denne adressen. + {% endtab %} + +{% tab title="Koble til lokalt" %} +Hvis du prøver å koble til serveren lokalt, kan du bruke `cmd /k ipconfig` i kjør-vinduet for å finne `IPv4-adressen` som vises. + +For eksempel, når du kjører kommandoen og får følgende utdata, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Du kan koble til serveren lokalt ved å bruke `192.168.3.7` som vises i IPv4-adressen her. + +Hvis serveren og spillet kjører på samme PC, kan du koble til med `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Utviklingssteg + +Når serveren er startet vellykket og fungerer som den skal, er det på tide å tilpasse serveren. + +Lær hvordan du tilpasser serveren ved å følge guiden nedenfor. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java kjøretidsmiljø. + +[^2]: Plazma, basert på Paper, som igjen er basert på Spigot, som er basert på den offisielle serverplattformen. + +[^3]: Windows-tast + R + +[^4]: For Linux, bruk `java --version` i terminalen. + +[^5]: JRE er en av mange åpen kildekodeprosjekter, som Minecraft-serverplattformen. + +[^6]: Det er vanligvis kjent som en **launcher**. + +[^7]: Hvis du aktiverer "Auto-restart", vil serveren starte på nytt automatisk. Du kan avslutte ved å trykke `Control + C`. + +[^8]: Det anbefales ikke å overskride halvparten av systemets minnekapasitet. + + For eksempel, hvis systemets totale minnekapasitet er 8GB, bør du ikke sette det høyere enn 4GB. + +[^9]: End-User License Agreement, sluttbrukerlisensavtale. Se [Minecrafts nettsted](https://www.minecraft.net/ko-kr/usage-guidelines) for mer informasjon. + +[^10]: Microsoft Corporation. + +[^11]: I henhold til lov om fremme av spillindustrien i Korea, paragraf 32, punkt 9, kan du saksøke **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur inkludert i Plazma kommuniserer automatisk med ruteren via denne teknologien for å åpne porten bare når serveren kjører, så du trenger ikke å videresende porten manuelt. + +[^13]: Hvis du ikke har en konto, kan du registrere deg på Ngrok med Google- eller GitHub-kontoen din. diff --git a/no/origin/plazma/adminstration/getting-started/customization.md b/no/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..a36766fd2 --- /dev/null +++ b/no/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Lær hvordan du tilpasser serveren. +--- + +# 🎨 Tilpasning diff --git a/no/origin/plazma/adminstration/referanse/README.md b/no/origin/plazma/adminstration/referanse/README.md new file mode 100644 index 000000000..ce5251ac2 --- /dev/null +++ b/no/origin/plazma/adminstration/referanse/README.md @@ -0,0 +1,2 @@ +# 📜 Referanse + diff --git a/no/origin/plazma/adminstration/referanse/konfigurasjonsfiler/README.md b/no/origin/plazma/adminstration/referanse/konfigurasjonsfiler/README.md new file mode 100644 index 000000000..9fc7201df --- /dev/null +++ b/no/origin/plazma/adminstration/referanse/konfigurasjonsfiler/README.md @@ -0,0 +1,2 @@ +# 🎨 Konfigurasjonsfiler + diff --git a/no/origin/plazma/adminstration/reference/arguments.md b/no/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..adc2a4231 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,527 @@ +--- +description: Lær om startargumenter og systemegenskaper. +--- + +# 🎛️ Argumenter og egenskaper + +Startvariabler og systemegenskaper er verdier som legges til kommandoer som brukes til å kjøre Plazma,\ +og lar deg endre verdier som ikke kan endres etter at Plazma er kjørt. + +Avhengig av [hvor de legges til kommandoen,](#user-content-fn-1)\[^1] deles de inn i **startargumenter** og **systemegenskaper**. + +*** + +## Systemegenskaper + +Systemegenskaper legges til foran `-jar` og behandles av JVM før Plazma initialiseres. + +{% hint style="warning" %} + +### Endringer i systemegenskaper kan endre måten Plazma og JVM fungerer på, og kan ha stor innvirkning på spillet! + +Hvis du ikke er sikker på hva hver systemegenskap gjør, **ikke bruk dem under noen omstendigheter!** +{% endhint %} + +### Bruksanvisning + +Systemegenskaper legges til som Java-kommandoargumenter mellom `java` og `-jar`. + +For eksempel, hvis du vil bruke systemegenskapen `Plazma.dummyProperty`,\ +og du legger til den som følger, vil verdien `37` legges til som neste egenskap og Plazma vil initialiseres. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indikerer at dette argumentet ikke er innebygd i JVM, men er et tilpasset argument for Plazma, + +Hvis ingen verdi er angitt, blir verdien [`true` som standard.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight-baserte serverplattformer inkluderer punktum i egenskapsnavnet for å skille systemegenskaper for hver plattform. + +Noen terminaler som Windows Powershell kan ikke godta slike argumenter, så du må legge til `"` i begge ender av argumentet. [Les mer.](#user-content-fn-4)[^4] +{% endhint %} + +### Alle systemegenskaper + +#### `convertLegacySigns` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Oppdaterer utdaterte skiltformater. + +#### `debug.entities` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for entitetsinformasjon. + +#### `debug.rewriteForIDE` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer NMS-revisjonen for å tillate riktig lasting av debuginformasjon i IDE,\ +og remapper automatisk interne versjonsinformasjoner. + +#### `disable.watchdog` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer Spigots Watchdog-varslingssystem. + +#### `letMeReload` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer bekreftelsesmeldingen for `/reload`-kommandoen. + +{% hint style="danger" %} + +### `/reload`-kommandoen er veldig ustabil, så alle problemer som oppstår etter `/reload` er brukerens ansvar. + +Hvis du er pluginutvikler og må oppdatere pluginen din, bruk heller hotswapping i stedet for `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer plugins som bruker standard inndata/utdata-system. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Advarer når utdaterte formater oppdages i chatkomponenter. + +#### `Paper.bypassHostCheck` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer serverens vertskontroll ved tilkobling av spillere. + +#### `Paper.debugDynamicMissingKeys` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for manglende nøkler i NBT-objekter. + +#### `Paper.debugInvalidSkullProfiles` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for ugyldige hodeskalleprofiler. + +Logger alle feilaktige hodeskalleblokker i verden med posisjon. + +#### `Paper.disableChannelLimit` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer grensen på 128 pluginkanaler per spiller[^5]. + +#### `Paper.disableClassPrioritization` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer prioriteringssystemet for plugin-klasser. + +Nyttig ved problemer med pluginskygging. + +#### `Paper.disableFlushConsolidate` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer Netty-flush-konsolideringssystemet. + +#### `Paper.excessiveTELimit` + +- **Type**: `Heltall` +- **Standardverdi**: `750` + +Del opp enheter i flere pakker for overføring hvis antallet overstiger denne verdien. + +#### `Paper.filterThreshold` + +- **Type**: `Heltall` +- **Standardverdi**: `8192` + +Setter maksimal størrelse på pakker som serveren kan motta. + +#### `Paper.ignoreJavaVersion` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Deaktiverer Java-versjonskontrollen. + +{% hint style="danger" %} + +### Dette kan føre til at JVM prøver å aksessere ikke-eksisterende kode! + +Dette kan permanent skade filer i verden og ødelegge spillets mekanikk. + +Enhver skade forårsaket av dette er brukerens ansvar, og Plamza gir ingen støtte for det. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Type**: `Heltall` +- **Standardverdi**: `64` + +Setter begrensningen for navn på plugin-kanaler[^6]. + +#### `Paper.maxSignLength` + +- **Type**: `Heltall` +- **Standardverdi**: `80` + +Setter maksimal lengde for tekst på et skilt. + +#### `Paper.minPrecachedDatafixVersion` + +- **Type**: `Heltall` +- **Standardverdi**: `(verden versjon) + 1` + +Setter versjonen for informasjon om verden som skal initialiseres først. + +Nyttig for store mengder blokker som må oppdateres, men sjelden brukt ellers. + +#### `Paper.parseYamlCommentsByDefault` + +- **Type**: `Boolsk` +- **Standardverdi**: `True` + +Aktiverer behandling av kommentarer i YAML-filer som standard. + +#### `Paper.playerConnection.keepAlive` + +- **Type**: `Heltall` +- **Standardverdi**: `30` + +Kaster ut spillere som ikke sender data innen angitt tid (i sekunder). + +Vanligvis sender spillet[^7] kontinuerlig [hjerteslagssignaler](#user-content-fn-8)[^8] til serveren, så spillere blir ikke kastet ut,\ +men hvis spillet ikke svarer, antas det å ha krasjet og spilleren kastes ut. + +#### `Paper.skipServerPropertiesComments` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Ignorerer kommentarer i serverens egenskaper. + +#### `Paper.debug-sync-loads` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer debuglogger for synkrone chunk-operasjoner. + +#### `Paper.enable-sync-chunk-writes` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer Minecrafts [standard chunk-writing-system](#user-content-fn-10)[^10]. + +Dette lagrer hver chunk i en sekvensiell rekkefølge, noe som kan forårsake betydelig ytelsesnedgang. + +#### `Paper.explicit-flush` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Aktiverer eksplisitt tømming av nettverkskanaler. + +#### `Paper.strict-thread-checks` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Logger alltid feil som ikke oppstår i hovedtråden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Advarer hvis planlagte oppgaver har overdreven ventetid. + +#### `Paperclip.patchOnly` + +- **Type**: `Boolsk` +- **Standardverdi**: `False` + +Når du bruker standard kjørbare filer, vil den bare bruke patching uten å starte serveren. + +#### `Plazma.aggressiveOptimize` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` + +{% hint style="warning" %} + +### Denne egenskapen vil bli flyttet til startargumenter etter 1.20.5. + +{% endhint %} + +Øker konfigurasjonsoptimaliseringen som brukes ved oppstart. + +Når aktivert, vil serveren bli raskere og sikrere, men det kan blokkere noen funksjoner eller ha stor innvirkning på spillopplevelsen. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` + +Undertrykker advarsler[^11] som vises når Plazma initialiseres. + +### Egenskapen er ikke lenger i bruk + +Følgende systemegenskaper er ikke lenger i bruk. + +#### `timings.bypassMax` + +- **Type**: `Boolsk` +- **Standardverdi**: `false` +- **Ikke lenger i bruk**: Timings ble fjernet fra Plazma + +Bestemmer om verdier som sendes til Aikar's Timings API kan overskride maksimumsgrensen. + +Selv om dette er tilfelle, vil en hastighetsbegrensning bli pålagt hvis det ikke håndteres som et unntak i API-en. + +*** + +## Startargument + +Startargumentet legges inn etter `-jar *.jar` for å initialisere Plazma og behandles sammen med det. + +### Bruksanvisning + +Systemegenskaper legges inn som programkommandoargumenter etter `-jar *.jar`. + +For eksempel, hvis du vil bruke startargumentet `nogui`,\ +kan du skrive det på følgende måte for at Plazma skal behandle `nogui`-argumentet under initialiseringen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Fullstendig startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standardverdi**: `bukkit.yml` + +Setter navn og plassering for [Bukkit-konfigurasjonsfilen](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Standardverdi**: `commands.yml` + +Setter navn og plassering for [Bukkit-kommandokonfigurasjonsfilen](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Standardverdi**: `server.properties` + +Setter navn og plassering for [serveregenskapsfilen](../reference/configurations/property.md). + +#### `demo` + +Starter serveren i demomodus. + +#### `eraseCache` + +Fjerner gjenværende hurtigbufferfiler etter verdenoppgradering. + +#### `forceUpgrade` + +Tvinger oppgradering av verdenen, uavhengig av versjonen, [oppgradering](#user-content-fn-12)[^12]. + +#### `help` + +- **Alias**: `?` + +Skriver ut alle startargumentene og beskrivelsene for Plazma. + +#### `initSettings` + +Oppretter kun konfigurasjonsfilen og avslutter serveren. + +#### `jfrProfile` + +Aktiverer JFR-profilering. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standardverdi**: `(serveregenskap)` + +Setter maksimalt tillatte antall [spillere](#user-content-fn-14)[^14]. + +#### `nogui` + +Deaktiverer det grafiske grensesnittspanelet. + +#### `nojline` + +Deaktiver JLine og bruk vanlig konsoll. + +#### `online-mode` + +- **Alias**: `o` +- **Standardverdi**: `(serveregenskap)` + +Velg om spillerne skal valideres mot Mojangs autentiseringsserver. + +**Hvis du ikke bruker Velocity eller andre proxyer, kan du bli straffet for brudd på [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardverdi**: `paper.yml` + +{% hint style="warning" %} + +### Denne parameteren er ikke lenger i bruk etter 1.19.4. + +{% endhint %} + +Setter plasseringen av den utdaterte PaperSpigot konfigurasjonsfilen. + +Denne brukes til å flytte eksisterende konfigurasjon til en ny fil, og brukes ikke etter dette. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardverdi**: `config` + +Setter navn og plassering av mappen der [Paper konfigurasjonsfiler](../reference/configurations/paper/README.md) befinner seg. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Setter navn og plassering av mappen der [Plazma konfigurasjonsfiler](../reference/configurations/plazma/README.md) befinner seg. + +#### `plugins` + +- **Alias**: `p` +- **Standardverdi**: `plugins` + +Setter plasseringen av plugin-mappen. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardverdi**: `pufferfish.yml` + +Setter navn og plassering av [Pufferfish konfigurasjonsfilen](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardverdi**: `purpur.yml` + +Setter navn og plassering av [Purpur konfigurasjonsfilen](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Starter serveren i fullstendig vaniljemodus. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standardverdi**: `(serveregenskap)` + +Setter vertens navn eller [Internet Protocol](#user-content-fn-13) adresse for serveren. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standardverdi**: `(serveregenskap)` + +Setter porten for serveren. + +#### `server-name` + +- **Standardverdi**: `A Plazma Server` + +Setter navnet på serveren. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardverdi**: `spigot.yml` + +Setter navn og plassering av [Spigot konfigurasjonsfilen](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Viser Plazma-versjonen. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardverdi**: `(servermappen)` + +Setter plasseringen der verdensfilene lagres. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standardverdi**: `(serveregenskap)` + +Setter navnet på verdensfilen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Endrer argumentbehandling avhengig av tilleggslokasjonen. + +[^3]: For eksempel, hvis du vil aktivere `Plazma.iKnowWhatIAmDoing` til `true`, trenger du bare å skrive `-DPlazma.iKnowWhatIAmDoing` i stedet for `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: For eksempel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Event Detector. + +[^6]: Event Detector. + +[^7]: Client. + +[^8]: Signal som indikerer at serveren er korrekt tilkoblet, som et hjerteslag. + +[^9]: Med Purpurs AFK-kick-funksjon kan du kicke spillere som er inaktive. + +[^10]: Sync Chunk Write System. + +[^11]: `WARNING! Plazma kan forårsake uventede problemer, så sørg for å teste grundig før du bruker det på en offentlig server.` + +[^12]: I spillet fungerer `world optimization` på samme måte. + +[^13]: Internet Protocol, IP. + +[^14]: Administratorer på `nivå 2` eller høyere er unntatt. diff --git a/no/origin/plazma/adminstration/reference/commands.md b/no/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..a38ea4a7a --- /dev/null +++ b/no/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Finn ut om kommandoene som er tilgjengelige på Plazma. +--- + +# 🖥️ Kommandoer diff --git a/no/origin/plazma/adminstration/reference/configurations/bukkit.md b/no/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..94b84ce83 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i bukkit.yml betyr. +--- + +# 🪣 Bukkit diff --git a/no/origin/plazma/adminstration/reference/configurations/paper/README.md b/no/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..133f5a134 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut formålet med hver fil i konfigurasjonsmappen. +--- + +# 🛩️ Papir diff --git a/no/origin/plazma/adminstration/reference/configurations/paper/global.md b/no/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..2d877951e --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node av paper-global.yml betyr. +--- + +# 🛩️ Paper (global konfigurasjon) diff --git a/no/origin/plazma/adminstration/reference/configurations/paper/world.md b/no/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..166183508 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i paper-world.yml betyr. +--- + +# 🛩️ Paper (sammensetning av verden) diff --git a/no/origin/plazma/adminstration/reference/configurations/plazma/README.md b/no/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..30fbee7d9 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut formålet med hver fil i konfigurasjonsmappen. +--- + +# ✨ Plazma diff --git a/no/origin/plazma/adminstration/reference/configurations/plazma/global.md b/no/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..038a34ff1 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i plazma-global.yml betyr. +--- + +# ✨ Plazma (global konfigurasjon) diff --git a/no/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/no/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..1e9bf57de --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Verdensomspennende sammensetning diff --git a/no/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/no/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..ed722a16b --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i plazma-world.yml betyr. +--- + +# ✨ Plazma (sammensetning av verdener) diff --git a/no/origin/plazma/adminstration/reference/configurations/property.md b/no/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..51268ca1f --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i server.properties betyr. +--- + +# 🪨 Server.properties diff --git a/no/origin/plazma/adminstration/reference/configurations/pufferfish.md b/no/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..5413348c6 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i pufferfish.yml betyr. +--- + +# 🐡 Pufferfisk diff --git a/no/origin/plazma/adminstration/reference/configurations/purpur/README.md b/no/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..705a9f2c8 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i purpur.yml betyr. +--- + +# 🦑 Purpur diff --git a/no/origin/plazma/adminstration/reference/configurations/purpur/global.md b/no/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..1880fda0d --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i purpur.yml betyr. +--- + +# 🦑 Purpur (global sammensetning) diff --git a/no/origin/plazma/adminstration/reference/configurations/purpur/world.md b/no/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..7bc865623 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i purpur.yml betyr. +--- + +# 🦑 Purpur (verdenssammensetning) diff --git a/no/origin/plazma/adminstration/reference/configurations/spigot.md b/no/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..4586890ad --- /dev/null +++ b/no/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Finn ut hva hver node i spigot.yml betyr. +--- + +# 🚰 Spigot diff --git a/no/origin/plazma/adminstration/reference/permissions.md b/no/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..feea515f6 --- /dev/null +++ b/no/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Få informasjon om tillatelsene til Plazma. +--- + +# 🛡️ Tillatelser diff --git a/no/origin/plazma/developers.md b/no/origin/plazma/developers.md new file mode 100644 index 000000000..27baa7ba9 --- /dev/null +++ b/no/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Utvikle tredjepartsprosjekter med Plazma. +--- + +# ⚙️ Utviklerguide diff --git a/no/origin/thunderbolt/README.md b/no/origin/thunderbolt/README.md new file mode 100644 index 000000000..f5d5c38f4 --- /dev/null +++ b/no/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt er en Plazma-basert serverplattform som lar deg eksperimentere med patcher ved å dele dem inn i smaker og bruke dem direkte. +--- + +# 🌩️ Thunderbolt Brukerveiledning diff --git a/no/origin/volt/README.md b/no/origin/volt/README.md new file mode 100644 index 000000000..8cc65f47d --- /dev/null +++ b/no/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt er en åpen kildekode mal som lar deg utvikle din egen Paperweight serverplattform basert på Plazma. +--- + +# ⚡ Volt Utviklingsguide diff --git a/ns/origin/README.md b/ns/origin/README.md new file mode 100644 index 000000000..1bb385757 --- /dev/null +++ b/ns/origin/README.md @@ -0,0 +1,41 @@ +--- +description: 질문이 있다면 Discord 또는 GitHub 토론을 통해 질문해 주세요. +--- + +# 🏠 문서 포털에 오신 것을 환영합니다 + +{% hint style="info" %} + +**플라즈마의 문서는 현재 기계 번역된 상태입니다.** + +[![Translation Status](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) 에서 문서 번역에 참여하여 문서를 개선해 보세요. + +{% endhint %} + +### 플라즈마 사용 중 문제가 발생하면? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderbolt에 대해 관심이 있다면? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` 더 많은 Minecraft 관련 정보가 필요하다면? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ns/origin/SUMMARY.md b/ns/origin/SUMMARY.md new file mode 100644 index 000000000..9b7349315 --- /dev/null +++ b/ns/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# 표 목차 + +- [🏠 문서 포털에 오신 것을 환영합니다](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 디스코드](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma 사용 설명서](plazma/README.md) +- [❓ Plazma란?](plazma/about/README.md) + - [⬇️ 다운로드](plazma/about/downloads.md) + - [✅ 지원되는 버전](plazma/about/supported-versions.md) +- [⚒️ 호스트 관리 안내서](plazma/administration/README.md) + - [👟 시작하기](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 리퍼런스](plazma/administration/reference/README.md) + - [🖥️ 명령어](plazma/administration/reference/commands.md) + - [🛡️ 권한](plazma/administration/reference/permissions.md) + - [🎛️ 인수와 속성](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 속성](plazma/administration/reference/configurations/property.md) + - [🪣 버킷](plazma/administration/reference/configurations/bukkit.md) + - [🚰 스피곳](plazma/administration/reference/configurations/spigot.md) + - [🛩️ 페이퍼](plazma/administration/reference/configurations/paper/README.md) + - [🌏 전역 구성](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/paper/world.md) + - [🐡 퍼피시](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 퍼퍼](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 전역 구성](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/purpur/world.md) + - [✨ 플라즈마](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 전역 구성](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ 세계별 구성](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 심화](plazma/administration/expert/README.md) + - [🧹 최적화](plazma/administration/expert/optimize.md) + - [🔀 프록시](plazma/administration/expert/proxy.md) + - [↩️ 바닐라화](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray 차단](plazma/administration/expert/xray.md) + - [⚠️ 취약점과 해결 방법](plazma/administration/expert/fix-exploits.md) + - [⁉️ 자주 묻는 질문](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ 개발자 가이드](plazma/developers.md) + - [✏️ 기여하기](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt 사용 안내](thunderbolt/README.md) + +## Volt + +- [⚡ Volt 개발 가이드](volt/README.md) + +## 기타 + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ 다운로드 전체보기](plazma/about/downloads-all.md) diff --git a/ns/origin/miscellaneous/README.md b/ns/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ns/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ns/origin/plazma/README.md b/ns/origin/plazma/README.md new file mode 100644 index 000000000..80d6f62eb --- /dev/null +++ b/ns/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma는 Paper 기반의 실험적 최적화와 여러 게임 메커니즘 사용자화 기능을 추가한 Minecraft: Java Edition용 오픈 소스 서버 플랫폼입니다." +--- + +# ✨ Plazma 사용 설명서 + +## 👋 Plazma 설명서에 오신 것을 환영합니다 + +Plazma 사용 설명서에 방문하신 것을 환영합니다! + +{% hint style="info" %} + +**설명서를 통해 문제를 해결할 수 없나요?** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub 토론](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! + +{% endhint %} + +### Plazma 소개 + +> Plazma는 어떤 서버 플랫폼인지 알아보세요. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### 관리자를 위한 + +> Plazma를 활용하여 자신만의 서버를 만들어 보세요. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### 개발자를 위한 + +> Plazma를 활용하여 서드파티 프로젝트를 개발해 보세요. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ns/origin/plazma/about/README.md b/ns/origin/plazma/about/README.md new file mode 100644 index 000000000..fd1d39c2e --- /dev/null +++ b/ns/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Plazma는 어떤 서버 플랫폼인지 알아보세요. +--- + +# ❓ Plazma란? + +- **Plazma**는 [Andromeda](https://github.com/EarendelArchived/Andromeda)와 [Fusion](https://github.com/RuinedTechnologyUnify/Fusion)에서 장점만을 가져온 [Paper](https://github.com/PaperMC/Paper) 기반의 서버 플랫폼 입니다. +- 항상 높은 안정성과 강력한 성능, 빠른 업데이트, 방대한 기능을 제공하기 위하여 노력하고 있습니다. + +## 📋 Plazma의 목표 + +- 빠른 업데이트, 높은 안정성을 가진 서버 플랫폼이 되기 위해 노력하고 있습니다. +- 모드 플랫폼 못지 않은 방대한 기능과 강력한 성능을 제공하기 위해 노력하고 있습니다. +- 바닐라의 패치도 사용자화 할 수 있는 자유로운 플랫폼을 만들기 위해 노력하고 있습니다. + +## ⚙️ 주요 특징 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **가장 빠른 업데이트**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)는 Plazma의 포함 패치가 항상 최신으로 유지될 수 있도록 해서, Paper 기반 서버 플랫폼 중에서 가장 빠른 업데이트를 제공하고 있습니다. +6. **기본 구성 파일 최적화**\ + 기본 적용되는 구성 파일이 최적화되어 있어, 직접 구성 파일을 최적화 하지 않아도 됩니다. +7. **체계적으로 작동하는 멀티스레드**\ + 게임의 메커니즘과 관계 없는 시스템 메커니즘을 비동기화 하여, [지연 시간](#user-content-fn-4)[^4]을 줄여 서버를 최적화 합니다. +8. **불필요한 공간의 사용 차단**\ + 비슷한 값을 가진 데이터를 모두 하나로 합쳐 메모리 사용량을 줄입니다. + +## ✨ 활용 사례 + +- **복잡한 플러그인도 올바르게 처리하는 플랫폼**\ + 개발자 [IPECTER](https://github.com/IPECTER)의 서버에서 Plazma가 사용되고 있습니다.\ + NMS와 리플렉션으로 작동하는 자체 플러그인, 복잡하고 방대한 크기의 데이터팩이 굉장히 많이 적용되어 있음에도,\ + 100명대 이상의 플레이어를 성능 하락 없이 받아들이고 있습니다. +- **RPG 서버에서도 빠른 성능을 유지한 플랫폼**\ + 단일 클러스터에서 100명의 플레이어를 TPS 하락 없이 안정적으로 유지하였으며,\ + 4개의 클러스터에서 총 250명의 플레이어가 쾌적하게 플레이 할 수 있었습니다. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **플랫폼**\ + 많은 스트리머 분들의 시청자 참여용 버킷으로 선택받아 사용되고 있습니다. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ 다운로드 + +아래 페이지에서 Plazma를 다운로드 할 수 있습니다. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### 버전 지원에 대한 자세한 정보를 알고 싶다면? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot 플러그인 및 Paper, Pufferfish, Purpur 플러그인. + +[^2]: 이하 Microsoft Corporation. + +[^3]: 채팅 신고 시스템을 비활성화 하면 채팅이 온전히 서버에서만 처리되어 Mojang의 채팅 추적을 막을 수 있습니다. + +[^4]: 시스템 메커니즘이 작동하기 위해 잠시 동안 게임이 멈추는 시간. diff --git a/ns/origin/plazma/about/downloads-all.md b/ns/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..d3601a574 --- /dev/null +++ b/ns/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: 플라즈마 실행 파일 다운로드 전체보기 +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| 버전 | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: 모즘맵 페이퍼클립. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: 리옵프 페이퍼클립. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: 모즘맵 페이퍼클립. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ns/origin/plazma/about/downloads.md b/ns/origin/plazma/about/downloads.md new file mode 100644 index 000000000..03639ae38 --- /dev/null +++ b/ns/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: 지금 Plazma를 다운로드하여 직접 사용해보세요. +--- + +# ⬇️ 다운로드 + +#### 버전 지원에 대한 자세한 정보를 알고 싶다면? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**아래 다운로드는 일반 사용자용 실행 파일입니다.** + +개발자이고, 다른 형태의 파일이 필요하다면, 아래 페이지를 참고하세요. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
버전다운로드
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/ns/origin/plazma/about/patches-list.md b/ns/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..588d3f680 --- /dev/null +++ b/ns/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Plazma에 추가된 모든 기능에 대해 알아보세요. +--- + +# 📑 포함된 패치 diff --git a/ns/origin/plazma/about/supported-versions.md b/ns/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..8ff8107f3 --- /dev/null +++ b/ns/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Plazma에서 지원하는 Minecraft: Java Edition 버전을 알아보세요." +--- + +# ✅ 버전 지원 상태 + +{% hint style="info" %} + +**Plazma는 1.19.4 이후부터 개발되어, 1.19.4 미만의 버전은 개발되어 있지 않습니다.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/정보%20없음 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| 버전 | 안정성 및 기능 지원 | 빌드 상태 | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ns/origin/plazma/administration/README.md b/ns/origin/plazma/administration/README.md new file mode 100644 index 000000000..5510b688a --- /dev/null +++ b/ns/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 활용하여 자신만의 서버를 만들어 보세요. +--- + +# ⚒️ 문탱 서버 관리 안내 diff --git a/ns/origin/plazma/administration/diagnosis/README.md b/ns/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..3e75f0a05 --- /dev/null +++ b/ns/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: 문제가 발생했을 때 대처하는 방법을 알아보세요. +--- + +# 🧾 진단 diff --git a/ns/origin/plazma/administration/diagnosis/plugins.md b/ns/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..6cb941039 --- /dev/null +++ b/ns/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: 플러그인이 정상 작동하지 않을 때 해결하는 방법에 대해 알아보세요. +--- + +# 📜 플러그인 diff --git a/ns/origin/plazma/administration/expert/README.md b/ns/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..684276f31 --- /dev/null +++ b/ns/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 전문적으로 다루는 방법에 대해 알아보세요. +--- + +# 🎓 심화 diff --git a/ns/origin/plazma/administration/expert/fix-exploits.md b/ns/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..a9be920d8 --- /dev/null +++ b/ns/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 알려진 취약점과 해결하는 방법에 대해 알아보세요. +--- + +# ⚠️ 알려진 취약점과 해결 방법 diff --git a/ns/origin/plazma/administration/expert/optimize.md b/ns/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..fb072e183 --- /dev/null +++ b/ns/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 최적화 하는 방법을 알아보세요. +--- + +# 🧹 최적화 diff --git a/ns/origin/plazma/administration/expert/proxy.md b/ns/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..640dda86d --- /dev/null +++ b/ns/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: 프록시 플랫폼 "Velocity"를 안전하게 구성하는 방법에 대해 알아보세요. +--- + +# 🔀 프록시 diff --git a/ns/origin/plazma/administration/expert/vanillaize.md b/ns/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..7d29c5441 --- /dev/null +++ b/ns/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper와 바닐라의 패치를 복원하는 방법에 대해 알아보세요. +--- + +# ↩️ 바닐라화 + +{% hint style="warning" %} + +**Paper는 바닐라의 오류를 해결하는 대부분의 패치에 선택지를 추가하고 있지 않습니다.** + +현재 Plazma는 그러한 오류 해결을 구성으로 비활성화 할 수 있도록 개발하고 있습니다. + +따라서 아직 본 가이드는 작성중이며, 언제나 정보가 바뀔 가능성이 있습니다. + +{% endhint %} diff --git a/ns/origin/plazma/administration/expert/xray.md b/ns/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..2bd0fe2df --- /dev/null +++ b/ns/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray를 차단하는 여러 가지 내장된 방법에 대해 알아보세요. +--- + +# 🩻 X-Ray 차단 diff --git a/ns/origin/plazma/administration/faq.md b/ns/origin/plazma/administration/faq.md new file mode 100644 index 000000000..4030d7990 --- /dev/null +++ b/ns/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: 답변을 찾을 수 없는 질문을 살펴보세요. +--- + +# ⁉️ 자주 묻는 질문 + +{% hint style="info" %} + +**답변을 찾을 수 없나요?** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub 토론](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! + +{% endhint %} + +### Plazma가 시작되지 않습니다 + +콘솔에 `no main manifest attribute, in plazma-(version).jar` 라고 출력된 경우,\ +다운로드한 파일은 개발용 API 파일로, GitHub 페이지에서 **Reobf Paperweight**을 다운로드해야 합니다. + +자세히 알아보려면 다음 페이지를 참고 하세요. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### 서버가 시작될 때 마다 경고가 표시됩니다 + +Plazma는 일부 불안정한 패치가 포함되어 있으며, 항상 오작동할 가능성이 있으므로 다음과 같은 경고문을 서버가 시작될 때 출력하고 있습니다. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +해당 경고문은 [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] 시스템 속성을 사용하여 비활성화 할 수 있습니다. + +자세히 알아보려면 다음 페이지를 참고 하세요. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1부터 사용 가능 diff --git a/ns/origin/plazma/administration/getting-started/README.md b/ns/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..909662720 --- /dev/null +++ b/ns/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Plazma로 서버를 만드는 방법을 알아 보세요. +--- + +# 👟 시작하기 + +Plazma를 안정적으로 사용하기 위해선, 시스템이 다음과 같은 요구 사항을 충족해야 합니다. + +| | 최저 | 권장 | +| :--: | --- | ---- | +| 아키텍쳐 | x64 | - | +| RAM | 8GB | 16GB | +| 저장공간 | 1GB | 8GB | +| JDK | 17 | 21 | + +원할한 구성 파일 수정을 위하여, [Visual Studio Code](https://code.visualstudio.com/download)등의 편집기를 설치하는것도 좋습니다. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="올바른 출력" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전하기 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 설명서를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Microsoft Corporation. + +[^11]: 대한민국의 경우 게임산업진흥에 관한 법률 제32조 제1항 제9호에 따라 **한국 마이크로스프트 주식회사**에서 법적 고소를 할 수 있습니다. + +[^12]: Universal Plug & Play. Plazma에 포함된 Purpur가 이 기술을 통해 자동으로 라우터와 통신하여 서버가 실행 중일 때만 포트를 열기 때문에, 포트 포워딩을 직접 할 필요가 없습니다. + +[^13]: 계정이 없는 경우 Google 또는 GitHub 계정을 통해 Ngrok에 가입합니다. diff --git a/ns/origin/plazma/administration/getting-started/customization.md b/ns/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..80cd85132 --- /dev/null +++ b/ns/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: 서버를 사용자화하는 방법에 대해 알아보세요. +--- + +# 🎨 사용자화 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 +Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 +**사용자화**가 가능하다는 점이 가장 클 것입니다. + +아래는 Plazma를 사용자화하고 활용하는 여러 방법입니다. + +## 구성 수정 + +Plazma를 사용자화 하는 가장 기본적인 방법은 바로 구성을 수정하는 것입니다. + +Plazma는 게임의 메커니즘부터 몹의 속성 등 강력한 구성 설정을 제공하고 있습니다. + +Plazma의 구성에 대한 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## 플러그인 사용 + +{% hint style="success" %} + +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, +Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 +모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. +Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 +공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 +사이트에 업로드하기도 합니다. + +{% hint style="caution" %} + +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, +신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. + +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 + 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, + `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. + 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. + `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. + 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, +[리소스팩](#user-content-fn-1)[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="caution" %} + +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. + +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. +폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} + +**일부 [데이터팩](#user-content-fn-2)[^2]의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. + +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, +서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} + +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md) + +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. diff --git a/ns/origin/plazma/administration/getting-started/next-step.md b/ns/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..05fe61318 --- /dev/null +++ b/ns/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: 서버를 사용자화하는 방법에 대해 알아보세요. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +아래는 Plazma를 사용자화하고 활용하는 여러 방법입니다. + +## 구성 수정 + +Plazma를 사용자화 하는 가장 기본적인 방법은 바로 구성을 수정하는 것입니다. + +Plazma는 게임의 메커니즘부터 몹의 속성 등 강력한 구성 설정을 제공하고 있습니다. + +Plazma의 구성에 대한 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## 플러그인 사용 + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma를 사용하는 주요 이유이자 Plazma를 사용자화하는 가장 강력한 방법입니다. Plazma의 강력한 플러그인 생태계는 서버를 손 쉽게 사용자화 할 수 있게 합니다. + +플러그인을 찾고 다운로드 하는데에는 여러 가지 방법이 있습니다. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +플러그인을 다운로드하기 위해 사용되는 서비스에는 여러 가지가 있습니다. 그 중, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) 등의 서비스는 플러그인이 업로드 되기 전 심사를 거치며, 안전하지 않은 플러그인은 바로 처리하여 안전한 플러그인만 유통되도록 하고 있습니다. + +### 플러그인 적용하기 + +플러그인을 다운로드 했다면, 이제 플러그인을 적용해볼 차례입니다. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 다운로드한 파일을 서버 폴더의 `plugins` 폴더에 넣고 서버를 (재)시작합니다. +3. Plazma가 시작되면, 콘솔에 새로운 내용이 출력이 될 것입니다. 이는 Plazma가 플러그인을 정상적으로 로드했다는 의미입니다. +4. Plazma가 플러그인을 정상적으로 로드했더라도, 플러그인을 시작하지 못했을 수 있습니다. `/plugins` 명령어를 사용하면 현재 서버에 로드된 플러그인을 불러올 수 있습니다. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +만약 플러그인이 정상적으로 로드되지 않았다면, 아래 페이지에서 문제에 대한 해결 방법을 찾을 수 있습니다. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 데이터팩 사용 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +데이터팩을 사용하면 새로운 생물 군계와 도전 과제를 추가하는 등 게임 내부의 일부를 수정할 수 있습니다. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +일부 고장난 데이터팩은 월드를 손상시킬 수 있으며, 이는 돌이킬 수 없습니다. + +따라서, 데이터팩을 적용하기 전 월드를 백업하는것이 권장됩니다. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +데이터팩을 다운로드 했다면, 서버의 월드 폴더에 `datapacks` 폴더에 넣어 적용할 수 있습니다. 폴더가 없는 경우 폴더를 생성하여 추가하면 됩니다. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +이런 경우에 대비하여 서버를 **2번** 재시작하는 것을 권장합니다. +{% endhint %} + +데이터팩은 Minecraft의 버전이 업데이트 될 때 마다 쉽게 손상될 수 있습니다. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +적용된 데이터팩은 `/datapack list` 명령어를 통해 확인할 수 있습니다. + +*** + +## 최적화 + +Plazma에는 다양한 최적화 패치가 적용되어 있습니다. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 프록시 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +안전하고 올바른 프록시 설정에 대한 정보는 아래 페이지를 참고하세요. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 보안 + +Minecraft는 모드가 발달하여 온라인에서 [취약점 공격 엔진](#user-content-fn-3)[^3]을 쉽게 구할 수 있습니다. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 권한 설정 + +일부 플러그인의 관리자 명령어는 적절한 권한이 설정되지 않은 취약점이 존재할 수 있습니다. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray 차단 + +X-Ray는 기본 최적화 클라이언트에서 쉽게 사용할 수 있는 취약점 중 하나입니다. + +Plazma에는 X-Ray를 차단할 수 있는 구성이 기본 제공됩니다. + +X-Ray 차단 방법과 설명은 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 화이트리스트 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +허용된 플레이어를 확인하려면 `/whitelist query`를 사용합니다. + +*** + +[^1]: 또는 Minecraft: Bedrock Edition의 애드온. + +[^2]: 생물 군계 추가 등. + +[^3]: 보통 "핵"으로 불립니다. + +[^4]: 구성이 최적화되지 않았거나, Plazma가 오래되었거나, 새로 발견된 취약점의 경우 차단되어 있지 않을 수 있습니다. + +[^5]: 플레이어가 서버에 접속할 때 Ngrok 프록시 서버를 통해 접속되며, 매 재시작마다 발급되는 Ngrok 주소는 달라집니다. diff --git a/ns/origin/plazma/administration/reference/README.md b/ns/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..bc03fe843 --- /dev/null +++ b/ns/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Plazma에서 기본 제공하는 사용자화 방법을 알아보세요. +--- + +# 📜 리퍼런스 + +Plazma에서는 여러 가지 사용자화 방법을 제공하고 있습니다. + +그 중, 아래 4가지 방법은 추가적인 작업 없이 바로 사용할 수 있는 사용자화 방법입니다. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub 토론](https://github.com/PlazmaMC/PlazmaBukkit/discussions)를 통해 커뮤니티에 질문해 보세요! +{% endhint %} + +*** + +## 🖥️ 명령어 + +> 명령어는 게임 내에서 정보를 수집하거나 플레이 환경을 사용자화 할 수 있게 합니다. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ 권한 + +> 권한은 플레이어가 상호 작용할 수 있는 범위를 지정합니다. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ 인수와 속성 + +> 인수와 속성은 Plazma의 작동에 전반적인 영향을 줍니다. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 구성 + +> 구성은 Plazma를 사용자화 하는 가장 기초적인 방법입니다. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ns/origin/plazma/administration/reference/arguments.md b/ns/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..19cead8a9 --- /dev/null +++ b/ns/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 인수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로, Plazma의 작동에 전반적인 영향을 줍니다. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **형태**: `Boolean` +- **기본값**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **형태**: `Boolean` +- **기본값**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **형태**: `Boolean` +- **기본값**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **형태**: `Boolean` +- **기본값**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **형태**: `Boolean` +- **기본값**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **형태**: `Boolean` +- **기본값**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **형태**: `Boolean` +- **기본값**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **형태**: `Boolean` +- **기본값**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **형태**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **형태**: `Boolean` +- **기본값**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **형태**: `Boolean` +- **기본값**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **형태**: `Boolean` +- **기본값**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **형태**: `Boolean` +- **기본값**: `false` + +Plazma 브랜딩을 비활성화 하고 바닐라 기본 서버 패비콘을 사용하도록 합니다. + +#### `Plazma.useVanillaConfiguration` + +- **형태**: `Boolean` +- **기본값**: `false` +- **긴림**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +이는 서버 안전 및 성능에 크게 영향을 줄 수 있습니다. + +해당 속성을 사용하여 발생하는 모든 문제는 서버 관리자에게 있습니다. +{% endhint %} + +초기 구성을 Mojang에서 제공하는 기본값으로 제공합니다. + +이는 Paper에서 적용한 모든 취약점 패치를 비활성화 합니다. + +취약점 패치는 Paper 구성 또는 Plazma 구성에서 다시 활성화 할 수 있습니다. + +#### `Plazma.vanillaize` + +- **형태**: `Boolean` +- **기본값**: `true` +- **긴림**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +초기 구성을 바닐라에 가깝게 설정합니다. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **형태**: `Boolean` +- **기본값**: `false` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **별칭**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **별칭**: `c` +- **기본값**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **기본값**: `(서버 속성)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **기본값**: `(서버 속성)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **기본값**: `(서버 속성)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **기본값**: `(서버 속성)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 출력합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **기본값**: `(서버 속성)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 덧붙여지는 위치에 따라 인수를 처리하는 위치가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정(활성화) 하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing` 만 입력해도 동일하게 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 이벤트 감지기. + +[^6]: 이벤트 감지기. + +[^7]: 클라이언트. + +[^8]: 심장 박동처럼 서버와 정상적으로 연결 되어 있음을 알리는 신호. + +[^9]: Purpur의 AFK 추방 기능을 사용하면 자리를 비운 플레이어도 추방할 수 있습니다. + +[^10]: 동기 청크 작성 체계, Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: 게임에서 `월드 최적화` 도 이와 같은 원리로 동작합니다. + +[^13]: `레벨 2` 이상의 관리자는 제외합니다. + +[^14]: Internet Protocol, IP. diff --git a/ns/origin/plazma/administration/reference/commands.md b/ns/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..afbc7b586 --- /dev/null +++ b/ns/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma에서 사용 가능한 명령어에 대해 알아보세요. +--- + +# 🖥️ 명령어 diff --git a/ns/origin/plazma/administration/reference/configurations/README.md b/ns/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..785a2dc01 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: 구성은 Plazma를 사용자화 하는 가장 기초적인 방법입니다. +--- + +# 🧾 구성 + +*** + +## 🪨 특성 + +> 특성은 Minecraft에서 제공하는 가장 기초적인 구성 파일입니다. 특성을 사용하면 게임의 기본적인 메커니즘을 변경할 수 있습니다. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit 구성 + +> Bukkit 구성은 Plazma에서 제공하는 가장 기초적인 구성 파일입니다. Bukkit 구성을 사용하면 Minecraft 서버의 기본적인 메커니즘을 변경할 수 있습니다. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot 구성 + +> Spigot 구성은 게임의 세부 메커니즘, 플레이어 처리, 명령어 등의 작동 및 메세지를 수정할 수 있게 합니다. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper 구성 + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish 구성은 Plazma의 월드와 엔티티의 처리를 변경할 수 있게 합니다. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur 구성 + +> Purpur 특성은 게임의 전반적인 기본 데이터를 수정할 수 있게 합니다. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma 구성 + +> Plazma 구성은 Plazma의 기능을 사용자화 할 수 있게 합니다. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ns/origin/plazma/administration/reference/configurations/bukkit.md b/ns/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..72ceb60ef --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪣 Bukkit diff --git a/ns/origin/plazma/administration/reference/configurations/paper/README.md b/ns/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..4d1b1fa77 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# 🛩️ 종이 diff --git a/ns/origin/plazma/administration/reference/configurations/paper/global.md b/ns/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..0437f9948 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/ns/origin/plazma/administration/reference/configurations/paper/world.md b/ns/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..58f54f8c0 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: paper-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 + +달마다별 diff --git a/ns/origin/plazma/administration/reference/configurations/plazma/README.md b/ns/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..9c77f6314 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# ✨ 플라즈마 diff --git a/ns/origin/plazma/administration/reference/configurations/plazma/global.md b/ns/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..d2edaeca4 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/ns/origin/plazma/administration/reference/configurations/plazma/world.md b/ns/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..833845b94 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/ns/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ns/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/ns/origin/plazma/administration/reference/configurations/property.md b/ns/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..1026fe311 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪨 Server.properties diff --git a/ns/origin/plazma/administration/reference/configurations/pufferfish.md b/ns/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04ffee13e --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 Pufferfish diff --git a/ns/origin/plazma/administration/reference/configurations/purpur/README.md b/ns/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd654c84c --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/ns/origin/plazma/administration/reference/configurations/purpur/global.md b/ns/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..fd93dd582 --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🌏 전역 구성 diff --git a/ns/origin/plazma/administration/reference/configurations/purpur/world.md b/ns/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..bf3c65ddc --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🏳️ 세계별 구성 diff --git a/ns/origin/plazma/administration/reference/configurations/spigot.md b/ns/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..fa0304fca --- /dev/null +++ b/ns/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🚰 스피곳 diff --git a/ns/origin/plazma/administration/reference/permissions.md b/ns/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..3da45eed1 --- /dev/null +++ b/ns/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Plazma의 권한에 대해 알아보세요. +--- + +# 🛡️ 권한 + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **기본 제공**: `세계 관리자` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.demo` + +- **기본 제공**: `세계 관리자` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ping` + +- **기본 제공**: `세계 관리자` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **기본 제공**: `세계 관리자` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **기본 제공**: `세계 관리자` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.restart` + +- **기본 제공**: `세계 관리자` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **기본 제공**: `세계 관리자` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **기본 제공**: `세계 관리자` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.timings` + +- **기본 제공**: `세계 관리자` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **기본 제공**: `세계 관리자` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **기본 제공**: `세계 관리자` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `paper.antixray.bypass` + +- **기본 제공**: `없음` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **기본 제공**: `없음` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **기본 제공**: `없음` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **기본 제공**: `없음` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **기본 제공**: `없음` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **기본 제공**: `없음` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **기본 제공**: `세계 관리자` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **기본 제공**: `없음` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **기본 제공**: `없음` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **기본 제공**: `없음` + +불사의 토템이 인벤토리에 있어도 작동하도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **기본 제공**: `없음` + +플레이어가 접속자수 제한을 무시하도록 허용합니다. + +#### `purpur.mending_shift_click` + +- **기본 제공**: `없음` + +플레이어가 `웅크리고 상호 작용`하면 들고 있는 아이템을 수선할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **기본 제공**: `없음` + +플레이어가 스포너를 설치할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **기본 제공**: `없음` + +플레이어가 네더 차원문을 사용했을 때 바로 순간이동 하도록 합니다. + +#### `purpur.sign.color` + +- **기본 제공**: `없음` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **기본 제공**: `없음` + +표지판에 난독화 코드`(&o)`를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **기본 제공**: `없음` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **기본 제공**: `없음` + +플레이어가 가위로 `상호 작용`하여 TNT 폭발을 막을 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### 제공 예정 권한 + +#### `plazma.bypass.ncr-require` + +- **기본 제공**: `없음` + +플레이어가 [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) 모드가 설치되어 있지 않아도 접속할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: 예: `ender_dragon` diff --git a/ns/origin/plazma/adminstration/README.md b/ns/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..5510b688a --- /dev/null +++ b/ns/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 활용하여 자신만의 서버를 만들어 보세요. +--- + +# ⚒️ 문탱 서버 관리 안내 diff --git a/ns/origin/plazma/adminstration/expert/README.md b/ns/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..684276f31 --- /dev/null +++ b/ns/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 전문적으로 다루는 방법에 대해 알아보세요. +--- + +# 🎓 심화 diff --git a/ns/origin/plazma/adminstration/expert/fix-exploits.md b/ns/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..a9be920d8 --- /dev/null +++ b/ns/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 알려진 취약점과 해결하는 방법에 대해 알아보세요. +--- + +# ⚠️ 알려진 취약점과 해결 방법 diff --git a/ns/origin/plazma/adminstration/expert/optimize.md b/ns/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..fb072e183 --- /dev/null +++ b/ns/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 최적화 하는 방법을 알아보세요. +--- + +# 🧹 최적화 diff --git a/ns/origin/plazma/adminstration/expert/vanillaize.md b/ns/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..73dab0249 --- /dev/null +++ b/ns/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper와 바닐라의 패치를 복원하는 방법에 대해 알아보세요. +--- + +# ↩️ 바닐라화 + +{% hint style="warning" %} + +### Paper는 바닐라의 오류를 해결하는 대부분의 패치에 선택지를 추가하고 있지 않습니다. + +현재 Plazma는 그러한 오류 해결을 구성으로 비활성화 할 수 있도록 개발하고 있습니다. + +따라서 아직 본 가이드는 작성중이며, 언제나 정보가 바뀔 가능성이 있습니다. +{% endhint %} diff --git a/ns/origin/plazma/adminstration/faq.md b/ns/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..ed3eeb275 --- /dev/null +++ b/ns/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: 답변을 찾을 수 없는 질문을 살펴보세요. +--- + +# ⁉️ 자주 묻는 질문 + +{% hint style="info" %} + +### 원하는 답변을 찾을 수 없나요? + +[공식 Discord 서버](https://discord.gg/MmfC52K8A8) 또는 [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)를 통해 커뮤니티에 질문해 보세요! +{% endhint %} + +### 메세지가 출력되면서 실행이 되지 않습니다 + +콘솔에 `no main manifest attribute, in plazma-(version).jar` 라고 출력된 경우,\ +다운로드한 파일은 개발용 API 파일로, GitHub 페이지에서 **Reobf Paperweight**을 다운로드해야 합니다. + +자세히 알아보려면 다음 페이지를 참고 하세요. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### 서버가 시작될 때 마다 경고가 표시됩니다 + +Plazma는 일부 불안정한 패치가 포함되어 있으며, 항상 오작동할 가능성이 있으므로 다음과 같은 경고문을 서버가 시작될 때 출력하고 있습니다. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +해당 경고문은 [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] 시스템 속성을 사용하여 비활성화 할 수 있습니다. + +자세히 알아보려면 다음 페이지를 참고 하세요. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1부터 사용 가능 diff --git a/ns/origin/plazma/adminstration/getting-started/README.md b/ns/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..6575fada8 --- /dev/null +++ b/ns/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Plazma로 서버를 만드는 방법을 알아 보세요. +--- + +# 👟 시작하기 + +Plazma를 안정적으로 사용하기 위해선, 시스템이 다음과 같은 요구 사항을 충족해야 합니다. + +| | 최저 | 권장 | +| :--: | --: | ---: | +| 아키텍쳐 | x64 | - | +| RAM | 8GB | 16GB | +| 저장공간 | 1GB | 8GB | +| JRE | 17 | 21 | + +원할한 구성 파일 수정을 위하여, [Visual Studio Code](https://code.visualstudio.com/download)등의 편집기를 설치하는것도 좋습니다. + +*** + +## 1. JRE 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JRE[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JRE를 설치해야 합니다. + +### 1.1 JRE 유무 확인 + +JRE가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](setup.md#id-2)로 건너뜁니다. + +{% code title="올바른 출력" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JRE가 없거나 너무 오래되었으므로, [1.2 단계](setup.md#id-1.2)를 수행해야 합니다. + +{% code title="JRE가 설치되어 있지 않음" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE가 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +본 가이드에서는 JRE의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](setup.md#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. 자세한 내용은 [Minecraft 홈페이지](https://www.minecraft.net/ko-kr/usage-guidelines)를 확인해 주세요. + +[^10]: Microsoft Corporation. + +[^11]: 대한민국의 경우 게임산업진흥에 관한 법률 제32조 제1항 제9호에 따라 **한국 마이크로스프트 주식회사**에서 법적 고소를 할 수 있습니다. + +[^12]: Universal Plug & Play. Plazma에 포함된 Purpur가 이 기술을 통해 자동으로 라우터와 통신하여 서버가 실행 중일 때만 포트를 열기 때문에, 포트 포워딩을 직접 할 필요가 없습니다. + +[^13]: 계정이 없는 경우 Google 또는 GitHub 계정을 통해 Ngrok에 가입합니다. diff --git a/ns/origin/plazma/adminstration/getting-started/customization.md b/ns/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..ffcd322f7 --- /dev/null +++ b/ns/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: 서버를 사용자화하는 방법에 대해 알아보세요. +--- + +# 🎨 사용자화 diff --git a/ns/origin/plazma/adminstration/reference/arguments.md b/ns/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..f91a6108c --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **형태**: `Boolean` +- **기본값**: `False` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **형태**: `Boolean` +- **기본값**: `False` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **형태**: `Boolean` +- **기본값**: `False` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **형태**: `Boolean` +- **기본값**: `False` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **형태**: `Boolean` +- **기본값**: `False` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **형태**: `Boolean` +- **기본값**: `False` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **형태**: `Boolean` +- **기본값**: `False` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **형태**: `Boolean` +- **기본값**: `False` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **형태**: `Boolean` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **형태**: `Boolean` +- **기본값**: `False` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **형태**: `Boolean` +- **기본값**: `False` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **형태**: `Boolean` +- **기본값**: `False` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `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` + +{% hint style="warning" %} + +### 해당 속성은 1.20.5 이후 시작 인수로 이동 될 예정입니다. + +{% endhint %} + +처음 시작시 적용되는 구성 최적화를 더 엄격하게 적용합니다. + +활성화 하면 서버가 더욱 빨라지고 안전해지지만, 일부 기믹을 차단하거나 게임 플레이에 큰 영향을 줄 수 있습니다. + +#### `Plazma.iKnowWhatIAmDoing` + +- **형태**: `Boolean` +- **기본값**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **형태**: `Boolean` +- **기본값**: `false` +- **사용 중단됨**: Timings가 Plazma에서 전면 제거된 후 부터 + +Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다. + +이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다. + +*** + +## 시작 인수 + +시작 인수는 `-jar *.jar` 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다. + +### 사용 방법 + +시스템 속성은 `-jar *.jar` 뒤에 프로그램 명령 인수로써 입력됩니다. + +예를 들어, `nogui` 시작 인수를 적용하려 하는 경우,\ +다음과 같이 입력하면 Plazma가 초기화 중에 `nogui` 인수를 처리하게 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 전체 시작 인수 + +#### `bukkit-settings` + +- **별칭**: `b` +- **기본값**: `bukkit.yml` + +[Bukkit 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **별칭**: `c` +- **기본값**: `commands.yml` + +[Bukkit 명령어 구성 파일](../reference/configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **별칭**: `c` +- **기본값**: `server.properties` + +[서버 속성](../reference/configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +데모 월드로 서버를 시작합니다. + +#### `eraseCache` + +월드 업그레이드 후 남은 캐시 파일을 제거합니다. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 [업그레이드](#user-content-fn-12)[^12] 합니다. + +#### `help` + +- **별칭**: `?` + +Plazma의 전체 시작 인수와 설명을 출력합니다. + +#### `initSettings` + +구성 파일만 생성하고 서버를 종료합니다. + +#### `jfrProfile` + +JFR 프로필링을 활성화 합니다. + +#### `max-players` + +- **별칭**: `s`, `size` +- **기본값**: `(서버 속성)` + +허용되는 최대 [플레이어](#user-content-fn-14)[^14] 수를 설정합니다. + +#### `nogui` + +그래픽 인터페이스 패널을 비활성화 합니다. + +#### `nojline` + +JLine을 비활성화 하고 바닐라 콘솔을 사용합니다. + +#### `online-mode` + +- **별칭**: `o` +- **기본값**: `(서버 속성)` + +Mojang 인증 서버로 플레이어를 검증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우 [EULA](../getting-started/README.md#id-5) 위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용이 중지되었습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **기본값**: `(서버 속성)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-13)[^13] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **기본값**: `(서버 속성)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](../reference/configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 출력합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **기본값**: `(서버 속성)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 덧붙여지는 위치에 따라 인수를 처리하는 위치가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정(활성화) 하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing` 만 입력해도 동일하게 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 이벤트 감지기. + +[^6]: 이벤트 감지기. + +[^7]: 클라이언트. + +[^8]: 심장 박동처럼 서버와 정상적으로 연결 되어 있음을 알리는 신호. + +[^9]: Purpur의 AFK 추방 기능을 사용하면 자리를 비운 플레이어도 추방할 수 있습니다. + +[^10]: 동기 청크 작성 체계, Sync Chunk Write System. + +[^11]: `WARNING! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server.` + +[^12]: 게임에서 `월드 최적화` 도 이와 같은 원리로 동작합니다. + +[^13]: Internet Protocol, IP. + +[^14]: `레벨 2` 이상의 관리자는 제외합니다. diff --git a/ns/origin/plazma/adminstration/reference/commands.md b/ns/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..afbc7b586 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma에서 사용 가능한 명령어에 대해 알아보세요. +--- + +# 🖥️ 명령어 diff --git a/ns/origin/plazma/adminstration/reference/configurations/bukkit.md b/ns/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..72ceb60ef --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪣 Bukkit diff --git a/ns/origin/plazma/adminstration/reference/configurations/paper/README.md b/ns/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..4d1b1fa77 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# 🛩️ 종이 diff --git a/ns/origin/plazma/adminstration/reference/configurations/paper/global.md b/ns/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..064845827 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🛩️ Paper (전역 구성) diff --git a/ns/origin/plazma/adminstration/reference/configurations/paper/world.md b/ns/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..9ffa74bdb --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: paper-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🛩️ 종이 (Paper) (월드별 구성) diff --git a/ns/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ns/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..9c77f6314 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config 폴더의 각 파일의 용도가 무엇인지 알아보세요. +--- + +# ✨ 플라즈마 diff --git a/ns/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ns/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a836b1569 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (전역 구성) diff --git a/ns/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ns/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..dfffd5a03 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ 달별 배치 diff --git a/ns/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ns/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..747468adc --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# ✨ Plazma (월드별 구성) diff --git a/ns/origin/plazma/adminstration/reference/configurations/property.md b/ns/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..1026fe311 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🪨 Server.properties diff --git a/ns/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ns/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04ffee13e --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🐡 Pufferfish diff --git a/ns/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ns/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..dd654c84c --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur diff --git a/ns/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ns/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..5b03ae8d1 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur (전역 구성) diff --git a/ns/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ns/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..2e9e29340 --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🦑 Purpur (월드별 구성) diff --git a/ns/origin/plazma/adminstration/reference/configurations/spigot.md b/ns/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..fa0304fca --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml의 각 노드가 무엇을 의미하는지 알아보세요. +--- + +# 🚰 스피곳 diff --git a/ns/origin/plazma/adminstration/reference/permissions.md b/ns/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..a879bbdcb --- /dev/null +++ b/ns/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Plazma의 권한에 대해 알아보세요. +--- + +# 🛡️ 권한 diff --git a/ns/origin/plazma/developers.md b/ns/origin/plazma/developers.md new file mode 100644 index 000000000..aeae587d1 --- /dev/null +++ b/ns/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Plazma를 활용하여 서드파티 프로젝트를 개발해 보세요. +--- + +# ⚙️ 모운태니언 개발자 안내 diff --git a/ns/origin/thunderbolt/README.md b/ns/origin/thunderbolt/README.md new file mode 100644 index 000000000..8c462bce4 --- /dev/null +++ b/ns/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 패치를 Flavor로 구분하여 직접 사용해볼 수 있도록 하는 Plazma 기반 서버 플랫폼입니다. +--- + +# 🌩️ Thunderbolt 사용 안내서 diff --git a/ns/origin/volt/README.md b/ns/origin/volt/README.md new file mode 100644 index 000000000..8fdddb2f7 --- /dev/null +++ b/ns/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Paperweight 서버 플랫폼을 개발할 수 있는 오픈 소스 템플릿입니다. +--- + +# ⚡ Volt 개발 안내서 diff --git a/pl/origin/README.md b/pl/origin/README.md new file mode 100644 index 000000000..30764108c --- /dev/null +++ b/pl/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Jeśli masz pytania, zadaj je za pośrednictwem Discorda lub dyskusji na GitHubie. +--- + +# 🏠 Witaj w portalu dokumentacyjnym + +{% hint style="info" %} + +**Dokumentacja Plazmy jest obecnie w stanie przetłumaczonym maszynowo.** + +[![Stan tłumaczenia](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Przejdź do [https://translate.plazmamc.org/](https://translate.plazmamc.org/) i uczestnicz w tłumaczeniu dokumentacji, aby ją ulepszyć. + +{% endhint %} + +### Jeśli wystąpił problem podczas korzystania z Plazmy, co zrobić? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Jeśli interesujesz się Thunderboltem, + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Jeśli chcesz stworzyć własną platformę serwerową za pomocą Volta, + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Jeśli potrzebujesz więcej informacji związanych z Minecraftem, + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/pl/origin/SUMMARY.md b/pl/origin/SUMMARY.md new file mode 100644 index 000000000..c2684927d --- /dev/null +++ b/pl/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Spis treści + +- [🏠 Witaj w portalu dokumentacji](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Dokumentacja użycia Plazmy](plazma/README.md) +- [❓ Czym jest Plazma?](plazma/about/README.md) + - [⬇️ Pobierz](plazma/about/downloads.md) + - [✅ Status obsługi wersji](plazma/about/supported-versions.md) +- [⚒️ Przewodnik po zarządzaniu serwerem](plazma/administration/README.md) + - [👟 Rozpoczęcie](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Odwołanie](plazma/administration/reference/README.md) + - [🖥️ Komendy](plazma/administration/reference/commands.md) + - [🛡️ Uprawnienia](plazma/administration/reference/permissions.md) + - [🎛️ Argumenty i Właściwości](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Właściwość](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globalna konfiguracja](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfiguracje według światów](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globalna konfiguracja](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfiguracje według światów](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globalna konfiguracja](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfiguracje według światów](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Zaawansowane](plazma/administration/expert/README.md) + - [🧹 Optymalizacja](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 Blokada X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Luki i ich naprawa](plazma/administration/expert/fix-exploits.md) + - [⁉️ Najczęściej zadawane pytania](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Przewodnik dla deweloperów](plazma/developers.md) + - [✏️ Współtworzenie](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Dokumentacja Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Przewodnik po użyciu Thunderbolta](thunderbolt/README.md) + +## Volt + +- [⚡ Przewodnik rozwoju Volta](volt/README.md) + +## Różne + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Pobierz wszystko](plazma/about/downloads-all.md) diff --git a/pl/origin/miscellaneous/README.md b/pl/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/pl/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/pl/origin/plazma/README.md b/pl/origin/plazma/README.md new file mode 100644 index 000000000..3ea6dca3a --- /dev/null +++ b/pl/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma to otwarta platforma serwerowa dla Minecraft: Java Edition, która dodaje eksperymentalną optymalizację opartą na papierze i możliwość dostosowania wielu mechanizmów gry." +--- + +# ✨ Dokumentacja użytkowania Plazmy + +## 👋 Witaj w Dokumentacji Plazmy + +Witaj w Dokumentacji Plazmy! + +{% hint style="info" %} + +**Czy nie można rozwiązać problemu za pomocą instrukcji?** + +Zadaj społeczności pytanie za pośrednictwem [oficjalnego serwera Discord](https://discord.gg/MmfC52K8A8) lub [Dyskusji na GitHubie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### O Plazmie + +> Dowiedz się, czym jest Plazma jako platforma serwerowa. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Dla Administratorów + +> Stwórz własny serwer przy użyciu Plazmy. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Dla Deweloperów + +> Rozwijaj projekty zewnętrzne przy użyciu Plazmy. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/pl/origin/plazma/about/README.md b/pl/origin/plazma/about/README.md new file mode 100644 index 000000000..0f0d9200a --- /dev/null +++ b/pl/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Dowiedz się, czym jest Plazma jako platforma serwerowa. +--- + +# ❓ Czym jest Plazma? + +- **Plazma** to platforma serwerowa oparta na [Paper](https://github.com/PaperMC/Paper), która czerpie tylko zalety z [Andromeda](https://github.com/EarendelArchived/Andromeda) i [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Staramy się zapewnić zawsze wysoką stabilność, potężne osiągi, szybkie aktualizacje i bogate funkcje. + +## 📋 Cele Plazmy + +- Dążymy do stworzenia platformy serwerowej charakteryzującej się szybkimi aktualizacjami i wysoką stabilnością. +- Staramy się zapewnić bogate funkcje i potężne osiągi, nie ustępując platformie modów. +- Dążymy do stworzenia platformy, która pozwala na swobodne dostosowanie łatki Vanilla. + +## ⚙️ Główne cechy + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Najszybsze aktualizacje**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) zapewnia, że łaty w Plazmie zawsze pozostają aktualne, oferując najbardziej dynamiczne aktualizacje wśród platform serwerowych opartych na Paper. +6. **Optymalizacja podstawowych plików konfiguracyjnych**\ + Domyślne pliki konfiguracyjne są zoptymalizowane, co pozwala uniknąć konieczności ręcznej optymalizacji. +7. **Systematyczna wielowątkowość**\ + Asynchronizacja mechanizmów systemowych niezwiązanych z mechaniką gry pomaga zmniejszyć opóźnienia i zoptymalizować serwer. +8. **Blokuje niepotrzebne użycie pamięci**\ + Łączy dane o podobnej wartości w jedną, zmniejszając zużycie pamięci. + +## ✨ Przykłady użycia + +- **Platforma obsługująca nawet skomplikowane wtyczki**\ + Plazma jest używana na serwerze dewelopera [IPECTER](https://github.com/IPECTER).\ + Działa bez problemu nawet z własnymi wtyczkami opartymi na NMS i refleksji, mimo zastosowania skomplikowanych i obszernych pakietów danych, + bez obniżania wydajności przy przyjęciu ponad 100 graczy. +- **Platforma zapewniająca szybką wydajność nawet na serwerach RPG**\ + Stabilnie utrzymała 100 graczy na jednym klastrze bez spadku TPS, + Na 4 klastrach łącznie 250 graczy mogło komfortowo grać. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platforma wybrana przez wielu streamerów**\ + Jest używana jako wiadro dla uczestnictwa widzów wielu streamerów. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Pobierz + +Możesz pobrać Plazmę ze strony poniżej. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Chcesz dowiedzieć się więcej o obsługiwanych wersjach? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Wtyczki Bukkit, CraftBukkit, Spigot oraz wtyczki Paper, Pufferfish, Purpur. + +[^2]: Przedsiębiorstwo Microsoft Corporation. + +[^3]: Wyłączając system zgłaszania czatu, komunikacja w czacie jest przetwarzana tylko na serwerze, co pozwala uniknąć śledzenia czatu przez Mojang. + +[^4]: Czas, w którym gra jest wstrzymywana, aby działał mechanizm systemowy. diff --git a/pl/origin/plazma/about/downloads-all.md b/pl/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..a3f373263 --- /dev/null +++ b/pl/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Pobierz pełny widok pliku wykonawczego Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Wersja | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/pl/origin/plazma/about/downloads.md b/pl/origin/plazma/about/downloads.md new file mode 100644 index 000000000..ae6f488c7 --- /dev/null +++ b/pl/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Pobierz Plazma teraz i wypróbuj go samodzielnie. +--- + +# ⬇️ Pobierz + +#### Chcesz dowiedzieć się więcej o obsługiwanych wersjach? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Poniższe pobieranie jest plikiem wykonywalnym dla użytkowników zwykłych.** + +Jeśli jesteś deweloperem i potrzebujesz innego rodzaju pliku, sprawdź poniższą stronę. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WersjaPobierz
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + pobierz +
1.20.1 + Pobierz +
1.19.4 + Pobierz +
+ +*** diff --git a/pl/origin/plazma/about/patches-list.md b/pl/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..8247206ed --- /dev/null +++ b/pl/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się więcej o wszystkich dodanych funkcjach w Plazmie. +--- + +# 📑 Zawarte łaty diff --git a/pl/origin/plazma/about/supported-versions.md b/pl/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..c3e3957fc --- /dev/null +++ b/pl/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Sprawdź obsługiwane wersje Minecraft: Java Edition przez Plazma." +--- + +# ✅ Stan obsługi wersji + +{% hint style="info" %} + +**Plazma została rozwijana od wersji 1.19.4, wersje poniżej 1.19.4 nie są już rozwijane.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Oczekiwanie%20na%20wydanie +[idv]: +[atv]: https://badge.plazmamc.org/2/Wsparcie +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Brak%20informacji +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normalne +[100]: https://badge.plazmamc.org/percent/100 + +![Oczekiwanie na wydanie][wtr] ![W trakcie rozwoju][idv] ![Wsparcie][atv] ![Wsparcie funkcji wstrzymane][fse] ![Wsparcie zakończone][eol] + +| Wersja | Stabilność i wsparcie funkcji | Stan budowy | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Stan kompilacji](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Status kompilacji](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Status kompilacji](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/pl/origin/plazma/administration/README.md b/pl/origin/plazma/administration/README.md new file mode 100644 index 000000000..0d3b1c882 --- /dev/null +++ b/pl/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Stwórz własny serwer przy użyciu Plazmy. +--- + +# ⚒️ Przewodnik po zarządzaniu serwerem diff --git a/pl/origin/plazma/administration/diagnosis/README.md b/pl/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..b4a0abacd --- /dev/null +++ b/pl/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, jak radzić sobie w przypadku wystąpienia problemu. +--- + +# 🧾 진단 diff --git a/pl/origin/plazma/administration/diagnosis/plugins.md b/pl/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..de9c80b36 --- /dev/null +++ b/pl/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się, jak naprawić działanie wtyczki, gdy nie działa poprawnie. +--- + +# 📜 플러그인 diff --git a/pl/origin/plazma/administration/expert/README.md b/pl/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..ca32298ba --- /dev/null +++ b/pl/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się więcej o profesjonalnym podejściu do obsługi Plazmy. +--- + +# 🎓 Zaawansowane diff --git a/pl/origin/plazma/administration/expert/fix-exploits.md b/pl/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..46b5e57cc --- /dev/null +++ b/pl/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź znane podatności i sposoby ich rozwiązywania. +--- + +# ⚠️ Znane podatności i sposoby ich rozwiązywania diff --git a/pl/origin/plazma/administration/expert/optimize.md b/pl/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..826d4760b --- /dev/null +++ b/pl/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się, jak zoptymalizować Plazmę. +--- + +# 🧹 Optymalizacja diff --git a/pl/origin/plazma/administration/expert/proxy.md b/pl/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..4db139a16 --- /dev/null +++ b/pl/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się, jak bezpiecznie skonfigurować platformę proxy „Velocity”. +--- + +# 🔀 Proxy diff --git a/pl/origin/plazma/administration/expert/vanillaize.md b/pl/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..5c3f702fd --- /dev/null +++ b/pl/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Dowiedz się, jak przywrócić patch Paper i Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper nie dodaje opcji wyboru do większości poprawek błędów w Vanilla.** + +Obecnie Plazma rozwija konfigurację umożliwiającą dezaktywację takich rozwiązań błędów. + +Dlatego ten przewodnik jest w trakcie pisania i informacje mogą ulec zmianie. + +{% endhint %} diff --git a/pl/origin/plazma/administration/expert/xray.md b/pl/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..f1dc7934e --- /dev/null +++ b/pl/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się o różnych wbudowanych metodach blokowania promieniowania rentgenowskiego X-Ray. +--- + +# 🩻 Blokada promieniowania rentgenowskiego X-Ray diff --git a/pl/origin/plazma/administration/faq.md b/pl/origin/plazma/administration/faq.md new file mode 100644 index 000000000..a97700624 --- /dev/null +++ b/pl/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Sprawdź często zadawane pytania. +--- + +# ⁉️ Często zadawane pytania + +{% hint style="info" %} + +**Nie możesz znaleźć odpowiedzi, której szukasz?** + +Zadaj społeczności pytanie za pośrednictwem [oficjalnego serwera Discord](https://discord.gg/MmfC52K8A8) lub [Dyskusji na GitHubie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma nie uruchamia się + +Jeśli w konsoli pojawi się komunikat `no main manifest attribute, in plazma-(version).jar`,\ +to pobrany plik jest plikiem API dla deweloperów, należy pobrać **Reobf Paperweight** ze strony GitHub. + +Aby uzyskać więcej informacji, sprawdź następną stronę. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Po każdym uruchomieniu serwera pojawia się ostrzeżenie + +Plazma zawiera niektóre niepewne łaty, co może prowadzić do nieprawidłowego działania, dlatego serwer wyświetla następujący komunikat ostrzegawczy przy uruchamianiu. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ten komunikat ostrzegawczy można wyłączyć, korzystając z właściwości systemowej [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Aby uzyskać więcej informacji, sprawdź następną stronę. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostępne od wersji 1.20.1 diff --git a/pl/origin/plazma/administration/getting-started/README.md b/pl/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..aede73fd8 --- /dev/null +++ b/pl/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Dowiedz się, jak zrobić serwer za pomocą Plazma. +--- + +# 👟 Rozpocznij + +Aby stabilnie korzystać z Plazma, system musi spełniać następujące wymagania. + +| | Minimalne | Zalecane | +| :----------------: | --------- | -------- | +| Architektura | x64 | - | +| RAM | 8GB | 16GB | +| Przestrzeń dyskowa | 1GB | 8GB | +| JDK | 17 | 21 | + +Aby swobodnie edytować pliki konfiguracyjne, zaleca się zainstalowanie edytora takiego jak [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Poprawne wyjście" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' nie jest wewnętrzną ani zewnętrzną komendą, programem wykonywalnym lub +plikiem wsadowym. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Najpierw pobierz **JDK 21** w formacie `.msi` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Uruchom pobrany instalator i kliknij `Dalej`. +3. Po lewej stronie środkowej części okna wybierz `Set JAVA_HOME variable`, a następnie kliknij `Dalej`. +4. Kliknij `Instaluj`, aby zainstalować JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Następnie wykonaj kolejną komendę w terminalu, aby zainstalować JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Pobieranie Plazma + +Plazma oferuje różne rodzaje plików wykonywalnych. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Dowiedz się więcej + +Nazwa pliku wykonywalnego to `plazma-(menedżer wersji)-1.20.4-R0.1-SNAPSHOT-(typ mapowania).jar`. + +- **Typ mapowania**\ + Mapowanie to rodzaj mapy łączącej rzeczywisty kod Minecrafta z zaszyfrowanym kodem. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Menedżer wersji**\ + Menedżer wersji to narzędzie uruchamiające serwer, które jest odpowiedzialne za pobieranie bibliotek niezbędnych do uruchomienia serwera oraz za łatanie plików serwera. + - **Paperclip**\ + Menedżer opracowany przez zespół PaperMC do Paper i innych platform pochodnych, służy do pobierania bibliotek i łatania serwera. + - **Bundler**\ + Menedżer wersji Vanilla Minecrafta. + +
+ +*** + +## 3. Tworzenie skryptu startowego + +Aby łatwo uruchamiać Plazma i automatycznie restartować serwer, musisz stworzyć [skrypt startowy](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Możesz pobrać skrypt startowy klikając na przycisk pobierania w lewym dolnym rogu.\ +**Upewnij się, że pobrany skrypt startowy jest zgodny z twoim systemem operacyjnym.** + +*** + +## 4. Porządkowanie plików + +Przenieś pobrany skrypt startowy i Plazma do nowego folderu. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Uruchom skrypt startowy. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Zgoda na EULA + +Po pierwszym uruchomieniu skryptu startowego zostanie utworzony plik `eula.txt` w folderze. + +EULA[^9] to umowa licencyjna, którą trzeba zaakceptować korzystając z usług [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Aby zaakceptować EULA, zmień `eula=false` na `eula=true` w pliku `eula.txt` i zapisz zmiany. + +*** + +## 6. Zezwolenie na zewnętrzny dostęp (Windows) + +Nowoczesne systemy operacyjne domyślnie blokują niebezpieczne połączenia z zewnątrz za pomocą **zapory** i **routera**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Jeśli router nie obsługuje UPnP, należy sprawdzić instrukcje dla konkretnego modelu routera. + +Możesz również użyć [Ngrok](https://ngrok.com/), aby tymczasowo udostępnić adres. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Sprawdzenie konieczności przekierowania portów + +Wpisz i uruchom poniższą komendę w oknie uruchamiania. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jeśli otrzymasz `True`, nie musisz nic więcej robić. Jeśli otrzymasz `False`, należy skonfigurować przekierowanie portów. + +### 6.2 Połączenie z serwerem + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Adres używany do połączenia z serwerem można sprawdzić [tutaj](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Następnie po restarcie serwera, Plazma automatycznie próbuje przekierować porty. + +Poniżej znajduje się informacja o sukcesie przekierowania UPnP, która zostanie wyświetlona w konsoli, np. `[UPnP] (wiadomość)`. + +| wiadomość | znaczenie | +| ------------------------------------- | ---------------------------------------------------------- | +| `Pomyślnie otwarto port (port)` | Sukces przekierowania portów. | +| `Port (port) jest już otwarty` | Inna usługa korzysta obecnie z tego portu. | +| `Nie udało się otworzyć portu (port)` | Przekierowanie portów nie powiodło się. | +| `Usługa jest niedostępna` | Router nie obsługuje UPnP. | + +Po zakończeniu pracy serwera, Plazma automatycznie zamyka porty. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Pobierz plik ZIP `Windows (64-bit)` z [strony Ngrok](https://ngrok.com/download). +2. Umieść pobrany Ngrok w folderze serwera. +3. Na [panelu Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) wygeneruj [token uwierzytelniający](#user-content-fn-13)[^13]. +4. W folderze serwera wykonaj polecenie wyświetlane w `Command Line`. +5. Dodaj polecenie `start /b ngrok tcp --region jp 25565` na początku skryptu uruchamiania i `taskkill /f /t /im ngrok.exe` na końcu. +6. Z informacji `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` w górnej części konsoli, `0.tcp.jp.ngrok.io:12345` będzie adresem serwera. +7. Teraz można połączyć się z serwerem zewnętrznym za pomocą tego adresu. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Na przykład, po wykonaniu polecenia, + +```log +Konfiguracja IP systemu Windows + +Karta Ethernet Ethernet: + + Sufiks DNS konkretnego połączenia. . . . : + Adres IPv4. . . . . . . . . : 192.168.3.7 + Maska podsieci. . . . . . . . : 255.255.255.0 + Brama domyślna. . . . . . . : 192.168.3.1 + +``` + +Możesz połączyć się z serwerem lokalnie, korzystając z adresu IPv4 `192.168.3.7`. + +Jeśli serwer i gra działają na tym samym komputerze, można użyć `localhost` do połączenia. +{% endtab %} +{% endtabs %} + +## 7. Rozwijaj się + +Jeśli serwer został pomyślnie uruchomiony i działa poprawnie, teraz nadszedł czas na dostosowanie serwera. + +Zapoznaj się z poniższą instrukcją, aby dowiedzieć się, jak dostosować serwer. + +{% content-ref url="następny-krok.md" %} +[następny-krok.md](następny-krok.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, na którym opiera się Plazma, bazuje na Spigot, który z kolei opiera się na oficjalnej platformie serwerowej Spigot. + +[^3]: Klawisz Windows + R + +[^4]: Dla systemu Linux, w terminalu wpisz `java --version` + +[^5]: JRE to jeden z projektów open source, podobnie jak platformy serwerowe Minecrafta. + +[^6]: Zazwyczaj jest nazywany **uruchamiaczem**. + +[^7]: Aktywując opcję "Auto-restart", serwer będzie automatycznie restartowany. Możesz zakończyć go, wpisując `Control + C`. + +[^8]: Nie zaleca się przekraczania połowy dostępnej pamięci systemowej. + + Na przykład, jeśli całkowita pojemność pamięci systemowej wynosi 8GB, nie zaleca się ustawiania wartości powyżej 4GB. + +[^9]: End-User License Agreement, Umowa Licencyjna Końcowego Użytkownika. Aby uzyskać więcej informacji, odwiedź [stronę Minecrafta](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Zgodnie z artykułem 32 ustęp 1 punkt 9 ustawy o wspieraniu przemysłu gier w Korei, **Koreańska Spółka Microsoft** może być poddana postępowaniu sądowemu. + +[^12]: Universal Plug & Play. Purpur zawarty w Plazmie automatycznie komunikuje się z routerem za pomocą tej technologii, otwierając porty tylko wtedy, gdy serwer jest uruchomiony, eliminując konieczność ręcznego przekierowywania portów. + +[^13]: Jeśli nie masz konta, zarejestruj się w Ngrok za pomocą konta Google lub GitHub. diff --git a/pl/origin/plazma/administration/getting-started/customization.md b/pl/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..f1c1766d2 --- /dev/null +++ b/pl/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,120 @@ +--- +description: Dowiedz się, jak dostosować serwer do użytku. +--- + +# 🎨 Dostosowanie użytkownika + +Dlaczego korzystamy z dostosowanej platformy serwerowej, takiej jak Plazma, zamiast oficjalnej platformy serwerowej dostarczanej przez Mojang Studios? Największym powodem jest możliwość **personalizacji**. + +Poniżej przedstawiono kilka sposobów dostosowania i wykorzystania Plazmy. + +## Modyfikacja konfiguracji + +Najbardziej podstawowym sposobem dostosowania Plazmy jest modyfikacja konfiguracji. + +Plazma oferuje silne ustawienia konfiguracyjne, począwszy od mechaniki gry po właściwości potworów. + +Zapoznaj się z opisem konfiguracji Plazmy na poniższej stronie. + +{% content-ref url="../reference/configurations/" %} +[konfiguracje](../reference/configurations/) +{% endcontent-ref %} + +## Użycie wtyczek + +{% hint style="success" %} + +**Plazma obsługuje wszystkie wtyczki oparte na papierze.** + +W przypadku wtyczek Spigot od wersji 1.20.5, z powodu zmian w mapowaniu w Paperze, niektóre mogą nie działać, ale większość wtyczek opartych na Paperze, takich jak Paper, Pufferfish i Purpur, działa również w Plazmie. Jeśli wtyczka nie działa poprawnie, należy natychmiast [zgłosić błąd w Plazmie.](../diagnosis/plugins.md) + +{% endhint %} + +Jest to główny powód korzystania z Plazmy oraz najskuteczniejszy sposób personalizacji Plazmy. +Potężny ekosystem wtyczek Plazmy umożliwia łatwe dostosowanie serwera. + +Istnieje wiele sposobów na znalezienie i pobranie wtyczek. Niektóre wtyczki są udostępniane w serwisach magazynowania publicznego, podczas gdy inne są udostępniane na GitHubie lub własnej stronie internetowej. + +{% hint style="caution" %} + +**Wtyczki mogą mieć bezpośredni dostęp do systemu!** + +Zawsze upewnij się, czy wtyczka jest bezpieczna, korzystając z usług takich jak VirusTotal, zanim ją zastosujesz, lub pobierz wtyczkę z zaufanego źródła. + +{% endhint %} + +Istnieje wiele usług do pobierania wtyczek. Spośród nich, usługi takie jak [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) przeprowadzają ocenę wtyczek przed ich udostępnieniem, aby zapewnić, że tylko bezpieczne wtyczki są dystrybuowane. + +### Zastosowanie wtyczki + +Po pobraniu wtyczki, nadszedł czas na jej zastosowanie. + +1. Wtyczki są plikami `.jar` lub `Java Executable File`.\ + Niektóre wtyczki mogą być skompresowane, w takim przypadku + po rozpakowaniu, jeśli nazwa zawiera `bukkit`, `spigot` lub `paper`, + należy użyć pliku z rozszerzeniem `fat`, jeśli taki istnieje. +2. Umieść pobrany plik w folderze `plugins` serwera i (ponownie) uruchom serwer. +3. Po uruchomieniu Plazmy, na konsoli pojawią się nowe komunikaty. + Oznacza to, że Plazma poprawnie załadowała wtyczki. +4. Mimo poprawnego załadowania wtyczek przez Plazmę, niektóre wtyczki mogą nie zostać uruchomione. + Za pomocą polecenia `/plugins` można sprawdzić, które wtyczki są obecnie załadowane na serwerze. + Jeśli nazwa zainstalowanej wtyczki jest czerwona, + jest to oznaczenie, że wtyczka nie została poprawnie załadowana, + jeśli jest zielona, to znaczy, że wtyczka została poprawnie załadowana. + +Jeśli wtyczka nie została poprawnie załadowana, można znaleźć rozwiązania na poniższej stronie. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Użycie pakietów danych + +Pakiety danych to sposób dostosowania gry oferowany domyślnie przez Minecraft, +podobny do paczek zasobów. + +Dzięki pakietom danych można zmieniać niektóre aspekty gry, dodając nowe gatunki stworzeń i wyzwania. + +{% hint style="caution" %} + +**Pakiety danych mogą uszkodzić świat gry!** + +Niektóre uszkodzone pakiety danych mogą uszkodzić świat gry w sposób nieodwracalny. + +Dlatego zaleca się wykonywanie kopii zapasowych świata gry przed zastosowaniem pakietów danych. + +{% endhint %} + +Pakiety danych można pobrać z wielu usług, takich jak [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/). + +Po pobraniu pakietu danych, można go zastosować, umieszczając go w folderze `datapacks` w folderze światowym serwera. +W przypadku braku folderu, należy go utworzyć i dodać pakiet danych. + +{% hint style="warning" %} + +**Niektóre [pakiety danych](#user-content-fn-2) mogą nie być poprawnie zastosowane za pierwszym razem.** + +W takim przypadku zaleca się **2-krotne** ponowne uruchomienie serwera. + +{% endhint %} + +Pakiety danych mogą łatwo ulec uszkodzeniu wraz z aktualizacjami Minecrafta. + +W przypadku całkowitego uszkodzenia pakietów danych, serwer może ulec awarii, dlatego +przed aktualizacją serwera ważne jest przeprowadzenie odpowiednich testów. + +{% hint style="info" %} + +**Po wpisaniu `safeMode` po poleceniu uruchamiającym serwer, można dezaktywować wszystkie pakiety danych i uruchomić serwer.** + +[Zobacz `Referencje > Argumenty` dla szczegółów.](../reference/arguments.md) + +{% endhint %} + +Zastosowane pakiety danych można sprawdzić za pomocą polecenia `/datapack list`. + +*** + +[^1]: Lub dodatków do Minecraft: Edycja Bedrock. + +[^2]: Dodawanie nowych gatunków stworzeń itp. diff --git a/pl/origin/plazma/administration/getting-started/next-step.md b/pl/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..956f3b058 --- /dev/null +++ b/pl/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Dowiedz się, jak dostosować serwer do użytku. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Poniżej przedstawiono kilka sposobów dostosowania i wykorzystania Plazmy. + +## Modyfikacja konfiguracji + +Najbardziej podstawowym sposobem dostosowania Plazmy jest modyfikacja konfiguracji. + +Plazma oferuje silne ustawienia konfiguracyjne, począwszy od mechaniki gry po właściwości potworów. + +Zapoznaj się z opisem konfiguracji Plazmy na poniższej stronie. + +{% content-ref url="../reference/configurations/" %} +[konfiguracje](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Użycie wtyczek + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Jest to główny powód korzystania z Plazmy oraz najskuteczniejszy sposób personalizacji Plazmy. Potężny ekosystem wtyczek Plazmy umożliwia łatwe dostosowanie serwera. + +Istnieje wiele sposobów na znalezienie i pobranie wtyczek. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Istnieje wiele usług do pobierania wtyczek. Spośród nich, usługi takie jak [Forum SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) przeprowadzają ocenę wtyczek przed ich udostępnieniem, aby zapewnić, że tylko bezpieczne wtyczki są dystrybuowane. + +### Zastosowanie wtyczki + +Po pobraniu wtyczki, nadszedł czas na jej zastosowanie. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Umieść pobrany plik w folderze `plugins` serwera i (ponownie) uruchom serwer. +3. Po uruchomieniu Plazmy, na konsoli pojawią się nowe komunikaty. Oznacza to, że Plazma poprawnie załadowała wtyczki. +4. Mimo poprawnego załadowania wtyczek przez Plazmę, niektóre wtyczki mogą nie zostać uruchomione. Za pomocą polecenia `/plugins` można sprawdzić, które wtyczki są obecnie załadowane na serwerze. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Jeśli wtyczka nie została poprawnie załadowana, można znaleźć rozwiązania na poniższej stronie. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Użycie pakietów danych + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Dzięki pakietom danych można zmieniać niektóre aspekty gry, dodając nowe gatunki stworzeń i wyzwania. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Niektóre uszkodzone pakiety danych mogą uszkodzić świat gry w sposób nieodwracalny. + +Dlatego zaleca się wykonywanie kopii zapasowych świata gry przed zastosowaniem pakietów danych. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Po pobraniu pakietu danych, można go zastosować, umieszczając go w folderze `datapacks` w folderze światowym serwera. W przypadku braku folderu, należy go utworzyć i dodać pakiet danych. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +W takim przypadku zaleca się **2-krotne** ponowne uruchomienie serwera. +{% endhint %} + +Pakiety danych mogą łatwo ulec uszkodzeniu wraz z aktualizacjami Minecrafta. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Zastosowane pakiety danych można sprawdzić za pomocą polecenia `/datapack list`. + +*** + +## Optymalizacja + +W Plazmie zastosowano wiele łatek optymalizacyjnych. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Aby uzyskać informacje na temat bezpiecznej i poprawnej konfiguracji proksów, zapoznaj się z poniższą stroną. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Bezpieczeństwo + +W przypadku rozwoju modów w Minecraft, łatwo dostępny jest [silnik ataków na luki](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Konfiguracja uprawnień + +W niektórych wtyczkach administratora mogą istnieć luki bez właściwie ustawionych uprawnień. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blokada X-Ray + +X-Ray to jedna z podstawowych luk, która jest łatwo dostępna nawet w podstawowym optymalizowanym kliencie. + +Plazma oferuje konfigurację blokady X-Ray domyślnie. + +Aby uzyskać informacje o metodach blokowania X-Ray, zapoznaj się z poniższą stroną. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Aby sprawdzić, którzy gracze mają dostęp, użyj `/whitelist query`. + +*** + +[^1]: Lub dodatków do Minecraft: Edycja Bedrock. + +[^2]: Dodawanie nowych gatunków stworzeń itp. + +[^3]: Zazwyczaj nazywany "hackami". + +[^4]: W przypadku nieoptymalnej konfiguracji, długiego użytkowania Plazmy lub nowo odkrytych luk, może nie być zablokowane. + +[^5]: Gracz łączy się z serwerem za pośrednictwem serwera proxy Ngrok, a każde ponowne uruchomienie generuje nowy adres Ngrok. diff --git a/pl/origin/plazma/administration/reference/README.md b/pl/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..03265de4b --- /dev/null +++ b/pl/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Dowiedz się, jak dostosować Plazmę do swoich potrzeb. +--- + +# 📜 리퍼런스 + +Plazma oferuje różne metody dostosowywania. + +Spośród nich cztery metody dostosowywania można używać od razu bez dodatkowych działań. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +Zadaj społeczności pytanie za pośrednictwem [oficjalnego serwera Discord](https://discord.gg/MmfC52K8A8) lub [Dyskusji na GitHubie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Polecenia + +> Polecenia pozwalają zbierać informacje w grze lub dostosować środowisko gry. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Uprawnienia + +> Uprawnienia określają zakres interakcji gracza. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenty i właściwości + +> Argumenty i właściwości mają ogólny wpływ na działanie Plazmy. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguracje + +> Konfiguracje są podstawowym sposobem dostosowywania Plazmy. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/pl/origin/plazma/administration/reference/arguments.md b/pl/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..4854582fd --- /dev/null +++ b/pl/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Dowiedz się o początkowych argumentach i właściwościach systemowych. +--- + +# 🎛️ Argumenty i właściwości + +Zmienne początkowe i właściwości systemowe są wartościami dodawanymi do [polecenia używanego do uruchomienia Plazmy](#user-content-fn-1)[^1], które mają ogólny wpływ na działanie Plazmy. + +Zgodnie z **parametrem lokalizacji** dodanym do [polecenia](#user-content-fn-2)[^2], zostanie podzielony na **argumenty początkowe** i **właściwości systemowe**. + +*** + +## Właściwości systemowe + +Właściwości systemowe są wartościami wprowadzanymi przed `-jar`, które są przetwarzane przez JVM przed inicjalizacją Plazmy. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Instrukcje + +Właściwości systemowe są wprowadzane jako argumenty Java między `java` a `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` oznacza, że ten argument jest dodatkowym argumentem dedykowanym Plazmie, a + +Jeśli nie podasz żadnej wartości dla właściwości, zostanie ona ustawiona na [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Wszystkie właściwości systemowe + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Aktualizuje formaty znaków zastanych. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania informacji dotyczących jednostek. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza rewizję NMS, umożliwiając IDE poprawne ładowanie informacji debugowania oraz automatyczne mapowanie wersji wewnętrznych. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza system ostrzeżeń Watchdog w Spigocie. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza potwierdzenie komendy `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Jeśli jesteś deweloperem pluginów i musisz zaktualizować plugin, użyj hotswapu zamiast komendy `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza pluginy korzystające z systemu standardowego wejścia-wyjścia. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyświetla ostrzeżenie, gdy wykryto przestarzałe formatowanie w komponentach czatu. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza weryfikację zgodności wzorca serwera podczas łączenia się z serwerem. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania brakujących kluczy w obiektach NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania błędnych profili czaszek. + +Loguje wszystkie błędne bloki czaszek w świecie wraz z ich lokalizacją. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza priorytetowanie klas pluginów. + +Przydatne w przypadku problemów z cieniowaniem pluginów. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza konsolidację spłukiwania Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Domyślnie**: `750` + +Jeśli istnieje więcej jednostek niż ustawiona wartość, dzielone są na wiele pakietów do przesłania. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Domyślnie**: `8192` + +Ustawia maksymalny rozmiar pakietu, który serwer może przyjąć naraz. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza sprawdzanie wersji Javy. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Może to spowodować trwałe uszkodzenie plików na poziomie świata i całkowite zniszczenie mechaniki gry. + +Wszelkie problemy wynikające z tego są twoją odpowiedzialnością, a Plazma nie udziela wsparcia w tej kwestii. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Domyślnie**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Domyślnie**: `80` + +Ustawia maksymalną długość linii na znakach tablicy. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Domyślnie**: `(wersja świata) + 1` + +Ustawia wersję informacji o aktualizacji świata, która zostanie zainicjowana jako pierwsza. + +Przydatne przy dużej liczbie chunków do aktualizacji, ale w innych przypadkach nie jest używane. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Domyślnie**: `True` + +Włącza obsługę komentarzy w plikach YAML. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Domyślnie**: `30` + +Po określonym czasie (w sekundach) bez otrzymania danych od gracza, gracz zostanie wyrzucony. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Ignoruje komentarze właściwości serwera. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania synchronizacji chunków. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza domyślny system zapisu chunków w Minecraft. + +To spowoduje, że każdy chunk będzie zapisywany sekwencyjnie, co znacząco obniży wydajność. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza wyraźne opróżnianie kanałów sieciowych. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Zawsze rejestruje błędy, które nie występują w głównym wątku. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyświetla ostrzeżenie, gdy zaplanowane zadanie ma zbyt duże opóźnienie. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Jeśli używasz domyślnego pliku wykonywalnego, aplikuje tylko łatkę bez uruchamiania serwera. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` +- **Kolizja**: `Plazma.disableConfigOptimization` + +Wprowadza bardziej agresywne optymalizacje początkowej konfiguracji. + +Ze włączeniem tego opcji serwer staje się szybszy i bezpieczniejszy, ale może wpłynąć znacząco na rozgrywkę. + +#### `Plazma.disableConfigOptimization` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` +- **Kolizja**: `Plazma.aggressiveOptimize` + +Nie optymalizuje początkowej konfiguracji. + +Ustawia domyślną konfigurację Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` + +Wyłącza markę Plazma i używa domyślnego serwerowego faviconu w stylu Vanilla. + +#### `Plazma.useVanillaConfiguration` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` +- **Kolizja**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Może to znacząco wpłynąć na bezpieczeństwo i wydajność serwera. + +Wszelkie problemy związane z tym parametrem są odpowiedzialnością administratora serwera. +{% endhint %} + +Ustawia początkową konfigurację na domyślne wartości dostarczane przez Mojang. + +Wyłącza wszystkie załatane wady zastosowane przez Paper. + +Wady mogą zostać ponownie włączone w konfiguracji Paper lub Plazma. + +#### `Plazma.vanillaize` + +- **Typ**: `Boolean` +- **Wartość domyślna**: `true` +- **Kolizja**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Ustawia początkową konfigurację bliżej stylu Vanilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Używane atrybuty zostały zakończone + +Poniższe atrybuty systemowe są atrybutami, które zostały zakończone. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` +- **Zakończone**: Timings zostały usunięte z Plazmy + +Decyduje, czy wartość przekazywana do interfejsu API Timingsa Aikara może przekroczyć maksymalną wartość. + +Nawet jeśli to jest zrobione, jeśli nie jest obsługiwane przez API, zostanie nałożone ograniczenie prędkości. + +*** + +## Argument początkowy + +Argument początkowy jest przekazywany po `-jar *.jar`, aby zainicjować Plazmę i jest przetwarzany razem z nią. + +### Sposób użycia + +Atrybuty systemowe są przekazywane jako argumenty programu po `-jar *.jar`. + +Na przykład, jeśli chcesz zastosować argument początkowy `nogui`,\ +to wprowadź go w ten sposób, a Plazma przetworzy ten argument podczas inicjalizacji. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Całkowity argument początkowy + +#### `bukkit-settings` + +- **Alias**: `b` +- **Domyślnie**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Domyślnie**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Domyślnie**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Rozpoczyna serwer w trybie demonstracyjnym. + +#### `eraseCache` + +Usuwa pozostałe pliki pamięci podręcznej po aktualizacji świata. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Wyświetla pełny argument początkowy i opis Plazmy. + +#### `initSettings` + +Tworzy tylko plik konfiguracyjny i zamyka serwer. + +#### `jfrProfile` + +Aktywuje profilowanie JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Domyślnie**: `(serwerowe właściwości)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Wyłącza panel interfejsu graficznego. + +#### `nojline` + +Wyłącz JLine i używaj konsoli Vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Domyślnie**: `(serwerowe właściwości)` + +Wybierz, czy zweryfikować graczy przez serwery uwierzytelniające Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Domyślny**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Ustawia lokalizację pliku konfiguracyjnego PaperSpigot, który został wycofany z użycia. + +Służy do przenoszenia istniejącej konfiguracji do nowego pliku konfiguracyjnego, który nie jest już używany. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Domyślny**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Domyślny**: `plugins` + +Ustawia lokalizację folderu wtyczek. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Domyślny**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Domyślny**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Uruchamia serwer w trybie pełnej Vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Domyślnie**: `(serwerowe właściwości)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Domyślnie**: `(serwerowe właściwości)` + +Ustawia port serwera. + +#### `server-name` + +- **Domyślny**: `A Plazma Server` + +Ustawia nazwę serwera. + +#### `spigot-settings` + +- **Alias**: `S` +- **Domyślny**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Wyświetla wersję Plazmy. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Domyślny**: `(folder serwera)` + +Ustawia lokalizację, w której są przechowywane pliki świata. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Domyślnie**: `(serwerowe właściwości)` + +Ustawia nazwę pliku świata. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Zmienia sposób obsługi argumentów w zależności od dodatkowego miejsca. + +[^3]: Na przykład, jeśli chcesz ustawić `Plazma.iKnowWhatIAmDoing` na `true`, zamiast wpisywać `-DPlazma.iKnowWhatIAmDoing=true`, wystarczy wpisać `-DPlazma.iKnowWhatIAmDoing` i będzie działać tak samo. + +[^4]: Na przykład, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor zdarzeń. + +[^6]: Detektor zdarzeń. + +[^7]: Klient. + +[^8]: Sygnał informujący o poprawnym połączeniu z serwerem, podobnie jak bicie serca. + +[^9]: Dzięki funkcji wyrzucania AFK w Purpur, można wyrzucić graczy, którzy są nieaktywni. + +[^10]: Synchroniczny system tworzenia chunków, Sync Chunk Write System. + +[^11]: `OSTRZEŻENIE! Plazma może powodować niespodziewane problemy, dlatego koniecznie przetestuj go dokładnie przed użyciem na serwerze publicznym.` + +[^12]: `Optymalizacja świata` w grach działa na tej samej zasadzie. + +[^13]: Administratorzy poziomu 2 i wyższego są wyłączeni. + +[^14]: Protokół internetowy, IP. diff --git a/pl/origin/plazma/administration/reference/commands.md b/pl/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..10fb9b20d --- /dev/null +++ b/pl/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź dostępne polecenia w Plazma. +--- + +# 🖥️ Polecenia diff --git a/pl/origin/plazma/administration/reference/configurations/README.md b/pl/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..037746824 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfiguracje są podstawowym sposobem dostosowywania Plazmy. +--- + +# 🧾 구성 + +*** + +## 🪨 Atrybut + +> Atrybuty to podstawowy plik konfiguracyjny dostarczany przez Minecraft. Dzięki atrybutom można zmieniać podstawowe mechanizmy gry. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Konfiguracja Bukkit + +> Konfiguracja Bukkit to podstawowy plik konfiguracyjny dostarczany przez Plazmę. Dzięki konfiguracji Bukkit można zmieniać podstawowe mechanizmy serwera Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Konfiguracja Spigot + +> Konfiguracja Spigot umożliwia modyfikację szczegółowych mechanizmów gry, przetwarzanie graczy, działanie poleceń i wiadomości. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Konfiguracja Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Konfiguracja Pufferfish + +> Konfiguracja Pufferfish umożliwia zmianę przetwarzania światów i jednostek w Plazmie. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Konfiguracja Purpur + +> Atrybuty Purpur pozwalają modyfikować ogólne dane gry. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Konfiguracja Plazma + +> Konfiguracja Plazma pozwala dostosować funkcje Plazmy. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/pl/origin/plazma/administration/reference/configurations/bukkit.md b/pl/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..ed0246901 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/pl/origin/plazma/administration/reference/configurations/paper/README.md b/pl/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..1d6105812 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, do czego służy każdy plik w folderze konfiguracyjnym. +--- + +# 🛩️ Papier diff --git a/pl/origin/plazma/administration/reference/configurations/paper/global.md b/pl/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..6f11854ca --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/pl/origin/plazma/administration/reference/configurations/paper/world.md b/pl/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..cba1d0b86 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Światowy diff --git a/pl/origin/plazma/administration/reference/configurations/plazma/README.md b/pl/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5d02da81f --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, do czego służy każdy plik w folderze konfiguracyjnym. +--- + +# ✨ Plazma diff --git a/pl/origin/plazma/administration/reference/configurations/plazma/global.md b/pl/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..aa76511c3 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/pl/origin/plazma/administration/reference/configurations/plazma/world.md b/pl/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..0ba98632d --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/pl/origin/plazma/administration/reference/configurations/plazma/worlds.md b/pl/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..82a55bd77 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w plazma-world.yml. +--- + +# ✨ Plazma (struktura świata) diff --git a/pl/origin/plazma/administration/reference/configurations/property.md b/pl/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..2d82d548c --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w server.properties. +--- + +# 🪨 Server.properties diff --git a/pl/origin/plazma/administration/reference/configurations/pufferfish.md b/pl/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..2af151ae2 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w pufferfish.yml. +--- + +# 🐡 Ryba balonowa diff --git a/pl/origin/plazma/administration/reference/configurations/purpur/README.md b/pl/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..9c61313cd --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w purpur.yml. +--- + +# 🦑 Purpur diff --git a/pl/origin/plazma/administration/reference/configurations/purpur/global.md b/pl/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..193cb4a36 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/pl/origin/plazma/administration/reference/configurations/purpur/world.md b/pl/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..1166460a3 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/pl/origin/plazma/administration/reference/configurations/spigot.md b/pl/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..b705b6ec6 --- /dev/null +++ b/pl/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w spigot.yml. +--- + +# 🚰 Spigot diff --git a/pl/origin/plazma/administration/reference/permissions.md b/pl/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..6efb10b1b --- /dev/null +++ b/pl/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Sprawdź uprawnienia Plazmy. +--- + +# 🛡️ Uprawnienia + +Uprawnienia to proste narzędzie bezpieczeństwa, które określa zakres interakcji graczy na serwerze. + +Aby skutecznie korzystać z uprawnień i łatwo je modyfikować, należy użyć wtyczek takich jak [LuckPerms](https://luckperms.net). + +*** + +## Zrozumienie podstawowego systemu uprawnień + +W Minecraft dostępne są podstawowe grupy uprawnień administracyjnych. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Gracz**\ + To standardowa grupa uprawnień, przypisywana zazwyczaj wszystkim graczom. +2. **Mediator**\ + Może ignorować ochronę spawnu. +3. **Administrator świata**\ + Może używać wszystkich poleceń i bloków poleceń związanych z zarządzaniem światem.\ + To podstawowa grupa uprawnień stosowana do pakietów danych i bloków poleceń. +4. **Administrator**\ + Może używać wszystkich poleceń związanych z zarządzaniem graczami. +5. **Superadministrator**\ + Może używać wszystkich poleceń związanych z zarządzaniem serwerem.\ + To podstawowa grupa uprawnień stosowana do konsoli i administratorów. + +*** + +## Ustawianie uprawnień + +*** + +## Pełne uprawnienia + +*** + +#### `allow.ride.(Nazwany klucz)` + +- **Domyślnie**: `Brak` + +Pozwala graczom na wchodzenie na jednostki poprzez `kucnięcie i interakcję` z nimi. + +Gdy gracz wsiądzie na jednostkę, może sterować jej ruchem za pomocą `klawiszy ruchu` oraz skakać lub latać za pomocą `klawisza skoku`. + +W miejscu `(Nazwany klucz)` wprowadzany jest [Identyfikator przestrzeni nazw](#user-content-fn-2)[^2] jednostki. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Nazwany klucz)` + +- **Domyślnie**: `Brak` + +Pozwala graczom na korzystanie z specjalnych umiejętności jednostki, gdy ją prowadzą. + +Nie wszystkie jednostki posiadają specjalne umiejętności. Sprawdź dostępne specjalne umiejętności poniżej. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Podziel się swoim pomysłem na [Discordzie Plazmy](https://plazmamc.org/discord) lub [Dyskusjach na GitHubie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Zobacz dostępne obecnie specjalne umiejętności + +- **`crepper`**\ + Po naciśnięciu `klawisza skoku` następuje wybuch.\ + Jeśli gracz ma uprawnienie `allow.powered.creeper`, może naładować wybuch, przytrzymując `klawisz skoku`. +- **`dolphin`**\ + Po naciśnięciu `klawisza skoku` następuje pędzenie. +- **`phantom`**\ + Po naciśnięciu `klawisza skoku` następuje wystrzelenie płomieni. +- **`wither`**\ + Po `interakcji` wystrzeliwuje głowę Wither'a. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/credits (Gracz)`](commands.md#credits). + +Dodanie `.other` po nazwie uprawnienia pozwala na udzielenie innym graczom możliwości korzystania z niej. + +#### `bukkit.command.demo` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/demo (Gracz)`](commands.md#demo). + +Dodanie `.other` po nazwie uprawnienia pozwala na udzielenie innym graczom możliwości korzystania z niej. + +#### `bukkit.command.ping` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/ping (Gracz)`](commands.md#ping). + +Dodanie `.other` po nazwie uprawnienia pozwala na udzielenie innym graczom możliwości korzystania z niej. + +#### `bukkit.command.ram` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/rambar (Gracz)`](commands.md#rambar). + +Dodanie `.other` po nazwie uprawnienia pozwala na udzielenie innym graczom możliwości korzystania z niej. + +#### `bukkit.command.restart` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/tpsbar (Gracz)`](commands.md#tpsbar). + +Dodanie `.other` po nazwie uprawnienia pozwala na udzielenie innym graczom możliwości korzystania z niej. + +#### `bukkit.command.timings` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Aby uzyskać informacje o podobnych komendach, odwiedź stronę [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(TrybGry)` + +- **Domyślnie**: `Administrator świata` + +Pozwala na użycie komendy [`/gamemode (TrybGry) (Gracz)`](commands.md#gamemode). + +Dodanie `.other` po nazwie uprawnienia pozwala na udzielenie innym graczom możliwości korzystania z niej. + +#### `paper.antixray.bypass` + +- **Domyślnie**: `Brak` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Dzięki temu obie strony mogą cieszyć się poprawioną wydajnością. + +> Aby dowiedzieć się więcej na temat konfiguracji X-Ray, sprawdź poniższą stronę. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Domyślnie**: `Brak` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Domyślnie**: `Brak` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Domyślnie**: `Brak` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Domyślnie**: `Brak` + +Pozwala na korzystanie z tagów [MiniMessage](https://docs.advntr.dev/minimessage/format.html) na kowadle. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Domyślnie**: `Brak` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Domyślnie**: `Brak` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Domyślnie**: `Brak` + +Wyłącza wydalanie gracza z powodu bezczynności. + +#### `purpur.debug.f3n` + +- **Domyślnie**: `Administrator świata` + +Pozwala graczom na zmianę trybu gry za pomocą klawiszy `F3 + N`. + +Funkcja ta nie działa, jeśli gracz nie ma odpowiednich uprawnień. + +#### `purpur.drop.spawners` + +- **Domyślnie**: `Brak` + +Kopanie spawnerów za pomocą odpowiedniego przedmiotu powoduje ich upuszczenie. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(LiczbaCiągZnaków)` + +- **Domyślnie**: `Brak` + +Zmienia rozmiar skrzyni Endera. + +W miejscu `(LiczbaCiągZnaków)` można wprowadzić `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Domyślnie**: `Brak` + +Pozwala na działanie totemów nieśmiertelności, gdy znajdują się w ekwipunku. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Domyślnie**: `Brak` + +Zezwala graczowi na zignorowanie limitu liczby graczy podłączonych. + +#### `purpur.mending_shift_click` + +- **Domyślnie**: `Brak` + +Zezwala graczowi na naprawę trzymanego przedmiotu poprzez `przytrzymanie i interakcję`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Domyślnie**: `Brak` + +Zezwala graczowi na instalację spawnów. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Domyślnie**: `Brak` + +Pozwala graczowi natychmiastowo teleportować się po wejściu do Netheru. + +#### `purpur.sign.color` + +- **Domyślnie**: `Brak` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Domyślnie**: `Brak` + +Zezwól na użycie kodu zaciemnienia `(&o)` na tablicach informacyjnych. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Domyślnie**: `Brak` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Domyślnie**: `Brak` + +Zezwól graczom na zatrzymanie wybuchu TNT poprzez `interakcję wzajemną` z nożyczkami. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Przyznane uprawnienia + +#### `plazma.bypass.ncr-require` + +- **Domyślnie**: `Brak` + +Zezwól graczom na dołączenie nawet bez zainstalowanego moda [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Przykład: `ender_dragon` diff --git a/pl/origin/plazma/adminstration/README.md b/pl/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..0d3b1c882 --- /dev/null +++ b/pl/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Stwórz własny serwer przy użyciu Plazmy. +--- + +# ⚒️ Przewodnik po zarządzaniu serwerem diff --git a/pl/origin/plazma/adminstration/expert/README.md b/pl/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..ca32298ba --- /dev/null +++ b/pl/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się więcej o profesjonalnym podejściu do obsługi Plazmy. +--- + +# 🎓 Zaawansowane diff --git a/pl/origin/plazma/adminstration/expert/fix-exploits.md b/pl/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..46b5e57cc --- /dev/null +++ b/pl/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź znane podatności i sposoby ich rozwiązywania. +--- + +# ⚠️ Znane podatności i sposoby ich rozwiązywania diff --git a/pl/origin/plazma/adminstration/expert/optimize.md b/pl/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..826d4760b --- /dev/null +++ b/pl/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się, jak zoptymalizować Plazmę. +--- + +# 🧹 Optymalizacja diff --git a/pl/origin/plazma/adminstration/expert/vanillaize.md b/pl/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..0bc744291 --- /dev/null +++ b/pl/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Dowiedz się, jak przywrócić patch Paper i Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### Paper nie dodaje opcji do większości patchy rozwiązujących błędy Vanilla. + +Obecnie Plazma rozwija konfigurację umożliwiającą dezaktywację takich rozwiązań błędów. + +Dlatego ten przewodnik jest w trakcie pisania i informacje mogą ulec zmianie. +{% endhint %} diff --git a/pl/origin/plazma/adminstration/faq.md b/pl/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..96971f5cb --- /dev/null +++ b/pl/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Sprawdź często zadawane pytania. +--- + +# ⁉️ Często zadawane pytania + +{% hint style="info" %} + +### Nie możesz znaleźć odpowiedzi, której szukasz? + +Zadaj pytanie społeczności na [oficjalnym serwerze Discorda](https://discord.gg/MmfC52K8A8) lub [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Wyświetla się komunikat, ale nie wykonuje się + +Jeśli w konsoli pojawi się komunikat `no main manifest attribute, in plazma-(version).jar`,\ +to pobrany plik jest plikiem API dla deweloperów, należy pobrać **Reobf Paperweight** ze strony GitHub. + +Aby uzyskać więcej informacji, sprawdź następną stronę. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Po każdym uruchomieniu serwera pojawia się ostrzeżenie + +Plazma zawiera niektóre niepewne łaty, co może prowadzić do nieprawidłowego działania, dlatego serwer wyświetla następujący komunikat ostrzegawczy przy uruchamianiu. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ten komunikat ostrzegawczy można wyłączyć, korzystając z właściwości systemowej [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Aby uzyskać więcej informacji, sprawdź następną stronę. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostępne od wersji 1.20.1 diff --git a/pl/origin/plazma/adminstration/getting-started/README.md b/pl/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..4aa5ef7c0 --- /dev/null +++ b/pl/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Dowiedz się, jak zrobić serwer za pomocą Plazma. +--- + +# 👟 Rozpocznij + +Aby stabilnie korzystać z Plazma, system musi spełniać następujące wymagania. + +| | Minimalne | Zalecane | +| :----------------: | --------: | -------: | +| Architektura | x64 | - | +| RAM | 8GB | 16GB | +| Przestrzeń dyskowa | 1GB | 8GB | +| JRE | 17 | 21 | + +Aby swobodnie edytować pliki konfiguracyjne, zaleca się zainstalowanie edytora takiego jak [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalacja JRE + +Jak wskazuje nazwa, Minecraft: **"Java"** Edition został stworzony w Javie, dlatego do uruchomienia wymagane jest JRE[^1]. + +Ponieważ Plazma opiera się na oficjalnej platformie serwerowej Mojang Studios [^2], do korzystania z Plazma konieczna jest również instalacja JRE. + +### 1.1 Sprawdzenie obecności JRE + +Aby sprawdzić, czy JRE jest zainstalowane na systemie, wpisz w oknie uruchamiania [`cmd /k java --version`](#user-content-fn-4)[^4] i uruchom. + +Jeśli otrzymasz odpowiedź pokazaną poniżej, przejdź do [kroku 2](setup.md#id-2). + +{% code title="Poprawna odpowiedź" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Jeśli nie otrzymasz odpowiedzi jak powyżej, lub otrzymasz odpowiedź jak poniżej, oznacza to brak JRE lub zbyt stare oprogramowanie, w takim przypadku należy wykonać [krok 1.2](setup.md#id-1.2). + +{% code title="Brak zainstalowanego JRE" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="Zbyt stare JRE" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalacja JRE + +W tym przewodniku używamy jednej z wersji JRE, Azul Zulu. + +Po zakończeniu instalacji, ponownie wykonaj [krok 1.1](setup.md#id-1.1), aby sprawdzić, czy instalacja przebiegła pomyślnie. + +{% tabs %} +{% tab title="Windows" %} + +1. Najpierw pobierz **JDK 21** w formacie `.msi` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Uruchom pobrany instalator i kliknij `Dalej`. +3. Po lewej stronie środkowej części okna wybierz `Set JAVA_HOME variable`, a następnie kliknij `Dalej`. +4. Kliknij `Instaluj`, aby zainstalować JRE. + {% endtab %} + +{% tab title="macOS" %} +Pobierz **JDK 21** w formacie `.dmg` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu), uruchom pobrany plik i zainstaluj JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Najpierw wykonaj poniższą komendę w terminalu, aby dodać repozytorium Azul Zulu do APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Następnie wykonaj kolejną komendę w terminalu, aby zainstalować JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Możesz zainstalować JRE za pomocą poniższej komendy. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Pobieranie Plazma + +Plazma oferuje różne rodzaje plików wykonywalnych. + +{% hint style="warning" %} + +### Zazwyczaj używa się `Reobf Paperclip`. + +Poniższe informacje są dla deweloperów lub osób zainteresowanych szczegółami poszczególnych rodzajów.\ +Jeśli jesteś zwykłym użytkownikiem, możesz przejść od razu do [kroku 3](setup.md#id-3). +{% endhint %} + +
+ +Dowiedz się więcej + +Nazwa pliku wykonywalnego to `plazma-(menedżer wersji)-1.20.4-R0.1-SNAPSHOT-(typ mapowania).jar`. + +- **Typ mapowania**\ + Mapowanie to rodzaj mapy łączącej rzeczywisty kod Minecrafta z zaszyfrowanym kodem. + - **Reobf**\ + Reobfuscation, nazywane także mapowaniem Spigot, używane głównie w wtyczkach NMS.\ + Od wersji 1.20.5 będzie przestarzałe. + - **Mojmap**\ + Mapowanie Mojanga, mapowanie Vanilla Minecrafta. +- **Menedżer wersji**\ + Menedżer wersji to narzędzie uruchamiające serwer, które jest odpowiedzialne za pobieranie bibliotek niezbędnych do uruchomienia serwera oraz za łatanie plików serwera. + - **Paperclip**\ + Menedżer opracowany przez zespół PaperMC do Paper i innych platform pochodnych, służy do pobierania bibliotek i łatania serwera. + - **Bundler**\ + Menedżer wersji Vanilla Minecrafta. + +
+ +*** + +## 3. Tworzenie skryptu startowego + +Aby łatwo uruchamiać Plazma i automatycznie restartować serwer, musisz stworzyć [skrypt startowy](#user-content-fn-6)[^6]. + +Możesz utworzyć skrypt startowy za pomocą [Flags.sh](https://flags.sh). Wystarczy podać [ilość pamięci do użycia przez Plazma](#user-content-fn-8)[^8], a komenda zostanie zoptymalizowana automatycznie. + +Możesz pobrać skrypt startowy klikając na przycisk pobierania w lewym dolnym rogu.\ +**Upewnij się, że pobrany skrypt startowy jest zgodny z twoim systemem operacyjnym.** + +*** + +## 4. Porządkowanie plików + +Przenieś pobrany skrypt startowy i Plazma do nowego folderu. + +{% hint style="warning" %} + +### Nazwa folderu musi być bez spacji i być w języku angielskim. + +W przeciwnym razie Plazma lub JRE mogą nie działać poprawnie. +{% endhint %} + +Uruchom skrypt startowy. W przypadku systemu Windows, w oknie wyboru zezwoleń na zapory wybierz **Zezwól**. + +*** + +## 5. Zgoda na EULA + +Po pierwszym uruchomieniu skryptu startowego zostanie utworzony plik `eula.txt` w folderze. + +EULA[^9] to umowa licencyjna, którą trzeba zaakceptować korzystając z usług [Mojang Studios](#user-content-fn-10)[^10]. + +Brak zgody na EULA uniemożliwi uruchomienie serwera, a naruszenie EULA może skutkować zawieszeniem konta lub innymi [sankcjami](#user-content-fn-11)[^11]. + +Aby zaakceptować EULA, zmień `eula=false` na `eula=true` w pliku `eula.txt` i zapisz zmiany. + +*** + +## 6. Zezwolenie na zewnętrzny dostęp (Windows) + +Nowoczesne systemy operacyjne domyślnie blokują niebezpieczne połączenia z zewnątrz za pomocą **zapory** i **routera**. + +W przypadku Windowsa, ponieważ zezwolenie na zapory zostało udzielone w [kroku 3](setup.md#id-3), wystarczy skonfigurować przekierowanie portów. + +{% hint style="info" %} + +### Ten przewodnik zakłada, że korzystasz z systemu Windows i [**UPnP**](#user-content-fn-12)[^12] jest obsługiwane przez router. + +Jeśli router nie obsługuje UPnP, należy sprawdzić instrukcje dla konkretnego modelu routera. + +Możesz również użyć [Ngrok](https://ngrok.com/), aby tymczasowo udostępnić adres. +{% endhint %} + +{% hint style="warning" %} + +### Dla systemów operacyjnych z rodziny UNIX, takich jak Linux lub macOS, konieczne jest skonfigurowanie zapory dla poszczególnych usług, dlatego należy sprawdzić instrukcje dla danego systemu. + +{% endhint %} + +### 6.1 Sprawdzenie konieczności przekierowania portów + +Wpisz i uruchom poniższą komendę w oknie uruchamiania. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Jeśli otrzymasz `True`, nie musisz nic więcej robić. Jeśli otrzymasz `False`, należy skonfigurować przekierowanie portów. + +### 6.2 Połączenie z serwerem + +{% tabs %} +{% tab title="Dostęp z zewnątrz" %} +Jeśli nie ma potrzeby przekierowania portów lub jeśli przekierowanie portów zostało już pomyślnie wykonane, można teraz połączyć się z serwerem. + +Adres używany do połączenia z serwerem można sprawdzić [tutaj](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Próba przekierowania portów UPnP" %} +W pliku `purpur.yml` w folderze serwera, ustaw `network.upnp-port-forwarding` na `true`. + +Następnie po restarcie serwera, Plazma automatycznie próbuje przekierować porty. + +Poniżej znajduje się informacja o sukcesie przekierowania UPnP, która zostanie wyświetlona w konsoli, np. `[UPnP] (wiadomość)`. + +| wiadomość | znaczenie | +| ------------------------------------- | ------------------------------------------ | +| `Pomyślnie otwarto port (port)` | Sukces przekierowania portów. | +| `Port (port) jest już otwarty` | Inna usługa korzysta obecnie z tego portu. | +| `Nie udało się otworzyć portu (port)` | Przekierowanie portów nie powiodło się. | +| `Usługa jest niedostępna` | Router nie obsługuje UPnP. | + +Po zakończeniu pracy serwera, Plazma automatycznie zamyka porty. +{% endtab %} + +{% tab title="Generowanie tymczasowego adresu za pomocą Ngrok" %} +Metoda z użyciem Ngrok jest przydatna do krótkoterminowych testów, gier wieloosobowych lub gry z przyjaciółmi. + +1. Pobierz plik ZIP `Windows (64-bit)` z [strony Ngrok](https://ngrok.com/download). +2. Umieść pobrany Ngrok w folderze serwera. +3. Na [panelu Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) wygeneruj [token uwierzytelniający](#user-content-fn-13)[^13]. +4. W folderze serwera wykonaj polecenie wyświetlane w `Command Line`. +5. Dodaj polecenie `start /b ngrok tcp --region jp 25565` na początku skryptu uruchamiania i `taskkill /f /t /im ngrok.exe` na końcu. +6. Z informacji `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` w górnej części konsoli, `0.tcp.jp.ngrok.io:12345` będzie adresem serwera. +7. Teraz można połączyć się z serwerem zewnętrznym za pomocą tego adresu. + {% endtab %} + +{% tab title="Dostęp lokalny" %} +Jeśli chcesz połączyć się z serwerem lokalnie, uruchom `cmd /k ipconfig` w oknie wykonawczym, a następnie użyj adresu `IPv4` wyświetlanego. + +Na przykład, po wykonaniu polecenia, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Możesz połączyć się z serwerem lokalnie, korzystając z adresu IPv4 `192.168.3.7`. + +Jeśli serwer i gra działają na tym samym komputerze, można użyć `localhost` do połączenia. +{% endtab %} +{% endtabs %} + +## 7. Etap rozwoju + +Jeśli serwer został pomyślnie uruchomiony i działa poprawnie, teraz nadszedł czas na dostosowanie serwera. + +Dowiedz się, jak dostosować serwer, korzystając z poniższego przewodnika. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, środowisko uruchomieniowe Javy. + +[^2]: Paper, na którym opiera się Plazma, bazuje na Spigot, który z kolei opiera się na oficjalnej platformie serwerowej Spigot. + +[^3]: Klawisz Windows + R + +[^4]: Dla systemu Linux, w terminalu wpisz `java --version` + +[^5]: JRE to jeden z projektów open source, podobnie jak platformy serwerowe Minecrafta. + +[^6]: Zazwyczaj jest nazywany **uruchamiaczem**. + +[^7]: Aktywując opcję "Auto-restart", serwer będzie automatycznie restartowany. Możesz zakończyć go, wpisując `Control + C`. + +[^8]: Nie zaleca się przekraczania połowy dostępnej pamięci systemowej. + + Na przykład, jeśli całkowita pojemność pamięci systemowej wynosi 8GB, nie zaleca się ustawiania wartości powyżej 4GB. + +[^9]: End-User License Agreement, Umowa Licencyjna Końcowego Użytkownika. Aby uzyskać więcej informacji, odwiedź [stronę Minecrafta](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: Zgodnie z artykułem 32 ustęp 1 punkt 9 ustawy o wspieraniu przemysłu gier w Korei, **Koreańska Spółka Microsoft** może być poddana postępowaniu sądowemu. + +[^12]: Universal Plug & Play. Purpur zawarty w Plazmie automatycznie komunikuje się z routerem za pomocą tej technologii, otwierając porty tylko wtedy, gdy serwer jest uruchomiony, eliminując konieczność ręcznego przekierowywania portów. + +[^13]: Jeśli nie masz konta, zarejestruj się w Ngrok za pomocą konta Google lub GitHub. diff --git a/pl/origin/plazma/adminstration/getting-started/customization.md b/pl/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..7c1642b95 --- /dev/null +++ b/pl/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Dowiedz się, jak dostosować serwer do użytku. +--- + +# 🎨 Dostosowanie użytkownika diff --git a/pl/origin/plazma/adminstration/odwolania/README.md b/pl/origin/plazma/adminstration/odwolania/README.md new file mode 100644 index 000000000..1af4c4994 --- /dev/null +++ b/pl/origin/plazma/adminstration/odwolania/README.md @@ -0,0 +1,2 @@ +# 📜 Odwołania + diff --git a/pl/origin/plazma/adminstration/odwolania/pliki-konfiguracyjne/README.md b/pl/origin/plazma/adminstration/odwolania/pliki-konfiguracyjne/README.md new file mode 100644 index 000000000..43c63416e --- /dev/null +++ b/pl/origin/plazma/adminstration/odwolania/pliki-konfiguracyjne/README.md @@ -0,0 +1,2 @@ +# 🎨 Pliki konfiguracyjne + diff --git a/pl/origin/plazma/adminstration/reference/arguments.md b/pl/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..d652206f4 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Dowiedz się o początkowych argumentach i właściwościach systemowych. +--- + +# 🎛️ Argumenty i właściwości + +Początkowe zmienne i właściwości systemowe to wartości dodawane do [polecenia używanego do uruchomienia Plazmy](#user-content-fn-1)[^1], które umożliwiają zmianę wartości, które nie mogą być zmienione po uruchomieniu Plazmy. + +W zależności od [miejsca, w którym jest dodawane do polecenia](#user-content-fn-2)[^2], dzielą się na **początkowe argumenty** i **właściwości systemowe**. + +*** + +## Właściwości systemowe + +Właściwości systemowe są wartościami wprowadzanymi przed `-jar`, które są przetwarzane przez JVM przed inicjalizacją Plazmy. + +{% hint style="warning" %} + +### Modyfikacja właściwości systemowych może zmienić zachowanie Plazmy i JVM, co może znacząco wpłynąć na grę! + +Jeśli nie jesteś pewien, do czego służy każda właściwość systemowa, **nie używaj ich w ogóle!** +{% endhint %} + +### Instrukcje + +Właściwości systemowe są wprowadzane jako argumenty Java między `java` a `-jar`. + +Na przykład, jeśli chcesz zastosować właściwość systemową `Plazma.dummyProperty`,\ +wprowadzając ją w ten sposób, wartość `37` zostanie przypisana do tej właściwości podczas inicjalizacji Plazmy. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` oznacza, że ten argument jest dodatkowym argumentem dedykowanym Plazmie, a + +jeśli nie wprowadzisz żadnej wartości, wartość zostanie [\`ustawiona na wartość „true”.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platformy serwerowe z rodziny Paperweight używają `.` w nazwach właściwości do rozróżnienia poszczególnych właściwości systemowych. + +W niektórych terminalach, takich jak Windows Powershell, może nie być obsługiwane dodawanie tych argumentów, dlatego na końcach argumentów należy dodać `"`.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Wszystkie właściwości systemowe + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Aktualizuje formaty znaków zastanych. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania informacji dotyczących jednostek. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza rewizję NMS, umożliwiając IDE poprawne ładowanie informacji debugowania oraz automatyczne mapowanie wersji wewnętrznych. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza system ostrzeżeń Watchdog w Spigocie. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza potwierdzenie komendy `/reload`. + +{% hint style="danger" %} + +### Komenda `/reload` jest bardzo niestabilna, dlatego wszelkie problemy serwerowe po jej użyciu są odpowiedzialnością użytkownika. + +Jeśli jesteś deweloperem pluginów i musisz zaktualizować plugin, użyj hotswapu zamiast komendy `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza pluginy korzystające z systemu standardowego wejścia-wyjścia. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyświetla ostrzeżenie, gdy wykryto przestarzałe formatowanie w komponentach czatu. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza weryfikację zgodności wzorca serwera podczas łączenia się z serwerem. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania brakujących kluczy w obiektach NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania błędnych profili czaszek. + +Loguje wszystkie błędne bloki czaszek w świecie wraz z ich lokalizacją. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza limit 128 kanałów pluginów na gracza[^5]. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza priorytetowanie klas pluginów. + +Przydatne w przypadku problemów z cieniowaniem pluginów. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza konsolidację spłukiwania Netty. + +#### `Paper.excessiveTELimit` + +- **Typ**: `Integer` +- **Domyślnie**: `750` + +Jeśli istnieje więcej jednostek niż ustawiona wartość, dzielone są na wiele pakietów do przesłania. + +#### `Paper.filterThreshold` + +- **Typ**: `Integer` +- **Domyślnie**: `8192` + +Ustawia maksymalny rozmiar pakietu, który serwer może przyjąć naraz. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyłącza sprawdzanie wersji Javy. + +{% hint style="danger" %} + +### To pozwala na próbę dostępu do nieistniejącego kodu przez JVM! + +Może to spowodować trwałe uszkodzenie plików na poziomie świata i całkowite zniszczenie mechaniki gry. + +Wszelkie problemy wynikające z tego są twoją odpowiedzialnością, a Plazma nie udziela wsparcia w tej kwestii. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Typ**: `Integer` +- **Domyślnie**: `64` + +Ustawia limit nazw kanałów pluginów[^6]. + +#### `Paper.maxSignLength` + +- **Typ**: `Integer` +- **Domyślnie**: `80` + +Ustawia maksymalną długość linii na znakach tablicy. + +#### `Paper.minPrecachedDatafixVersion` + +- **Typ**: `Integer` +- **Domyślnie**: `(wersja świata) + 1` + +Ustawia wersję informacji o aktualizacji świata, która zostanie zainicjowana jako pierwsza. + +Przydatne przy dużej liczbie chunków do aktualizacji, ale w innych przypadkach nie jest używane. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Domyślnie**: `True` + +Włącza obsługę komentarzy w plikach YAML. + +#### `Paper.playerConnection.keepAlive` + +- **Typ**: `Integer` +- **Domyślnie**: `30` + +Po określonym czasie (w sekundach) bez otrzymania danych od gracza, gracz zostanie wyrzucony. + +Zazwyczaj gra[^7] nadal wysyła [sygnał bicza serwera](#user-content-fn-8)[^8], więc nie zostaniesz wyrzucony, ale]\(#user-content-fn-9)[^9] jeśli gra nie odpowiada, serwer uzna to za awarię i przestanie obsługiwać gracza, wyrzucając go. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Ignoruje komentarze właściwości serwera. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza dzienniki debugowania synchronizacji chunków. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza domyślny system zapisu chunków w Minecraft. + +To spowoduje, że każdy chunk będzie zapisywany sekwencyjnie, co znacząco obniży wydajność. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Włącza wyraźne opróżnianie kanałów sieciowych. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Zawsze rejestruje błędy, które nie występują w głównym wątku. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Wyświetla ostrzeżenie, gdy zaplanowane zadanie ma zbyt duże opóźnienie. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Domyślnie**: `False` + +Jeśli używasz domyślnego pliku wykonywalnego, aplikuje tylko łatkę bez uruchamiania serwera. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` + +{% hint style="warning" %} + +### Ta właściwość zostanie przeniesiona do argumentów początkowych po wersji 1.20.5. + +{% endhint %} + +Zwiększa restrykcje konfiguracji stosowane podczas pierwszego uruchomienia. + +Aktywacja sprawia, że serwer staje się szybszy i bezpieczniejszy, ale może blokować niektóre mechanizmy lub znacząco wpłynąć na rozgrywkę. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` + +Tłumi komunikat ostrzegawczy[^11], który pojawia się podczas inicjalizacji Plazmy. + +### Używane atrybuty zostały zakończone + +Poniższe atrybuty systemowe są atrybutami, które zostały zakończone. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Domyślnie**: `false` +- **Zakończone**: Timings zostały usunięte z Plazmy + +Decyduje, czy wartość przekazywana do interfejsu API Timingsa Aikara może przekroczyć maksymalną wartość. + +Nawet jeśli to jest zrobione, jeśli nie jest obsługiwane przez API, zostanie nałożone ograniczenie prędkości. + +*** + +## Argument początkowy + +Argument początkowy jest przekazywany po `-jar *.jar`, aby zainicjować Plazmę i jest przetwarzany razem z nią. + +### Sposób użycia + +Atrybuty systemowe są przekazywane jako argumenty programu po `-jar *.jar`. + +Na przykład, jeśli chcesz zastosować argument początkowy `nogui`,\ +to wprowadź go w ten sposób, a Plazma przetworzy ten argument podczas inicjalizacji. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Całkowity argument początkowy + +#### `bukkit-settings` + +- **Alias**: `b` +- **Domyślnie**: `bukkit.yml` + +Ustawia nazwę i lokalizację [pliku konfiguracyjnego Bukkita](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Domyślnie**: `commands.yml` + +Ustawia nazwę i lokalizację [pliku konfiguracyjnego komend Bukkita](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Domyślnie**: `server.properties` + +Ustawia nazwę i lokalizację [pliku właściwości serwera](../reference/configurations/property.md). + +#### `demo` + +Rozpoczyna serwer w trybie demonstracyjnym. + +#### `eraseCache` + +Usuwa pozostałe pliki pamięci podręcznej po aktualizacji świata. + +#### `forceUpgrade` + +Niezależnie od wersji, wymusza [aktualizację](#user-content-fn-12)[^12] świata. + +#### `help` + +- **Alias**: `?` + +Wyświetla pełny argument początkowy i opis Plazmy. + +#### `initSettings` + +Tworzy tylko plik konfiguracyjny i zamyka serwer. + +#### `jfrProfile` + +Aktywuje profilowanie JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Domyślnie**: `(serwerowe właściwości)` + +Ustawia maksymalną liczbę [graczy](#user-content-fn-14)[^14] dozwoloną. + +#### `nogui` + +Wyłącza panel interfejsu graficznego. + +#### `nojline` + +Wyłącz JLine i używaj konsoli Vanilla. + +#### `online-mode` + +- **Alias**: `o` +- **Domyślnie**: `(serwerowe właściwości)` + +Wybierz, czy zweryfikować graczy przez serwery uwierzytelniające Mojang. + +**Jeśli nie używasz Velocity lub innych proxy, możesz zostać ukarany za naruszenie [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Domyślny**: `paper.yml` + +{% hint style="warning" %} + +### Ten argument został wycofany po wersji 1.19.4 + +{% endhint %} + +Ustawia lokalizację pliku konfiguracyjnego PaperSpigot, który został wycofany z użycia. + +Służy do przenoszenia istniejącej konfiguracji do nowego pliku konfiguracyjnego, który nie jest już używany. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Domyślny**: `config` + +Ustawia nazwę i lokalizację folderu, w którym znajdują się [pliki konfiguracyjne Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Ustawia nazwę i lokalizację folderu, w którym znajdują się [pliki konfiguracyjne Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Domyślny**: `plugins` + +Ustawia lokalizację folderu wtyczek. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Domyślny**: `pufferfish.yml` + +Ustawia nazwę i lokalizację [pliku konfiguracyjnego Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Domyślny**: `purpur.yml` + +Ustawia nazwę i lokalizację [pliku konfiguracyjnego Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Uruchamia serwer w trybie pełnej Vanilla. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Domyślnie**: `(serwerowe właściwości)` + +Ustawia nazwę hosta serwera lub adres [protokołu internetowego](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Domyślnie**: `(serwerowe właściwości)` + +Ustawia port serwera. + +#### `server-name` + +- **Domyślny**: `A Plazma Server` + +Ustawia nazwę serwera. + +#### `spigot-settings` + +- **Alias**: `S` +- **Domyślny**: `spigot.yml` + +Ustawia nazwę i lokalizację [pliku konfiguracyjnego Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Wyświetla wersję Plazmy. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Domyślny**: `(folder serwera)` + +Ustawia lokalizację, w której są przechowywane pliki świata. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Domyślnie**: `(serwerowe właściwości)` + +Ustawia nazwę pliku świata. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Zmienia sposób obsługi argumentów w zależności od dodatkowego miejsca. + +[^3]: Na przykład, jeśli chcesz ustawić `Plazma.iKnowWhatIAmDoing` na `true`, zamiast wpisywać `-DPlazma.iKnowWhatIAmDoing=true`, wystarczy wpisać `-DPlazma.iKnowWhatIAmDoing` i będzie działać tak samo. + +[^4]: Na przykład, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor zdarzeń. + +[^6]: Detektor zdarzeń. + +[^7]: Klient. + +[^8]: Sygnał informujący o poprawnym połączeniu z serwerem, podobnie jak bicie serca. + +[^9]: Dzięki funkcji wyrzucania AFK w Purpur, można wyrzucić graczy, którzy są nieaktywni. + +[^10]: Synchroniczny system tworzenia chunków, Sync Chunk Write System. + +[^11]: `OSTRZEŻENIE! Plazma może powodować niespodziewane problemy, dlatego koniecznie przetestuj go dokładnie przed użyciem na serwerze publicznym.` + +[^12]: `Optymalizacja świata` w grach działa na tej samej zasadzie. + +[^13]: Protokół internetowy, IP. + +[^14]: Administratorzy poziomu 2 i wyższego są wyłączeni. diff --git a/pl/origin/plazma/adminstration/reference/commands.md b/pl/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..10fb9b20d --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź dostępne polecenia w Plazma. +--- + +# 🖥️ Polecenia diff --git a/pl/origin/plazma/adminstration/reference/configurations/bukkit.md b/pl/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..ed0246901 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/pl/origin/plazma/adminstration/reference/configurations/paper/README.md b/pl/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..1d6105812 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, do czego służy każdy plik w folderze konfiguracyjnym. +--- + +# 🛩️ Papier diff --git a/pl/origin/plazma/adminstration/reference/configurations/paper/global.md b/pl/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..567428159 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w paper-global.yml. +--- + +# 🛩️ Paper (konfiguracja globalna) diff --git a/pl/origin/plazma/adminstration/reference/configurations/paper/world.md b/pl/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..db3c00372 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w paper-world.yml. +--- + +# 🛩️ Papier (skład świata) diff --git a/pl/origin/plazma/adminstration/reference/configurations/plazma/README.md b/pl/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5d02da81f --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, do czego służy każdy plik w folderze konfiguracyjnym. +--- + +# ✨ Plazma diff --git a/pl/origin/plazma/adminstration/reference/configurations/plazma/global.md b/pl/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f21997a79 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w plazma-global.yml. +--- + +# ✨ Plazma (konfiguracja globalna) diff --git a/pl/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/pl/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..77e985285 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Skład na świecie diff --git a/pl/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/pl/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..82a55bd77 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w plazma-world.yml. +--- + +# ✨ Plazma (struktura świata) diff --git a/pl/origin/plazma/adminstration/reference/configurations/property.md b/pl/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..2d82d548c --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w server.properties. +--- + +# 🪨 Server.properties diff --git a/pl/origin/plazma/adminstration/reference/configurations/pufferfish.md b/pl/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..2af151ae2 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w pufferfish.yml. +--- + +# 🐡 Ryba balonowa diff --git a/pl/origin/plazma/adminstration/reference/configurations/purpur/README.md b/pl/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..9c61313cd --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w purpur.yml. +--- + +# 🦑 Purpur diff --git a/pl/origin/plazma/adminstration/reference/configurations/purpur/global.md b/pl/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..e7e7b02aa --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w purpur.yml. +--- + +# 🦑 Purpur (struktura globalna) diff --git a/pl/origin/plazma/adminstration/reference/configurations/purpur/world.md b/pl/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..d174afdaa --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w purpur.yml. +--- + +# 🦑 Purpur (skład świata) diff --git a/pl/origin/plazma/adminstration/reference/configurations/spigot.md b/pl/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..b705b6ec6 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź, co oznacza każdy węzeł w spigot.yml. +--- + +# 🚰 Spigot diff --git a/pl/origin/plazma/adminstration/reference/permissions.md b/pl/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..1d5109b55 --- /dev/null +++ b/pl/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Sprawdź uprawnienia Plazmy. +--- + +# 🛡️ Uprawnienia diff --git a/pl/origin/plazma/developers.md b/pl/origin/plazma/developers.md new file mode 100644 index 000000000..ed4a49281 --- /dev/null +++ b/pl/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Rozwijaj projekty zewnętrzne przy użyciu Plazmy. +--- + +# ⚙️ Przewodnik dla programistów diff --git a/pl/origin/rozne/rozne/README.md b/pl/origin/rozne/rozne/README.md new file mode 100644 index 000000000..faf4d93c6 --- /dev/null +++ b/pl/origin/rozne/rozne/README.md @@ -0,0 +1,2 @@ +# 🧾 Różne + diff --git a/pl/origin/thunderbolt/README.md b/pl/origin/thunderbolt/README.md new file mode 100644 index 000000000..ded9add27 --- /dev/null +++ b/pl/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt jest platformą serwerową opartą na Plazma, która umożliwia eksperymentalne łatanie dzielone na Flavor, aby można było je bezpośrednio wypróbować. +--- + +# 🌩️ Przewodnik użytkowania Thunderbolt diff --git a/pl/origin/volt/README.md b/pl/origin/volt/README.md new file mode 100644 index 000000000..645e05ab2 --- /dev/null +++ b/pl/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt jest szablonem open source, który umożliwia rozwijanie platformy serwerowej Paperweight opartej na Plazmie. +--- + +# ⚡ Przewodnik Rozwoju Volta diff --git a/pt-BR/origin/README.md b/pt-BR/origin/README.md new file mode 100644 index 000000000..ab0e25559 --- /dev/null +++ b/pt-BR/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Se tiver alguma dúvida, por favor pergunte no Discord ou nas Discussões do GitHub. +--- + +# 🏠 Bem-vindo ao Portal de Documentos + +{% hint style="info" %} + +**Os documentos do Plazma estão atualmente em estado de tradução automática.** + +[![Status de Tradução](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) 에서 문서 번역에 참여하여 문서를 개선해 보세요. + +{% endhint %} + +### Se ocorrer algum problema durante o uso do Plazma, o que devo fazer? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Se você tem interesse em Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 sua própria plataforma de servidor? Se você quer criar + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `PATROCINADOR` Precisa de mais informações relacionadas ao Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/pt-BR/origin/SUMMARY.md b/pt-BR/origin/SUMMARY.md new file mode 100644 index 000000000..f7cab0c19 --- /dev/null +++ b/pt-BR/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Sumário + +- [🏠 Bem-vindo ao Portal de Documentos](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documentação de Uso do Plazma](plazma/README.md) +- [❓ O que é o Plazma?](plazma/about/README.md) + - [⬇️ Download](plazma/about/downloads.md) + - [✅ Estado de Suporte da Versão](plazma/about/supported-versions.md) +- [⚒️ Guia de Administração do Servidor](plazma/administration/README.md) + - [👟 Começando](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referência](plazma/administration/reference/README.md) + - [🖥️ Comandos](plazma/administration/reference/commands.md) + - [🛡️ Permissões](plazma/administration/reference/permissions.md) + - [🎛️ Argumentos e Propriedades](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Propriedade](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configuração Global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Configurações por Mundo](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configuração Global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Configurações por Mundo](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configuração Global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Configurações por Mundo](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avançado](plazma/administration/expert/README.md) + - [🧹 Otimização](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Voltar ao Padrão](plazma/administration/expert/vanillaize.md) + - [🩻 Bloqueio de Raios X](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilidades e Soluções](plazma/administration/expert/fix-exploits.md) + - [⁉️ Perguntas Frequentes](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Guia do Desenvolvedor](plazma/developers.md) + - [✏️ Contribuir](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Guia de Uso do Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Guia de Desenvolvimento do Volt](volt/README.md) + +## Vários + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Baixar Tudo](plazma/about/downloads-all.md) diff --git a/pt-BR/origin/miscellaneous/README.md b/pt-BR/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/pt-BR/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/pt-BR/origin/plazma/README.md b/pt-BR/origin/plazma/README.md new file mode 100644 index 000000000..695c2dca4 --- /dev/null +++ b/pt-BR/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma é uma plataforma de servidor de código aberto para Minecraft: Java Edition que adiciona otimização experimental baseada em papel e recursos de personalização de vários mecanismos de jogo." +--- + +# ✨ Documentos de Uso do Plazma + +## 👋 Bem-vindo aos Documentos do Plazma + +Bem-vindo aos Documentos de Uso do Plazma! + +{% hint style="info" %} + +**Não consegue resolver o problema através do manual?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Discussões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) para fazer perguntas à comunidade! + +{% endhint %} + +### Sobre o Plazma + +> Descubra mais sobre o que é o Plazma como plataforma de servidor. + +{% content-ref url="sobre/" %} +[sobre](sobre/) +{% endcontent-ref %} + +### Para Administradores + +> Crie seu próprio servidor usando o Plazma. + +{% content-ref url="administration/" %} +[administração](administration/) +{% endcontent-ref %} + +### Para Desenvolvedores + +> Desenvolva projetos de terceiros usando o Plazma. + +{% content-ref url="desenvolvedores.md" %} +[desenvolvedores.md](desenvolvedores.md) +{% endcontent-ref %} + +*** diff --git a/pt-BR/origin/plazma/about/README.md b/pt-BR/origin/plazma/about/README.md new file mode 100644 index 000000000..06f25aba7 --- /dev/null +++ b/pt-BR/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Descubra mais sobre o que é o Plazma como plataforma de servidor. +--- + +# ❓ O que é o Plazma? + +- **Plazma** é uma plataforma de servidor baseada no [Paper](https://github.com/PaperMC/Paper), que traz apenas os pontos fortes do [Andromeda](https://github.com/EarendelArchived/Andromeda) e do [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Estamos empenhados em fornecer sempre alta estabilidade, desempenho poderoso, atualizações rápidas e uma ampla gama de recursos. + +## 📋 Objetivos do Plazma + +- Estamos trabalhando para ser uma plataforma de servidor com atualizações rápidas e alta estabilidade. +- Estamos empenhados em fornecer uma ampla gama de recursos e desempenho poderoso, não menos do que uma plataforma de modos. +- Estamos trabalhando para criar uma plataforma livre que permita personalizar até mesmo os patches do Vanilla. + +## ⚙️ Principais Características + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Atualizações mais rápidas**\ + O [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) garante que os patches incluídos no Plazma estejam sempre atualizados, oferecendo as atualizações mais rápidas entre as plataformas de servidor baseadas no Paper. +6. **Otimização dos arquivos de configuração padrão**\ + Os arquivos de configuração padrão são otimizados, não sendo necessário otimizá-los manualmente. +7. **Funcionamento multi-thread de forma sistemática**\ + As mecânicas do jogo são assíncronas em relação às mecânicas do sistema não relacionadas ao jogo, reduzindo o [tempo de latência](#user-content-fn-4)[^4] para otimizar o servidor. +8. **Bloqueio do uso de espaço desnecessário**\ + Dados com valores semelhantes são combinados para reduzir o uso de memória. + +## ✨ Casos de Uso + +- **Plataforma que lida corretamente com plugins complexos**\ + O Plazma é usado nos servidores do desenvolvedor [IPECTER](https://github.com/IPECTER).\ + Mesmo com plugins próprios que funcionam com NMS e reflexão, e uma grande quantidade de datapacks complexos e extensos,\ + consegue lidar com mais de 100 jogadores sem queda de desempenho. +- **Plataforma que mantém um desempenho rápido em servidores de RPG**\ + Manteve 100 jogadores em um único cluster de forma estável sem queda de TPS, e permitiu que 250 jogadores jogassem confortavelmente em 4 clusters. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Plataforma escolhida por muitos streamers**\ + É escolhida como um balde de participação dos espectadores por muitos streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +Você pode baixar o Plazma na página abaixo. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Quer saber mais sobre o suporte de versões? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plug-ins Bukkit, CraftBukkit, Spigot e Paper, Pufferfish, Purpur. + +[^2]: Propriedade da Microsoft Corporation. + +[^3]: Ao desativar o sistema de denúncias de chat, o chat é processado apenas no servidor, evitando o rastreamento de chat da Mojang. + +[^4]: Tempo em que o jogo é interrompido para permitir o funcionamento do mecanismo do sistema. diff --git a/pt-BR/origin/plazma/about/downloads-all.md b/pt-BR/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..93c840f46 --- /dev/null +++ b/pt-BR/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma executável de download completo +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versão | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/pt-BR/origin/plazma/about/downloads.md b/pt-BR/origin/plazma/about/downloads.md new file mode 100644 index 000000000..81eb03cb8 --- /dev/null +++ b/pt-BR/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Baixe o Plazma agora mesmo e experimente você mesmo. +--- + +# ⬇️ Download + +#### Quer saber mais sobre o suporte de versões? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**O download abaixo é um arquivo executável para uso geral.** + +Se você é um desenvolvedor e precisa de outro tipo de arquivo, consulte a página abaixo. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersãoDownload
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + Baixar +
1.19.4 + Baixar +
+ +*** diff --git a/pt-BR/origin/plazma/about/patches-list.md b/pt-BR/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..876bad0fd --- /dev/null +++ b/pt-BR/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Descubra todas as funcionalidades adicionadas ao Plazma. +--- + +# 📑 Patches incluídos diff --git a/pt-BR/origin/plazma/about/supported-versions.md b/pt-BR/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..b59a7fa77 --- /dev/null +++ b/pt-BR/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Descubra as versões do Minecraft: Java Edition suportadas pelo Plazma." +--- + +# ✅ Estado de suporte da versão + +{% hint style="info" %} + +**Plazma foi desenvolvido a partir da versão 1.19.4 e versões abaixo de 1.19.4 não estão mais sendo desenvolvidas.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Informações%20indisponíveis +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Aguardando lançamento][wtr] ![Em desenvolvimento][idv] ![Em suporte][atv] ![Suporte de funcionalidades interrompido][fse] ![Suporte encerrado][eol] + +| Versão | Estabilidade e suporte funcional | Estado de construção | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Status de build](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Status de compilação](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Status de compilação](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/pt-BR/origin/plazma/administration/README.md b/pt-BR/origin/plazma/administration/README.md new file mode 100644 index 000000000..44fedd64e --- /dev/null +++ b/pt-BR/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Crie seu próprio servidor usando o Plazma. +--- + +# ⚒️ Guia de Gerenciamento do Servidor diff --git a/pt-BR/origin/plazma/administration/diagnosis/README.md b/pt-BR/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..7bc395aeb --- /dev/null +++ b/pt-BR/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra como lidar quando surgir um problema. +--- + +# 🧾 진단 diff --git a/pt-BR/origin/plazma/administration/diagnosis/plugins.md b/pt-BR/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..058190752 --- /dev/null +++ b/pt-BR/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Descubra como resolver quando o plugin não está funcionando corretamente. +--- + +# 📜 플러그인 diff --git a/pt-BR/origin/plazma/administration/expert/README.md b/pt-BR/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..d8d45534a --- /dev/null +++ b/pt-BR/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra como lidar profissionalmente com o Plazma. +--- + +# 🎓 Avançado diff --git a/pt-BR/origin/plazma/administration/expert/fix-exploits.md b/pt-BR/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..0fa9668a8 --- /dev/null +++ b/pt-BR/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descubra sobre as vulnerabilidades conhecidas e como resolvê-las. +--- + +# ⚠️ Vulnerabilidades conhecidas e métodos de resolução diff --git a/pt-BR/origin/plazma/administration/expert/optimize.md b/pt-BR/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..4419837a0 --- /dev/null +++ b/pt-BR/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descubra como otimizar o Plazma. +--- + +# 🧹 Otimização diff --git a/pt-BR/origin/plazma/administration/expert/proxy.md b/pt-BR/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..d4be5f473 --- /dev/null +++ b/pt-BR/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Descubra como configurar com segurança a plataforma de proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/pt-BR/origin/plazma/administration/expert/vanillaize.md b/pt-BR/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..4c7ea7519 --- /dev/null +++ b/pt-BR/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Descubra como restaurar o patch do Paper e do Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +**Paper não adiciona opções à maioria dos patches de correção de erros do Vanilla.** + +Atualmente, o Plazma está desenvolvendo uma configuração para desativar essas correções de erro. + +Portanto, este guia ainda está em desenvolvimento e as informações estão sujeitas a alterações. + +{% endhint %} diff --git a/pt-BR/origin/plazma/administration/expert/xray.md b/pt-BR/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..33315cdbf --- /dev/null +++ b/pt-BR/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Descubra várias maneiras incorporadas de bloquear raios-X. +--- + +# 🩻 Bloqueio de raios-X diff --git a/pt-BR/origin/plazma/administration/faq.md b/pt-BR/origin/plazma/administration/faq.md new file mode 100644 index 000000000..7f7eb4445 --- /dev/null +++ b/pt-BR/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Descubra as perguntas frequentes. +--- + +# ⁉️ Perguntas frequentes + +{% hint style="info" %} + +**Não consegue encontrar a resposta que procura?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Discussões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) para fazer perguntas à comunidade! + +{% endhint %} + +### Plazma não está iniciando + +Se receber a mensagem `no main manifest attribute, in plazma-(versão).jar` no console,\ +o arquivo baixado é um arquivo de API de desenvolvimento, você deve baixar o **Reobf Paperweight** na página do GitHub. + +Para mais informações, consulte a seguinte página. + +{% content-ref url="getting-started/" %} +[iniciando](getting-started#id-2) +{% endcontent-ref %} + +### Um aviso é exibido sempre que o servidor é iniciado + +Plazma contém patches instáveis e pode apresentar mau funcionamento, portanto, exibe a seguinte mensagem de aviso sempre que o servidor é iniciado. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Este aviso pode ser desativado usando a propriedade do sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Para mais informações, consulte a seguinte página. + +{% content-ref url="reference/arguments.md" %} +[arguimentos.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponível a partir da versão 1.20.1 diff --git a/pt-BR/origin/plazma/administration/getting-started/README.md b/pt-BR/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..8f63374e0 --- /dev/null +++ b/pt-BR/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Descubra como criar um servidor com Plazma. +--- + +# 👟 Começando + +Para usar o Plazma de forma estável, o sistema deve atender aos seguintes requisitos. + +| | Mínimo | Recomendado | +| :---------------------: | ------ | ----------- | +| Arquitetura | x64 | - | +| RAM | 8GB | 16GB | +| Espaço de armazenamento | 1GB | 8GB | +| JDK | 17 | 21 | + +Para facilitar a edição dos arquivos de configuração, é recomendável instalar um editor como o [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Saída Correta" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Primeiramente, faça o download do **JDK 21** em formato `.msi` do [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Execute o assistente de instalação baixado e clique em `Next`. +3. Ative a opção `Set JAVA_HOME variable` no menu exibido no centro esquerdo da janela e clique em `Next`. +4. Clique em `Install` para concluir a instalação do JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Em seguida, execute o seguinte comando no terminal para instalar o JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download do Plazma + +O Plazma oferece diversos tipos de arquivos executáveis. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Saiba mais + +O nome do arquivo executável é `plazma-(gerenciador de versão)-1.20.4-R0.1-SNAPSHOT-(tipo de mapeamento).jar`. + +- **Tipo de mapeamento**\ + O mapeamento é uma espécie de mapa que liga o código real do Minecraft ao código ofuscado. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mapeado pela Mojang, é o mapeamento do Minecraft vanilla. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Gerenciador de versão**\ + O gerenciador de versão é uma espécie de lançador do servidor que é necessário para executar o servidor e aplicar patches nos arquivos do servidor. + - **Paperclip**\ + Desenvolvido pela equipe do PaperMC para Paper e outras plataformas derivadas, é responsável por baixar bibliotecas e aplicar patches no servidor. + - **Bundler**\ + Gerenciador de versão do Minecraft Vanilla. + +
+ +*** + +## 3. Criação do script de inicialização + +Para iniciar o Plazma facilmente e reiniciar o servidor automaticamente, é necessário criar um [script de inicialização](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Você pode baixar o script de inicialização clicando no botão de download na parte inferior esquerda.\ +**Certifique-se de que o script de inicialização baixado corresponde ao seu sistema operacional.** + +*** + +## 4. Organização dos arquivos + +Agora, mova o script de inicialização e o Plazma para uma nova pasta. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Agora, execute o script de inicialização. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Aceitação do EULA + +Após executar o script de inicialização, um arquivo `eula.txt` será criado na pasta. + +O EULA[^9] é um contrato de licença que você deve concordar ao usar os serviços da [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Para concordar com o EULA, edite o arquivo `eula.txt` de `eula=false` para `eula=true` e salve. + +*** + +## 6. Permitindo acesso externo (Windows) + +Os sistemas operacionais modernos bloqueiam o acesso externo por padrão com o uso de **firewalls** e **roteadores** para impedir acessos não autorizados. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Se o roteador não suportar UPnP, você precisará pesquisar as configurações específicas de cada modelo. + +Você também pode usar o [Ngrok](https://ngrok.com/) para gerar um endereço temporário. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Verificação da necessidade de encaminhamento de porta + +Digite o seguinte comando na janela de execução e execute. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Se a saída for `True`, não é necessário fazer mais nada. Se for `False`, é necessário configurar o encaminhamento de porta. + +### 6.2 Acessar o servidor + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +O endereço usado para acessar o servidor pode ser verificado [aqui](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Em seguida, ao reiniciar o servidor, o Plazma tentará automaticamente encaminhar a porta. + +Abaixo está o resultado do sucesso do UPnP com base na mensagem exibida no console, que será exibida como `[UPnP] (mensagem)` no console. + +| mensagem | significado | +| ---------------------------------- | --------------------------------------------------- | +| `Porta aberta com sucesso (porta)` | Sucesso no encaminhamento de porta. | +| `Porta (porta) já está aberta` | Outro serviço está usando a porta. | +| `Falha ao abrir porta (porta)` | Falha no encaminhamento de porta. | +| `Serviço indisponível` | O roteador não suporta UPnP. | + +Quando o servidor é encerrado, o Plazma automaticamente fecha a porta. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Baixe o arquivo ZIP `Windows (64-bit)` do [site do Ngrok](https://ngrok.com/download). +2. Coloque o Ngrok baixado na pasta do servidor. +3. No [painel do Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), gere um [token de autenticação](#user-content-fn-13)[^13]. +4. Execute o comando exibido na linha de comando na pasta do servidor. +5. Adicione `start /b ngrok tcp --region jp 25565` no início do script de execução e `taskkill /f /t /im ngrok.exe` no final. +6. A partir da mensagem exibida no topo do console `Encaminhando tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, `0.tcp.jp.ngrok.io:12345` será o endereço do servidor. +7. Agora você pode acessar o servidor externamente através desse endereço. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Por exemplo, se após a execução do comando você vir: + +```log +Configuração de IP do Windows + +Adaptador Ethernet Ethernet: + + Sufixo DNS específico de conexão. . . . : + Endereço IPv4. . . . . . . . . : 192.168.3.7 + Máscara de sub-rede. . . . . . . : 255.255.255.0 + Gateway Padrão. . . . . . . : 192.168.3.1 + +``` + +Você pode acessar o servidor localmente usando o `192.168.3.7` mostrado como o Endereço IPv4. + +Se o servidor e o jogo estiverem sendo executados no mesmo PC, você pode acessar usando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Crescer + +Se o servidor foi iniciado com sucesso e está funcionando corretamente, agora é hora de personalizar o servidor. + +Descubra como personalizar o servidor através do manual abaixo. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: O Paper, base do Plazma, é baseado no Spigot, que por sua vez é baseado na plataforma oficial do servidor Spigot. + +[^3]: Tecla Windows + R + +[^4]: Para Linux, execute `java --version` no terminal. + +[^5]: O JRE é um dos projetos de código aberto e existem várias variantes, assim como no caso da plataforma de servidores Minecraft. + +[^6]: Comumente conhecido como **launcher**. + +[^7]: Ativar o "Auto-restart" fará com que o servidor reinicie automaticamente. Você pode encerrar digitando `Control + C`. + +[^8]: Não é recomendado ultrapassar metade da capacidade do sistema. + + Por exemplo, se a capacidade total de memória do sistema for de 8GB, não é recomendado configurar mais de 4GB. + +[^9]: Contrato de Licença do Usuário Final, EULA. Consulte o [site do Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) para mais informações. + +[^10]: Microsoft Corporation. + +[^11]: De acordo com o Artigo 32, Parágrafo 1, Item 9 da Lei de Promoção da Indústria de Jogos da Coreia, a **Microsoft Korea Co., Ltd.** pode ser processada legalmente. + +[^12]: Universal Plug & Play. O Purpur incluído no Plazma se comunica automaticamente com o roteador através dessa tecnologia para abrir a porta somente quando o servidor está em execução, eliminando a necessidade de encaminhamento de porta direto. + +[^13]: Se você não tem uma conta, registre-se no Ngrok usando uma conta do Google ou GitHub. diff --git a/pt-BR/origin/plazma/administration/getting-started/customization.md b/pt-BR/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..82f5bc459 --- /dev/null +++ b/pt-BR/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Descubra como personalizar o servidor. +--- + +# 🎨 Personalização + +A razão pela qual se utiliza uma plataforma de servidor modificada como Plazma, em vez da plataforma oficial fornecida pela Mojang Studios, é a capacidade de **personalização** poderosa. + +Aqui estão várias maneiras de personalizar e usar o Plazma. + +## Modificação de Configuração + +A maneira mais básica de personalizar o Plazma é modificando a configuração. + +O Plazma oferece configurações poderosas, desde os mecanismos do jogo até as propriedades dos mobs. + +Consulte a página abaixo para obter informações sobre a configuração do Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurações](../reference/configurations/) +{% endcontent-ref %} + +## Uso de Plugins + +{% hint style="success" %} + +**Plazma suporta todos os plugins baseados em Paper normalmente.** + +Para plugins do Spigot, devido às mudanças de mapeamento a partir do Paper 1.20.5, alguns podem não funcionar, mas a maioria dos plugins baseados em Paper, Pufferfish e Purpur funcionam normalmente no Plazma. Se não funcionarem corretamente, é um erro do Plazma, portanto, [reporte imediatamente.](../diagnosis/plugins.md) + +{% endhint %} + +Esta é a principal razão para usar o Plazma e a forma mais poderosa de personalizá-lo. +O ecossistema de plugins poderoso do Plazma permite personalizar o servidor facilmente. + +Existem várias maneiras de encontrar e baixar plugins. Alguns plugins são enviados para serviços de repositórios públicos, enquanto outros são enviados para o GitHub ou sites próprios. + +{% hint style="caution" %} + +**Os plugins podem ter acesso direto ao sistema!** + +Sempre verifique se os plugins são seguros antes de aplicá-los, usando serviços como o VirusTotal, ou baixe os plugins de serviços confiáveis. + +{% endhint %} + +Existem vários serviços para baixar plugins. Dentre eles, serviços como [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisam os plugins antes de serem disponibilizados, garantindo a segurança. + +### Aplicando Plugins + +Após baixar os plugins, é hora de aplicá-los. + +1. Os plugins são arquivos `.jar` ou `Java Executable File`. Alguns podem estar compactados, nesse caso, descompacte e use o arquivo com `bukkit`, `spigot` ou `paper` no nome, ou se houver um arquivo com `fat`, use este. +2. Coloque o arquivo baixado na pasta 'plugins' do servidor e reinicie o servidor. +3. Ao iniciar o Plazma, novas informações serão exibidas no console. + Isso indica que o Plazma carregou os plugins corretamente. +4. Mesmo que o Plazma tenha carregado os plugins corretamente, pode haver problemas ao iniciá-los. + Use o comando `/plugins` para ver os plugins carregados no servidor. + Se o nome do plugin não estiver em vermelho, mas sim em verde, significa que o plugin foi carregado corretamente. + +Se o plugin não foi carregado corretamente, você pode encontrar soluções na página abaixo. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Uso de Datapacks + +Datapacks são uma forma de personalização fornecida pelo Minecraft, semelhante a pacotes de recursos. + +Com datapacks, é possível adicionar novas entidades e desafios ao jogo, modificando partes internas do jogo. + +{% hint style="caution" %} + +**Datapacks podem danificar o mundo!** + +Datapacks defeituosos podem danificar o mundo de forma irreversível. + +Portanto, é recomendável fazer backup do mundo antes de aplicar datapacks. + +{% endhint %} + +Datapacks podem ser baixados de diversos serviços, como [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs). + +Após baixar o datapack, coloque-o na pasta 'datapacks' do mundo do servidor para aplicá-lo. +Se a pasta não existir, crie-a antes de adicionar o datapack. + +{% hint style="warning" %} + +**Alguns [datapacks](#user-content-fn-2) podem não ser aplicados corretamente na primeira vez.** + +Para esses casos, é recomendável reiniciar o servidor **2 vezes**. + +{% endhint %} + +Datapacks podem ser facilmente corrompidos a cada atualização do Minecraft. + +Principalmente se um datapack estiver completamente corrompido, pode causar falhas no servidor. Portanto, é importante testar bem antes de atualizar o servidor. + +{% hint style="info" %} + +**Após o comando de inicialização do servidor, digite `safeMode` para desativar todos os datapacks antes de iniciar o servidor.** + +[Consulte 'Referência > Argumentos' para mais detalhes.](../reference/arguments.md) + +{% endhint %} + +Você pode verificar os datapacks aplicados com o comando `/datapack list`. + +*** + +[^1]: Ou através de addons do Minecraft: Bedrock Edition. + +[^2]: Adição de novas entidades, etc. diff --git a/pt-BR/origin/plazma/administration/getting-started/next-step.md b/pt-BR/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..6351b7867 --- /dev/null +++ b/pt-BR/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Descubra como personalizar o servidor. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Aqui estão várias maneiras de personalizar e usar o Plazma. + +## Modificação de Configuração + +A maneira mais básica de personalizar o Plazma é modificando a configuração. + +O Plazma oferece configurações poderosas, desde os mecanismos do jogo até as propriedades dos mobs. + +Consulte a página abaixo para obter informações sobre a configuração do Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurações](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Uso de Plugins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Esta é a principal razão para usar o Plazma e a forma mais poderosa de personalizá-lo. O ecossistema de plugins poderoso do Plazma permite personalizar o servidor facilmente. + +Existem várias maneiras de encontrar e baixar plugins. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Existem vários serviços para baixar plugins. Dentre eles, serviços como [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisam os plugins antes de serem disponibilizados, garantindo a segurança. + +### Aplicando Plugins + +Após baixar os plugins, é hora de aplicá-los. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Coloque o arquivo baixado na pasta 'plugins' do servidor e reinicie o servidor. +3. Ao iniciar o Plazma, novas informações serão exibidas no console. Isso indica que o Plazma carregou os plugins corretamente. +4. Mesmo que o Plazma tenha carregado os plugins corretamente, pode haver problemas ao iniciá-los. Use o comando `/plugins` para ver os plugins carregados no servidor. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Se o plugin não foi carregado corretamente, você pode encontrar soluções na página abaixo. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Uso de Datapacks + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Com datapacks, é possível adicionar novas entidades e desafios ao jogo, modificando partes internas do jogo. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Datapacks defeituosos podem danificar o mundo de forma irreversível. + +Portanto, é recomendável fazer backup do mundo antes de aplicar datapacks. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Após baixar o datapack, coloque-o na pasta 'datapacks' do mundo do servidor para aplicá-lo. Se a pasta não existir, crie-a antes de adicionar o datapack. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Para esses casos, é recomendável reiniciar o servidor **2 vezes**. +{% endhint %} + +Datapacks podem ser facilmente corrompidos a cada atualização do Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Você pode verificar os datapacks aplicados com o comando `/datapack list`. + +*** + +## Otimização + +Plazma possui muitos patches de otimização aplicados. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Consulte a página abaixo para informações sobre configurações de proxy seguras e corretas. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Segurança + +Com o desenvolvimento de mods, é fácil encontrar [motores de ataque de vulnerabilidades](#user-content-fn-3)[^3] online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Configuração de permissões + +Alguns comandos de administrador de plugins podem ter vulnerabilidades se as permissões não forem configuradas corretamente. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Bloqueio de X-Ray + +X-Ray é uma das vulnerabilidades facilmente exploráveis mesmo em clientes de otimização básica. + +Plazma oferece uma configuração para bloquear X-Ray por padrão. + +Consulte a página abaixo para obter informações e instruções sobre como bloquear X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Lista branca + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Para ver os jogadores com permissão de entrada, use `/whitelist query`. + +*** + +[^1]: Ou através de addons do Minecraft: Bedrock Edition. + +[^2]: Adição de novas entidades, etc. + +[^3]: Comumente conhecidos como "hacks". + +[^4]: Se a configuração não estiver otimizada, se o Plazma estiver desatualizado ou se houver novas vulnerabilidades descobertas, elas podem não estar bloqueadas. + +[^5]: Os jogadores acessam o servidor através do servidor proxy Ngrok e o endereço do Ngrok gerado a cada reinicialização é diferente. diff --git a/pt-BR/origin/plazma/administration/reference/README.md b/pt-BR/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..1b01c5f8f --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Descubra os métodos de personalização fornecidos pelo Plazma. +--- + +# 📜 리퍼런스 + +Plazma oferece vários métodos de personalização. + +Entre eles, os 4 métodos a seguir são métodos de personalização que podem ser usados imediatamente, sem necessidade de trabalho adicional. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Discussões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) para fazer perguntas à comunidade! +{% endhint %} + +*** + +## 🖥️ Comandos + +> Os comandos permitem coletar informações dentro do jogo ou personalizar o ambiente de jogo. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permissões + +> As permissões especificam a extensão da interação do jogador. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumentos e Propriedades + +> Argumentos e propriedades têm um impacto geral na operação do Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurações + +> As configurações são a forma mais fundamental de personalizar o Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/pt-BR/origin/plazma/administration/reference/arguments.md b/pt-BR/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..c24604260 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Descubra sobre os argumentos iniciais e as propriedades do sistema. +--- + +# 🎛️ Argumentos e Propriedades + +O início da aquisição e as propriedades do sistema são valores adicionados ao comando usado na execução do Plazma, que têm um impacto geral na operação do Plazma. + +[Posição anexada ao comando](#user-content-fn-2)[^2] irá dividir-se em **Argumento Inicial** e **Propriedades do Sistema**. + +*** + +## Propriedades do Sistema + +As propriedades do sistema são valores processados pelo JVM antes da inicialização do Plazma, inseridos antes do `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Modo de Uso + +As propriedades do sistema são inseridas como argumentos Java entre `java` e `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indica que o argumento não é integrado ao JVM, sendo um argumento exclusivo do Plazma, + +Se nenhum valor for inserido nas propriedades, o valor será fixado como [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Todas as Propriedades do Sistema + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Atualiza o formato de placas desativadas. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa os logs de depuração das informações das entidades. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a revisão de NMS para permitir que as informações sejam corretamente carregadas no IDE e remapeia automaticamente as informações de versão interna. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa o sistema de alerta do Watchdog do Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a mensagem de confirmação do comando `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Se você é um desenvolvedor de plugins e precisa atualizá-los, utilize o hotswap ao invés do `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa plugins que usam o sistema de entrada e saída padrão. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Adverte quando um formato desativado é detectado nos componentes de chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a verificação de padrão do servidor quando um jogador se conecta. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa logs de depuração para chaves ausentes em objetos NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa logs de depuração para blocos de cabeça com perfis inválidos. + +Isso registra todas as cabeças com perfis inválidos no mundo, juntamente com suas posições. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a priorização de classes de plugins. + +Útil em situações de problemas com sombreamento de plugins. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a consolidação de limpeza do Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valor Padrão**: `750` + +Divide em múltiplos pacotes para transmissão se a entidade exceder o valor definido. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valor Padrão**: `8192` + +Define o tamanho máximo dos pacotes que o servidor pode receber de uma vez. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a verificação da versão do Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Pode resultar em danos permanentes nos arquivos do mundo e na quebra de todo o mecanismo do jogo. + +Quaisquer problemas resultantes do uso dessa configuração são de responsabilidade do usuário, e o Plamza não oferece suporte para isso. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valor Padrão**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valor Padrão**: `80` + +Define o comprimento máximo de caracteres por linha em placas. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valor Padrão**: `(versão do mundo) + 1` + +Define a versão das informações de atualização do mundo a ser inicializada primeiro. + +Útil ao atualizar grandes quantidades de chunks, mas raramente usado em outras situações. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `True` + +Ativa o processamento de comentários em arquivos YAML. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valor Padrão**: `30` + +Expulsa um jogador se não receber dados por um determinado tempo em segundos. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ignora os comentários das propriedades do servidor. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa logs de depuração para a criação sincronizada de chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa o sistema de criação de chunks padrão do Minecraft. + +Isso salva cada chunk sequencialmente, resultando em uma grande perda de desempenho. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa o Flush Explicito do canal de rede. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Registra sempre erros que não ocorrem na thread principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Exibe um aviso se uma tarefa agendada tiver um atraso excessivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Se estiver usando o arquivo de execução fornecido por padrão, aplica apenas o patch sem iniciar o servidor. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` +- **Conflito**: `Plazma.disableConfigOptimization` + +Fortalece ainda mais a otimização inicial. + +Ativar isso fará com que o servidor fique mais rápido e seguro, mas pode ter um grande impacto no gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` +- **Conflito**: `Plazma.aggressiveOptimize` + +Não otimiza a configuração inicial. + +Isso faz uso da configuração padrão do Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` + +Desativa a marca Plazma e utiliza o ícone de servidor padrão do Vanilla. + +#### `Plazma.useVanillaConfiguration` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` +- **Conflito**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Isso pode ter um grande impacto na segurança e desempenho do servidor. + +Quaisquer problemas decorrentes do uso deste atributo são de responsabilidade do administrador do servidor. +{% endhint %} + +Fornece a configuração inicial com os valores padrão fornecidos pela Mojang. + +Isso desativa todas as correções de vulnerabilidades aplicadas pelo Paper. + +As correções de vulnerabilidades podem ser reativadas na configuração do Paper ou da Plazma. + +#### `Plazma.vanillaize` + +- **Tipo**: `Boolean` +- **Padrão**: `true` +- **Conflito**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Configura a otimização inicial para se aproximar do Vanilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Propriedade descontinuada + +As seguintes propriedades do sistema são descontinuadas. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` +- **Descontinuado**: Desde a remoção do Timings do Plazma + +Determina se pode exceder o valor máximo que pode ser enviado para a API de Timings de Aikar. + +Mesmo que isso seja feito, se não for tratado pela API, um limite de taxa será aplicado. + +*** + +## Argumento de início + +O argumento de início é inserido após `-jar *.jar` para inicializar o Plazma e é processado em conjunto. + +### Como usar + +As propriedades do sistema são inseridas como argumentos de comando após `-jar *.jar`. + +Por exemplo, se você quiser aplicar o argumento de início `nogui`,\ +insira da seguinte forma para que o Plazma processe o argumento `nogui` durante a inicialização. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumento de início completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valor padrão**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Valor padrão**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Valor padrão**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Inicia o servidor no mundo de demonstração. + +#### `eraseCache` + +Remove os arquivos de cache restantes após a atualização do mundo. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Exibe todos os argumentos de início do Plazma e suas descrições. + +#### `initSettings` + +Cria apenas os arquivos de configuração e encerra o servidor. + +#### `jfrProfile` + +Ativa o perfil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valor padrão**: `(propriedades do servidor)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Desativa o painel de interface gráfica. + +#### `nojline` + +Desativa o JLine e usa o console padrão. + +#### `online-mode` + +- **Alias**: `o` +- **Valor padrão**: `(propriedades do servidor)` + +Escolhe se deve validar os jogadores no servidor de autenticação da Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Valor padrão**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Configura a localização do arquivo de configuração descontinuado do PaperSpigot. + +Usado para migrar a configuração existente para um novo arquivo de configuração e não será mais usado posteriormente. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Valor padrão**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Valor padrão**: `plugins` + +Configura a localização da pasta de plugins. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Valor padrão**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Valor padrão**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Inicia o servidor em um estado completamente padrão. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Valor padrão**: `(propriedades do servidor)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Valor padrão**: `(propriedades do servidor)` + +Configura a porta do servidor. + +#### `server-name` + +- **Valor padrão**: `Um Servidor Plazma` + +Configura o nome do servidor. + +#### `spigot-settings` + +- **Alias**: `S` +- **Valor padrão**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Exibe a versão do Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Valor padrão**: `(pasta do servidor)` + +Configura a localização onde os arquivos do mundo são salvos. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o nome do arquivo do mundo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: A posição de processamento dos argumentos muda dependendo da posição em que são anexados. + +[^3]: Por exemplo, ao tentar definir `Plazma.iKnowWhatIAmDoing` como `true` (ativado), você pode usar apenas `-DPlazma.iKnowWhatIAmDoing` em vez de `-DPlazma.iKnowWhatIAmDoing=true` e ainda funcionará da mesma forma. + +[^4]: Por exemplo, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de eventos. + +[^6]: Detector de eventos. + +[^7]: Cliente. + +[^8]: Um sinal que indica que está conectado corretamente ao servidor, como batimentos cardíacos. + +[^9]: Com a função de expulsão AFK do Purpur, é possível expulsar jogadores ausentes. + +[^10]: Sistema de escrita de chunk síncrono, Sync Chunk Write System. + +[^11]: \`ATENÇÃO!" Plazma pode causar problemas inesperados, portanto, certifique-se de testá-lo completamente antes de usá-lo em um servidor público. + +[^12]: No jogo, a `otimização de mundo` também funciona com o mesmo princípio. + +[^13]: Administradores de `nível 2` ou superior são excluídos. + +[^14]: Protocolo de Internet, IP. diff --git a/pt-BR/origin/plazma/administration/reference/commands.md b/pt-BR/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..52e208f8c --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descubra os comandos disponíveis no Plazma. +--- + +# 🖥️ Comandos diff --git a/pt-BR/origin/plazma/administration/reference/configurations/README.md b/pt-BR/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..6f4c304aa --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: As configurações são a forma mais fundamental de personalizar o Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Propriedades + +> As propriedades são arquivos de configuração mais básicos fornecidos pelo Minecraft. Ao usar as propriedades, você pode alterar os mecanismos básicos do jogo. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configuração do Bukkit + +> A configuração do Bukkit é o arquivo de configuração mais básico fornecido pela Plazma. Ao usar a configuração do Bukkit, você pode alterar os mecanismos básicos do servidor Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configuração do Spigot + +> A configuração do Spigot permite modificar detalhes do jogo, processamento de jogadores, funcionamento de comandos e mensagens. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configuração do Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configuração do Pufferfish + +> A configuração do Pufferfish permite modificar o processamento de mundos e entidades da Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configuração do Purpur + +> As propriedades do Purpur permitem modificar os dados básicos gerais do jogo. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configuração do Plazma + +> A configuração do Plazma permite personalizar as funcionalidades da Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/pt-BR/origin/plazma/administration/reference/configurations/bukkit.md b/pt-BR/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..c7c626571 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/pt-BR/origin/plazma/administration/reference/configurations/paper/README.md b/pt-BR/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..fb95132de --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra para que serve cada arquivo na pasta de configuração. +--- + +# 🛩️ Papel diff --git a/pt-BR/origin/plazma/administration/reference/configurations/paper/global.md b/pt-BR/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f52aa30f6 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em paper-global.yml significa. +--- + +# 🌏 전역 구성 diff --git a/pt-BR/origin/plazma/administration/reference/configurations/paper/world.md b/pt-BR/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..db42c2d27 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Descubra o que cada nó em paper-world.yml significa. +--- + +# 🏳️ 세계별 구성 + +mundo diff --git a/pt-BR/origin/plazma/administration/reference/configurations/plazma/README.md b/pt-BR/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..472ba06ad --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra para que serve cada arquivo na pasta de configuração. +--- + +# ✨ Plazma diff --git a/pt-BR/origin/plazma/administration/reference/configurations/plazma/global.md b/pt-BR/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..76c606d81 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-global.yml significa. +--- + +# 🌏 전역 구성 diff --git a/pt-BR/origin/plazma/administration/reference/configurations/plazma/world.md b/pt-BR/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..0aaa75b0a --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-world.yml significa. +--- + +# 🏳️ 세계별 구성 diff --git a/pt-BR/origin/plazma/administration/reference/configurations/plazma/worlds.md b/pt-BR/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..147d1cf5a --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-world.yml significa. +--- + +# ✨ Plazma (Configuração por mundo) diff --git a/pt-BR/origin/plazma/administration/reference/configurations/property.md b/pt-BR/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..eaca537cb --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em server.properties significa. +--- + +# 🪨 Server.properties diff --git a/pt-BR/origin/plazma/administration/reference/configurations/pufferfish.md b/pt-BR/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..134e52525 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em pufferfish.yml significa. +--- + +# 🐡 Baiacu diff --git a/pt-BR/origin/plazma/administration/reference/configurations/purpur/README.md b/pt-BR/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..4fdc76d64 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em purpur.yml. +--- + +# 🦑 Purpur diff --git a/pt-BR/origin/plazma/administration/reference/configurations/purpur/global.md b/pt-BR/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..a9601a18b --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/pt-BR/origin/plazma/administration/reference/configurations/purpur/world.md b/pt-BR/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..938c2d880 --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/pt-BR/origin/plazma/administration/reference/configurations/spigot.md b/pt-BR/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..51a1e119e --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó do spigot.yml significa. +--- + +# 🚰 Spigot diff --git a/pt-BR/origin/plazma/administration/reference/permissions.md b/pt-BR/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..ad76a341d --- /dev/null +++ b/pt-BR/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,379 @@ +--- +description: Saiba mais sobre as permissões do Plazma. +--- + +# 🛡️ Permissões + +Permissão é uma ferramenta de segurança simples que define o escopo no qual os jogadores no servidor podem interagir entre si. + +Para usar e editar permissões corretamente, você deve usar plugins como [LuckPerms](https://luckperms.net). + +*** + +## Entendendo o sistema de permissões básicas + +No Minecraft, existem grupos de permissões de gerenciamento básicos fornecidos. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Jogador**\ + É o grupo de permissões concedido a todos os jogadores em geral. +2. **Moderador**\ + Pode ignorar a proteção de spawn. +3. **Administrador de Mundo**\ + Pode usar todos os comandos e blocos de comando relacionados à gestão do mundo. É o grupo de permissões padrão para datapacks e blocos de comando. +4. **Administrador**\ + Pode usar todos os comandos relacionados à gestão de jogadores. +5. **Super Administrador**\ + Pode usar todos os comandos, incluindo os de gestão do servidor. É o grupo de permissões padrão para o console e operadores. + +*** + +## Configurando Permissões + +*** + +## Permissões Totais + +*** + +#### `allow.ride.(Chave de Namespace)` + +- **Padrão**: `Nenhum` + +Permite que os jogadores montem em entidades ao se agacharem e interagirem com elas. + +Ao montar em uma entidade, os jogadores podem controlar o movimento da entidade com as teclas de movimento e pular ou voar com a tecla de pulo. + +A `(Chave de Namespace)` é o [ID de Namespace](#user-content-fn-2) da entidade. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Chave de Namespace)` + +- **Padrão**: `Nenhum` + +Permite que os jogadores usem habilidades especiais das entidades enquanto montadas nelas. + +Nem todas as entidades possuem habilidades especiais disponíveis. Consulte abaixo para ver todas as habilidades especiais disponíveis. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Compartilhe suas ideias no [Plazma Discord](https://plazmamc.org/discord) ou [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Ver Habilidades Especiais Disponíveis Atualmente + +- **`creeper`**\ + Explode ao pressionar a tecla de pulo. Se o jogador tiver a permissão `allow.powered.creeper`, pode segurar a tecla de pulo para carregar a explosão. +- **`dolphin`**\ + Avança ao pressionar a tecla de pulo. +- **`phantom`**\ + Dispara chamas ao pressionar a tecla de pulo. +- **`wither`**\ + Dispara cabeças de Wither ao interagir. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/credits (Jogador)`](commands.md#credits). + +Adiciona a extensão `.other` ao nome da permissão para permitir que outros jogadores a usem. + +#### `bukkit.command.demo` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/demo (Jogador)`](commands.md#demo). + +Adiciona a extensão `.other` ao nome da permissão para permitir que outros jogadores a usem. + +#### `bukkit.command.ping` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/ping (Jogador)`](commands.md#ping). + +Adiciona a extensão `.other` ao nome da permissão para permitir que outros jogadores a usem. + +#### `bukkit.command.ram` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/rambar (Jogador)`](commands.md#rambar). + +Adiciona a extensão `.other` ao nome da permissão para permitir que outros jogadores a usem. + +#### `bukkit.command.restart` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/tpsbar (Jogador)`](commands.md#tpsbar). + +Adiciona a extensão `.other` ao nome da permissão para permitir que outros jogadores a usem. + +#### `bukkit.command.timings` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Para funcionalidades similares, consulte [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(Modo de Jogo)` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/gamemode (Modo de Jogo) (Jogador)`](commands.md#gamemode). + +Adiciona a extensão `.other` ao nome da permissão para permitir que outros jogadores a usem. + +#### `paper.antixray.bypass` + +- **Padrão**: `Nenhum` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Isso melhora o desempenho para ambos os lados. + +> Para saber mais sobre as configurações de X-Ray, consulte a página abaixo. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Padrão**: `Nenhum` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Padrão**: `Nenhum` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Padrão**: `Nenhum` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Padrão**: `Nenhum` + +Permite o uso de [tags MiniMessage](https://docs.advntr.dev/minimessage/format.html) em bigornas. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Padrão**: `Nenhum` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Padrão**: `Nenhum` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Padrão**: `Nenhum` + +Exclui jogadores da lista de expulsão por inatividade. + +#### `purpur.debug.f3n` + +- **Padrão**: `Administrador de Mundo` + +Permite que os jogadores alterem o modo de jogo pressionando `F3 + N`. + +Isso só funciona se o jogador tiver permissão para esse modo de jogo. + +#### `purpur.drop.spawners` + +- **Padrão**: `Nenhum` + +Ao minerar um bloco de spawner com o item configurado, o bloco de spawner será derrubado. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NúmeroString)` + +- **Padrão**: `Nenhum` + +Altera o tamanho do baú de ender. + +Você pode inserir `one`, `two`, `three`, `four`, `five`, `six` em `(NúmeroString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Padrão**: `Nenhum` + +Permite que o totem da imortalidade funcione mesmo quando está no inventário. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Padrão**: `Nenhum` + +Permite que o jogador ignore o limite de jogadores conectados. + +#### `purpur.mending_shift_click` + +- **Padrão**: `Nenhum` + +Permite que o jogador repare o item que está segurando ao `agachar e interagir`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Padrão**: `Nenhum` + +Permite que o jogador instale spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Padrão**: `Nenhum` + +Permite que o jogador seja teleportado imediatamente ao usar o portal do Nether. + +#### `purpur.sign.color` + +- **Padrão**: `Nenhum` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Padrão**: `Nenhum` + +Permite o uso do código de obfuscação `(&o)` em placas. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Padrão**: `Nenhum` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Padrão**: `Nenhum` + +Permite que os jogadores evitem a explosão do TNT interagindo com ele usando uma tesoura. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permissões previstas + +#### `plazma.bypass.ncr-require` + +- **Padrão**: `Nenhum` + +Permite que os jogadores entrem mesmo sem ter o mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) instalado. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operador. + +[^2]: Exemplo: `ender_dragon` diff --git a/pt-BR/origin/plazma/adminstration/README.md b/pt-BR/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..44fedd64e --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Crie seu próprio servidor usando o Plazma. +--- + +# ⚒️ Guia de Gerenciamento do Servidor diff --git a/pt-BR/origin/plazma/adminstration/expert/README.md b/pt-BR/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..d8d45534a --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra como lidar profissionalmente com o Plazma. +--- + +# 🎓 Avançado diff --git a/pt-BR/origin/plazma/adminstration/expert/fix-exploits.md b/pt-BR/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..0fa9668a8 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descubra sobre as vulnerabilidades conhecidas e como resolvê-las. +--- + +# ⚠️ Vulnerabilidades conhecidas e métodos de resolução diff --git a/pt-BR/origin/plazma/adminstration/expert/optimize.md b/pt-BR/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..4419837a0 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descubra como otimizar o Plazma. +--- + +# 🧹 Otimização diff --git a/pt-BR/origin/plazma/adminstration/expert/vanillaize.md b/pt-BR/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..a54ec4a4e --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Descubra como restaurar o patch do Paper e do Vanilla. +--- + +# ↩️ Vanillaize + +{% hint style="warning" %} + +### O Paper não oferece opções para a maioria dos patches de correção do Vanilla. + +Atualmente, o Plazma está desenvolvendo uma configuração para desativar essas correções de erro. + +Portanto, este guia ainda está em desenvolvimento e as informações estão sujeitas a alterações. +{% endhint %} diff --git a/pt-BR/origin/plazma/adminstration/faq.md b/pt-BR/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..491a9c8a4 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Descubra as perguntas frequentes. +--- + +# ⁉️ Perguntas frequentes + +{% hint style="info" %} + +### Não consegue encontrar a resposta que procura? + +Faça perguntas à comunidade através do [servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### O programa não está sendo executado com uma mensagem de saída + +Se receber a mensagem `no main manifest attribute, in plazma-(versão).jar` no console,\ +o arquivo baixado é um arquivo de API de desenvolvimento, você deve baixar o **Reobf Paperweight** na página do GitHub. + +Para mais informações, consulte a seguinte página. + +{% content-ref url="getting-started/" %} +[iniciando](getting-started#id-2) +{% endcontent-ref %} + +### Um aviso é exibido sempre que o servidor é iniciado + +Plazma contém patches instáveis e pode apresentar mau funcionamento, portanto, exibe a seguinte mensagem de aviso sempre que o servidor é iniciado. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Este aviso pode ser desativado usando a propriedade do sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Para mais informações, consulte a seguinte página. + +{% content-ref url="reference/arguments.md" %} +[arguimentos.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponível a partir da versão 1.20.1 diff --git a/pt-BR/origin/plazma/adminstration/getting-started/README.md b/pt-BR/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..71e00673b --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Descubra como criar um servidor com Plazma. +--- + +# 👟 Começando + +Para usar o Plazma de forma estável, o sistema deve atender aos seguintes requisitos. + +| | Mínimo | Recomendado | +| :---------------------: | -----: | ----------: | +| Arquitetura | x64 | - | +| RAM | 8GB | 16GB | +| Espaço de armazenamento | 1GB | 8GB | +| JRE | 17 | 21 | + +Para facilitar a edição dos arquivos de configuração, é recomendável instalar um editor como o [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalação do JRE + +Como o nome sugere, o Minecraft: **"Java"** Edition é desenvolvido em Java e requer o JRE[^1] para ser executado. + +Como o Plazma é baseado na plataforma oficial de servidores da Mojang Studios[^2], também é necessário instalar o JRE para usar o Plazma. + +### 1.1 Verificação da existência do JRE + +Para verificar se o JRE está instalado no sistema, digite [`cmd /k java --version`](#user-content-fn-4)[^4] na janela de execução. + +Se a saída for como abaixo, pule para o [passo 2](setup.md#id-2). + +{% code title="Saída correta" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Se a saída for diferente ou se for como abaixo, o JRE não está instalado ou está desatualizado, então você precisa executar o [passo 1.2](setup.md#id-1.2). + +{% code title="JRE não instalado" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE desatualizado" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalação do JRE + +Neste guia, utilizaremos o Azul Zulu como [uma das opções](#user-content-fn-5)[^5] de JRE. + +Após a instalação, verifique se a instalação foi concluída corretamente executando novamente o [passo 1.1](setup.md#id-1.1). + +{% tabs %} +{% tab title="Windows" %} + +1. Primeiramente, faça o download do **JDK 21** em formato `.msi` do [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Execute o assistente de instalação baixado e clique em `Next`. +3. Ative a opção `Set JAVA_HOME variable` no menu exibido no centro esquerdo da janela e clique em `Next`. +4. Clique em `Install` para concluir a instalação do JRE. + {% endtab %} + +{% tab title="macOS" %} +Faça o download do assistente de instalação em formato `.dmg` do **JDK 21** no [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) e execute para instalar o JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Primeiro, execute o seguinte comando no terminal para adicionar o repositório do Azul Zulu ao APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Em seguida, execute o seguinte comando no terminal para instalar o JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Você pode instalar o JRE executando o seguinte comando. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download do Plazma + +O Plazma oferece diversos tipos de arquivos executáveis. + +{% hint style="warning" %} + +### Na maioria dos casos, utilize o `Reobf Paperclip`. + +As informações a seguir são para desenvolvedores ou curiosos sobre as características de cada tipo.\ +Se você é um usuário comum, não há problema em pular para o [passo 3](setup.md#id-3). +{% endhint %} + +
+ +Saiba mais + +O nome do arquivo executável é `plazma-(gerenciador de versão)-1.20.4-R0.1-SNAPSHOT-(tipo de mapeamento).jar`. + +- **Tipo de mapeamento**\ + O mapeamento é uma espécie de mapa que liga o código real do Minecraft ao código ofuscado. + - **Reobf**\ + Reobfuscation, também conhecido como mapeamento Spigot, é amplamente utilizado em plugins NMS.\ + A partir da versão 1.20.5, seu uso será descontinuado. + - **Mojmap**\ + Mapeamento da Mojang, é o mapeamento do Minecraft Vanilla. +- **Gerenciador de versão**\ + O gerenciador de versão é uma espécie de lançador do servidor que é necessário para executar o servidor e aplicar patches nos arquivos do servidor. + - **Paperclip**\ + Desenvolvido pela equipe do PaperMC para Paper e outras plataformas derivadas, é responsável por baixar bibliotecas e aplicar patches no servidor. + - **Bundler**\ + Gerenciador de versão do Minecraft Vanilla. + +
+ +*** + +## 3. Criação do script de inicialização + +Para iniciar o Plazma facilmente e reiniciar o servidor automaticamente, é necessário criar um [script de inicialização](#user-content-fn-6)[^6]. + +Você pode criar o script de inicialização através do [Flags.sh](https://flags.sh). Basta inserir a [memória a ser usada pelo Plazma](#user-content-fn-8)[^8] e o comando será otimizado automaticamente. + +Você pode baixar o script de inicialização clicando no botão de download na parte inferior esquerda.\ +**Certifique-se de que o script de inicialização baixado corresponde ao seu sistema operacional.** + +*** + +## 4. Organização dos arquivos + +Agora, mova o script de inicialização e o Plazma para uma nova pasta. + +{% hint style="warning" %} + +### O nome da pasta não deve conter espaços e deve ser em inglês. + +Caso contrário, o Plazma ou o JRE podem não funcionar corretamente. +{% endhint %} + +Agora, execute o script de inicialização. Para o Windows, no prompt de permissão de firewall, selecione **Permitir**. + +*** + +## 5. Aceitação do EULA + +Após executar o script de inicialização, um arquivo `eula.txt` será criado na pasta. + +O EULA[^9] é um contrato de licença que você deve concordar ao usar os serviços da [Mojang Studios](#user-content-fn-10)[^10]. + +Se você não concordar com o EULA, não poderá iniciar o servidor e poderá receber penalidades, como a suspensão da conta, por violar o EULA. + +Para concordar com o EULA, edite o arquivo `eula.txt` de `eula=false` para `eula=true` e salve. + +*** + +## 6. Permitindo acesso externo (Windows) + +Os sistemas operacionais modernos bloqueiam o acesso externo por padrão com o uso de **firewalls** e **roteadores** para impedir acessos não autorizados. + +No Windows, como você já permitiu no [passo 3](setup.md#id-3), basta encaminhar as portas. + +{% hint style="info" %} + +### Este guia pressupõe que você está utilizando o sistema operacional Windows e um roteador compatível com [**UPnP**](#user-content-fn-12)[^12]. + +Se o roteador não suportar UPnP, você precisará pesquisar as configurações específicas de cada modelo. + +Você também pode usar o [Ngrok](https://ngrok.com/) para gerar um endereço temporário. +{% endhint %} + +{% hint style="warning" %} + +### Para sistemas operacionais baseados em UNIX, como Linux ou macOS, a configuração do firewall varia de acordo com o serviço, então é necessário pesquisar as informações específicas. + +{% endhint %} + +### 6.1 Verificação da necessidade de encaminhamento de porta + +Digite o seguinte comando na janela de execução e execute. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Se a saída for `True`, não é necessário fazer mais nada. Se for `False`, é necessário configurar o encaminhamento de porta. + +### 6.2 Acessar o servidor + +{% tabs %} +{% tab title="Acesso externo" %} +Se não for necessário encaminhamento de porta ou se o encaminhamento de porta já foi bem-sucedido, agora você pode acessar o servidor. + +O endereço usado para acessar o servidor pode ser verificado [aqui](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Tentando encaminhamento de porta UPnP" %} +No arquivo `purpur.yml` da pasta do servidor, ative `network.upnp-port-forwarding` para `true`. + +Em seguida, ao reiniciar o servidor, o Plazma tentará automaticamente encaminhar a porta. + +Abaixo está o resultado do sucesso do UPnP com base na mensagem exibida no console, que será exibida como `[UPnP] (mensagem)` no console. + +| mensagem | significado | +| ---------------------------------- | ----------------------------------- | +| `Porta aberta com sucesso (porta)` | Sucesso no encaminhamento de porta. | +| `Porta (porta) já está aberta` | Outro serviço está usando a porta. | +| `Falha ao abrir porta (porta)` | Falha no encaminhamento de porta. | +| `Serviço indisponível` | O roteador não suporta UPnP. | + +Quando o servidor é encerrado, o Plazma automaticamente fecha a porta. +{% endtab %} + +{% tab title="Criando um endereço temporário com Ngrok" %} +O uso do Ngrok é útil para testes temporários, jogar com amigos ou participar de atividades colaborativas. + +1. Baixe o arquivo ZIP `Windows (64-bit)` do [site do Ngrok](https://ngrok.com/download). +2. Coloque o Ngrok baixado na pasta do servidor. +3. No [painel do Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), gere um [token de autenticação](#user-content-fn-13)[^13]. +4. Execute o comando exibido na linha de comando na pasta do servidor. +5. Adicione `start /b ngrok tcp --region jp 25565` no início do script de execução e `taskkill /f /t /im ngrok.exe` no final. +6. A partir da mensagem exibida no topo do console `Encaminhando tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, `0.tcp.jp.ngrok.io:12345` será o endereço do servidor. +7. Agora você pode acessar o servidor externamente através desse endereço. + {% endtab %} + +{% tab title="Acesso local" %} +Se você está tentando acessar o servidor localmente, execute `cmd /k ipconfig` na janela de execução para acessar o servidor usando o `Endereço IPv4` exibido. + +Por exemplo, se após a execução do comando você vir: + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Você pode acessar o servidor localmente usando o `192.168.3.7` mostrado como o Endereço IPv4. + +Se o servidor e o jogo estiverem sendo executados no mesmo PC, você pode acessar usando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Fase de desenvolvimento + +Se o servidor foi iniciado com sucesso e está funcionando corretamente, agora é hora de personalizar o servidor. + +Saiba como personalizar o servidor seguindo o guia abaixo. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Ambiente de Execução Java. + +[^2]: O Paper, base do Plazma, é baseado no Spigot, que por sua vez é baseado na plataforma oficial do servidor Spigot. + +[^3]: Tecla Windows + R + +[^4]: Para Linux, execute `java --version` no terminal. + +[^5]: O JRE é um dos projetos de código aberto e existem várias variantes, assim como no caso da plataforma de servidores Minecraft. + +[^6]: Comumente conhecido como **launcher**. + +[^7]: Ativar o "Auto-restart" fará com que o servidor reinicie automaticamente. Você pode encerrar digitando `Control + C`. + +[^8]: Não é recomendado ultrapassar metade da capacidade do sistema. + + Por exemplo, se a capacidade total de memória do sistema for de 8GB, não é recomendado configurar mais de 4GB. + +[^9]: Contrato de Licença do Usuário Final, EULA. Consulte o [site do Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) para mais informações. + +[^10]: Microsoft Corporation. + +[^11]: De acordo com o Artigo 32, Parágrafo 1, Item 9 da Lei de Promoção da Indústria de Jogos da Coreia, a **Microsoft Korea Co., Ltd.** pode ser processada legalmente. + +[^12]: Universal Plug & Play. O Purpur incluído no Plazma se comunica automaticamente com o roteador através dessa tecnologia para abrir a porta somente quando o servidor está em execução, eliminando a necessidade de encaminhamento de porta direto. + +[^13]: Se você não tem uma conta, registre-se no Ngrok usando uma conta do Google ou GitHub. diff --git a/pt-BR/origin/plazma/adminstration/getting-started/customization.md b/pt-BR/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..af08617e6 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Descubra como personalizar o servidor. +--- + +# 🎨 Personalização diff --git a/pt-BR/origin/plazma/adminstration/reference/arguments.md b/pt-BR/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..278b7b5c1 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Descubra sobre os argumentos iniciais e as propriedades do sistema. +--- + +# 🎛️ Argumentos e Propriedades + +Os argumentos iniciais e as propriedades do sistema são valores adicionados aos comandos usados na execução do Plazma, permitindo alterar valores que não podem ser modificados após a execução do Plazma. + +De acordo com a [posição em que são adicionados aos comandos](#user-content-fn-2)[^2], eles são divididos em **Argumentos Iniciais** e **Propriedades do Sistema**. + +*** + +## Propriedades do Sistema + +As propriedades do sistema são valores processados pelo JVM antes da inicialização do Plazma, inseridos antes do `-jar`. + +{% hint style="warning" %} + +### Alterar as propriedades do sistema pode modificar o funcionamento do Plazma e do JVM, podendo impactar significativamente o jogo! + +Se não entender claramente o papel de cada propriedade do sistema, **não as utilize de forma alguma!** +{% endhint %} + +### Modo de Uso + +As propriedades do sistema são inseridas como argumentos Java entre `java` e `-jar`. + +Por exemplo, ao aplicar a propriedade do sistema `Plazma.dummyProperty`, ao inserir o valor `37`, o Plazma será inicializado com esse valor. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indica que o argumento não é integrado ao JVM, sendo um argumento exclusivo do Plazma, + +Se nenhum valor for inserido, o valor será fixado como [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### As plataformas de servidor da série Paperweight incluem um ponto `.` no nome da propriedade para distinguir as propriedades do sistema entre as plataformas. + +Em alguns terminais como o Windows Powershell, pode ser necessário adicionar `"` nas extremidades dos argumentos para aceitá-los. [Adicionar.](#user-content-fn-4)[^4] +{% endhint %} + +### Todas as Propriedades do Sistema + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Atualiza o formato de placas desativadas. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa os logs de depuração das informações das entidades. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a revisão de NMS para permitir que as informações sejam corretamente carregadas no IDE e remapeia automaticamente as informações de versão interna. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa o sistema de alerta do Watchdog do Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a mensagem de confirmação do comando `/reload`. + +{% hint style="danger" %} + +### Como o comando `/reload` é muito instável, todos os problemas que ocorrerem no servidor após seu uso são de responsabilidade do usuário. + +Se você é um desenvolvedor de plugins e precisa atualizá-los, utilize o hotswap ao invés do `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa plugins que usam o sistema de entrada e saída padrão. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Adverte quando um formato desativado é detectado nos componentes de chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a verificação de padrão do servidor quando um jogador se conecta. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa logs de depuração para chaves ausentes em objetos NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa logs de depuração para blocos de cabeça com perfis inválidos. + +Isso registra todas as cabeças com perfis inválidos no mundo, juntamente com suas posições. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa o limite de 128 canais de plugin por jogador. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a priorização de classes de plugins. + +Útil em situações de problemas com sombreamento de plugins. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a consolidação de limpeza do Netty. + +#### `Paper.excessiveTELimit` + +- **Tipo**: `Integer` +- **Valor Padrão**: `750` + +Divide em múltiplos pacotes para transmissão se a entidade exceder o valor definido. + +#### `Paper.filterThreshold` + +- **Tipo**: `Integer` +- **Valor Padrão**: `8192` + +Define o tamanho máximo dos pacotes que o servidor pode receber de uma vez. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Desativa a verificação da versão do Java. + +{% hint style="danger" %} + +### Isso pode permitir que o JVM acesse código inexistente! + +Pode resultar em danos permanentes nos arquivos do mundo e na quebra de todo o mecanismo do jogo. + +Quaisquer problemas resultantes do uso dessa configuração são de responsabilidade do usuário, e o Plamza não oferece suporte para isso. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tipo**: `Integer` +- **Valor Padrão**: `64` + +Define o limite de caracteres nos nomes dos canais de plugin. + +#### `Paper.maxSignLength` + +- **Tipo**: `Integer` +- **Valor Padrão**: `80` + +Define o comprimento máximo de caracteres por linha em placas. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tipo**: `Integer` +- **Valor Padrão**: `(versão do mundo) + 1` + +Define a versão das informações de atualização do mundo a ser inicializada primeiro. + +Útil ao atualizar grandes quantidades de chunks, mas raramente usado em outras situações. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `True` + +Ativa o processamento de comentários em arquivos YAML. + +#### `Paper.playerConnection.keepAlive` + +- **Tipo**: `Integer` +- **Valor Padrão**: `30` + +Expulsa um jogador se não receber dados por um determinado tempo em segundos. + +Normalmente, o jogo[^7] continua enviando sinais de [heartbeat](#user-content-fn-8)[^8] ao servidor, evitando a expulsão, mas se o jogo não responder, é considerado em colapso e o jogador é expulso. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ignora os comentários das propriedades do servidor. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa logs de depuração para a criação sincronizada de chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa o sistema de criação de chunks padrão do Minecraft. + +Isso salva cada chunk sequencialmente, resultando em uma grande perda de desempenho. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Ativa o Flush Explicito do canal de rede. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Registra sempre erros que não ocorrem na thread principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Exibe um aviso se uma tarefa agendada tiver um atraso excessivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `False` + +Se estiver usando o arquivo de execução fornecido por padrão, aplica apenas o patch sem iniciar o servidor. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` + +{% hint style="warning" %} + +### Essa propriedade será movida para os argumentos iniciais após o 1.20.5. + +{% endhint %} + +Aplica otimizações de configuração mais rigorosas no início do jogo. + +Ao ativar, o servidor ficará mais rápido e seguro, mas pode bloquear algumas mecânicas ou ter um grande impacto no jogo. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` + +Suprime o aviso[^11] exibido quando o Plazma é inicializado. + +### Propriedade descontinuada + +As seguintes propriedades do sistema são descontinuadas. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `false` +- **Descontinuado**: Desde a remoção do Timings do Plazma + +Determina se pode exceder o valor máximo que pode ser enviado para a API de Timings de Aikar. + +Mesmo que isso seja feito, se não for tratado pela API, um limite de taxa será aplicado. + +*** + +## Argumento de início + +O argumento de início é inserido após `-jar *.jar` para inicializar o Plazma e é processado em conjunto. + +### Como usar + +As propriedades do sistema são inseridas como argumentos de comando após `-jar *.jar`. + +Por exemplo, se você quiser aplicar o argumento de início `nogui`,\ +insira da seguinte forma para que o Plazma processe o argumento `nogui` durante a inicialização. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumento de início completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valor padrão**: `bukkit.yml` + +Configura o nome e a localização do [arquivo de configurações do Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Valor padrão**: `commands.yml` + +Configura o nome e a localização do [arquivo de configurações de comandos do Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Valor padrão**: `server.properties` + +Configura o nome e a localização do [arquivo de propriedades do servidor](../reference/configurations/property.md). + +#### `demo` + +Inicia o servidor no mundo de demonstração. + +#### `eraseCache` + +Remove os arquivos de cache restantes após a atualização do mundo. + +#### `forceUpgrade` + +Força a [atualização](#user-content-fn-12)[^12] do mundo, ignorando a versão. + +#### `help` + +- **Alias**: `?` + +Exibe todos os argumentos de início do Plazma e suas descrições. + +#### `initSettings` + +Cria apenas os arquivos de configuração e encerra o servidor. + +#### `jfrProfile` + +Ativa o perfil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valor padrão**: `(propriedades do servidor)` + +Define o número máximo de [jogadores](#user-content-fn-14)[^14] permitidos. + +#### `nogui` + +Desativa o painel de interface gráfica. + +#### `nojline` + +Desativa o JLine e usa o console padrão. + +#### `online-mode` + +- **Alias**: `o` +- **Valor padrão**: `(propriedades do servidor)` + +Escolhe se deve validar os jogadores no servidor de autenticação da Mojang. + +**Caso não esteja usando Velocity ou outro proxy, pode resultar em violação do [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Valor padrão**: `paper.yml` + +{% hint style="warning" %} + +### Este argumento foi descontinuado após a versão 1.19.4 + +{% endhint %} + +Configura a localização do arquivo de configuração descontinuado do PaperSpigot. + +Usado para migrar a configuração existente para um novo arquivo de configuração e não será mais usado posteriormente. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Valor padrão**: `config` + +Configura o nome e a localização da pasta onde o [arquivo de configuração do Paper](../reference/configurations/paper/README.md) está localizado. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Configura o nome e a localização da pasta onde o [arquivo de configuração do Plazma](../reference/configurations/plazma/README.md) está localizado. + +#### `plugins` + +- **Alias**: `p` +- **Valor padrão**: `plugins` + +Configura a localização da pasta de plugins. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Valor padrão**: `pufferfish.yml` + +Configura o nome e a localização do [arquivo de configuração do Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Valor padrão**: `purpur.yml` + +Configura o nome e a localização do [arquivo de configuração do Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Inicia o servidor em um estado completamente padrão. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o nome do host do servidor ou o endereço de [Protocolo de Internet](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Valor padrão**: `(propriedades do servidor)` + +Configura a porta do servidor. + +#### `server-name` + +- **Valor padrão**: `Um Servidor Plazma` + +Configura o nome do servidor. + +#### `spigot-settings` + +- **Alias**: `S` +- **Valor padrão**: `spigot.yml` + +Configura o nome e a localização do [arquivo de configurações do Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Exibe a versão do Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Valor padrão**: `(pasta do servidor)` + +Configura a localização onde os arquivos do mundo são salvos. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o nome do arquivo do mundo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: A posição de processamento dos argumentos muda dependendo da posição em que são anexados. + +[^3]: Por exemplo, ao tentar definir `Plazma.iKnowWhatIAmDoing` como `true` (ativado), você pode usar apenas `-DPlazma.iKnowWhatIAmDoing` em vez de `-DPlazma.iKnowWhatIAmDoing=true` e ainda funcionará da mesma forma. + +[^4]: Por exemplo, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de eventos. + +[^6]: Detector de eventos. + +[^7]: Cliente. + +[^8]: Um sinal que indica que está conectado corretamente ao servidor, como batimentos cardíacos. + +[^9]: Com a função de expulsão AFK do Purpur, é possível expulsar jogadores ausentes. + +[^10]: Sistema de escrita de chunk síncrono, Sync Chunk Write System. + +[^11]: \`ATENÇÃO!" Plazma pode causar problemas inesperados, portanto, certifique-se de testá-lo completamente antes de usá-lo em um servidor público. + +[^12]: No jogo, a `otimização de mundo` também funciona com o mesmo princípio. + +[^13]: Protocolo de Internet, IP. + +[^14]: Administradores de `nível 2` ou superior são excluídos. diff --git a/pt-BR/origin/plazma/adminstration/reference/commands.md b/pt-BR/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..52e208f8c --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descubra os comandos disponíveis no Plazma. +--- + +# 🖥️ Comandos diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/bukkit.md b/pt-BR/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..c7c626571 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/paper/README.md b/pt-BR/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..fb95132de --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra para que serve cada arquivo na pasta de configuração. +--- + +# 🛩️ Papel diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/paper/global.md b/pt-BR/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..d02dfd30e --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em paper-global.yml significa. +--- + +# 🛩️ Paper (Configuração Global) diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/paper/world.md b/pt-BR/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..b0fee12df --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em paper-world.yml significa. +--- + +# 🛩️ Paper (Composição por mundo) diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/README.md b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..472ba06ad --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra para que serve cada arquivo na pasta de configuração. +--- + +# ✨ Plazma diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/global.md b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f31dafe34 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-global.yml significa. +--- + +# ✨ Plazma (Configuração Global) diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..9d783ce50 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Mundial por país diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..147d1cf5a --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-world.yml significa. +--- + +# ✨ Plazma (Configuração por mundo) diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/property.md b/pt-BR/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..eaca537cb --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em server.properties significa. +--- + +# 🪨 Server.properties diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/pufferfish.md b/pt-BR/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..134e52525 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em pufferfish.yml significa. +--- + +# 🐡 Baiacu diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/README.md b/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..4fdc76d64 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em purpur.yml. +--- + +# 🦑 Purpur diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/global.md b/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..4cd536e0b --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em purpur.yml. +--- + +# 🦑 Purpur (estrutura global) diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/world.md b/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..b19444814 --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o significado de cada nó em purpur.yml. +--- + +# 🦑 Purpur (composição mundial) diff --git a/pt-BR/origin/plazma/adminstration/reference/configurations/spigot.md b/pt-BR/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..51a1e119e --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó do spigot.yml significa. +--- + +# 🚰 Spigot diff --git a/pt-BR/origin/plazma/adminstration/reference/permissions.md b/pt-BR/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..393f2714e --- /dev/null +++ b/pt-BR/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Saiba mais sobre as permissões do Plazma. +--- + +# 🛡️ Permissões diff --git a/pt-BR/origin/plazma/developers.md b/pt-BR/origin/plazma/developers.md new file mode 100644 index 000000000..67eec462c --- /dev/null +++ b/pt-BR/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Desenvolva projetos de terceiros usando o Plazma. +--- + +# ⚙️ Guia do desenvolvedor diff --git a/pt-BR/origin/thunderbolt/README.md b/pt-BR/origin/thunderbolt/README.md new file mode 100644 index 000000000..ceefdb4c9 --- /dev/null +++ b/pt-BR/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt é uma plataforma de servidor baseada em Plazma que permite experimentar patches experimentais diferenciando-os como Flavor para uso direto. +--- + +# 🌩️ Guia de Uso do Thunderbolt diff --git a/pt-BR/origin/volt/README.md b/pt-BR/origin/volt/README.md new file mode 100644 index 000000000..13111adf7 --- /dev/null +++ b/pt-BR/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt é um modelo de código aberto que permite desenvolver sua própria plataforma de servidor Paperweight com base no Plazma. +--- + +# ⚡ Guia de Desenvolvimento do Volt diff --git a/pt-PT/origin/README.md b/pt-PT/origin/README.md new file mode 100644 index 000000000..6b5b8948a --- /dev/null +++ b/pt-PT/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Se tiver alguma pergunta, por favor faça no Discord ou nas Discussões do GitHub. +--- + +# 🏠 Bem-vindo ao Portal de Documentos + +{% dica estilo="info" %} + +**Os documentos do Plazma estão atualmente em estado de tradução automática.** + +[![Status de Tradução](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) 에서 문서 번역에 참여하여 문서를 개선해 보세요. + +{% endhint %} + +### Se ocorrer algum problema durante a utilização do Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Se estiver interessado no Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Se deseja criar sua própria plataforma de servidor com o Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `PATROCINADOR` Se precisar de mais informações relacionadas ao Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/pt-PT/origin/SUMMARY.md b/pt-PT/origin/SUMMARY.md new file mode 100644 index 000000000..6ec5c6825 --- /dev/null +++ b/pt-PT/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Tabela de conteúdos + +- [🏠 Bem-vindo ao Portal de Documentos](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documentos de Uso do Plazma](plazma/README.md) +- [❓ O que é o Plazma?](plazma/about/README.md) + - [⬇️ Download](plazma/about/downloads.md) + - [✅ Estado de Suporte de Versão](plazma/about/supported-versions.md) +- [⚒️ Guia de Administração do Servidor](plazma/administration/README.md) + - [👟 Começando](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referência](plazma/administration/reference/README.md) + - [🖥️ Comandos](plazma/administration/reference/commands.md) + - [🛡️ Permissões](plazma/administration/reference/permissions.md) + - [🎛️ Argumentos e Propriedades](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Propriedade](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configuração Global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Configurações por Mundo](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configuração Global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Configurações por Mundo](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configuração Global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Configurações por Mundo](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avançado](plazma/administration/expert/README.md) + - [🧹 Otimização](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanillaize](plazma/administration/expert/vanillaize.md) + - [🩻 Bloqueio de Raio X](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilidades e Soluções](plazma/administration/expert/fix-exploits.md) + - [⁉️ Perguntas Frequentes](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Guia do Desenvolvedor](plazma/developers.md) + - [✏️ Contribuir](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Guia de Uso do Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Guia de Desenvolvimento do Volt](volt/README.md) + +## Miscelânea + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Baixar Todos](plazma/about/downloads-all.md) diff --git a/pt-PT/origin/miscellaneous/README.md b/pt-PT/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/pt-PT/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/pt-PT/origin/plazma/README.md b/pt-PT/origin/plazma/README.md new file mode 100644 index 000000000..07fee97be --- /dev/null +++ b/pt-PT/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma é uma plataforma de servidor de código aberto para Minecraft: Java Edition que adiciona otimização experimental baseada em papel e recursos de personalização de vários mecanismos de jogo." +--- + +# ✨ Documentos de Uso do Plazma + +## 👋 Bem-vindo aos Documentos do Plazma + +Bem-vindo aos Documentos de Uso do Plazma! + +{% dica estilo="info" %} + +**Não consegue resolver o problema através do manual?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Discussões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) para perguntar à comunidade! + +{% endhint %} + +### Sobre o Plazma + +> Descubra o que é o Plazma como plataforma de servidor. + +{% referência-conteúdo url="sobre/" %} +[sobre](sobre/) +{% endcontent-ref %} + +### Para Administradores + +> Crie seu próprio servidor usando o Plazma. + +{% content-ref url="administration/" %} +[administração](administration/) +{% endcontent-ref %} + +### Para Desenvolvedores + +> Desenvolva projetos de terceiros usando o Plazma. + +{% referência-conteúdo url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/pt-PT/origin/plazma/about/README.md b/pt-PT/origin/plazma/about/README.md new file mode 100644 index 000000000..4b5eb76a5 --- /dev/null +++ b/pt-PT/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Descubra o que é o Plazma como plataforma de servidor. +--- + +# ❓ O que é o Plazma? + +- **Plazma** é uma plataforma de servidor baseada no [Paper](https://github.com/PaperMC/Paper) que traz apenas as vantagens do [Andromeda](https://github.com/EarendelArchived/Andromeda) e [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Estamos empenhados em fornecer sempre alta estabilidade, desempenho poderoso, atualizações rápidas e uma ampla gama de recursos. + +## 📋 Objetivos do Plazma + +- Estamos empenhados em ser uma plataforma de servidor com atualizações rápidas e alta estabilidade. +- Estamos empenhados em fornecer uma ampla gama de recursos e desempenho poderoso, não menos do que uma plataforma de modos. +- Estamos empenhados em criar uma plataforma livre que permita a personalização dos patches do Vanilla. + +## ⚙️ Principais características + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Atualizações mais rápidas**\ + O [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) garante que os patches incluídos no Plazma sejam sempre mantidos atualizados, oferecendo as atualizações mais rápidas entre as plataformas de servidor baseadas em Paper. +6. **Otimização dos arquivos de configuração padrão**\ + Os arquivos de configuração padrão são otimizados, não sendo necessário otimizá-los manualmente. +7. **Operação multithread de forma sistemática**\ + As mecânicas do jogo e os sistemas mecânicos não relacionados ao jogo são assíncronos, reduzindo [o tempo de latência](#user-content-fn-4)[^4] para otimizar o servidor. +8. **Bloqueio do uso de espaço desnecessário**\ + Os dados com valores semelhantes são combinados para reduzir o uso de memória. + +## ✨ Casos de uso + +- **Plataforma que lida corretamente com plugins complexos**\ + Plazma é usado nos servidores do desenvolvedor [IPECTER](https://github.com/IPECTER).\ + Mesmo com plugins personalizados que funcionam com NMS e reflexão, e com uma grande quantidade de datapacks complexos aplicados,\ + é capaz de lidar com mais de 100 jogadores sem queda de desempenho. +- **Plataforma mantendo desempenho rápido em servidores de RPG**\ + Manteve 100 jogadores em um único cluster sem queda de TPS de forma estável, e\ + 250 jogadores no total em 4 clusters puderam jogar confortavelmente. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Plataforma escolhida por muitos streamers**\ + É escolhida como o balde de participação dos espectadores de muitos streamers. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Download + +Você pode baixar o Plazma na página abaixo. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Quer saber mais sobre o suporte de versões? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plug-ins Bukkit, CraftBukkit, Spigot e Paper, Pufferfish, Purpur. + +[^2]: Microsoft Corporation. + +[^3]: Ao desativar o sistema de relatório de chat, o chat é processado apenas no servidor, impedindo o rastreamento de chat da Mojang. + +[^4]: Tempo em que o jogo fica parado para que o sistema mecânico funcione. diff --git a/pt-PT/origin/plazma/about/downloads-all.md b/pt-PT/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..a4421778b --- /dev/null +++ b/pt-PT/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Visualização completa do download do arquivo Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versão | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/pt-PT/origin/plazma/about/downloads.md b/pt-PT/origin/plazma/about/downloads.md new file mode 100644 index 000000000..5af1c2bc2 --- /dev/null +++ b/pt-PT/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Baixe o Plazma agora e experimente você mesmo. +--- + +# ⬇️ Download + +#### Quer saber mais sobre o suporte de versões? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% dica estilo="info" %} + +**O download abaixo é um arquivo executável para uso geral.** + +Se você é um desenvolvedor e precisa de outro tipo de arquivo, consulte a página abaixo. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersãoBaixar
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/pt-PT/origin/plazma/about/patches-list.md b/pt-PT/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..fe9179941 --- /dev/null +++ b/pt-PT/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Descubra todas as funcionalidades adicionadas ao Plazma. +--- + +# 📑 Patch incluído diff --git a/pt-PT/origin/plazma/about/supported-versions.md b/pt-PT/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..f7651dc65 --- /dev/null +++ b/pt-PT/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Descubra as versões do Minecraft: Java Edition suportadas pelo Plazma." +--- + +# ✅ Estado de suporte da versão + +{% dica estilo="info" %} + +**Plazma foi desenvolvido a partir da versão 1.19.4 e versões abaixo de 1.19.4 não estão mais em desenvolvimento.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: +[atv]: +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/Não%20há%20informação +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Aguardando lançamento][wtr] ![Em desenvolvimento][idv] ![Em suporte][atv] ![Suporte de funcionalidades interrompido][fse] ![Suporte encerrado][eol] + +| Versão | Estabilidade e suporte de funcionalidades | Estado de compilação | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Status de compilação](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Estado de construção](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Estado de construção](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/pt-PT/origin/plazma/administration/README.md b/pt-PT/origin/plazma/administration/README.md new file mode 100644 index 000000000..44fedd64e --- /dev/null +++ b/pt-PT/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Crie seu próprio servidor usando o Plazma. +--- + +# ⚒️ Guia de Gerenciamento do Servidor diff --git a/pt-PT/origin/plazma/administration/diagnosis/README.md b/pt-PT/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..706eaa65d --- /dev/null +++ b/pt-PT/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra como lidar com problemas quando surgirem. +--- + +# 🧾 진단 diff --git a/pt-PT/origin/plazma/administration/diagnosis/plugins.md b/pt-PT/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..058190752 --- /dev/null +++ b/pt-PT/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Descubra como resolver quando o plugin não está funcionando corretamente. +--- + +# 📜 플러그인 diff --git a/pt-PT/origin/plazma/administration/expert/README.md b/pt-PT/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..d8d45534a --- /dev/null +++ b/pt-PT/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra como lidar profissionalmente com o Plazma. +--- + +# 🎓 Avançado diff --git a/pt-PT/origin/plazma/administration/expert/fix-exploits.md b/pt-PT/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..289daf042 --- /dev/null +++ b/pt-PT/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descubra sobre vulnerabilidades conhecidas e como resolvê-las. +--- + +# ⚠️ Vulnerabilidades conhecidas e métodos de resolução diff --git a/pt-PT/origin/plazma/administration/expert/optimize.md b/pt-PT/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..4419837a0 --- /dev/null +++ b/pt-PT/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descubra como otimizar o Plazma. +--- + +# 🧹 Otimização diff --git a/pt-PT/origin/plazma/administration/expert/proxy.md b/pt-PT/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..d4be5f473 --- /dev/null +++ b/pt-PT/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Descubra como configurar com segurança a plataforma de proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/pt-PT/origin/plazma/administration/expert/vanillaize.md b/pt-PT/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..dcc178984 --- /dev/null +++ b/pt-PT/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Descubra como restaurar o patch do Paper e do Vanilla. +--- + +# ↩️ Vanilização + +{% hint style="warning" %} + +**O Paper não inclui opções na maioria dos patches para corrigir erros do Vanilla.** + +Atualmente, o Plazma está desenvolvendo uma configuração para desativar essas correções de erro. + +Portanto, este guia ainda está em desenvolvimento e as informações estão sujeitas a alterações a qualquer momento. + +{% endhint %} diff --git a/pt-PT/origin/plazma/administration/expert/xray.md b/pt-PT/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..0ba867bfa --- /dev/null +++ b/pt-PT/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Descubra várias maneiras incorporadas de bloquear o X-Ray. +--- + +# 🩻 Bloqueio de X-Ray diff --git a/pt-PT/origin/plazma/administration/faq.md b/pt-PT/origin/plazma/administration/faq.md new file mode 100644 index 000000000..17d3658a4 --- /dev/null +++ b/pt-PT/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Descubra as perguntas frequentes. +--- + +# ⁉️ Perguntas frequentes + +{% dica estilo="info" %} + +**Não consegue encontrar a resposta que procura?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Discussões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) para perguntar à comunidade! + +{% endhint %} + +### Plazma가 시작되지 않습니다 + +Se `no main manifest attribute, in plazma-(version).jar` for exibido no console,\ +o arquivo baixado é um arquivo de API de desenvolvimento e você precisa baixar **Reobf Paperweight** na página do GitHub. + +Consulte a próxima página para obter mais informações. + +{% content-ref url="getting-started/" %} +[início](getting-started#id-2) +{% endcontent-ref %} + +### Um aviso é exibido sempre que o servidor é iniciado + +Plazma contém patches instáveis e pode apresentar mau funcionamento, portanto, exibe a seguinte mensagem de aviso ao iniciar o servidor. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Este aviso pode ser desativado usando a propriedade do sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Consulte a próxima página para obter mais informações. + +{% content-ref url="reference/arguments.md" %} +[argumetos.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponível a partir da versão 1.20.1 diff --git a/pt-PT/origin/plazma/administration/getting-started/README.md b/pt-PT/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..7321187d8 --- /dev/null +++ b/pt-PT/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: Saiba como criar um servidor com Plazma. +--- + +# 👟 Começar + +Para usar o Plazma de forma estável, o sistema deve atender aos seguintes requisitos. + +| | Mínimo | Recomendado | +| :---------------------: | ------ | ----------- | +| Arquitetura | x64 | - | +| RAM | 8GB | 16GB | +| Espaço de armazenamento | 1GB | 8GB | +| JDK | 17 | 21 | + +Para facilitar a edição de arquivos de configuração, é recomendável instalar um editor como o [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Saída correta" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Primeiro, faça o download do **JDK 21** em formato `.msi` do [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Execute o assistente de instalação baixado e clique em `Next`. +3. Ative `Set JAVA_HOME variable` no menu exibido no centro esquerdo da janela e clique em `Next`. +4. Clique em `Install` para concluir a instalação do JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Em seguida, execute o seguinte comando no terminal para instalar o JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download do Plazma + +O Plazma oferece vários tipos de arquivos de execução. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Saiba mais + +O nome do arquivo de execução é `plazma-(gerenciador de versão)-1.20.4-R0.1-SNAPSHOT-(tipo de mapeamento).jar`. + +- **Tipo de mapeamento**\ + O mapeamento é uma espécie de mapa que conecta o código real do Minecraft ao código ofuscado. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mapeado pela Mojang, é o mapeamento padrão do Minecraft vanilla. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Gerenciador de versão**\ + O gerenciador de versão pode ser considerado o lançador do servidor, que é responsável por fornecer as bibliotecas necessárias para a execução do servidor e aplicar patches nos arquivos do servidor. + - **Paperclip**\ + Desenvolvido pela equipe PaperMC para Paper e outras plataformas derivadas, é responsável por baixar bibliotecas e aplicar patches no servidor. + - **Bundler**\ + Gerenciador de versão do Minecraft Vanilla. + +
+ +*** + +## 3. Criação de script de inicialização + +Para iniciar o Plazma facilmente e reiniciar o servidor automaticamente, você precisa criar um [script de inicialização](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Você pode baixar o script de inicialização clicando no botão de download na parte inferior esquerda.\ +**Certifique-se de que o script de inicialização baixado corresponda ao seu sistema operacional.** + +*** + +## 4. Organização de arquivos + +Agora, mova o script de inicialização baixado e o Plazma para uma nova pasta. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Agora, execute o script de inicialização. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Aceitação do EULA + +Após executar o script de inicialização, um arquivo `eula.txt` será criado na pasta. + +O EULA[^9] é um contrato de licença que deve ser aceito ao utilizar os serviços da [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Para aceitar o EULA, edite o arquivo `eula.txt` alterando `eula=false` para `eula=true` e salve. + +*** + +## 6. Permitir acesso externo (Windows) + +Os sistemas operacionais modernos bloqueiam o acesso externo por padrão para evitar acessos não autorizados através do **firewall** e **roteador**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Se o roteador não suportar UPnP, será necessário pesquisar a configuração específica para cada modelo de roteador. + +Também é possível usar o [Ngrok](https://ngrok.com/) para gerar um endereço temporário. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Verificação da necessidade de redirecionamento de porta + +Digite o seguinte na janela de execução e execute. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Se a saída for `True`, você pode parar por aqui, mas se for `False`, é necessário configurar o redirecionamento de porta. + +### 6.2 Acesso ao servidor + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +O endereço usado para acessar o servidor pode ser verificado [aqui](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Em seguida, ao reiniciar o servidor, o Plazma tentará encaminhar automaticamente a porta. + +Abaixo está o resultado do sucesso do UPnP de acordo com a mensagem exibida no console, que será mostrada como `[UPnP] (mensagem)`. + +| mensagem | significado | +| ---------------------------------- | --------------------------------------------------- | +| `Porta aberta com sucesso (porta)` | Sucesso no encaminhamento de porta. | +| `Porta (porta) já está aberta` | Outro serviço está usando a porta. | +| `Falha ao abrir a porta (porta)` | Falha no encaminhamento de porta. | +| `Serviço indisponível` | O roteador não suporta UPnP. | + +Quando o servidor é desligado, o Plazma fecha automaticamente a porta. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Baixe o arquivo ZIP do `Windows (64-bit)` no [site do Ngrok](https://ngrok.com/download). +2. Coloque o Ngrok baixado na pasta do servidor. +3. No [painel do Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), gere um [token de autenticação](#user-content-fn-13)[^13]. +4. Execute o comando exibido na linha de comando na pasta do servidor. +5. Adicione `start /b ngrok tcp --region jp 25565` no topo do script de execução e `taskkill /f /t /im ngrok.exe` na parte inferior. +6. A partir do `Encaminhamento tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` exibido no topo do console, `0.tcp.jp.ngrok.io:12345` será o endereço do servidor. +7. Agora é possível acessar o servidor externamente através desse endereço. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Por exemplo, ao obter a seguinte saída após a execução do comando, + +```log +Configuração de IP do Windows + +Adaptador Ethernet Ethernet: + + Sufixo DNS específico de conexão. . . . : + Endereço IPv4. . . . . . . . . : 192.168.3.7 + Máscara de sub-rede. . . . . . . : 255.255.255.0 + Gateway Padrão. . . . . . . : 192.168.3.1 + +``` + +Tentando se conectar com o endereço IPv4 indicado `192.168.3.7` permitirá o acesso ao servidor localmente. + +Se o servidor e o jogo estiverem sendo executados no mesmo PC, é possível se conectar usando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. 발전하기 + +Após iniciar o servidor com sucesso e ele estar funcionando corretamente, é hora de personalizá-lo. + +Veja como personalizar o servidor através do manual abaixo. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: O Paper, base do Plazma, é baseado no Spigot, que por sua vez é baseado na plataforma oficial de servidores Spigot. + +[^3]: Tecla Windows + R + +[^4]: No caso do Linux, execute `java --version` no terminal. + +[^5]: O JRE é um projeto de código aberto, assim como a plataforma de servidores Minecraft, e possui várias variantes. + +[^6]: Comumente conhecido como **launcher**. + +[^7]: Ao ativar o "Auto-restart", o servidor reiniciará automaticamente. É possível encerrar digitando `Control + C`. + +[^8]: Não é recomendado alocar mais da metade da memória do sistema. + + Por exemplo, se a capacidade total de memória do sistema for de 8GB, não é recomendado alocar mais de 4GB. + +[^9]: Contrato de Licença do Usuário Final, EULA. Para mais detalhes, consulte o [site do Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: De acordo com o Artigo 32, Parágrafo 1, Item 9 da Lei de Promoção da Indústria de Jogos da Coreia, é possível processar legalmente a **Microsoft Korea Corporation**. + +[^12]: Universal Plug & Play. O Purpur incluído no Plazma se comunica automaticamente com o roteador através dessa tecnologia para abrir a porta apenas quando o servidor está em execução, eliminando a necessidade de encaminhamento de porta direto. + +[^13]: Se não tiver uma conta, inscreva-se no Ngrok através de uma conta Google ou GitHub. diff --git a/pt-PT/origin/plazma/administration/getting-started/customization.md b/pt-PT/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..7bd2c8cfd --- /dev/null +++ b/pt-PT/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,114 @@ +--- +description: Descubra como personalizar o servidor. +--- + +# 🎨 Personalização do usuário + +A razão pela qual se utiliza uma plataforma de servidor modificada como o Plazma em vez da plataforma oficial fornecida pela Mojang Studios é a capacidade de **personalização** intensa. + +Aqui estão várias maneiras de personalizar e utilizar o Plazma. + +## Modificação de configuração + +A forma mais básica de personalizar o Plazma é modificando a configuração. + +O Plazma oferece configurações poderosas, desde os mecanismos do jogo até as propriedades dos mobs. + +Consulte a página abaixo para obter informações sobre as configurações do Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurações](../reference/configurations/) +{% endcontent-ref %} + +## Utilização de plugins + +{% dica style="sucesso" %} + +**Plazma suporta todos os plugins baseados em Paper normalmente.** + +Para plugins Spigot, devido às mudanças de mapeamento do Paper a partir da 1.20.5, alguns podem não funcionar corretamente, mas a maioria dos plugins baseados em Paper, como Paper, Pufferfish e Purpur, funcionam normalmente no Plazma e, se não funcionarem corretamente, é um erro do Plazma, então por favor [reporte imediatamente.](../diagnosis/plugins.md) + +{% endhint %} + +Esta é a principal razão para usar o Plazma e a maneira mais poderosa de personalizá-lo. +O ecossistema de plugins robusto do Plazma permite personalizar facilmente o servidor. + +Existem várias maneiras de encontrar e baixar plugins. Alguns plugins são enviados para serviços de repositórios públicos e outros são enviados para GitHub ou sites próprios. + +{% dica style="atenção" %} + +**Os plugins podem acessar diretamente o sistema!** + +Sempre verifique se o plugin é seguro antes de aplicá-lo usando serviços como VirusTotal, ou baixe o plugin de serviços confiáveis. + +{% endhint %} + +Existem vários serviços para baixar plugins. Entre eles, serviços como [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisam os plugins antes de serem enviados, garantindo que apenas plugins seguros sejam distribuídos. + +### Aplicando plugins + +Depois de baixar os plugins, é hora de aplicá-los. + +1. Os plugins estão em arquivos `.jar` ou `Java Executable File`.\ + Alguns são compactados e, nesse caso, extraia, procure por `bukkit`, `spigot` ou `paper` no nome e, se houver um arquivo `fat`, use-o. +2. Coloque o arquivo baixado na pasta `plugins` do servidor e (re)inicie o servidor. +3. Quando o Plazma iniciar, haverá novas mensagens no console. + Isso significa que o Plazma carregou os plugins corretamente. +4. Mesmo que o Plazma tenha carregado os plugins corretamente, eles podem não iniciar. + Com o comando `/plugins`, você pode ver os plugins carregados no servidor. + Se o nome do plugin não estiver em vermelho, mas sim em verde, significa que o plugin foi carregado corretamente. + +Se os plugins não foram carregados corretamente, você pode encontrar soluções na página abaixo. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Usando pacotes de dados + +Os pacotes de dados são uma forma de personalização fornecida pelo Minecraft, semelhante a [pacotes de recursos](#user-content-fn-1)[^1]. + +Com pacotes de dados, você pode adicionar novas entidades e desafios ao jogo, entre outras modificações internas. + +{% dica style="atenção" %} + +**Os pacotes de dados podem danificar o mundo!** + +Alguns pacotes de dados defeituosos podem danificar o mundo de forma irreversível. + +Portanto, é recomendável fazer backup do mundo antes de aplicar pacotes de dados. + +{% endhint %} + +Os pacotes de dados podem ser baixados de vários serviços, como [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/), entre outros. + +Depois de baixar os pacotes de dados, você pode aplicá-los colocando-os na pasta `datapacks` do mundo do servidor. +Se a pasta não existir, crie-a para adicionar os pacotes de dados. + +{% hint style="warning" %} + +**Alguns [pacotes de dados](#user-content-fn-2)[^2] podem não ser aplicados corretamente na primeira vez.** + +Para isso, é recomendável reiniciar o servidor **2 vezes**. + +{% endhint %} + +Os pacotes de dados podem ser facilmente corrompidos a cada atualização do Minecraft. + +Especialmente se os pacotes de dados estiverem completamente corrompidos, é importante testar bem antes de atualizar o servidor para evitar conflitos. + +{% dica estilo="info" %} + +**Depois de inserir `safeMode` após o comando de inicialização do servidor, você pode desativar todos os pacotes de dados e iniciar o servidor.** + +Para mais detalhes, consulte `Referência > Argumentos`.](../reference/arguments.md) + +{% endhint %} + +Você pode verificar os pacotes de dados aplicados com o comando `/datapack list`. + +*** + +[^1]: Ou no Minecraft: Bedrock Edition, os add-ons. + +[^2]: Adição de novas entidades, entre outras coisas. diff --git a/pt-PT/origin/plazma/administration/getting-started/next-step.md b/pt-PT/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..135fe7b76 --- /dev/null +++ b/pt-PT/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Descubra como personalizar o servidor. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Aqui estão várias maneiras de personalizar e utilizar o Plazma. + +## Modificação de configuração + +A forma mais básica de personalizar o Plazma é modificando a configuração. + +O Plazma oferece configurações poderosas, desde os mecanismos do jogo até as propriedades dos mobs. + +Consulte a página abaixo para obter informações sobre as configurações do Plazma. + +{% content-ref url="../reference/configurations/" %} +[configurações](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Utilização de plugins + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Esta é a principal razão para usar o Plazma e a maneira mais poderosa de personalizá-lo. O ecossistema de plugins robusto do Plazma permite personalizar facilmente o servidor. + +Existem várias maneiras de encontrar e baixar plugins. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Existem vários serviços para baixar plugins. Entre eles, serviços como [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) revisam os plugins antes de serem enviados, garantindo que apenas plugins seguros sejam distribuídos. + +### Aplicando plugins + +Depois de baixar os plugins, é hora de aplicá-los. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Coloque o arquivo baixado na pasta `plugins` do servidor e (re)inicie o servidor. +3. Quando o Plazma iniciar, haverá novas mensagens no console. Isso significa que o Plazma carregou os plugins corretamente. +4. Mesmo que o Plazma tenha carregado os plugins corretamente, eles podem não iniciar. Com o comando `/plugins`, você pode ver os plugins carregados no servidor. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Se os plugins não foram carregados corretamente, você pode encontrar soluções na página abaixo. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Usando pacotes de dados + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Com pacotes de dados, você pode adicionar novas entidades e desafios ao jogo, entre outras modificações internas. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Alguns pacotes de dados defeituosos podem danificar o mundo de forma irreversível. + +Portanto, é recomendável fazer backup do mundo antes de aplicar pacotes de dados. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Depois de baixar os pacotes de dados, você pode aplicá-los colocando-os na pasta `datapacks` do mundo do servidor. Se a pasta não existir, crie-a para adicionar os pacotes de dados. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Para isso, é recomendável reiniciar o servidor **2 vezes**. +{% endhint %} + +Os pacotes de dados podem ser facilmente corrompidos a cada atualização do Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Você pode verificar os pacotes de dados aplicados com o comando `/datapack list`. + +*** + +## Otimização + +Plazma tem muitos patches de otimização aplicados. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Para informações sobre configurações de proxy seguras e corretas, consulte a página abaixo. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Segurança + +Com o avanço dos mods, é fácil encontrar um [motor de ataque de vulnerabilidades](#user-content-fn-3)[^3] online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Configuração de permissões + +Alguns comandos de administrador de plugins podem ter vulnerabilidades se as permissões não forem configuradas corretamente. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Bloqueio de X-Ray + +O X-Ray é uma das vulnerabilidades facilmente exploráveis mesmo em clientes de otimização básica. + +Plazma oferece uma configuração para bloquear o uso do X-Ray por padrão. + +Consulte a página abaixo para obter informações e instruções sobre o bloqueio do X-Ray. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Lista branca + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Use `/whitelist query` para ver os jogadores permitidos a entrar. + +*** + +[^1]: Ou no Minecraft: Bedrock Edition, os add-ons. + +[^2]: Adição de novas entidades, entre outras coisas. + +[^3]: Normalmente chamado de "hacks". + +[^4]: Se a configuração não estiver otimizada, se o Plazma estiver desatualizado ou se novas vulnerabilidades forem descobertas, elas podem não ser bloqueadas. + +[^5]: Os jogadores se conectam ao servidor através do servidor de proxy Ngrok e um novo endereço Ngrok é emitido a cada reinicialização. diff --git a/pt-PT/origin/plazma/administration/reference/README.md b/pt-PT/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..9df0ff886 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Descubra os métodos de personalização fornecidos por Plazma. +--- + +# 📜 리퍼런스 + +Plazma oferece vários métodos de personalização. + +Entre eles, os seguintes 4 métodos de personalização podem ser usados imediatamente sem necessidade de trabalho adicional. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Discussões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) para perguntar à comunidade! +{% endhint %} + +*** + +## 🖥️ Comandos + +> Os comandos permitem coletar informações dentro do jogo ou personalizar o ambiente de jogo. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permissões + +> As permissões especificam o alcance de interação do jogador. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumentos e Atributos + +> Argumentos e atributos têm um impacto geral no funcionamento do Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurações + +> As configurações são a forma mais básica de personalizar o Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/pt-PT/origin/plazma/administration/reference/arguments.md b/pt-PT/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..840035df2 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Descubra sobre os argumentos de inicialização e as propriedades do sistema. +--- + +# 🎛️ Argumentos e Propriedades + +Os argumentos de entrada e as propriedades do sistema são valores adicionais anexados ao comando usado na execução do Plazma, que afetam globalmente o funcionamento do Plazma. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## Propriedades do Sistema + +As propriedades do sistema são valores inseridos antes de `-jar`, processados pelo JVM antes da inicialização do Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Modo de Uso + +As propriedades do sistema são inseridas como argumentos de comando Java entre `java` e `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indica que o argumento não está embutido no JVM, mas é um argumento exclusivo adicionado ao Plazma, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Todas as Propriedades do Sistema + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Atualiza o formato de placas desativadas. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração relacionados às informações de entidades. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a revisão NMS para permitir que as informações de depuração sejam carregadas corretamente no IDE e remapeia automaticamente as informações de versão interna. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa o sistema de alerta de Watchdog do Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a mensagem de confirmação do comando `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Se você é um desenvolvedor de plugins e precisa atualizar um plugin, use o hotswap em vez do `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa plugins que usam o sistema de entrada/saída padrão. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Avisa quando um formato descontinuado é detectado em componentes de chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a verificação de padrão do servidor quando um jogador se conecta. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração para chaves ausentes em objetos NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração para blocos de cabeça com perfis inválidos. + +Isso registra todos os blocos de cabeça inválidos no mundo, juntamente com suas localizações. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa o sistema de priorização de classes de plugins. + +Útil em casos de problemas com sombreamento de plugins. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a consolidação de descarga do Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valor Padrão**: `750` + +Divide em múltiplos pacotes para transmissão se houver mais entidades do que o valor definido. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valor Padrão**: `8192` + +Define o tamanho máximo de pacotes que o servidor pode receber de uma só vez. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a verificação da versão do Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Isso pode resultar em danos permanentes nos arquivos do mundo e causar falhas em todo o mecanismo do jogo. + +Qualquer problema causado pelo uso disso é de responsabilidade do usuário e o Plamza não oferece suporte para isso. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valor Padrão**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valor Padrão**: `80` + +Define o comprimento máximo de caracteres em uma linha de placa. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valor Padrão**: `(versão do mundo) + 1` + +Define a versão das informações de atualização do mundo a serem inicializadas primeiro. + +Útil ao atualizar um grande número de chunks, mas raramente usado em outras situações. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Verdadeiro` + +Ativa o processamento de comentários em arquivos YAML. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valor Padrão**: `30` + +Expulsa o jogador se não receber dados por um determinado período de tempo (em segundos). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ignora os comentários das propriedades do servidor. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração para a criação síncrona de chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa o sistema de escrita de chunks síncrono padrão do Minecraft. + +Isso salva cada chunk em ordem, causando uma grande degradação de desempenho. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa o Flush Explícito do canal de rede. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Registra sempre erros que não ocorreram no thread principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Exibe um aviso se uma tarefa agendada tiver um atraso excessivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ao usar o arquivo de execução padrão, aplica apenas o patch sem iniciar o servidor. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` +- **충돌**: `Plazma.disableConfigOptimization` + +초기 구성을 더 강하게 최적화 합니다. + +활성화 하면 servidor ficará mais rápido e seguro, mas pode afetar significativamente o jogo. + +#### `Plazma.disableConfigOptimization` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` +- **충돌**: `Plazma.aggressiveOptimize` + +초기 구성을 최적화하지 않습니다. + +Isso faz com que utilize a configuração padrão do Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` + +Desativa a marca Plazma e utiliza o ícone de servidor padrão do tipo baunilha. + +#### `Plazma.useVanillaConfiguration` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` +- **충돌**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Isso pode ter um impacto significativo na segurança e desempenho do servidor. + +Quaisquer problemas decorrentes do uso deste atributo são de responsabilidade do administrador do servidor. +{% endhint %} + +Fornece a configuração inicial com os valores padrão fornecidos pela Mojang. + +Isso desativa todas as correções de falhas aplicadas pelo Paper. + +As correções de falhas podem ser reativadas na configuração do Paper ou na configuração do Plazma. + +#### `Plazma.vanillaize` + +- **Tipo**: `Boolean` +- **Padrão**: `true` +- **충돌**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Configura a inicialização para ser mais semelhante ao tipo baunilha. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Atributo obsoleto + +Os atributos de sistema abaixo são obsoletos. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` +- **Obsoleto**: Desde a remoção do Timings do Plazma + +Decide se pode exceder o máximo de valores enviados para a API de Timings de Aikar. + +Se não for tratado pela API, será aplicado um limite de taxa. + +*** + +## Argumento de início + +O argumento de início é inserido após `-jar *.jar` para inicializar o Plazma e é processado em conjunto. + +### Modo de uso + +Os atributos de sistema são inseridos como argumentos de programa após `-jar *.jar`. + +Por exemplo, se você deseja aplicar o argumento de início `nogui`,\ +insira da seguinte forma para que o Plazma processe o argumento `nogui` durante a inicialização. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumento de início completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valor padrão**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Valor padrão**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Valor padrão**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Inicia o servidor no mundo de demonstração. + +#### `eraseCache` + +Remove os arquivos de cache restantes após a atualização do mundo. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Exibe todos os argumentos de início do Plazma e suas descrições. + +#### `initSettings` + +Cria apenas o arquivo de configuração e encerra o servidor. + +#### `jfrProfile` + +Ativa o perfil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valor padrão**: `(propriedades do servidor)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Desativa o painel de interface gráfica. + +#### `nojline` + +Desativar o JLine e usar o console de baunilha. + +#### `online-mode` + +- **Alias**: `o` +- **Valor padrão**: `(propriedades do servidor)` + +Escolha se autenticar os jogadores no servidor de autenticação da Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Valor padrão**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Configura a localização do arquivo de configuração do PaperSpigot descontinuado. + +Usado para migrar as configurações do PaperSpigot descontinuado para um novo arquivo de configuração, não é mais utilizado posteriormente. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Valor padrão**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Valor padrão**: `plugins` + +Configura a localização da pasta de plugins. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Valor padrão**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Valor padrão**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Inicia o servidor em um estado completamente de baunilha (modo seguro). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Valor padrão**: `(propriedades do servidor)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Valor padrão**: `(propriedades do servidor)` + +Configura a porta do servidor. + +#### `server-name` + +- **Valor padrão**: `A Plazma Server` + +Configura o nome do servidor. + +#### `spigot-settings` + +- **Alias**: `S` +- **Valor padrão**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Exibe a versão do Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Valor padrão**: `(pasta do servidor)` + +Configura a localização onde os arquivos do mundo são salvos. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o nome do arquivo do mundo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: A forma como os argumentos são tratados muda dependendo da posição em que são adicionados. + +[^3]: Por exemplo, se você deseja definir (ativar) `Plazma.iKnowWhatIAmDoing` como `true`, em vez de inserir `-DPlazma.iKnowWhatIAmDoing=true`, você pode simplesmente inserir `-DPlazma.iKnowWhatIAmDoing` e ele funcionará da mesma maneira. + +[^4]: Por exemplo, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de eventos. + +[^6]: Detector de eventos. + +[^7]: Cliente. + +[^8]: Um sinal que indica que o cliente está conectado ao servidor de forma adequada, como os batimentos cardíacos. + +[^9]: Com a função de expulsão AFK do Purpur, é possível expulsar jogadores ausentes. + +[^10]: Sistema de escrita de chunks síncrono, Sync Chunk Write System. + +[^11]: `AVISO! Plazma pode causar problemas inesperados, portanto, certifique-se de testá-lo completamente antes de usá-lo em um servidor público.` + +[^12]: `World Optimization` no jogo também funciona com o mesmo princípio. + +[^13]: Administradores de `nível 2` ou superior estão excluídos. + +[^14]: Protocolo de Internet, IP. diff --git a/pt-PT/origin/plazma/administration/reference/commands.md b/pt-PT/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..52e208f8c --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descubra os comandos disponíveis no Plazma. +--- + +# 🖥️ Comandos diff --git a/pt-PT/origin/plazma/administration/reference/configurations/README.md b/pt-PT/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..77eb9f6ed --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: As configurações são a forma mais básica de personalizar o Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atributo + +> Atributo é o arquivo de configuração mais básico fornecido pelo Minecraft. Usando atributos, é possível alterar os mecanismos básicos do jogo. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configuração Bukkit + +> A configuração Bukkit é o arquivo de configuração mais básico fornecido pela Plazma. Usando a configuração Bukkit, é possível alterar os mecanismos básicos do servidor Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configuração Spigot + +> A configuração Spigot permite modificar os detalhes dos mecanismos do jogo, processamento de jogadores, funcionamento de comandos e mensagens. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configuração Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configuração Pufferfish + +> A configuração Pufferfish permite alterar o processamento de mundos e entidades da Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configuração Purpur + +> A configuração Purpur permite modificar os dados básicos gerais do jogo. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configuração Plazma + +> A configuração Plazma permite personalizar as funcionalidades da Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/pt-PT/origin/plazma/administration/reference/configurations/bukkit.md b/pt-PT/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f7cea0cea --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em bukkit.yml significa. +--- + +# 🪣 Bukkit diff --git a/pt-PT/origin/plazma/administration/reference/configurations/paper/README.md b/pt-PT/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..3f33c916d --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o propósito de cada arquivo na pasta de configuração. +--- + +# 🛩️ Papel diff --git a/pt-PT/origin/plazma/administration/reference/configurations/paper/global.md b/pt-PT/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f52aa30f6 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em paper-global.yml significa. +--- + +# 🌏 전역 구성 diff --git a/pt-PT/origin/plazma/administration/reference/configurations/paper/world.md b/pt-PT/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..5805169c9 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Descubra o que cada nó em paper-world.yml significa. +--- + +# 🏳️ 세계별 구성 + +mundial diff --git a/pt-PT/origin/plazma/administration/reference/configurations/plazma/README.md b/pt-PT/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5a3da3908 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o propósito de cada arquivo na pasta de configuração. +--- + +# ✨ Plazma diff --git a/pt-PT/origin/plazma/administration/reference/configurations/plazma/global.md b/pt-PT/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..76c606d81 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-global.yml significa. +--- + +# 🌏 전역 구성 diff --git a/pt-PT/origin/plazma/administration/reference/configurations/plazma/world.md b/pt-PT/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..0aaa75b0a --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-world.yml significa. +--- + +# 🏳️ 세계별 구성 diff --git a/pt-PT/origin/plazma/administration/reference/configurations/plazma/worlds.md b/pt-PT/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..c19e0c5fd --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-world.yml significa. +--- + +# ✨ Plazma (Composição mundial) diff --git a/pt-PT/origin/plazma/administration/reference/configurations/property.md b/pt-PT/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..eaca537cb --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em server.properties significa. +--- + +# 🪨 Server.properties diff --git a/pt-PT/origin/plazma/administration/reference/configurations/pufferfish.md b/pt-PT/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..134e52525 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em pufferfish.yml significa. +--- + +# 🐡 Baiacu diff --git a/pt-PT/origin/plazma/administration/reference/configurations/purpur/README.md b/pt-PT/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..f0c947eab --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em purpur.yml significa. +--- + +# 🦑 Purpur diff --git a/pt-PT/origin/plazma/administration/reference/configurations/purpur/global.md b/pt-PT/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..09d287524 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em purpur.yml significa. +--- + +# 🌏 전역 구성 diff --git a/pt-PT/origin/plazma/administration/reference/configurations/purpur/world.md b/pt-PT/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..316197779 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em purpur.yml significa. +--- + +# 🏳️ 세계별 구성 diff --git a/pt-PT/origin/plazma/administration/reference/configurations/spigot.md b/pt-PT/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..d6c432d14 --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em spigot.yml significa. +--- + +# 🚰 Spigot diff --git a/pt-PT/origin/plazma/administration/reference/permissions.md b/pt-PT/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..5e5ff52ac --- /dev/null +++ b/pt-PT/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Descubra sobre as permissões do Plazma. +--- + +# 🛡️ Permissões + +Permissões são ferramentas simples de segurança que definem o alcance no qual os jogadores podem interagir no servidor. + +Para utilizar e modificar permissões adequadamente, você deve usar plugins como [LuckPerms](https://luckperms.net). + +*** + +## Entendendo o sistema de permissões básicas + +No Minecraft, grupos de permissões de gerenciamento básicos são fornecidos. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Jogador**\ + Grupo de permissões geralmente atribuído a todos os jogadores. +2. **Moderador**\ + Pode ignorar proteções de spawn. +3. **Administrador de Mundo**\ + Pode usar todos os comandos e blocos de comando relacionados à gestão do mundo.\ + Grupo de permissões aplicado por padrão a data packs e blocos de comando. +4. **Administrador**\ + Pode usar todos os comandos relacionados à gestão de jogadores. +5. **Superadministrador**\ + Pode usar todos os comandos, incluindo os de gestão do servidor.\ + Grupo de permissões aplicado por padrão ao console e operadores. + +*** + +## Definindo permissões + +*** + +## Permissões gerais + +*** + +#### `allow.ride.(Chave com Namespace)` + +- **Padrão**: `None` + +Permite que os jogadores montem em entidades ao se agachar e interagir com elas. + +Ao montar em uma entidade, você pode controlar seu movimento com as teclas de movimento e pular ou voar com a tecla de salto. + +A `(Chave com Namespace)` é o [ID com Namespace](#user-content-fn-2)[^2] da entidade. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Chave com Namespace)` + +- **Padrão**: `None` + +Permite que os jogadores usem habilidades especiais das entidades enquanto as montam. + +Nem todas as entidades possuem habilidades especiais disponíveis. Consulte a lista completa de habilidades especiais disponíveis abaixo. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Compartilhe suas ideias no [Plazma Discord](https://plazmamc.org/discord) ou no [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Ver habilidades especiais disponíveis atualmente + +- **`crepper`**\ + Explode ao pressionar a tecla de salto.\ + Se o jogador possuir a permissão `allow.powered.creeper`, pode segurar a tecla de salto para carregar a explosão. +- **`dolphin`**\ + Carrega ao pressionar a tecla de salto. +- **`phantom`**\ + Dispara chamas ao pressionar a tecla de salto. +- **`wither`**\ + Dispara cabeças de Wither ao interagir. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/credits (Jogador)`](commands.md#credits). + +Adicionando `.other` após o nome da permissão permite que outros jogadores a usem. + +#### `bukkit.command.demo` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/demo (Jogador)`](commands.md#demo). + +Adicionando `.other` após o nome da permissão permite que outros jogadores a usem. + +#### `bukkit.command.ping` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/ping (Jogador)`](commands.md#ping). + +Adicionando `.other` após o nome da permissão permite que outros jogadores a usem. + +#### `bukkit.command.ram` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/rambar (Jogador)`](commands.md#rambar). + +Adicionando `.other` após o nome da permissão permite que outros jogadores a usem. + +#### `bukkit.command.restart` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/tpsbar (Jogador)`](commands.md#tpsbar). + +Adicionando `.other` após o nome da permissão permite que outros jogadores a usem. + +#### `bukkit.command.timings` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Para comandos similares, consulte o [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(Modo de Jogo)` + +- **Padrão**: `Administrador de Mundo` + +Permite o uso do comando [`/gamemode (Modo de Jogo) (Jogador)`](commands.md#gamemode). + +Adicionando `.other` após o nome da permissão permite que outros jogadores a usem. + +#### `paper.antixray.bypass` + +- **Padrão**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Isso melhora o desempenho de ambos os lados. + +> Para saber mais sobre as configurações X-Ray, consulte a página abaixo. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Padrão**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Padrão**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Padrão**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Padrão**: `None` + +Permite o uso de [tags MiniMessage](https://docs.advntr.dev/minimessage/format.html) em bigornas. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Padrão**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Padrão**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Padrão**: `None` + +Exclui jogadores do kick por inatividade. + +#### `purpur.debug.f3n` + +- **Padrão**: `Administrador de Mundo` + +Permite que os jogadores alternem o modo de jogo pressionando `F3 + N`. + +Isso só funciona se o jogador tiver permissão para esse modo de jogo. + +#### `purpur.drop.spawners` + +- **Padrão**: `None` + +Quando minerar um bloco de spawner com o item configurado, ele será derrubado. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NúmeroTexto)` + +- **Padrão**: `None` + +Altera o tamanho do baú de ender. + +Você pode usar `one`, `two`, `three`, `four`, `five`, `six` como valores para `(NúmeroTexto)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Padrão**: `None` + +Permite que o totem da indomabilidade funcione mesmo se estiver no inventário. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Padrão**: `None` + +Permite que o jogador ignore o limite de número de jogadores conectados. + +#### `purpur.mending_shift_click` + +- **Padrão**: `None` + +Permite que o jogador repare o item que está segurando ao `agachar e interagir`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Padrão**: `None` + +Permite que o jogador instale spawners. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Padrão**: `None` + +Permite que o jogador seja teleportado instantaneamente ao usar o portal do Nether. + +#### `purpur.sign.color` + +- **Padrão**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Padrão**: `None` + +Permite o uso do código de encriptação de analfabetismo `(&o)` nas placas. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Padrão**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Padrão**: `None` + +Permite que os jogadores evitem a explosão do TNT interagindo com ele usando tesouras. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permissões previstas + +#### `plazma.bypass.ncr-require` + +- **Padrão**: `None` + +Permite que os jogadores entrem mesmo sem ter o mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) instalado. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operador. + +[^2]: Exemplo: `ender_dragon` diff --git a/pt-PT/origin/plazma/adminstration/README.md b/pt-PT/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..44fedd64e --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Crie seu próprio servidor usando o Plazma. +--- + +# ⚒️ Guia de Gerenciamento do Servidor diff --git a/pt-PT/origin/plazma/adminstration/expert/README.md b/pt-PT/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..d8d45534a --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra como lidar profissionalmente com o Plazma. +--- + +# 🎓 Avançado diff --git a/pt-PT/origin/plazma/adminstration/expert/fix-exploits.md b/pt-PT/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..289daf042 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Descubra sobre vulnerabilidades conhecidas e como resolvê-las. +--- + +# ⚠️ Vulnerabilidades conhecidas e métodos de resolução diff --git a/pt-PT/origin/plazma/adminstration/expert/optimize.md b/pt-PT/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..4419837a0 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Descubra como otimizar o Plazma. +--- + +# 🧹 Otimização diff --git a/pt-PT/origin/plazma/adminstration/expert/vanillaize.md b/pt-PT/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..dd7f91824 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Descubra como restaurar o patch do Paper e do Vanilla. +--- + +# ↩️ Vanilização + +{% hint style="warning" %} + +### O Paper não oferece opções para a maioria dos patches de correção de erros do Vanilla. + +Atualmente, o Plazma está desenvolvendo uma configuração para desativar essas correções de erro. + +Portanto, este guia ainda está em desenvolvimento e as informações estão sujeitas a alterações a qualquer momento. +{% endhint %} diff --git a/pt-PT/origin/plazma/adminstration/faq.md b/pt-PT/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..67c7c2923 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Descubra as perguntas frequentes. +--- + +# ⁉️ Perguntas frequentes + +{% dica estilo="info" %} + +### Não consegue encontrar a resposta que procura? + +Pergunte à comunidade através do [Servidor Discord oficial](https://discord.gg/MmfC52K8A8) ou [Questões no GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### A execução não ocorre e uma mensagem é exibida + +Se `no main manifest attribute, in plazma-(version).jar` for exibido no console,\ +o arquivo baixado é um arquivo de API de desenvolvimento e você precisa baixar **Reobf Paperweight** na página do GitHub. + +Consulte a próxima página para obter mais informações. + +{% content-ref url="getting-started/" %} +[início](getting-started#id-2) +{% endcontent-ref %} + +### Um aviso é exibido sempre que o servidor é iniciado + +Plazma contém patches instáveis e pode apresentar mau funcionamento, portanto, exibe a seguinte mensagem de aviso ao iniciar o servidor. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Este aviso pode ser desativado usando a propriedade do sistema [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Consulte a próxima página para obter mais informações. + +{% content-ref url="reference/arguments.md" %} +[argumetos.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponível a partir da versão 1.20.1 diff --git a/pt-PT/origin/plazma/adminstration/getting-started/README.md b/pt-PT/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..1bef347d0 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Saiba como criar um servidor com Plazma. +--- + +# 👟 Começar + +Para usar o Plazma de forma estável, o sistema deve atender aos seguintes requisitos. + +| | Mínimo | Recomendado | +| :---------------------: | -----: | ----------: | +| Arquitetura | x64 | - | +| RAM | 8GB | 16GB | +| Espaço de armazenamento | 1GB | 8GB | +| JRE | 17 | 21 | + +Para facilitar a edição de arquivos de configuração, é recomendável instalar um editor como o [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalação do JRE + +Como o nome sugere, o Minecraft: **"Java"** Edition é desenvolvido em Java e requer o JRE[^1] para ser executado. + +Como o Plazma é baseado na plataforma oficial de servidores da Mojang Studios, também é necessário instalar o JRE para usar o Plazma. + +### 1.1 Verificação do JRE + +Para verificar se o JRE está instalado no sistema, digite [`cmd /k java --version`](#user-content-fn-4)[^4] na janela de execução e execute. + +Se for exibido como abaixo, prossiga para o [passo 2](setup.md#id-2). + +{% code title="Saída correta" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Se não for exibido como acima, ou se for exibido como abaixo, significa que o JRE não está instalado ou está desatualizado, então você precisa seguir o [passo 1.2](setup.md#id-1.2). + +{% code title="JRE não instalado" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE desatualizado" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalação do JRE + +Neste guia, usaremos o Azul Zulu como uma das [opções de JRE](#user-content-fn-5)[^5]. + +Após a instalação, verifique novamente o [passo 1.1](setup.md#id-1.1) para garantir que a instalação foi concluída corretamente. + +{% tabs %} +{% tab title="Windows" %} + +1. Primeiro, faça o download do **JDK 21** em formato `.msi` do [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Execute o assistente de instalação baixado e clique em `Next`. +3. Ative `Set JAVA_HOME variable` no menu exibido no centro esquerdo da janela e clique em `Next`. +4. Clique em `Install` para concluir a instalação do JRE. + {% endtab %} + +{% tab title="macOS" %} +Faça o download do assistente de instalação do **JDK 21** em formato `.dmg` do [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) e execute para instalar o JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Primeiro, execute o seguinte comando no terminal para adicionar o repositório Azul Zulu ao APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Em seguida, execute o seguinte comando no terminal para instalar o JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Você pode instalar o JRE executando o seguinte comando. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Download do Plazma + +O Plazma oferece vários tipos de arquivos de execução. + +{% hint style="warning" %} + +### Na maioria dos casos, use o `Reobf Paperclip`. + +As informações a seguir são para desenvolvedores ou aqueles interessados nas características de cada tipo.\ +Se você é um usuário comum, não há problema em pular para o [passo 3](setup.md#id-3). +{% endhint %} + +
+ +Saiba mais + +O nome do arquivo de execução é `plazma-(gerenciador de versão)-1.20.4-R0.1-SNAPSHOT-(tipo de mapeamento).jar`. + +- **Tipo de mapeamento**\ + O mapeamento é uma espécie de mapa que conecta o código real do Minecraft ao código ofuscado. + - **Reobf**\ + Reobfuscation, também conhecido como mapeamento Spigot, é amplamente utilizado em plugins NMS.\ + A partir da versão 1.20.5, seu uso será descontinuado. + - **Mojmap**\ + Mapeamento da Mojang, é o mapeamento do Minecraft Vanilla. +- **Gerenciador de versão**\ + O gerenciador de versão pode ser considerado o lançador do servidor, que é responsável por fornecer as bibliotecas necessárias para a execução do servidor e aplicar patches nos arquivos do servidor. + - **Paperclip**\ + Desenvolvido pela equipe PaperMC para Paper e outras plataformas derivadas, é responsável por baixar bibliotecas e aplicar patches no servidor. + - **Bundler**\ + Gerenciador de versão do Minecraft Vanilla. + +
+ +*** + +## 3. Criação de script de inicialização + +Para iniciar o Plazma facilmente e reiniciar o servidor automaticamente, você precisa criar um [script de inicialização](#user-content-fn-6)[^6]. + +Você pode gerar o script de inicialização através do [Flags.sh](https://flags.sh).\ +Basta inserir a quantidade de memória a ser usada pelo Plazma e o comando será otimizado automaticamente. + +Você pode baixar o script de inicialização clicando no botão de download na parte inferior esquerda.\ +**Certifique-se de que o script de inicialização baixado corresponda ao seu sistema operacional.** + +*** + +## 4. Organização de arquivos + +Agora, mova o script de inicialização baixado e o Plazma para uma nova pasta. + +{% hint style="warning" %} + +### O nome da pasta deve ser sem espaços e em inglês. + +Caso contrário, o Plazma ou o JRE podem não funcionar corretamente. +{% endhint %} + +Agora, execute o script de inicialização. No caso do Windows, você deve selecionar **Permitir** na janela de seleção de permissão do firewall. + +*** + +## 5. Aceitação do EULA + +Após executar o script de inicialização, um arquivo `eula.txt` será criado na pasta. + +O EULA[^9] é um contrato de licença que deve ser aceito ao utilizar os serviços da [Mojang Studios](#user-content-fn-10)[^10]. + +Se você não aceitar o EULA, não poderá iniciar o servidor e poderá sofrer punições, como a suspensão da conta, por violar o EULA. + +Para aceitar o EULA, edite o arquivo `eula.txt` alterando `eula=false` para `eula=true` e salve. + +*** + +## 6. Permitir acesso externo (Windows) + +Os sistemas operacionais modernos bloqueiam o acesso externo por padrão para evitar acessos não autorizados através do **firewall** e **roteador**. + +No caso do Windows, como foi permitido no [passo 3](setup.md#id-3), basta configurar o redirecionamento de portas. + +{% dica estilo="info" %} + +### Este guia foi escrito considerando o sistema operacional Windows e um roteador que suporte [**UPnP**](#user-content-fn-12)[^12]. + +Se o roteador não suportar UPnP, será necessário pesquisar a configuração específica para cada modelo de roteador. + +Também é possível usar o [Ngrok](https://ngrok.com/) para gerar um endereço temporário. +{% endhint %} + +{% hint style="warning" %} + +### Para sistemas baseados em UNIX, como Linux ou macOS, os métodos de configuração do firewall variam para cada serviço, portanto, é necessário pesquisar as informações específicas. + +{% endhint %} + +### 6.1 Verificação da necessidade de redirecionamento de porta + +Digite o seguinte na janela de execução e execute. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Se a saída for `True`, você pode parar por aqui, mas se for `False`, é necessário configurar o redirecionamento de porta. + +### 6.2 Acesso ao servidor + +{% tabs %} +{% tab title="Acesso externo" %} +Se não for necessário encaminhamento de porta, ou se já tiver sido bem-sucedido, agora poderá acessar o servidor. + +O endereço usado para acessar o servidor pode ser verificado [aqui](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Tentativa de encaminhamento de porta UPnP" %} +No arquivo `purpur.yml` da pasta do servidor, ative `network.upnp-port-forwarding` para `true`. + +Em seguida, ao reiniciar o servidor, o Plazma tentará encaminhar automaticamente a porta. + +Abaixo está o resultado do sucesso do UPnP de acordo com a mensagem exibida no console, que será mostrada como `[UPnP] (mensagem)`. + +| mensagem | significado | +| ---------------------------------- | ----------------------------------- | +| `Porta aberta com sucesso (porta)` | Sucesso no encaminhamento de porta. | +| `Porta (porta) já está aberta` | Outro serviço está usando a porta. | +| `Falha ao abrir a porta (porta)` | Falha no encaminhamento de porta. | +| `Serviço indisponível` | O roteador não suporta UPnP. | + +Quando o servidor é desligado, o Plazma fecha automaticamente a porta. +{% endtab %} + +{% tab title="Criação de endereço temporário com Ngrok" %} +A utilização do Ngrok é útil para testes temporários, jogar com amigos ou participar. + +1. Baixe o arquivo ZIP do `Windows (64-bit)` no [site do Ngrok](https://ngrok.com/download). +2. Coloque o Ngrok baixado na pasta do servidor. +3. No [painel do Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken), gere um [token de autenticação](#user-content-fn-13)[^13]. +4. Execute o comando exibido na linha de comando na pasta do servidor. +5. Adicione `start /b ngrok tcp --region jp 25565` no topo do script de execução e `taskkill /f /t /im ngrok.exe` na parte inferior. +6. A partir do `Encaminhamento tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` exibido no topo do console, `0.tcp.jp.ngrok.io:12345` será o endereço do servidor. +7. Agora é possível acessar o servidor externamente através desse endereço. + {% endtab %} + +{% tab title="Acesso local" %} +Se estiver tentando acessar o servidor localmente, execute `cmd /k ipconfig` na janela de execução para obter o `Endereço IPv4` exibido. + +Por exemplo, ao obter a seguinte saída após a execução do comando, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Tentando se conectar com o endereço IPv4 indicado `192.168.3.7` permitirá o acesso ao servidor localmente. + +Se o servidor e o jogo estiverem sendo executados no mesmo PC, é possível se conectar usando `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Fase de evolução + +Após iniciar o servidor com sucesso e ele estar funcionando corretamente, é hora de personalizá-lo. + +Descubra como personalizar o servidor seguindo o guia abaixo. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Ambiente de execução Java, ambiente de execução Java. + +[^2]: O Paper, base do Plazma, é baseado no Spigot, que por sua vez é baseado na plataforma oficial de servidores Spigot. + +[^3]: Tecla Windows + R + +[^4]: No caso do Linux, execute `java --version` no terminal. + +[^5]: O JRE é um projeto de código aberto, assim como a plataforma de servidores Minecraft, e possui várias variantes. + +[^6]: Comumente conhecido como **launcher**. + +[^7]: Ao ativar o "Auto-restart", o servidor reiniciará automaticamente. É possível encerrar digitando `Control + C`. + +[^8]: Não é recomendado alocar mais da metade da memória do sistema. + + Por exemplo, se a capacidade total de memória do sistema for de 8GB, não é recomendado alocar mais de 4GB. + +[^9]: Contrato de Licença do Usuário Final, EULA. Para mais detalhes, consulte o [site do Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Microsoft Corporation. + +[^11]: De acordo com o Artigo 32, Parágrafo 1, Item 9 da Lei de Promoção da Indústria de Jogos da Coreia, é possível processar legalmente a **Microsoft Korea Corporation**. + +[^12]: Universal Plug & Play. O Purpur incluído no Plazma se comunica automaticamente com o roteador através dessa tecnologia para abrir a porta apenas quando o servidor está em execução, eliminando a necessidade de encaminhamento de porta direto. + +[^13]: Se não tiver uma conta, inscreva-se no Ngrok através de uma conta Google ou GitHub. diff --git a/pt-PT/origin/plazma/adminstration/getting-started/customization.md b/pt-PT/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..a7a2fa1e9 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Descubra como personalizar o servidor. +--- + +# 🎨 Personalização do usuário diff --git a/pt-PT/origin/plazma/adminstration/reference/arguments.md b/pt-PT/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..fd780d311 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Descubra sobre os argumentos de inicialização e as propriedades do sistema. +--- + +# 🎛️ Argumentos e Propriedades + +Os argumentos de inicialização e as propriedades do sistema são valores adicionados aos comandos [usados ​​na execução do Plazma](#user-content-fn-1)[^1], que permitem alterar valores que não podem ser alterados após a execução do Plazma. + +Dependendo da [posição em que são adicionados ao comando](#user-content-fn-2)[^2], eles são divididos em **Argumentos de Inicialização** e **Propriedades do Sistema**. + +*** + +## Propriedades do Sistema + +As propriedades do sistema são valores inseridos antes de `-jar`, processados pelo JVM antes da inicialização do Plazma. + +{% hint style="warning" %} + +### Modificar as propriedades do sistema pode alterar o funcionamento do Plazma e do JVM, podendo ter um grande impacto no jogo! + +Se você não tem certeza sobre o papel de cada propriedade do sistema, **não as utilize de forma alguma!** +{% endhint %} + +### Modo de Uso + +As propriedades do sistema são inseridas como argumentos de comando Java entre `java` e `-jar`. + +Por exemplo, se você deseja aplicar a propriedade do sistema `Plazma.dummyProperty`, ao inserir da seguinte forma, o valor `37` será inserido na próxima propriedade para inicializar o Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indica que o argumento não está embutido no JVM, mas é um argumento exclusivo adicionado ao Plazma, + +Se nenhum valor for inserido na propriedade, o valor será fixado como [`true`.](#user-content-fn-3)[^3] + +{% dica estilo="info" %} + +### As plataformas de servidor da série Paperweight incluem um ponto `.` no nome da propriedade para distinguir as propriedades do sistema entre cada plataforma. + +Alguns terminais como o Windows Powershell podem não aceitar esses argumentos, portanto, `"` deve ser adicionado nas extremidades dos argumentos.[^4] +{% endhint %} + +### Todas as Propriedades do Sistema + +#### `convertLegacySigns` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Atualiza o formato de placas desativadas. + +#### `debug.entities` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração relacionados às informações de entidades. + +#### `debug.rewriteForIDE` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a revisão NMS para permitir que as informações de depuração sejam carregadas corretamente no IDE e remapeia automaticamente as informações de versão interna. + +#### `disable.watchdog` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa o sistema de alerta de Watchdog do Spigot. + +#### `letMeReload` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a mensagem de confirmação do comando `/reload`. + +{% hint style="danger" %} + +### Como o comando `/reload` é muito instável, todos os problemas no servidor após o uso do `/reload` são de responsabilidade do usuário. + +Se você é um desenvolvedor de plugins e precisa atualizar um plugin, use o hotswap em vez do `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa plugins que usam o sistema de entrada/saída padrão. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Avisa quando um formato descontinuado é detectado em componentes de chat. + +#### `Paper.bypassHostCheck` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a verificação de padrão do servidor quando um jogador se conecta. + +#### `Paper.debugDynamicMissingKeys` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração para chaves ausentes em objetos NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração para blocos de cabeça com perfis inválidos. + +Isso registra todos os blocos de cabeça inválidos no mundo, juntamente com suas localizações. + +#### `Paper.disableChannelLimit` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa o limite de 128 canais de plugin por jogador. + +#### `Paper.disableClassPrioritization` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa o sistema de priorização de classes de plugins. + +Útil em casos de problemas com sombreamento de plugins. + +#### `Paper.disableFlushConsolidate` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a consolidação de descarga do Netty. + +#### `Paper.excessiveTELimit` + +- **Tipo**: `Integer` +- **Valor Padrão**: `750` + +Divide em múltiplos pacotes para transmissão se houver mais entidades do que o valor definido. + +#### `Paper.filterThreshold` + +- **Tipo**: `Integer` +- **Valor Padrão**: `8192` + +Define o tamanho máximo de pacotes que o servidor pode receber de uma só vez. + +#### `Paper.ignoreJavaVersion` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Desativa a verificação da versão do Java. + +{% hint style="danger" %} + +### Isso permite que o JVM tente acessar código inexistente! + +Isso pode resultar em danos permanentes nos arquivos do mundo e causar falhas em todo o mecanismo do jogo. + +Qualquer problema causado pelo uso disso é de responsabilidade do usuário e o Plamza não oferece suporte para isso. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tipo**: `Integer` +- **Valor Padrão**: `64` + +Define o limite de caracteres no nome do canal do plugin. + +#### `Paper.maxSignLength` + +- **Tipo**: `Integer` +- **Valor Padrão**: `80` + +Define o comprimento máximo de caracteres em uma linha de placa. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tipo**: `Integer` +- **Valor Padrão**: `(versão do mundo) + 1` + +Define a versão das informações de atualização do mundo a serem inicializadas primeiro. + +Útil ao atualizar um grande número de chunks, mas raramente usado em outras situações. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Verdadeiro` + +Ativa o processamento de comentários em arquivos YAML. + +#### `Paper.playerConnection.keepAlive` + +- **Tipo**: `Integer` +- **Valor Padrão**: `30` + +Expulsa o jogador se não receber dados por um determinado período de tempo (em segundos). + +Normalmente, o jogo[^7] envia continuamente um [sinal de pulsação](#user-content-fn-8)[^8] para o servidor, evitando a expulsão, mas se o jogo não responder, o servidor considera que houve uma falha e expulsa o jogador. + +#### `Paper.skipServerPropertiesComments` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ignora os comentários das propriedades do servidor. + +#### `Paper.debug-sync-loads` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa logs de depuração para a criação síncrona de chunks. + +#### `Paper.enable-sync-chunk-writes` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa o sistema de escrita de chunks síncrono padrão do Minecraft. + +Isso salva cada chunk em ordem, causando uma grande degradação de desempenho. + +#### `Paper.explicit-flush` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ativa o Flush Explícito do canal de rede. + +#### `Paper.strict-thread-checks` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Registra sempre erros que não ocorreram no thread principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Exibe um aviso se uma tarefa agendada tiver um atraso excessivo. + +#### `Paperclip.patchOnly` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `Falso` + +Ao usar o arquivo de execução padrão, aplica apenas o patch sem iniciar o servidor. + +#### `Plazma.aggressiveOptimize` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` + +{% hint style="warning" %} + +### Esta propriedade será movida para argumentos de inicialização após a versão 1.20.5. + +{% endhint %} + +Aplica otimizações de configuração mais rigorosas no início. + +Ao ativar, o servidor ficará mais rápido e seguro, mas pode bloquear algumas mecânicas ou ter um grande impacto no jogo. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` + +Suprime o aviso[^11] exibido quando o Plazma é inicializado. + +### Atributo obsoleto + +Os atributos de sistema abaixo são obsoletos. + +#### `timings.bypassMax` + +- **Tipo**: `Boolean` +- **Valor Padrão**: `falso` +- **Obsoleto**: Desde a remoção do Timings do Plazma + +Decide se pode exceder o máximo de valores enviados para a API de Timings de Aikar. + +Se não for tratado pela API, será aplicado um limite de taxa. + +*** + +## Argumento de início + +O argumento de início é inserido após `-jar *.jar` para inicializar o Plazma e é processado em conjunto. + +### Modo de uso + +Os atributos de sistema são inseridos como argumentos de programa após `-jar *.jar`. + +Por exemplo, se você deseja aplicar o argumento de início `nogui`,\ +insira da seguinte forma para que o Plazma processe o argumento `nogui` durante a inicialização. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumento de início completo + +#### `bukkit-settings` + +- **Alias**: `b` +- **Valor padrão**: `bukkit.yml` + +Configura o nome e localização do [arquivo de configuração do Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Valor padrão**: `commands.yml` + +Configura o nome e localização do [arquivo de configuração de comandos do Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Valor padrão**: `server.properties` + +Configura o nome e localização do arquivo de [propriedades do servidor](../reference/configurations/property.md). + +#### `demo` + +Inicia o servidor no mundo de demonstração. + +#### `eraseCache` + +Remove os arquivos de cache restantes após a atualização do mundo. + +#### `forceUpgrade` + +Força a [atualização](#user-content-fn-12)[^12] do mundo, ignorando a versão. + +#### `help` + +- **Alias**: `?` + +Exibe todos os argumentos de início do Plazma e suas descrições. + +#### `initSettings` + +Cria apenas o arquivo de configuração e encerra o servidor. + +#### `jfrProfile` + +Ativa o perfil JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o número máximo de [jogadores](#user-content-fn-14)[^14] permitidos. + +#### `nogui` + +Desativa o painel de interface gráfica. + +#### `nojline` + +Desativar o JLine e usar o console de baunilha. + +#### `online-mode` + +- **Alias**: `o` +- **Valor padrão**: `(propriedades do servidor)` + +Escolha se autenticar os jogadores no servidor de autenticação da Mojang. + +**Se não estiver usando Velocity ou outro proxy, você pode ser sancionado por violar o [EULA](../getting-started/README.md#id-5)** + +#### `paper-settings` + +- **Alias**: `paper` +- **Valor padrão**: `paper.yml` + +{% hint style="warning" %} + +### Este argumento foi descontinuado após a versão 1.19.4 + +{% endhint %} + +Configura a localização do arquivo de configuração do PaperSpigot descontinuado. + +Usado para migrar as configurações do PaperSpigot descontinuado para um novo arquivo de configuração, não é mais utilizado posteriormente. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Valor padrão**: `config` + +Configura o nome e a localização da pasta onde os arquivos de configuração do Paper estão localizados. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Configura o nome e a localização da pasta onde os arquivos de configuração do Plazma estão localizados. + +#### `plugins` + +- **Alias**: `p` +- **Valor padrão**: `plugins` + +Configura a localização da pasta de plugins. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Valor padrão**: `pufferfish.yml` + +Configura o nome e a localização do arquivo de configuração do Pufferfish. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Valor padrão**: `purpur.yml` + +Configura o nome e a localização do arquivo de configuração do Purpur. + +#### `safeMode` + +Inicia o servidor em um estado completamente de baunilha (modo seguro). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o nome do host do servidor ou o endereço IP do [Protocolo de Internet](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Valor padrão**: `(propriedades do servidor)` + +Configura a porta do servidor. + +#### `server-name` + +- **Valor padrão**: `A Plazma Server` + +Configura o nome do servidor. + +#### `spigot-settings` + +- **Alias**: `S` +- **Valor padrão**: `spigot.yml` + +Configura o nome e a localização do arquivo de configuração do Spigot. + +#### `version` + +- **Alias**: `v` + +Exibe a versão do Plazma. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Valor padrão**: `(pasta do servidor)` + +Configura a localização onde os arquivos do mundo são salvos. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Valor padrão**: `(propriedades do servidor)` + +Configura o nome do arquivo do mundo. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: A forma como os argumentos são tratados muda dependendo da posição em que são adicionados. + +[^3]: Por exemplo, se você deseja definir (ativar) `Plazma.iKnowWhatIAmDoing` como `true`, em vez de inserir `-DPlazma.iKnowWhatIAmDoing=true`, você pode simplesmente inserir `-DPlazma.iKnowWhatIAmDoing` e ele funcionará da mesma maneira. + +[^4]: Por exemplo, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de eventos. + +[^6]: Detector de eventos. + +[^7]: Cliente. + +[^8]: Um sinal que indica que o cliente está conectado ao servidor de forma adequada, como os batimentos cardíacos. + +[^9]: Com a função de expulsão AFK do Purpur, é possível expulsar jogadores ausentes. + +[^10]: Sistema de escrita de chunks síncrono, Sync Chunk Write System. + +[^11]: `AVISO! Plazma pode causar problemas inesperados, portanto, certifique-se de testá-lo completamente antes de usá-lo em um servidor público.` + +[^12]: `World Optimization` no jogo também funciona com o mesmo princípio. + +[^13]: Protocolo de Internet, IP. + +[^14]: Administradores de `nível 2` ou superior estão excluídos. diff --git a/pt-PT/origin/plazma/adminstration/reference/commands.md b/pt-PT/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..52e208f8c --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Descubra os comandos disponíveis no Plazma. +--- + +# 🖥️ Comandos diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/bukkit.md b/pt-PT/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..f7cea0cea --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em bukkit.yml significa. +--- + +# 🪣 Bukkit diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/paper/README.md b/pt-PT/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..3f33c916d --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o propósito de cada arquivo na pasta de configuração. +--- + +# 🛩️ Papel diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/paper/global.md b/pt-PT/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..d02dfd30e --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em paper-global.yml significa. +--- + +# 🛩️ Paper (Configuração Global) diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/paper/world.md b/pt-PT/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..99da02cf5 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em paper-world.yml significa. +--- + +# 🛩️ Paper (Composição do Mundo) diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/README.md b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..5a3da3908 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o propósito de cada arquivo na pasta de configuração. +--- + +# ✨ Plazma diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/global.md b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..f31dafe34 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-global.yml significa. +--- + +# ✨ Plazma (Configuração Global) diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..cb2a24829 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Configuração por país diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..c19e0c5fd --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em plazma-world.yml significa. +--- + +# ✨ Plazma (Composição mundial) diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/property.md b/pt-PT/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..eaca537cb --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em server.properties significa. +--- + +# 🪨 Server.properties diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/pufferfish.md b/pt-PT/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..134e52525 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em pufferfish.yml significa. +--- + +# 🐡 Baiacu diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/README.md b/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..f0c947eab --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em purpur.yml significa. +--- + +# 🦑 Purpur diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/global.md b/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..bb5ccce80 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em purpur.yml significa. +--- + +# 🦑 Purpur (composição global) diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/world.md b/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..9a3efe0a4 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em purpur.yml significa. +--- + +# 🦑 Purpur (Composição do mundo) diff --git a/pt-PT/origin/plazma/adminstration/reference/configurations/spigot.md b/pt-PT/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..d6c432d14 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Descubra o que cada nó em spigot.yml significa. +--- + +# 🚰 Spigot diff --git a/pt-PT/origin/plazma/adminstration/reference/permissions.md b/pt-PT/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..8ec57cc76 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Descubra sobre as permissões do Plazma. +--- + +# 🛡️ Permissões diff --git a/pt-PT/origin/plazma/adminstration/referencia/README.md b/pt-PT/origin/plazma/adminstration/referencia/README.md new file mode 100644 index 000000000..4e59bc817 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/referencia/README.md @@ -0,0 +1,2 @@ +# 📜 Referência + diff --git a/pt-PT/origin/plazma/adminstration/referencia/arquivos-de-configuracao/README.md b/pt-PT/origin/plazma/adminstration/referencia/arquivos-de-configuracao/README.md new file mode 100644 index 000000000..826972f18 --- /dev/null +++ b/pt-PT/origin/plazma/adminstration/referencia/arquivos-de-configuracao/README.md @@ -0,0 +1,2 @@ +# 🎨 Arquivos de Configuração + diff --git a/pt-PT/origin/plazma/developers.md b/pt-PT/origin/plazma/developers.md new file mode 100644 index 000000000..67eec462c --- /dev/null +++ b/pt-PT/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Desenvolva projetos de terceiros usando o Plazma. +--- + +# ⚙️ Guia do desenvolvedor diff --git a/pt-PT/origin/thunderbolt/README.md b/pt-PT/origin/thunderbolt/README.md new file mode 100644 index 000000000..a497b782e --- /dev/null +++ b/pt-PT/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt é uma plataforma de servidor baseada em Plazma que permite experimentar patches experimentais diferenciados por sabor para uso direto. +--- + +# 🌩️ Guia de Uso do Thunderbolt diff --git a/pt-PT/origin/volt/README.md b/pt-PT/origin/volt/README.md new file mode 100644 index 000000000..13111adf7 --- /dev/null +++ b/pt-PT/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt é um modelo de código aberto que permite desenvolver sua própria plataforma de servidor Paperweight com base no Plazma. +--- + +# ⚡ Guia de Desenvolvimento do Volt diff --git a/ro/origin/README.md b/ro/origin/README.md new file mode 100644 index 000000000..0ca23a39c --- /dev/null +++ b/ro/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Dacă aveți întrebări, vă rugăm să le adresați prin Discord sau GitHub Discussions. +--- + +# 🏠 Bine ați venit la Portalul de Documente + +{% hint style="info" %} + +**Documentele lui Plazma sunt în prezent traduse automat.** + +[![Stare de traducere](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Participați la traducerea documentelor pe [https://translate.plazmamc.org/](https://translate.plazmamc.org/) pentru a îmbunătăți documentele. + +{% endhint %} + +### Plazma 사용 중 문제가 생겼다면? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Dacă sunteți interesat de Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Dacă doriți să vă creați propria platformă de server cu Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Dacă aveți nevoie de mai multe informații legate de Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ro/origin/SUMMARY.md b/ro/origin/SUMMARY.md new file mode 100644 index 000000000..6cef90a5c --- /dev/null +++ b/ro/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Cuprins + +- [🏠 Bun venit la Portalul Docs](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Documentație de Utilizare Plazma](plazma/README.md) +- [❓ Ce Este Plazma?](plazma/about/README.md) + - [⬇️ Descărcare](plazma/about/downloads.md) + - [✅ Starea de Suport a Versiunii](plazma/about/supported-versions.md) +- [⚒️ Ghid de administrare a serverului](plazma/administration/README.md) + - [👟 Începând](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referință](plazma/administration/reference/README.md) + - [🖥️ Comenzi](plazma/administration/reference/commands.md) + - [🛡️ Permisiuni](plazma/administration/reference/permissions.md) + - [🎛️ Argumente și Atribute](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Proprietate](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Configurație Globală](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Configurații pe glob](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Configurație Globală](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Configurații pe glob](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Configurație Globală](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Configurații pe glob](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avansat](plazma/administration/expert/README.md) + - [🧹 Optimizare](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanilizare](plazma/administration/expert/vanillaize.md) + - [🩻 Blocare X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Vulnerabilități și Soluții](plazma/administration/expert/fix-exploits.md) + - [⁉️ Întrebări Frecvente](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Ghid pentru Dezvoltatori](plazma/developers.md) + - [✏️ Contribuie](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadoc-uri](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Ghid de Utilizare Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Ghid de Dezvoltare Volt](volt/README.md) + +## Diverse + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Descărcați Toate](plazma/about/downloads-all.md) diff --git a/ro/origin/miscellaneous/README.md b/ro/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ro/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ro/origin/plazma/README.md b/ro/origin/plazma/README.md new file mode 100644 index 000000000..23a630f25 --- /dev/null +++ b/ro/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma este o platformă de servere open source pentru Minecraft: Java Edition care adaugă optimizare experimentală bazată pe hârtie și personalizarea mecanicilor de joc." +--- + +# ✨ Documentație de Utilizare Plazma + +## 👋 Bine ați venit la Documentația Plazma + +Bine ați venit la ghidul de utilizare al Plazma! + +{% hint style="info" %} + +**Nu puteți rezolva problema prin intermediul manualului de instrucțiuni?** + +[Server Discord oficial](https://discord.gg/MmfC52K8A8) sau [Discuții GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) pentru a pune întrebări comunității! + +{% endhint %} + +### Despre Plazma + +> Aflați mai multe despre platforma de servere Plazma. + +{% content-ref url="about/" %} +[despre](about/) +{% endcontent-ref %} + +### Pentru Administratori + +> Creează-ți propriul server folosind Plazma. + +{% content-ref url="administration/" %} +[administrare](administration/) +{% endcontent-ref %} + +### Pentru Dezvoltatori + +> Dezvoltă proiecte terțe folosind Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ro/origin/plazma/about/README.md b/ro/origin/plazma/about/README.md new file mode 100644 index 000000000..74418f20b --- /dev/null +++ b/ro/origin/plazma/about/README.md @@ -0,0 +1,72 @@ +--- +description: Aflați mai multe despre platforma de servere Plazma. +--- + +# ❓ Ce este Plazma? + +- **Plazma** este o platformă de server bazată pe [Paper](https://github.com/PaperMC/Paper) care își aduce doar avantajele din [Andromeda](https://github.com/EarendelArchived/Andromeda) și [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Ne străduim să oferim întotdeauna o stabilitate ridicată, performanță puternică, actualizări rapide și o gamă extinsă de funcționalități. + +## 📋 Obiectivele Plazma + +- Ne străduim să devenim o platformă de server cu actualizări rapide și o stabilitate ridicată. +- Ne străduim să oferim o gamă extinsă de funcționalități și performanță puternică, la fel de bune ca cele ale unei platforme de moduri. +- Ne străduim să creăm o platformă liberă și personalizabilă care să permită și patch-uri pentru Vanilla. + +## ⚙️ Caracteristici cheie + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Cele mai rapide actualizări**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) asigură că patch-urile incluse în Plazma sunt întotdeauna actualizate, oferind cele mai rapide actualizări printre platformele de server bazate pe Paper. +6. **Optimizarea fișierelor de configurare implicite**\ + Fișierele de configurare aplicate implicit sunt optimizate, astfel încât nu este necesară optimizarea acestora manual. +7. **Funcționare sistematică pe mai multe fire de execuție**\ + Asincronizează mecanismele de sistem care nu sunt legate de mecanismele jocului pentru a reduce [timpul de întârziere](#user-content-fn-4) și a optimiza serverul. +8. **Blocarea utilizării spațiilor inutile**\ + Combinați datele cu valori similare într-una singură pentru a reduce consumul de memorie. + +## ✨ Studii de caz + +- **Platforma care gestionează corect și plugin-urile complexe**\ + Plazma este utilizat pe serverul dezvoltatorului [IPECTER](https://github.com/IPECTER).\ + Cu propriul său plugin care funcționează cu NMS și reflecție, și cu o cantitate mare și complexă de pachete de date aplicate, serverul poate susține peste 100 de jucători fără scădere de performanță. +- **Platforma care menține performanța rapidă și pe serverele RPG**\ + A reușit să mențină 100 de jucători pe un singur cluster fără scădere a TPS-ului și să permită 250 de jucători să joace confortabil pe 4 clustere. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platforma aleasă de mulți streameri**\ + Este aleasă ca un recipient pentru implicarea spectatorilor multor streameri. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Descărcare + +Puteți descărca Plazma de pe pagina de mai jos. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Doriți să aflați mai multe despre suportul pentru versiuni? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Plugin-urile Bukkit, CraftBukkit, Spigot și plugin-urile Paper, Pufferfish, Purpur. + +[^2]: De la Microsoft Corporation. + +[^3]: Dacă dezactivați sistemul de raportare a chat-ului, chat-ul este gestionat exclusiv pe server, prevenind urmărirea chat-ului de către Mojang. + +[^4]: Timpul când jocul se oprește pentru ca mecanismele de sistem să funcționeze. diff --git a/ro/origin/plazma/about/downloads-all.md b/ro/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..819d4df8c --- /dev/null +++ b/ro/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Vizualizare completă a fișierului de descărcare Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| versiune | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ro/origin/plazma/about/downloads.md b/ro/origin/plazma/about/downloads.md new file mode 100644 index 000000000..8f475aefb --- /dev/null +++ b/ro/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Descărcați acum Plazma și încercați-l direct. +--- + +# ⬇️ Descărcare + +#### Doriți să aflați mai multe despre suportul pentru versiuni? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Descărcarea de mai jos este un fișier executabil pentru utilizatorii obișnuiți.** + +Dacă sunteți dezvoltator și aveți nevoie de un alt tip de fișier, consultați pagina de mai jos. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
versiunedescărcare
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/ro/origin/plazma/about/patches-list.md b/ro/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..bd91dd74a --- /dev/null +++ b/ro/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Descoperiți toate funcțiile adăugate în Plazma. +--- + +# 📑 Patch-uri incluse diff --git a/ro/origin/plazma/about/supported-versions.md b/ro/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..3a3cbef53 --- /dev/null +++ b/ro/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Descoperiți versiunea Minecraft: Java Edition suportată de Plazma." +--- + +# ✅ Starea de suport a versiunii + +{% hint style="info" %} + +**Plazma a fost dezvoltat începând cu versiunea 1.19.4 și versiunile sub 1.19.4 nu mai sunt dezvoltate.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Așteptare%20pentru%20eliberare +[idv]: https://badge.plazmamc.org/1/în%20dezvoltare +[atv]: https://badge.plazmamc.org/2/în%20curs%20de%20sprijin +[fse]: https://badge.plazmamc.org/6/suport%20pentru%20funcționalitate%20întrerupt +[eol]: https://badge.plazmamc.org/4/sfârșitul%20suportului +[ukn]: https://badge.plazmamc.org/0/No%20information +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: https://badge.plazmamc.org/percent/100 + +![În așteptarea lansării][wtr] ![În dezvoltare][idv] ![În curs de sprijin][atv] ![Suport pentru funcționalitate întrerupt][fse] ![Sfârșitul suportului][eol] + +| versiune | Stabilitate și suport funcțional | Stare de construcție | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Starea construirii](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Stare de construcție](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Stare de construcție](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ro/origin/plazma/administration/README.md b/ro/origin/plazma/administration/README.md new file mode 100644 index 000000000..38210d224 --- /dev/null +++ b/ro/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Creează-ți propriul server folosind Plazma. +--- + +# ⚒️ Ghid de administrare a serverului diff --git a/ro/origin/plazma/administration/diagnosis/README.md b/ro/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..717b2c6ff --- /dev/null +++ b/ro/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să gestionați situațiile când apar probleme. +--- + +# 🧾 진단 diff --git a/ro/origin/plazma/administration/diagnosis/plugins.md b/ro/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..4ece821fa --- /dev/null +++ b/ro/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să rezolvați problema atunci când un plugin nu funcționează corect. +--- + +# 📜 플러그인 diff --git a/ro/origin/plazma/administration/expert/README.md b/ro/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..a0e65dffb --- /dev/null +++ b/ro/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să lucrați profesional cu Plazma. +--- + +# 🎓 Avansat diff --git a/ro/origin/plazma/administration/expert/fix-exploits.md b/ro/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..5de9b71c3 --- /dev/null +++ b/ro/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Aflați despre vulnerabilitățile cunoscute și cum să le rezolvați. +--- + +# ⚠️ Vulnerabilități cunoscute și metode de rezolvare diff --git a/ro/origin/plazma/administration/expert/optimize.md b/ro/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..c7d54eaf7 --- /dev/null +++ b/ro/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să optimizați Plazma. +--- + +# 🧹 Optimizare diff --git a/ro/origin/plazma/administration/expert/proxy.md b/ro/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..2883654b4 --- /dev/null +++ b/ro/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să configurați în mod sigur platforma de proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/ro/origin/plazma/administration/expert/vanillaize.md b/ro/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..ffe9636f7 --- /dev/null +++ b/ro/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Aflați cum să restaurați patch-ul Paper și Vanilla. +--- + +# ↩️ Vanilizare + +{% hint style="warning" %} + +**Paper nu adaugă opțiuni în majoritatea patch-urilor pentru a rezolva erorile de vanilie.** + +În prezent, Plazma dezvoltă o configurație pentru a dezactiva aceste soluții de rezolvare a erorilor. + +Prin urmare, acest ghid este încă în curs de elaborare și informațiile pot fi modificate în orice moment. + +{% endhint %} diff --git a/ro/origin/plazma/administration/expert/xray.md b/ro/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..5a4421363 --- /dev/null +++ b/ro/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Descoperiți mai multe metode încorporate pentru blocarea razei X. +--- + +# 🩻 Blocare raze X diff --git a/ro/origin/plazma/administration/faq.md b/ro/origin/plazma/administration/faq.md new file mode 100644 index 000000000..5251ee816 --- /dev/null +++ b/ro/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Aflați mai multe despre întrebările frecvente. +--- + +# ⁉️ Întrebări frecvente + +{% hint style="info" %} + +**Nu găsiți răspunsul dorit?** + +[Server Discord oficial](https://discord.gg/MmfC52K8A8) sau [Discuții GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) pentru a pune întrebări comunității! + +{% endhint %} + +### Plazma nu se deschide + +Dacă apare în consolă `no main manifest attribute, in plazma-(version).jar`,\ +fișierul descărcat este un fișier API de dezvoltare, trebuie să descărcați **Reobf Paperweight** de pe pagina GitHub. + +Pentru mai multe informații, consultați pagina următoare. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Avertismentul apare de fiecare dată când serverul este pornit. + +Plazma conține unele patch-uri instabile și are întotdeauna posibilitatea de a funcționa necorespunzător, prin urmare afișează avertismente similare atunci când serverul este pornit. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Acest avertisment poate fi dezactivat folosind proprietatea de sistem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Pentru mai multe informații, consultați pagina următoare. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponibil începând cu versiunea 1.20.1 diff --git a/ro/origin/plazma/administration/getting-started/README.md b/ro/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..b0c82dbc8 --- /dev/null +++ b/ro/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Aflați cum să creați un server cu Plazma. +--- + +# 👟 Începeți + +Pentru a utiliza Plazma în mod stabil, sistemul trebuie să îndeplinească următoarele cerințe. + +| | Minim | Recomandat | +| :---------------: | ----- | ---------- | +| Arhitectură | x64 | - | +| RAM | 8GB | 16GB | +| Spațiu de stocare | 1GB | 8GB | +| JDK | 17 | 21 | + +Pentru a modifica fișierele de configurare fără probleme, este recomandat să instalați un editor cum ar fi [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Output corect" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' nu este o comandă internă sau externă, un program executabil sau +un fișier batch. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Opțiune neidentificată: --version +Eroare: Nu s-a putut crea Mașina Virtuală Java. +Eroare: A apărut o excepție fatală. Programul se va închide. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Descărcați JDK 21 de la [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) în format `.msi`. +2. Executați asistentul de instalare descărcat și faceți clic pe `Next`. +3. După ce activați `Set JAVA_HOME variable` din meniul afișat în mijlocul stânga al ferestrei, faceți clic pe `Next`. +4. Finalizați instalarea JRE făcând clic pe `Install`. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Apoi, instalați JRE-ul executând următoarea comandă în terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Descărcarea Plazma + +Plazma oferă diverse fișiere de executare. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Află mai multe + +Numele fișierului de executare este `plazma-(managerul versiunii)-1.20.4-R0.1-SNAPSHOT-(formă de mapare).jar`. + +- **Forma de mapare**\ + Maparea este o hartă care leagă codul real al Minecraft-ului de codul obfuscat. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mapare Mojang, este o mapare pentru Minecraft-ul vanilla. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Managerul versiunii**\ + Managerul versiunii este un launcher al serverului care furnizează bibliotecile necesare pentru rularea serverului și aplică patch-uri pe fișierele serverului. + - **Paperclip**\ + Dezvoltat de echipa PaperMC pentru Paper și alte platforme derivate, acesta descarcă bibliotecile și aplică patch-uri pe server. + - **Bundler**\ + Managerul versiunii Vanilla Minecraft. + +
+ +*** + +## 3. Crearea scriptului de pornire + +Pentru a porni Plazma simplu și pentru a reporni automat serverul, trebuie să creați un [script de pornire](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Puteți descărca scriptul de pornire făcând clic pe butonul de descărcare din partea de jos stânga.\ +**Asigurați-vă că scriptul de pornire descărcat este compatibil cu sistemul de operare al dvs.** + +*** + +## 4. Curățarea fișierelor + +Mută scriptul de pornire descărcat și Plazma într-un folder nou. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Executați scriptul de pornire. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Acordarea EULA + +După ce rulați scriptul de pornire o dată, un fișier `eula.txt` va fi creat în folder. + +EULA[^9] este un acord de licență pe care trebuie să-l acceptați pentru a utiliza serviciile [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Pentru a accepta EULA, modificați `eula=false` în fișierul `eula.txt` în `eula=true` și salvați modificările. + +*** + +## 6. Permiterea accesului extern (Windows) + +Sistemele de operare moderne blochează accesul extern pentru a preveni accesul neautorizat prin intermediul **firewall-ului** și **router-ului**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Dacă routerul dvs. nu suportă UPnP, va trebui să căutați informații specifice pentru fiecare router în parte. + +De asemenea, puteți utiliza [Ngrok](https://ngrok.com/) pentru a genera o adresă temporară. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Verificarea necesității de port forwarding + +Introduceți comanda următoare în fereastra de comandă și executați-o. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Dacă obțineți `True`, nu mai este necesar să faceți nimic, dar dacă obțineți `False`, va trebui să setați port forwarding-ul. + +### 6.2 Conectarea la server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Puteți găsi adresa folosită pentru a accesa serverul [aici](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Apoi, dacă reporniți serverul, Plazma va încerca automat să redirecționeze porturile. + +Mai jos este un mesaj de succes sau eșec UPnP afișat în consolă, care va fi afișat ca `[UPnP] (mesaj)`. + +| Mesaj | Semnificație | +| ------------------------------------------- | ------------------------------------------------------- | +| `Portul (port)` a fost deschis cu succes | Redirecționare porturi reușită. | +| `Portul (port) este deja deschis` | Alt serviciu folosește deja acest port. | +| `Nu s-a reușit deschiderea portului (port)` | Redirecționarea porturilor a eșuat. | +| `Serviciul nu este disponibil` | Routerul nu suportă UPnP. | + +Când serverul este oprit, Plazma va închide automat portul. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Descărcați fișierul ZIP `Windows (64-bit)` de pe [site-ul Ngrok](https://ngrok.com/download). +2. Puneți fișierul Ngrok descărcat în dosarul serverului. +3. Generați un token de autentificare pe [Tabloul de bord Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Executați comanda afișată în linia de comandă din dosarul serverului. +5. Adăugați `start /b ngrok tcp --region jp 25565` în partea de sus a scriptului de pornire și `taskkill /f /t /im ngrok.exe` în partea de jos. +6. Adresa serverului va fi `0.tcp.jp.ngrok.io:12345` conform afișării de sus `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`. +7. Acum puteți accesa serverul de la distanță folosind această adresă. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +De exemplu, atunci când rulați comanda și obțineți următorul rezultat, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Puteți accesa serverul local folosind adresa IPv4 `192.168.3.7` afișată aici. + +Dacă serverul și jocul rulează pe același PC, puteți accesa folosind `localhost`. +{% endtab %} +{% endtabs %} + +## 7. A evolua + +Dacă serverul a fost inițiat cu succes și funcționează corect, acum este momentul să îl personalizați. + +Aflați cum să personalizați serverul urmând instrucțiunile de mai jos. + +{% content-ref url="urmatorul-pas.md" %} +[urmatorul-pas.md](urmatorul-pas.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, pe care se bazează Plazma, este bazat pe Spigot și Spigot se bazează pe platforma oficială a serverului. + +[^3]: Tastele Windows + R + +[^4]: Pentru Linux, rulați `java --version` în terminal + +[^5]: JRE este un proiect open source și există diverse versiuni, asemănătoare cu platforma serverului Minecraft. + +[^6]: Este cunoscut în mod obișnuit ca **launcher**. + +[^7]: Activarea opțiunii "Repornire automată" va duce la repornirea automată a serverului. Puteți opri serverul tastând `Control + C`. + +[^8]: Nu se recomandă alocarea a mai mult de jumătate din resursele sistemului. + + De exemplu, pentru un total de 8GB memorie RAM, nu este recomandat să alocați mai mult de 4GB. + +[^9]: Acordul de licență pentru utilizatorul final, End-User License Agreement. Pentru detalii, consultați [site-ul Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Corporația Microsoft. + +[^11]: În conformitate cu articolul 32 alineatul (1) punctul 9 din Legea privind promovarea industriei de jocuri video din Coreea, puteți acționa în justiție **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpurul inclus în Plazma utilizează această tehnologie pentru a comunica automat cu routerul și a deschide porturile doar atunci când serverul rulează, eliminând necesitatea redirecționării manuale a porturilor. + +[^13]: Dacă nu aveți un cont, vă puteți înregistra pe Ngrok folosind un cont Google sau GitHub. diff --git a/ro/origin/plazma/administration/getting-started/customization.md b/ro/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..0f1d6d481 --- /dev/null +++ b/ro/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,114 @@ +--- +description: Aflați cum să personalizați serverul. +--- + +# 🎨 Personalizare utilizator + +Motivul pentru care se utilizează o platformă de server modificată precum Plazma în locul platformei oficiale furnizate de Mojang Studios este capacitatea puternică de **personalizare** pe care o oferă. + +Mai jos sunt enumerate mai multe moduri de personalizare și utilizare a Plazma. + +## Modificarea configurației + +Cel mai simplu mod de a personaliza Plazma este prin modificarea configurației. + +Plazma oferă setări de configurare puternice, inclusiv mecanisme de joc și caracteristici ale entităților. + +Pentru informații detaliate despre configurația Plazma, consultați pagina de mai jos. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Utilizarea de plugin-uri + +{% hint style="success" %} + +**Plazma suportă în mod normal toate pluginurile bazate pe hârtie.** + +În cazul pluginurilor Spigot, din cauza modificărilor de mapare de la 1.20.5 la hârtie, unele pot să nu funcționeze, dar majoritatea pluginurilor bazate pe hârtie, cum ar fi Paper, Pufferfish și Purpur, vor funcționa normal în Plazma, iar dacă nu funcționează corect, este o eroare în Plazma, vă rugăm să [raportați imediat.](../diagnosis/plugins.md) + +{% endhint %} + +Acesta este unul dintre principalele motive pentru utilizarea Plazma și cea mai puternică metodă de personalizare a Plazmei. +Ecosistemul puternic de pluginuri al Plazma permite personalizarea ușoară a serverului. + +Există mai multe modalități de a găsi și descărca pluginuri. Unele pluginuri sunt încărcate pe servicii de depozitare publică, iar altele sunt încărcate pe GitHub sau pe propriul lor site. + +{% hint style="caution" %} + +**Pluginurile pot accesa direct sistemul!** + +Utilizați servicii precum VirusTotal pentru a verifica întotdeauna siguranța pluginurilor înainte de a le aplica sau descărca pluginuri de pe servicii de încredere. + +{% endhint %} + +Există mai multe servicii pentru descărcarea pluginurilor. Dintre acestea, servicii precum [Forumul SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) supun pluginurile la o verificare înainte de a fi încărcate, astfel încât doar pluginurile sigure să fie distribuite. + +### Aplicarea pluginurilor + +Dacă ați descărcat un plugin, acum este momentul să îl aplicați. + +1. Pluginurile sunt sub formă de fișiere `.jar` sau fișiere executabile Java.\ + Unele pluginuri pot fi împachetate în arhive, în acest caz, extrageți arhiva și utilizați fișierul care conține `bukkit`, `spigot` sau `paper` în nume, iar dacă există un fișier `fat`, folosiți acel fișier. +2. Puneți fișierul descărcat în dosarul `plugins` al serverului și reporniți serverul. +3. Când Plazma începe, va afișa noi informații în consolă. + Acest lucru indică faptul că Plazma a încărcat pluginul corect. +4. Chiar dacă Plazma a încărcat pluginul corect, acesta ar putea să nu pornească. + Puteți folosi comanda `/plugins` pentru a afișa pluginurile încărcate în prezent pe server. + Dacă numele pluginului nu este roșu, ci verde, atunci pluginul a fost încărcat corect. + +Dacă pluginul nu a fost încărcat corect, puteți găsi soluții la probleme pe pagina de mai jos. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Utilizarea Datapack-urilor + +Datapack-urile sunt o metodă de personalizare oferită de Minecraft, similară cu [pachetele de resurse](#user-content-fn-1)[^1]. + +Prin utilizarea Datapack-urilor, puteți adăuga noi entități și provocări în joc, modificând anumite aspecte ale acestuia. + +{% hint style="caution" %} + +**Datapack-urile pot afecta lumea jocului!** + +Anumite Datapack-uri defecte pot afecta lumea jocului în mod ireversibil. + +De aceea, este recomandat să faceți backup la lumea jocului înainte de a aplica Datapack-urile. + +{% endhint %} + +Datapack-urile pot fi descărcate de pe mai multe servicii, cum ar fi [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) și altele. + +După ce ați descărcat Datapack-ul, puteți aplica acesta punându-l în dosarul `datapacks` al lumii serverului. +Dacă dosarul nu există, puteți crea unul pentru a adăuga Datapack-ul. + +{% hint style="warning" %} + +**Pentru unele [Datapack-uri](#user-content-fn-2)[^2], la prima aplicare ar putea să nu funcționeze corect.** + +În acest caz, se recomandă să reporniți serverul **de 2 ori**. + +{% endhint %} + +Datapack-urile pot fi afectate ușor de actualizările Minecraft-ului. + +În special, în cazul în care un Datapack este grav afectat, serverul poate să se blocheze, așa că este important să testați suficient înainte de a actualiza serverul. + +{% hint style="info" %} + +**După comanda de pornire a serverului, puteți introduce `safeMode` pentru a dezactiva toate Datapack-urile și apoi să porniți serverul.** + +[Pentru mai multe informații, consultați `Referințe > Argumente și Atribute`.](../reference/arguments.md) + +{% endhint %} + +Datapack-urile aplicate pot fi verificate folosind comanda `/datapack list`. + +*** + +[^1]: Sau Minecraft: Ediția Bedrock. + +[^2]: Adăugarea de entități și altele. diff --git a/ro/origin/plazma/administration/getting-started/next-step.md b/ro/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..c01988527 --- /dev/null +++ b/ro/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Aflați cum să personalizați serverul. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Mai jos sunt enumerate mai multe moduri de personalizare și utilizare a Plazma. + +## Modificarea configurației + +Cel mai simplu mod de a personaliza Plazma este prin modificarea configurației. + +Plazma oferă setări de configurare puternice, inclusiv mecanisme de joc și caracteristici ale entităților. + +Pentru informații detaliate despre configurația Plazma, consultați pagina de mai jos. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Utilizarea de plugin-uri + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Acesta este unul dintre principalele motive pentru utilizarea Plazma și cea mai puternică metodă de personalizare a Plazmei. Ecosistemul puternic de pluginuri al Plazma permite personalizarea ușoară a serverului. + +Există mai multe modalități de a găsi și descărca pluginuri. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Există mai multe servicii pentru descărcarea pluginurilor. Dintre acestea, servicii precum [Forumul SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) supun pluginurile la o verificare înainte de a fi încărcate, astfel încât doar pluginurile sigure să fie distribuite. + +### Aplicarea pluginurilor + +Dacă ați descărcat un plugin, acum este momentul să îl aplicați. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Puneți fișierul descărcat în dosarul `plugins` al serverului și reporniți serverul. +3. Când Plazma începe, va afișa noi informații în consolă. Acest lucru indică faptul că Plazma a încărcat pluginul corect. +4. Chiar dacă Plazma a încărcat pluginul corect, acesta ar putea să nu pornească. Puteți folosi comanda `/plugins` pentru a afișa pluginurile încărcate în prezent pe server. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Dacă pluginul nu a fost încărcat corect, puteți găsi soluții la probleme pe pagina de mai jos. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Utilizarea Datapack-urilor + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Prin utilizarea Datapack-urilor, puteți adăuga noi entități și provocări în joc, modificând anumite aspecte ale acestuia. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Anumite Datapack-uri defecte pot afecta lumea jocului în mod ireversibil. + +De aceea, este recomandat să faceți backup la lumea jocului înainte de a aplica Datapack-urile. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +După ce ați descărcat Datapack-ul, puteți aplica acesta punându-l în dosarul `datapacks` al lumii serverului. Dacă dosarul nu există, puteți crea unul pentru a adăuga Datapack-ul. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +În acest caz, se recomandă să reporniți serverul **de 2 ori**. +{% endhint %} + +Datapack-urile pot fi afectate ușor de actualizările Minecraft-ului. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Datapack-urile aplicate pot fi verificate folosind comanda `/datapack list`. + +*** + +## Optimizare + +Plazma are multe patch-uri de optimizare aplicate. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Pentru informații despre configurarea corectă și sigură a proxy-ului, consultați pagina de mai jos. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Siguranță + +Minecraft-ul s-a dezvoltat în așa fel încât să permită obținerea ușoară a unui [motor de atac cu vulnerabilități](#user-content-fn-3)[^3] și online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Configurare permisiuni + +Unele comenzi de administrator ale unor plugin-uri pot prezenta vulnerabilități dacă permisiunile nu sunt setate corect. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blocare X-Ray + +X-Ray este una dintre vulnerabilitățile ușor de utilizat chiar și într-un client de optimizare de bază. + +Plazma oferă o configurare care poate bloca X-Ray-ul în mod implicit. + +Pentru metodele și descrierile de blocare a X-Ray-ului, consultați pagina de mai jos. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Listă albă + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Pentru a vedea jucătorii cu acces permis, folosiți comanda `/whitelist query`. + +*** + +[^1]: Sau Minecraft: Ediția Bedrock. + +[^2]: Adăugarea de entități și altele. + +[^3]: Sunt cunoscuți în mod obișnuit sub numele de "hack". + +[^4]: În cazul în care configurarea nu este optimizată, Plazma este veche sau există vulnerabilități noi, acestea ar putea să nu fie blocate. + +[^5]: Atunci când un jucător se conectează la server, se face prin intermediul serverului proxy Ngrok și adresa Ngrok emisă la fiecare repornire va fi diferită. diff --git a/ro/origin/plazma/administration/reference/README.md b/ro/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..033d5a2ea --- /dev/null +++ b/ro/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Aflați cum să vă personalizați Plazma. +--- + +# 📜 리퍼런스 + +Plazma oferă diverse metode de personalizare pentru utilizatori. + +Dintre acestea, există 4 metode de personalizare pe care le puteți utiliza imediat, fără alte operațiuni suplimentare. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Server Discord oficial](https://discord.gg/MmfC52K8A8) sau [Discuții GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) pentru a pune întrebări comunității! +{% endhint %} + +*** + +## 🖥️ Comenzi + +> Comenzile vă permit să colectați informații în joc sau să personalizați mediul de joc. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Permisiuni + +> Permisiunile stabilesc domeniul în care jucătorii pot interacționa. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumente și Atribute + +> Argumentele și atributele au un impact general asupra funcționării Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Configurare + +> Configurarea este cea mai fundamentală metodă de personalizare a Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ro/origin/plazma/administration/reference/arguments.md b/ro/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..cd96eb22b --- /dev/null +++ b/ro/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Înțelegeți argumentele de pornire și proprietățile sistemului. +--- + +# 🎛️ Argumente și proprietăți + +Începutul achiziției și proprietățile sistemului sunt valori adăugate la [comenzile utilizate](#user-content-fn-1)[^1] pentru a rula Plazma, având un impact general asupra funcționării Plazmei. + +[Locația adăugată comenzii](#user-content-fn-2)[^2] va fi împărțită în **Argumentul de pornire** și **Proprietățile sistemului** conform. + +*** + +## Proprietățile sistemului + +Proprietățile sistemului sunt valorile procesate de JVM înainte de inițializarea Plazma, fiind introduse înainte de `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Mod de utilizare + +Proprietățile sistemului sunt introduse ca argumente Java între `java` și `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indică faptul că argumentul respectiv nu este încorporat în JVM, ci este un argument dedicat adăugat la Plazma, + +Dacă nu se introduce nici o valoare pentru proprietate, valoarea va fi fixată la [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Toate proprietățile sistemului + +#### `convertLegacySigns` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Actualizează formatul panourilor de semnalizare dezactivate. + +#### `debug.entities` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare legate de informațiile entității. + +#### `debug.rewriteForIDE` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează revizia NMS pentru a permite IDE-ului să citească corect informațiile de depanare și remapează automat informațiile de versiune interne. + +#### `disable.watchdog` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează sistemul de avertizare Watchdog al Spigot. + +#### `letMeReload` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează mesajul de confirmare al comenzii `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Dacă sunteți dezvoltator de plugin-uri și trebuie să faceți actualizări, folosiți hotswap în loc de comanda `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează pluginurile care folosesc sistemul standard de intrare/ieșire. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Avertizează când se detectează un format vechi în componentele de chat. + +#### `Paper.bypassHostCheck` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează verificarea potrivirii modelului serverului atunci când un jucător se conectează la server. + +#### `Paper.debugDynamicMissingKeys` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare pentru cheile lipsă din obiectele NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare pentru profilurile incorecte ale capului. + +Aceasta va înregistra toate blocurile de cap incorecte din lume, împreună cu locațiile acestora. + +#### `Paper.disableChannelLimit` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează sistemul de prioritizare a claselor de pluginuri. + +Util în cazul în care apar probleme în umbrirea pluginurilor. + +#### `Paper.disableFlushConsolidate` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează consolidarea de flux Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Valoare implicită**: `750` + +Dacă entitățile depășesc valoarea setată, sunt trimise în pachete multiple. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Valoare implicită**: `8192` + +Setează dimensiunea maximă a pachetului pe care serverul îl poate primi odată. + +#### `Paper.ignoreJavaVersion` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează verificarea versiunii Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Acest lucru poate duce la deteriorarea permanentă a fișierelor precum lumea și la defectarea mecanismului de joc. + +Orice problemă cauzată de acest lucru este responsabilitatea dumneavoastră, Plazma nu oferă nicio asistență în acest sens. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Valoare implicită**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Valoare implicită**: `80` + +Setează lungimea maximă a textului pe o linie a unui panou de semnalizare. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Valoare implicită**: `(versiunea lumii) + 1` + +Setează versiunea inițială a informațiilor de actualizare a lumii care trebuie inițializate. + +Util în cazul în care este necesară actualizarea în masă a chunk-urilor, dar în celelalte situații nu este folosit. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tip**: `Boolean` +- **Valoare implicită**: `True` + +Activează procesarea comentariilor YAML din fișiere. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Valoare implicită**: `30` + +Dacă un jucător nu trimite nicio dată pentru o perioadă specificată (în secunde), este deconectat. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Ignoră comentariile din proprietățile serverului. + +#### `Paper.debug-sync-loads` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare pentru încărcările sincronizate de chunk-uri. + +#### `Paper.enable-sync-chunk-writes` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează sistemul de scriere a chunk-urilor sincronizat implicit din Minecraft. + +Acest lucru duce la o performanță foarte scăzută deoarece fiecare chunk este salvat în ordine. + +#### `Paper.explicit-flush` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează descărcarea explicită a canalului de rețea. + +#### `Paper.strict-thread-checks` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Înregistrează întotdeauna erorile care nu apar pe thread-ul principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Afișează avertismente când o sarcină programată are o întârziere excesivă. + +#### `Paperclip.patchOnly` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dacă se folosește fișierul de executare implicit, aplică doar patch-ul fără a porni serverul. + +#### `Plazma.aggressiveOptimize` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` +- **Conflict**: `Plazma.disableConfigOptimization` + +Optimize the initial configuration more strongly. + +Activating this will make the server faster and safer, but can have a major impact on gameplay. + +#### `Plazma.disableConfigOptimization` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` +- **Conflict**: `Plazma.aggressiveOptimize` + +Do not optimize the initial configuration. + +This forces the use of the default configuration of Paper. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` + +Disables Plazma branding and uses the vanilla default server favicon. + +#### `Plazma.useVanillaConfiguration` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` +- **Conflict**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +This can significantly impact server security and performance. + +Any issues arising from using this property are the responsibility of the server administrator. +{% endhint %} + +Provides the initial configuration with the default values provided by Mojang. + +This disables all vulnerability patches applied in Paper. + +Vulnerability patches can be re-enabled in Paper configuration or Plazma configuration. + +#### `Plazma.vanillaize` + +- **Tip**: `Boolean` +- **Default**: `true` +- **Conflict**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Sets the initial configuration closer to vanilla. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Proprietatea întreruptă + +Următoarele proprietăți de sistem sunt proprietăți întrerupte. + +#### `timings.bypassMax` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` +- **Întrerupt**: Timings a fost eliminat din Plazma + +Hotărăște dacă valoarea trimisă către API-ul Timings al lui Aikar poate depăși maximul permis. + +Chiar și atunci când se face acest lucru, limita de rată se aplică dacă nu este gestionată excepțional de API. + +*** + +## Argumentul de pornire + +Argumentul de pornire este introdus după `-jar *.jar` pentru a inițializa Plazma și este tratat împreună cu acesta. + +### Mod de utilizare + +Proprietățile de sistem sunt introduse ca argumente de comandă după `-jar *.jar`. + +De exemplu, dacă doriți să aplicați argumentul de pornire `nogui`,\ +introduceți astfel pentru ca Plazma să-l proceseze în timpul inițializării. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumentul de pornire complet + +#### `bukkit-settings` + +- **Poreclă**: `b` +- **Valoare implicită**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Poreclă**: `c` +- **Valoare implicită**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Poreclă**: `c` +- **Valoare implicită**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Pornește serverul în lumea demonstrativă. + +#### `eraseCache` + +Șterge fișierele de cache rămase după actualizarea lumii. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Poreclă**: `?` + +Afișează toate argumentele și descrierile de pornire ale Plazma. + +#### `initSettings` + +Generează doar fișierele de configurare și închide serverul. + +#### `jfrProfile` + +Activează profilarea JFR. + +#### `max-players` + +- **Poreclă**: `s`, `size` +- **Valoare implicită**: `(proprietatea serverului)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Dezactivează panoul interfeței grafice. + +#### `nojline` + +Dezactivează JLine și folosește consola vanilla. + +#### `mod-online` + +- **Poreclă**: `o` +- **Valoare implicită**: `(proprietatea serverului)` + +Selectează dacă să verifice jucătorii prin serverul de autentificare Mojang. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `setări-hârtie` + +- **Poreclă**: `hârtie` +- **Valoare implicită**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Stabilește locația fișierului de configurare PaperSpigot dezactivat. + +Acesta este utilizat pentru a muta configurația existentă într-un nou fișier de configurare și nu va fi utilizat ulterior. + +#### `director-setări-hârtie` + +- **Poreclă**: `dir-hârtie` +- **Valoare implicită**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `director-setări-plazma` + +- **Poreclă**: `dir-plazma` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `module` + +- **Poreclă**: `m` +- **Valoare implicită**: `module` + +Stabilește locația folderului pentru module. + +#### `setări-pufferfish` + +- **Poreclă**: `pufferfish` +- **Valoare implicită**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `setări-purpur` + +- **Poreclă**: `purpur` +- **Valoare implicită**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `mod-sigur` + +(Mod sigur) Pornește serverul într-o stare complet vanilată. + +#### `ip-server` + +- **Poreclă**: `h`, `gazdă` +- **Valoare implicită**: `(proprietatea serverului)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `port-server` + +- **Poreclă**: `p`, `port` +- **Valoare implicită**: `(proprietatea serverului)` + +Stabilește portul serverului. + +#### `nume-server` + +- **Valoare implicită**: `Un server Plazma` + +Stabilește numele serverului. + +#### `setări-spigot` + +- **Poreclă**: `S` +- **Valoare implicită**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `versiune` + +- **Poreclă**: `v` + +Afișează versiunea Plazma. + +#### `director-lume` + +- **Poreclă**: `W`, `univers`, `container-lume` +- **Valoare implicită**: `(folder-ul serverului)` + +Stabilește locația în care sunt salvate fișierele lumii. + +#### `nume-lume` + +- **Poreclă**: `w`, `lume` +- **Valoare implicită**: `(proprietatea serverului)` + +Stabilește numele fișierului lumii. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Poziția de procesare a argumentelor se schimbă în funcție de locația adăugată. + +[^3]: De exemplu, dacă doriți să setați (activați) `Plazma.iKnowWhatIAmDoing` la `true`, în loc să introduceți `-DPlazma.iKnowWhatIAmDoing=true`, puteți introduce doar `-DPlazma.iKnowWhatIAmDoing` și va funcționa la fel de bine. + +[^4]: De exemplu, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de evenimente. + +[^6]: Detector de evenimente. + +[^7]: Client. + +[^8]: Semnal care confirmă o conexiune corectă cu serverul, similar cu bătăile inimii. + +[^9]: Cu funcția de eliminare AFK a lui Purpur, jucătorii care stau inactivi pot fi eliminați. + +[^10]: Sistem de scriere sincronizată a chunk-urilor, Sync Chunk Write System. + +[^11]: `ATENȚIE! Plazma poate cauza probleme neașteptate, așa că asigurați-vă că o testați în detaliu înainte de a o utiliza pe un server public.` + +[^12]: Optimizarea lumii în joc funcționează pe același principiu. + +[^13]: Administratorii de nivel 2 și peste sunt excluși. + +[^14]: Protocolul Internet, IP. diff --git a/ro/origin/plazma/administration/reference/commands.md b/ro/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..84de30a39 --- /dev/null +++ b/ro/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Aflați despre comenzile disponibile în Plazma. +--- + +# 🖥️ Comenzi diff --git a/ro/origin/plazma/administration/reference/configurations/README.md b/ro/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..143573000 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Configurarea este cea mai fundamentală metodă de personalizare a Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atribut + +> Atributul este fișierul de configurare fundamental oferit de Minecraft. Prin utilizarea atributului, puteți schimba mecanismele de bază ale jocului. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Configurație Bukkit + +> Configurația Bukkit este fișierul de configurare fundamental oferit de Plazma. Prin utilizarea configurației Bukkit, puteți schimba mecanismele de bază ale serverului Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Configurație Spigot + +> Configurația Spigot vă permite să modificați mecanismele detaliate ale jocului, prelucrarea jucătorilor, funcționarea comenzilor și mesajele. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Configurație Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Configurație Pufferfish + +> Configurația Pufferfish vă permite să modificați prelucrarea lumii și a entităților din Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Configurație Purpur + +> Atributul Purpur vă permite să modificați datele de bază generale ale jocului. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Configurație Plazma + +> Configurația Plazma vă permite să personalizați funcțiile Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/ro/origin/plazma/administration/reference/configurations/bukkit.md b/ro/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..186d62eb6 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din fișierul bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ro/origin/plazma/administration/reference/configurations/paper/README.md b/ro/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..1307bfcdb --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați scopul fiecărui fișier din dosarul config. +--- + +# 🛩️ Hârtie diff --git a/ro/origin/plazma/administration/reference/configurations/paper/global.md b/ro/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..c6cf47c9b --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ro/origin/plazma/administration/reference/configurations/paper/world.md b/ro/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..3770d2de4 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Aflați ce înseamnă fiecare nod din fișierul paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +lumea diff --git a/ro/origin/plazma/administration/reference/configurations/plazma/README.md b/ro/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..a41eba793 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați scopul fiecărui fișier din dosarul config. +--- + +# ✨ Plazma diff --git a/ro/origin/plazma/administration/reference/configurations/plazma/global.md b/ro/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..67835ee24 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ro/origin/plazma/administration/reference/configurations/plazma/world.md b/ro/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..e66d15013 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ro/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ro/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a39e9b39b --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în plazma-world.yml. +--- + +# ✨ Plazma (componența pe lume) diff --git a/ro/origin/plazma/administration/reference/configurations/property.md b/ro/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..2e9b7c254 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din server.properties. +--- + +# 🪨 Server.properties diff --git a/ro/origin/plazma/administration/reference/configurations/pufferfish.md b/ro/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7009ce42c --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/ro/origin/plazma/administration/reference/configurations/purpur/README.md b/ro/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..139057753 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în purpur.yml. +--- + +# 🦑 Purpur diff --git a/ro/origin/plazma/administration/reference/configurations/purpur/global.md b/ro/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..116981b84 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/ro/origin/plazma/administration/reference/configurations/purpur/world.md b/ro/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..c2fde2089 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ro/origin/plazma/administration/reference/configurations/spigot.md b/ro/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..82909eb25 --- /dev/null +++ b/ro/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din spigot.yml. +--- + +# 🚰 Spigot diff --git a/ro/origin/plazma/administration/reference/permissions.md b/ro/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..60b7fb3be --- /dev/null +++ b/ro/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Aflați mai multe despre permisiunile Plazma. +--- + +# 🛡️ Permisiuni + +Permisiunea este o unealtă simplă de securitate care stabilește domeniul în care jucătorii de pe server pot interacționa între ei. + +Pentru a utiliza și modifica permisiunile în mod eficient, trebuie să folosiți plugin-uri precum [LuckPerms](https://luckperms.net). + +*** + +## Înțelegerea sistemului de permisiuni de bază + +În Minecraft, sunt furnizate grupuri de permisiuni de administrare de bază. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Jucător**\ + Este grupul de permisiuni acordat de obicei tuturor jucătorilor. +2. **Mediator**\ + Poate ignora protecția de spawn. +3. **Administrator de lume**\ + Poate folosi toate comenzile și blocurile de comandă legate de administrarea lumii.\ + Este grupul de permisiuni implicit pentru datapack-uri și blocuri de comandă. +4. **Administrator**\ + Poate folosi toate comenzile legate de administrarea jucătorilor. +5. **Superadministrator**\ + Poate folosi toate comenzile, inclusiv cele de administrare a serverului.\ + Este grupul de permisiuni implicit pentru consolă și operatori. + +*** + +## Setarea permisiunilor + +*** + +## Permisiuni complete + +*** + +#### `allow.ride.(Cheia în spațiul de nume)` + +- **Implicit**: `None` + +Permite jucătorilor să se așeze și să interacționeze cu entitățile pentru a le călări. + +Când călărește o entitate, jucătorul poate controla mișcarea entității cu tastele de deplasare și poate sări sau zbura cu tasta de sărit. + +În `(Cheia în spațiul de nume)` se introduce [ID-ul în spațiul de nume](#user-content-fn-2)[^2] al entității. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Cheie spațiată)` + +- **Implicit**: `None` + +Permite jucătorului să folosească abilitățile speciale ale entității când este călare pe aceasta. + +Nu toate entitățile au abilități speciale disponibile. Consultați lista completă a abilităților speciale disponibile mai jos. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Vă rugăm să postați ideile pe [Plazma Discord](https://plazmamc.org/discord) sau [Discuțiile GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Vizualizați abilitățile speciale disponibile + +- **`crepper`**\ + Dacă apăsați tasta `săritură`, va exploda.\ + Dacă jucătorul are permisiunea `allow.powered.creeper`, poate încărca apăsând tasta `săritură`. +- **`dolphin`**\ + Dacă apăsați tasta `săritură`, va înota rapid. +- **`phantom`**\ + Dacă apăsați tasta `săritură`, va trage cu flăcări. +- **`wither`**\ + Interacționând, va trage cu capul de wither. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/credits (Jucător)`](commands.md#credits). + +Introducând `.other` după numele permisiunii, permite utilizarea pentru alți jucători. + +#### `bukkit.command.demo` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/demo (Jucător)`](commands.md#demo). + +Introducând `.other` după numele permisiunii, permite utilizarea pentru alți jucători. + +#### `bukkit.command.ping` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/ping (Jucător)`](commands.md#ping). + +Introducând `.other` după numele permisiunii, permite utilizarea pentru alți jucători. + +#### `bukkit.command.ram` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/rambar (Jucător)`](commands.md#rambar). + +Introducând `.other` după numele permisiunii, permite utilizarea pentru alți jucători. + +#### `bukkit.command.restart` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/tpsbar (Jucător)`](commands.md#tpsbar). + +Introducând `.other` după numele permisiunii, permite utilizarea pentru alți jucători. + +#### `bukkit.command.timings` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Pentru a afla despre comenzile similare, consultați [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Încorporat**: `Administrator de lume` + +Permite utilizarea comenzii `/gamemode (GameMode) (Jucător)`. + +Introducând `.other` după numele permisiunii, permite utilizarea pentru alți jucători. + +#### `paper.antixray.bypass` + +- **Implicit**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Aceasta va îmbunătăți performanța pentru ambele părți. + +> Pentru informații despre setarea X-Ray, consultați pagina de mai jos. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Implicit**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Implicit**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Implicit**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Implicit**: `None` + +Permite utilizarea tagurilor [MiniMessage](https://docs.advntr.dev/minimessage/format.html) pe nicovală. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Implicit**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Implicit**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Implicit**: `None` + +Exclude jucătorul de la a fi eliminat din cauza inactivității. + +#### `purpur.debug.f3n` + +- **Încorporat**: `Administrator de lume` + +Permite jucătorului să schimbe modul de joc folosind tasta `F3 + N`. + +Funcționează doar dacă nu are permisiunea pentru acel mod de joc. + +#### `purpur.drop.spawners` + +- **Implicit**: `None` + +Dacă săpați un bloc de generator cu un element configurat, va elibera blocul generator. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Implicit**: `None` + +Schimbă dimensiunea cufărului ender. + +În `(NumberString)` puteți introduce `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Implicit**: `None` + +Permite funcționarea totemului de nemurire chiar dacă este în inventar. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Implicit**: `None` + +Permite jucătorilor să ignore limita de conectare. + +#### `purpur.mending_shift_click` + +- **Implicit**: `None` + +Permite jucătorilor să-și repare obiectele ținând `apăsat Shift` și făcând clic. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Implicit**: `None` + +Permite jucătorilor să instaleze spawnere. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Implicit**: `None` + +Permite jucătorilor să se teleporteze instantaneu când folosesc portalul Nether. + +#### `purpur.sign.color` + +- **Implicit**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Implicit**: `None` + +Permite utilizarea codului de iluzie `(&o)` pe panouri. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Implicit**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Implicit**: `None` + +Permite jucătorilor să prevină explozia TNT-ului interacționând cu ea cu foarfeca. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Permisiuni planificate + +#### `plazma.bypass.ncr-require` + +- **Implicit**: `None` + +Permite jucătorilor să se conecteze fără a avea modul [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) instalat. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: Exemplu: `ender_dragon` diff --git a/ro/origin/plazma/adminstration/README.md b/ro/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..38210d224 --- /dev/null +++ b/ro/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Creează-ți propriul server folosind Plazma. +--- + +# ⚒️ Ghid de administrare a serverului diff --git a/ro/origin/plazma/adminstration/expert/README.md b/ro/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..a0e65dffb --- /dev/null +++ b/ro/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să lucrați profesional cu Plazma. +--- + +# 🎓 Avansat diff --git a/ro/origin/plazma/adminstration/expert/fix-exploits.md b/ro/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..5de9b71c3 --- /dev/null +++ b/ro/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Aflați despre vulnerabilitățile cunoscute și cum să le rezolvați. +--- + +# ⚠️ Vulnerabilități cunoscute și metode de rezolvare diff --git a/ro/origin/plazma/adminstration/expert/optimize.md b/ro/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..c7d54eaf7 --- /dev/null +++ b/ro/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să optimizați Plazma. +--- + +# 🧹 Optimizare diff --git a/ro/origin/plazma/adminstration/expert/vanillaize.md b/ro/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..10554b20d --- /dev/null +++ b/ro/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Aflați cum să restaurați patch-ul Paper și Vanilla. +--- + +# ↩️ Vanilizare + +{% hint style="warning" %} + +### Paper nu oferă opțiuni pentru majoritatea patch-urilor de rezolvare a erorilor din Vanilla. + +În prezent, Plazma dezvoltă o configurație pentru a dezactiva aceste soluții de rezolvare a erorilor. + +Prin urmare, acest ghid este încă în curs de elaborare și informațiile pot fi modificate în orice moment. +{% endhint %} diff --git a/ro/origin/plazma/adminstration/faq.md b/ro/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..8165f2d1f --- /dev/null +++ b/ro/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Aflați mai multe despre întrebările frecvente. +--- + +# ⁉️ Întrebări frecvente + +{% hint style="info" %} + +### Nu găsiți răspunsul dorit? + +Întrebați comunitatea prin intermediul [serverului oficial de Discord](https://discord.gg/MmfC52K8A8) sau al [problemelor de pe GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Execuția nu se realizează cu un mesaj de ieșire. + +Dacă apare în consolă `no main manifest attribute, in plazma-(version).jar`,\ +fișierul descărcat este un fișier API de dezvoltare, trebuie să descărcați **Reobf Paperweight** de pe pagina GitHub. + +Pentru mai multe informații, consultați pagina următoare. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Avertismentul apare de fiecare dată când serverul este pornit. + +Plazma conține unele patch-uri instabile și are întotdeauna posibilitatea de a funcționa necorespunzător, prin urmare afișează avertismente similare atunci când serverul este pornit. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Acest avertisment poate fi dezactivat folosind proprietatea de sistem [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Pentru mai multe informații, consultați pagina următoare. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponibil începând cu versiunea 1.20.1 diff --git a/ro/origin/plazma/adminstration/getting-started/README.md b/ro/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..667b50792 --- /dev/null +++ b/ro/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Aflați cum să creați un server cu Plazma. +--- + +# 👟 Începeți + +Pentru a utiliza Plazma în mod stabil, sistemul trebuie să îndeplinească următoarele cerințe. + +| | Minim | Recomandat | +| :---------------: | ----: | ---------: | +| Arhitectură | x64 | - | +| RAM | 8GB | 16GB | +| Spațiu de stocare | 1GB | 8GB | +| JRE | 17 | 21 | + +Pentru a modifica fișierele de configurare fără probleme, este recomandat să instalați un editor cum ar fi [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalarea JRE + +După cum sugerează numele, Minecraft: **"Java"** Edition este dezvoltat în Java și necesită JRE[^1] pentru a fi executat. + +Deoarece Plazma este bazat pe platforma oficială a serverelor Mojang Studios [^2], trebuie să instalați JRE pentru a utiliza Plazma. + +### 1.1 Verificarea existenței JRE + +Pentru a verifica dacă JRE este instalat pe sistem, introduceți [`cmd /k java --version`](#user-content-fn-4)[^4] în fereastra de comandă și executați comanda. + +Dacă obțineți un rezultat similar, treceți la [Pasul 2](setup.md#id-2). + +{% code title="Rezultat corect" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Dacă nu obțineți acest rezultat sau obțineți unul similar cu cel de mai jos, înseamnă că JRE lipsește sau este prea vechi și trebuie să urmați [Pasul 1.2](setup.md#id-1.2). + +{% code title="JRE lipsă" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE prea vechi" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Instalarea JRE + +În acest ghid, vom utiliza Azul Zulu ca una dintre [variantele](#user-content-fn-5)[^5] de JRE. + +După instalare, verificați din nou [Pasul 1.1](setup.md#id-1.1) pentru a confirma instalarea corectă. + +{% tabs %} +{% tab title="Windows" %} + +1. Descărcați JDK 21 de la [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) în format `.msi`. +2. Executați asistentul de instalare descărcat și faceți clic pe `Next`. +3. După ce activați `Set JAVA_HOME variable` din meniul afișat în mijlocul stânga al ferestrei, faceți clic pe `Next`. +4. Finalizați instalarea JRE făcând clic pe `Install`. + {% endtab %} + +{% tab title="macOS" %} +Descărcați JDK 21 de la [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) sub formă de fișier `.dmg` și instalați JRE-ul executând asistentul de instalare descărcat. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Adăugați depozitul Azul Zulu la APT executând următoarea comandă în terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Apoi, instalați JRE-ul executând următoarea comandă în terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Puteți instala JRE-ul executând următoarea comandă. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Descărcarea Plazma + +Plazma oferă diverse fișiere de executare. + +{% hint style="warning" %} + +### În majoritatea cazurilor, se recomandă utilizarea `Reobf Paperclip`. + +Informațiile de mai jos sunt pentru dezvoltatori sau cei interesați de caracteristicile fiecărei forme.\ +Pentru utilizatorii obișnuiți, nu este o problemă să săriți la [Pasul 3](setup.md#id-3). +{% endhint %} + +
+ +Află mai multe + +Numele fișierului de executare este `plazma-(managerul versiunii)-1.20.4-R0.1-SNAPSHOT-(formă de mapare).jar`. + +- **Forma de mapare**\ + Maparea este o hartă care leagă codul real al Minecraft-ului de codul obfuscat. + - **Reobf**\ + Reobfuscarea, cunoscută și sub numele de mapare Spigot, este folosită în mare parte în pluginurile NMS.\ + Va fi eliminată începând cu versiunea 1.20.5. + - **Mojmap**\ + Maparea Mojang, este maparea Vanilla Minecraft-ului. +- **Managerul versiunii**\ + Managerul versiunii este un launcher al serverului care furnizează bibliotecile necesare pentru rularea serverului și aplică patch-uri pe fișierele serverului. + - **Paperclip**\ + Dezvoltat de echipa PaperMC pentru Paper și alte platforme derivate, acesta descarcă bibliotecile și aplică patch-uri pe server. + - **Bundler**\ + Managerul versiunii Vanilla Minecraft. + +
+ +*** + +## 3. Crearea scriptului de pornire + +Pentru a porni Plazma simplu și pentru a reporni automat serverul, trebuie să creați un [script de pornire](#user-content-fn-6)[^6]. + +Puteți genera scriptul de pornire folosind [Flags.sh](https://flags.sh).\ +Introduceți doar memoria pe care doriți să o alocați pentru Plazma și comanda va fi optimizată automat. + +Puteți descărca scriptul de pornire făcând clic pe butonul de descărcare din partea de jos stânga.\ +**Asigurați-vă că scriptul de pornire descărcat este compatibil cu sistemul de operare al dvs.** + +*** + +## 4. Curățarea fișierelor + +Mută scriptul de pornire descărcat și Plazma într-un folder nou. + +{% hint style="warning" %} + +### Numele folderului trebuie să nu conțină spații și să fie în limba engleză. + +Altfel, Plazma sau JRE ar putea să nu funcționeze corect. +{% endhint %} + +Executați scriptul de pornire. În cazul sistemului Windows, trebuie să selectați **Allow** în fereastra de selecție a permisiunilor firewall-ului. + +*** + +## 5. Acordarea EULA + +După ce rulați scriptul de pornire o dată, un fișier `eula.txt` va fi creat în folder. + +EULA[^9] este un acord de licență pe care trebuie să-l acceptați pentru a utiliza serviciile [Mojang Studios](#user-content-fn-10)[^10]. + +Dacă nu acceptați EULA, nu veți putea porni serverul și veți fi supus sancțiunilor, cum ar fi suspendarea contului, dacă încălcați EULA. + +Pentru a accepta EULA, modificați `eula=false` în fișierul `eula.txt` în `eula=true` și salvați modificările. + +*** + +## 6. Permiterea accesului extern (Windows) + +Sistemele de operare moderne blochează accesul extern pentru a preveni accesul neautorizat prin intermediul **firewall-ului** și **router-ului**. + +În cazul Windows-ului, deoarece ați permis deja în [Pasul 3](setup.md#id-3), trebuie doar să faceți port forwarding. + +{% hint style="info" %} + +### Acest ghid presupune că utilizați un sistem de operare Windows și un router care suportă [**UPnP**](#user-content-fn-12)[^12]. + +Dacă routerul dvs. nu suportă UPnP, va trebui să căutați informații specifice pentru fiecare router în parte. + +De asemenea, puteți utiliza [Ngrok](https://ngrok.com/) pentru a genera o adresă temporară. +{% endhint %} + +{% hint style="warning" %} + +### Pentru sistemele de operare bazate pe UNIX, cum ar fi Linux sau macOS, procedura de configurare a serviciilor firewall-ului este diferită pentru fiecare serviciu și va trebui să căutați informații specifice. + +{% endhint %} + +### 6.1 Verificarea necesității de port forwarding + +Introduceți comanda următoare în fereastra de comandă și executați-o. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Dacă obțineți `True`, nu mai este necesar să faceți nimic, dar dacă obțineți `False`, va trebui să setați port forwarding-ul. + +### 6.2 Conectarea la server + +{% tabs %} +{% tab title="Acces extern" %} +Dacă nu este necesară redirecționarea porturilor sau aceasta a fost deja realizată cu succes, acum puteți accesa serverul. + +Puteți găsi adresa folosită pentru a accesa serverul [aici](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Încercare de redirecționare a porturilor prin UPnP" %} +În fișierul `purpur.yml` din dosarul serverului, activați `network.upnp-port-forwarding` la `true`. + +Apoi, dacă reporniți serverul, Plazma va încerca automat să redirecționeze porturile. + +Mai jos este un mesaj de succes sau eșec UPnP afișat în consolă, care va fi afișat ca `[UPnP] (mesaj)`. + +| Mesaj | Semnificație | +| ------------------------------------------- | --------------------------------------- | +| `Portul (port)` a fost deschis cu succes | Redirecționare porturi reușită. | +| `Portul (port) este deja deschis` | Alt serviciu folosește deja acest port. | +| `Nu s-a reușit deschiderea portului (port)` | Redirecționarea porturilor a eșuat. | +| `Serviciul nu este disponibil` | Routerul nu suportă UPnP. | + +Când serverul este oprit, Plazma va închide automat portul. +{% endtab %} + +{% tab title="Generare adresă temporară folosind Ngrok" %} +Pentru teste pe termen scurt, jocuri multiplayer sau petreceri cu prietenii, utilizarea Ngrok este utilă. + +1. Descărcați fișierul ZIP `Windows (64-bit)` de pe [site-ul Ngrok](https://ngrok.com/download). +2. Puneți fișierul Ngrok descărcat în dosarul serverului. +3. Generați un token de autentificare pe [Tabloul de bord Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Executați comanda afișată în linia de comandă din dosarul serverului. +5. Adăugați `start /b ngrok tcp --region jp 25565` în partea de sus a scriptului de pornire și `taskkill /f /t /im ngrok.exe` în partea de jos. +6. Adresa serverului va fi `0.tcp.jp.ngrok.io:12345` conform afișării de sus `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`. +7. Acum puteți accesa serverul de la distanță folosind această adresă. + {% endtab %} + +{% tab title="Acces local" %} +Dacă doriți să accesați serverul de pe calculatorul local, puteți utiliza `cmd /k ipconfig` în fereastra de comandă pentru a găsi `Adresa IPv4` afișată. + +De exemplu, atunci când rulați comanda și obțineți următorul rezultat, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Puteți accesa serverul local folosind adresa IPv4 `192.168.3.7` afișată aici. + +Dacă serverul și jocul rulează pe același PC, puteți accesa folosind `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Faza de dezvoltare + +Dacă serverul a fost inițiat cu succes și funcționează corect, acum este momentul să îl personalizați. + +Consultați ghidul pentru personalizarea serverului. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Mediu de executare Java, Java Runtime Environment. + +[^2]: Paper, pe care se bazează Plazma, este bazat pe Spigot și Spigot se bazează pe platforma oficială a serverului. + +[^3]: Tastele Windows + R + +[^4]: Pentru Linux, rulați `java --version` în terminal + +[^5]: JRE este un proiect open source și există diverse versiuni, asemănătoare cu platforma serverului Minecraft. + +[^6]: Este cunoscut în mod obișnuit ca **launcher**. + +[^7]: Activarea opțiunii "Repornire automată" va duce la repornirea automată a serverului. Puteți opri serverul tastând `Control + C`. + +[^8]: Nu se recomandă alocarea a mai mult de jumătate din resursele sistemului. + + De exemplu, pentru un total de 8GB memorie RAM, nu este recomandat să alocați mai mult de 4GB. + +[^9]: Acordul de licență pentru utilizatorul final, End-User License Agreement. Pentru detalii, consultați [site-ul Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Corporația Microsoft. + +[^11]: În conformitate cu articolul 32 alineatul (1) punctul 9 din Legea privind promovarea industriei de jocuri video din Coreea, puteți acționa în justiție **Korea Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpurul inclus în Plazma utilizează această tehnologie pentru a comunica automat cu routerul și a deschide porturile doar atunci când serverul rulează, eliminând necesitatea redirecționării manuale a porturilor. + +[^13]: Dacă nu aveți un cont, vă puteți înregistra pe Ngrok folosind un cont Google sau GitHub. diff --git a/ro/origin/plazma/adminstration/getting-started/customization.md b/ro/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..b036e0e29 --- /dev/null +++ b/ro/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Aflați cum să personalizați serverul. +--- + +# 🎨 Personalizare utilizator diff --git a/ro/origin/plazma/adminstration/reference/arguments.md b/ro/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..fa1f5daff --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,523 @@ +--- +description: Înțelegeți argumentele de pornire și proprietățile sistemului. +--- + +# 🎛️ Argumente și proprietăți + +Argumentele de pornire și proprietățile sistemului sunt valori adăugate la [comenzile utilizate](#user-content-fn-1)[^1] pentru execuția Plazma, permițând modificarea unei valori care nu poate fi schimbată după ce Plazma a fost inițializat. + +În funcție de [locul unde sunt adăugate la comandă](#user-content-fn-2)[^2], acestea sunt împărțite în **argumente de pornire** și **proprietăți de sistem**. + +*** + +## Proprietățile sistemului + +Proprietățile sistemului sunt valorile procesate de JVM înainte de inițializarea Plazma, fiind introduse înainte de `-jar`. + +{% hint style="warning" %} + +### Modificarea proprietăților sistemului poate schimba modul de funcționare al Plazma și al JVM și poate avea un impact semnificativ asupra jocului! + +Dacă nu înțelegeți exact rolul fiecărei proprietăți de sistem, **nu le folosiți niciodată!** +{% endhint %} + +### Mod de utilizare + +Proprietățile sistemului sunt introduse ca argumente Java între `java` și `-jar`. + +De exemplu, pentru a aplica proprietatea de sistem `Plazma.dummyProperty`, introducând `37` ca valoare, Plazma se va inițializa cu această proprietate. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indică faptul că argumentul respectiv nu este încorporat în JVM, ci este un argument dedicat adăugat la Plazma, + +dacă nu se introduce nicio valoare, aceasta va fi fixată ca [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platformele server din seria Paperweight includ un punct `.` în numele proprietății pentru a distinge proprietățile sistemului între platforme. + +În unele terminale precum Windows Powershell, aceste argumente ar putea să nu fie acceptate, așa că trebuie să adăugați `"` la fiecare capăt al argumentului. [Trebuie să faceți acest lucru.](#user-content-fn-4)[^4] +{% endhint %} + +### Toate proprietățile sistemului + +#### `convertLegacySigns` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Actualizează formatul panourilor de semnalizare dezactivate. + +#### `debug.entities` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare legate de informațiile entității. + +#### `debug.rewriteForIDE` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează revizia NMS pentru a permite IDE-ului să citească corect informațiile de depanare și remapează automat informațiile de versiune interne. + +#### `disable.watchdog` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează sistemul de avertizare Watchdog al Spigot. + +#### `letMeReload` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează mesajul de confirmare al comenzii `/reload`. + +{% hint style="danger" %} + +### Deoarece comanda `/reload` este foarte instabilă, toate problemele apărute după folosirea acestei comenzi sunt responsabilitatea utilizatorului. + +Dacă sunteți dezvoltator de plugin-uri și trebuie să faceți actualizări, folosiți hotswap în loc de comanda `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează pluginurile care folosesc sistemul standard de intrare/ieșire. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Avertizează când se detectează un format vechi în componentele de chat. + +#### `Paper.bypassHostCheck` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează verificarea potrivirii modelului serverului atunci când un jucător se conectează la server. + +#### `Paper.debugDynamicMissingKeys` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare pentru cheile lipsă din obiectele NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare pentru profilurile incorecte ale capului. + +Aceasta va înregistra toate blocurile de cap incorecte din lume, împreună cu locațiile acestora. + +#### `Paper.disableChannelLimit` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează limita de 128 de canale de pluginuri pe jucător[^5]. + +#### `Paper.disableClassPrioritization` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează sistemul de prioritizare a claselor de pluginuri. + +Util în cazul în care apar probleme în umbrirea pluginurilor. + +#### `Paper.disableFlushConsolidate` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează consolidarea de flux Netty. + +#### `Paper.excessiveTELimit` + +- **Tip**: `Integer` +- **Valoare implicită**: `750` + +Dacă entitățile depășesc valoarea setată, sunt trimise în pachete multiple. + +#### `Paper.filterThreshold` + +- **Tip**: `Integer` +- **Valoare implicită**: `8192` + +Setează dimensiunea maximă a pachetului pe care serverul îl poate primi odată. + +#### `Paper.ignoreJavaVersion` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dezactivează verificarea versiunii Java. + +{% hint style="danger" %} + +### Aceasta permite JVM-ului să încerce să acceseze cod inexistent! + +Acest lucru poate duce la deteriorarea permanentă a fișierelor precum lumea și la defectarea mecanismului de joc. + +Orice problemă cauzată de acest lucru este responsabilitatea dumneavoastră, Plazma nu oferă nicio asistență în acest sens. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Tip**: `Integer` +- **Valoare implicită**: `64` + +Setează limita numelui canalului de pluginuri[^6]. + +#### `Paper.maxSignLength` + +- **Tip**: `Integer` +- **Valoare implicită**: `80` + +Setează lungimea maximă a textului pe o linie a unui panou de semnalizare. + +#### `Paper.minPrecachedDatafixVersion` + +- **Tip**: `Integer` +- **Valoare implicită**: `(versiunea lumii) + 1` + +Setează versiunea inițială a informațiilor de actualizare a lumii care trebuie inițializate. + +Util în cazul în care este necesară actualizarea în masă a chunk-urilor, dar în celelalte situații nu este folosit. + +#### `Paper.parseYamlCommentsByDefault` + +- **Tip**: `Boolean` +- **Valoare implicită**: `True` + +Activează procesarea comentariilor YAML din fișiere. + +#### `Paper.playerConnection.keepAlive` + +- **Tip**: `Integer` +- **Valoare implicită**: `30` + +Dacă un jucător nu trimite nicio dată pentru o perioadă specificată (în secunde), este deconectat. + +De obicei, jocul[^7] trimite în mod regulat semnale de [heartbeat](#user-content-fn-8)[^8] către server, astfel că nu este deconectat, + +#### `Paper.skipServerPropertiesComments` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Ignoră comentariile din proprietățile serverului. + +#### `Paper.debug-sync-loads` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează jurnalele de depanare pentru încărcările sincronizate de chunk-uri. + +#### `Paper.enable-sync-chunk-writes` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează sistemul de scriere a chunk-urilor sincronizat implicit din Minecraft. + +Acest lucru duce la o performanță foarte scăzută deoarece fiecare chunk este salvat în ordine. + +#### `Paper.explicit-flush` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Activează descărcarea explicită a canalului de rețea. + +#### `Paper.strict-thread-checks` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Înregistrează întotdeauna erorile care nu apar pe thread-ul principal. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Afișează avertismente când o sarcină programată are o întârziere excesivă. + +#### `Paperclip.patchOnly` + +- **Tip**: `Boolean` +- **Valoare implicită**: `False` + +Dacă se folosește fișierul de executare implicit, aplică doar patch-ul fără a porni serverul. + +#### `Plazma.aggressiveOptimize` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` + +{% hint style="warning" %} + +### Această proprietate va fi mutată ca argument de pornire după versiunea 1.20.5. + +{% endhint %} + +Aplică optimizări mai stricte la configurarea inițială la prima pornire. + +Activarea va face serverul să funcționeze mai rapid și mai sigur, dar poate bloca unele mecanisme sau putea afecta în mod semnificativ jocul. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` + +Suprimă avertismentul care apare la inițializarea Plazmei. + +### Proprietatea întreruptă + +Următoarele proprietăți de sistem sunt proprietăți întrerupte. + +#### `timings.bypassMax` + +- **Tip**: `Boolean` +- **Valoare implicită**: `false` +- **Întrerupt**: Timings a fost eliminat din Plazma + +Hotărăște dacă valoarea trimisă către API-ul Timings al lui Aikar poate depăși maximul permis. + +Chiar și atunci când se face acest lucru, limita de rată se aplică dacă nu este gestionată excepțional de API. + +*** + +## Argumentul de pornire + +Argumentul de pornire este introdus după `-jar *.jar` pentru a inițializa Plazma și este tratat împreună cu acesta. + +### Mod de utilizare + +Proprietățile de sistem sunt introduse ca argumente de comandă după `-jar *.jar`. + +De exemplu, dacă doriți să aplicați argumentul de pornire `nogui`,\ +introduceți astfel pentru ca Plazma să-l proceseze în timpul inițializării. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumentul de pornire complet + +#### `bukkit-settings` + +- **Poreclă**: `b` +- **Valoare implicită**: `bukkit.yml` + +Stabilește numele și locația [fișierului de configurare Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Poreclă**: `c` +- **Valoare implicită**: `commands.yml` + +Stabilește numele și locația [fișierului de configurare a comenzilor Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Poreclă**: `c` +- **Valoare implicită**: `server.properties` + +Stabilește numele și locația [fișierului de proprietăți al serverului](../reference/configurations/property.md). + +#### `demo` + +Pornește serverul în lumea demonstrativă. + +#### `eraseCache` + +Șterge fișierele de cache rămase după actualizarea lumii. + +#### `forceUpgrade` + +Actualizează lumea forțat, ignorând versiunea [de actualizare](#user-content-fn-12)[^12]. + +#### `help` + +- **Poreclă**: `?` + +Afișează toate argumentele și descrierile de pornire ale Plazma. + +#### `initSettings` + +Generează doar fișierele de configurare și închide serverul. + +#### `jfrProfile` + +Activează profilarea JFR. + +#### `max-players` + +- **Poreclă**: `s`, `size` +- **Valoare implicită**: `(proprietatea serverului)` + +Stabilește numărul maxim de [jucători](#user-content-fn-14)[^14] permis. + +#### `nogui` + +Dezactivează panoul interfeței grafice. + +#### `nojline` + +Dezactivează JLine și folosește consola vanilla. + +#### `mod-online` + +- **Poreclă**: `o` +- **Valoare implicită**: `(proprietatea serverului)` + +Selectează dacă să verifice jucătorii prin serverul de autentificare Mojang. + +**În cazul în care nu se utilizează Velocity sau alte proxy-uri, se poate fi sancționat pentru încălcarea [EULA](../getting-started/README.md#id-5).** + +#### `setări-hârtie` + +- **Poreclă**: `hârtie` +- **Valoare implicită**: `paper.yml` + +{% hint style="warning" %} + +### Acest argument a fost întrerupt după versiunea 1.19.4 + +{% endhint %} + +Stabilește locația fișierului de configurare PaperSpigot dezactivat. + +Acesta este utilizat pentru a muta configurația existentă într-un nou fișier de configurare și nu va fi utilizat ulterior. + +#### `director-setări-hârtie` + +- **Poreclă**: `dir-hârtie` +- **Valoare implicită**: `config` + +Stabilește numele și locația folderului în care se află [fișierele de configurare Paper](../reference/configurations/paper/README.md). + +#### `director-setări-plazma` + +- **Poreclă**: `dir-plazma` + +Stabilește numele și locația folderului în care se află [fișierele de configurare Plazma](../reference/configurations/plazma/README.md). + +#### `module` + +- **Poreclă**: `m` +- **Valoare implicită**: `module` + +Stabilește locația folderului pentru module. + +#### `setări-pufferfish` + +- **Poreclă**: `pufferfish` +- **Valoare implicită**: `pufferfish.yml` + +Stabilește numele și locația [fișierului de configurare Pufferfish](../reference/configurations/pufferfish.md). + +#### `setări-purpur` + +- **Poreclă**: `purpur` +- **Valoare implicită**: `purpur.yml` + +Stabilește numele și locația [fișierului de configurare Purpur](../reference/configurations/purpur/README.md). + +#### `mod-sigur` + +(Mod sigur) Pornește serverul într-o stare complet vanilată. + +#### `ip-server` + +- **Poreclă**: `h`, `gazdă` +- **Valoare implicită**: `(proprietatea serverului)` + +Stabilește numele gazdei sau adresa [Protocolului Internet](#user-content-fn-13)[^13] a serverului. + +#### `port-server` + +- **Poreclă**: `p`, `port` +- **Valoare implicită**: `(proprietatea serverului)` + +Stabilește portul serverului. + +#### `nume-server` + +- **Valoare implicită**: `Un server Plazma` + +Stabilește numele serverului. + +#### `setări-spigot` + +- **Poreclă**: `S` +- **Valoare implicită**: `spigot.yml` + +Stabilește numele și locația [fișierului de configurare Spigot](../reference/configurations/spigot.md). + +#### `versiune` + +- **Poreclă**: `v` + +Afișează versiunea Plazma. + +#### `director-lume` + +- **Poreclă**: `W`, `univers`, `container-lume` +- **Valoare implicită**: `(folder-ul serverului)` + +Stabilește locația în care sunt salvate fișierele lumii. + +#### `nume-lume` + +- **Poreclă**: `w`, `lume` +- **Valoare implicită**: `(proprietatea serverului)` + +Stabilește numele fișierului lumii. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Poziția de procesare a argumentelor se schimbă în funcție de locația adăugată. + +[^3]: De exemplu, dacă doriți să setați (activați) `Plazma.iKnowWhatIAmDoing` la `true`, în loc să introduceți `-DPlazma.iKnowWhatIAmDoing=true`, puteți introduce doar `-DPlazma.iKnowWhatIAmDoing` și va funcționa la fel de bine. + +[^4]: De exemplu, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detector de evenimente. + +[^6]: Detector de evenimente. + +[^7]: Client. + +[^8]: Semnal care confirmă o conexiune corectă cu serverul, similar cu bătăile inimii. + +[^9]: Cu funcția de eliminare AFK a lui Purpur, jucătorii care stau inactivi pot fi eliminați. + +[^10]: Sistem de scriere sincronizată a chunk-urilor, Sync Chunk Write System. + +[^11]: `ATENȚIE! Plazma poate cauza probleme neașteptate, așa că asigurați-vă că o testați în detaliu înainte de a o utiliza pe un server public.` + +[^12]: Optimizarea lumii în joc funcționează pe același principiu. + +[^13]: Protocolul Internet, IP. + +[^14]: Administratorii de nivel 2 și peste sunt excluși. diff --git a/ro/origin/plazma/adminstration/reference/commands.md b/ro/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..84de30a39 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Aflați despre comenzile disponibile în Plazma. +--- + +# 🖥️ Comenzi diff --git a/ro/origin/plazma/adminstration/reference/configurations/bukkit.md b/ro/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..186d62eb6 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din fișierul bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ro/origin/plazma/adminstration/reference/configurations/paper/README.md b/ro/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..1307bfcdb --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați scopul fiecărui fișier din dosarul config. +--- + +# 🛩️ Hârtie diff --git a/ro/origin/plazma/adminstration/reference/configurations/paper/global.md b/ro/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..3fb6d8dd8 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din paper-global.yml. +--- + +# 🛩️ Hârtie (Configurație globală) diff --git a/ro/origin/plazma/adminstration/reference/configurations/paper/world.md b/ro/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..d1078a466 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din fișierul paper-world.yml. +--- + +# 🛩️ Hârtie (componența lumii) diff --git a/ro/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ro/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..a41eba793 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați scopul fiecărui fișier din dosarul config. +--- + +# ✨ Plazma diff --git a/ro/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ro/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..2668b0d34 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din plazma-global.yml. +--- + +# ✨ Plazma (Configurație globală) diff --git a/ro/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ro/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..a7645360e --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Componența pe regiuni a lumii diff --git a/ro/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ro/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a39e9b39b --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în plazma-world.yml. +--- + +# ✨ Plazma (componența pe lume) diff --git a/ro/origin/plazma/adminstration/reference/configurations/property.md b/ro/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..2e9b7c254 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din server.properties. +--- + +# 🪨 Server.properties diff --git a/ro/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ro/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7009ce42c --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/ro/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ro/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..139057753 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în purpur.yml. +--- + +# 🦑 Purpur diff --git a/ro/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ro/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..8e5425a3f --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în purpur.yml. +--- + +# 🦑 Purpuriu (compoziție globală) diff --git a/ro/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ro/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..679751315 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod în purpur.yml. +--- + +# 🦑 Purpuriu (compoziția lumii) diff --git a/ro/origin/plazma/adminstration/reference/configurations/spigot.md b/ro/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..82909eb25 --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Aflați ce înseamnă fiecare nod din spigot.yml. +--- + +# 🚰 Spigot diff --git a/ro/origin/plazma/adminstration/reference/permissions.md b/ro/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..8fec5baaf --- /dev/null +++ b/ro/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Aflați mai multe despre permisiunile Plazma. +--- + +# 🛡️ Permisiuni diff --git a/ro/origin/plazma/adminstration/referinta/README.md b/ro/origin/plazma/adminstration/referinta/README.md new file mode 100644 index 000000000..d817bc909 --- /dev/null +++ b/ro/origin/plazma/adminstration/referinta/README.md @@ -0,0 +1,2 @@ +# 📜 Referință + diff --git a/ro/origin/plazma/adminstration/referinta/fisiere-de-configurare/README.md b/ro/origin/plazma/adminstration/referinta/fisiere-de-configurare/README.md new file mode 100644 index 000000000..ef4a0c3a8 --- /dev/null +++ b/ro/origin/plazma/adminstration/referinta/fisiere-de-configurare/README.md @@ -0,0 +1,2 @@ +# 🎨 Fișiere de Configurare + diff --git a/ro/origin/plazma/developers.md b/ro/origin/plazma/developers.md new file mode 100644 index 000000000..726246543 --- /dev/null +++ b/ro/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Dezvoltă proiecte terțe folosind Plazma. +--- + +# ⚙️ Ghidul dezvoltatorului diff --git a/ro/origin/thunderbolt/README.md b/ro/origin/thunderbolt/README.md new file mode 100644 index 000000000..e59e71dea --- /dev/null +++ b/ro/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt este o platformă de servere bazată pe Plazma care permite utilizatorilor să utilizeze experimental patch-urile ca un Flavor separat. +--- + +# 🌩️ Ghid de Utilizare Thunderbolt diff --git a/ro/origin/volt/README.md b/ro/origin/volt/README.md new file mode 100644 index 000000000..33607f948 --- /dev/null +++ b/ro/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt este un șablon open source care vă permite să dezvoltați propria platformă de server Paperweight bazată pe Plazma. +--- + +# ⚡ Ghid de Dezvoltare Volt diff --git a/ru/origin/README.md b/ru/origin/README.md new file mode 100644 index 000000000..3c34a51c0 --- /dev/null +++ b/ru/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Если у вас есть вопросы, пожалуйста, задавайте их через Discord или GitHub Discussions. +--- + +# 🏠 Добро пожаловать в портал документации + +{% hint style="info" %} + +**Документы Plazma в настоящее время находятся в состоянии машинного перевода.** + +[![Статус перевода](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Принимайте участие в переводе документации на [https://translate.plazmamc.org/](https://translate.plazmamc.org/), чтобы улучшить документацию. + +{% endhint %} + +### Если у вас возникли проблемы при использовании Plazma, что делать? + +{% content-ref url="plazma/" %} +[плазма](plazma/) +{% endcontent-ref %} + +### Если вас интересует Thunderbolt, + +{% content-ref url="thunderbolt/" %} +[гром](thunderbolt/) +{% endcontent-ref %} + +### Volt - хотите создать свою собственную серверную платформу с помощью Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `СПОНСОР` Нужна больше информации о Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/ru/origin/SUMMARY.md b/ru/origin/SUMMARY.md new file mode 100644 index 000000000..6e49e236d --- /dev/null +++ b/ru/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Содержание + +- [🏠 Добро пожаловать в портал документации](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Плазма + +- [✨ Документация по использованию Плазмы](plazma/README.md) +- [❓ Что такое Plazma?](plazma/about/README.md) + - [⬇️ Скачать](plazma/about/downloads.md) + - [✅ Статус поддерживаемых версий](plazma/about/supported-versions.md) +- [⚒️ Руководство по управлению сервером](plazma/administration/README.md) + - [👟 Начало работы](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Справочник](plazma/administration/reference/README.md) + - [🖥️ Команды](plazma/administration/reference/commands.md) + - [🛡️ Права доступа](plazma/administration/reference/permissions.md) + - [🎛️ Аргументы и свойства](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Свойство](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Глобальные настройки](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Конфигурации по мирам](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Глобальные настройки](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Конфигурации по мирам](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Глобальные настройки](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Конфигурации по мирам](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Углубленное изучение](plazma/administration/expert/README.md) + - [🧹 Оптимизация](plazma/administration/expert/optimize.md) + - [🔀 Прокси](plazma/administration/expert/proxy.md) + - [↩️ Приведение к стандарту Vanilla](plazma/administration/expert/vanillaize.md) + - [🩻 Блокировка X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Уязвимости и их устранение](plazma/administration/expert/fix-exploits.md) + - [⁉️ Часто задаваемые вопросы](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Руководство разработчика](plazma/developers.md) + - [✏️ Внести вклад](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Руководство по использованию Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Руководство по разработке Volt](volt/README.md) + +## Разное + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Просмотреть все загрузки](plazma/about/downloads-all.md) diff --git a/ru/origin/miscellaneous/README.md b/ru/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/ru/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/ru/origin/plazma/README.md b/ru/origin/plazma/README.md new file mode 100644 index 000000000..a50c17e43 --- /dev/null +++ b/ru/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma - это открытая серверная платформа для Minecraft: Java Edition, добавляющая оптимизацию на основе бумаги и возможность настройки механик игры." +--- + +# ✨ Документация по использованию Plazma + +## 👋 Добро пожаловать в документацию по Plazma + +Добро пожаловать в документацию по использованию Plazma! + +{% hint style="info" %} + +**Не удается решить проблему через руководство?** + +[Официальный сервер Discord](https://discord.gg/MmfC52K8A8) или [Обсуждения на GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - задайте вопросы сообществу! + +{% endhint %} + +### О Plazma + +> Узнайте больше о платформе Plazma. + +{% content-ref url="about/" %} +[о нас](about/) +{% endcontent-ref %} + +### Для администраторов + +> Создайте свой собственный сервер с помощью Plazma. + +{% content-ref url="administration/" %} +[администрирование](administration/) +{% endcontent-ref %} + +### Для разработчиков + +> Разработайте сторонний проект с использованием Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/ru/origin/plazma/about/README.md b/ru/origin/plazma/about/README.md new file mode 100644 index 000000000..1af25b6ad --- /dev/null +++ b/ru/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Узнайте больше о платформе Plazma. +--- + +# ❓ Что такое Plazma? + +- **Plazma** - это серверная платформа на основе [Paper](https://github.com/PaperMC/Paper), которая берет лучшее из [Andromeda](https://github.com/EarendelArchived/Andromeda) и [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Мы постоянно работаем над обеспечением высокой стабильности, мощной производительности, быстрым обновлением и обширным функционалом. + +## 📋 Цели Plazma + +- Мы стремимся создать серверную платформу с быстрым обновлением и высокой стабильностью. +- Мы также работаем над обширным функционалом и мощной производительностью, сопоставимыми с платформами для модов. +- Мы стремимся создать свободную платформу, которая позволяет настраивать даже патчи ваниллы. + +## ⚙️ Основные характеристики + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Самые быстрые обновления**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) обеспечивает, чтобы патчи в Plazma всегда были актуальными, предоставляя самые быстрые обновления среди серверных платформ на основе Paper. +6. **Оптимизированные конфигурационные файлы по умолчанию**\ + Конфигурационные файлы по умолчанию оптимизированы, поэтому вам не нужно самостоятельно их настраивать. +7. **Систематический многопоточный режим работы**\ + Асинхронизация системных механизмов, не связанных с механикой игры, снижает задержки и оптимизирует сервер. +8. **Блокировка избыточного использования памяти**\ + Объединение данных с похожими значениями позволяет сократить объем используемой памяти. + +## ✨ Примеры использования + +- **Платформа, обрабатывающая даже сложные плагины правильно**\ + Plazma используется на сервере разработчика [IPECTER](https://github.com/IPECTER).\ + Собственные плагины, работающие с NMS и рефлексией, обширные и сложные пакеты данных успешно применены,\ + принимая более 100 игроков без снижения производительности. +- **Платформа, обеспечивающая быструю производительность на RPG серверах**\ + Стабильно поддерживает 100 игроков на одном кластере без снижения TPS и комфортно позволяет 250 игрокам играть на 4 кластерах. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Платформа, выбранная многими стримерами**\ + Используется как ведро для участия зрителей многими стримерами. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Скачать + +Вы можете скачать Plazma на следующей странице. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Хотите узнать подробнее о поддерживаемых версиях? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Плагины Bukkit, CraftBukkit, Spigot и Paper, Pufferfish, Purpur. + +[^2]: Принадлежит Microsoft Corporation. + +[^3]: При отключении системы отчетов о чате чат обрабатывается только на сервере, что позволяет избежать отслеживания чата Mojang. + +[^4]: Время, в течение которого игра приостанавливается, чтобы системный механизм мог функционировать. diff --git a/ru/origin/plazma/about/downloads-all.md b/ru/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..13c7eb3ed --- /dev/null +++ b/ru/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Полный просмотр загрузки файла Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Версия | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/ru/origin/plazma/about/downloads.md b/ru/origin/plazma/about/downloads.md new file mode 100644 index 000000000..44f60c696 --- /dev/null +++ b/ru/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Прямо сейчас загрузите Plazma и попробуйте его самостоятельно. +--- + +# ⬇️ Скачать + +#### Хотите узнать подробнее о поддерживаемых версиях? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Ниже приведен исполняемый файл для обычных пользователей.** + +Если вы разработчик и вам нужен другой тип файла, пожалуйста, обратитесь к следующей странице. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВерсияСкачать
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + скачать +
1.20.1 + 다운로드 +
1.19.4 + 다운로드 +
+ +*** diff --git a/ru/origin/plazma/about/patches-list.md b/ru/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..5f28f98bd --- /dev/null +++ b/ru/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о всех функциях, добавленных в Plazma. +--- + +# 📑 Включенные патчи diff --git a/ru/origin/plazma/about/supported-versions.md b/ru/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..265bd56c0 --- /dev/null +++ b/ru/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Узнайте, какие версии Minecraft: Java Edition поддерживает Plazma." +--- + +# ✅ Статус поддержки версии + +{% hint style="info" %} + +**Plazma был разработан с версии 1.19.4 и выше, версии ниже 1.19.4 не разрабатываются.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Ожидание%20релиза +[idv]: https://badge.plazmamc.org/1/в_разработке +[atv]: https://badge.plazmamc.org/2/поддерживается +[fse]: https://badge.plazmamc.org/6/поддержка_функции_прекращена +[eol]: https://badge.plazmamc.org/4/поддержка_завершена +[ukn]: https://badge.plazmamc.org/0/Информации%20нет +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/обычный +[100]: https://badge.plazmamc.org/percent/100 + +![Ожидание релиза][wtr] ![В разработке][idv] ![Поддерживается][atv] ![Поддержка функции прекращена][fse] ![Поддержка завершена][eol] + +| Версия | Стабильность и поддержка функций | Статус сборки | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Статус сборки](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Состояние сборки](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Состояние сборки](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/ru/origin/plazma/administration/README.md b/ru/origin/plazma/administration/README.md new file mode 100644 index 000000000..7369a9262 --- /dev/null +++ b/ru/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Создайте свой собственный сервер с помощью Plazma. +--- + +# ⚒️ Руководство по управлению сервером diff --git a/ru/origin/plazma/administration/diagnosis/README.md b/ru/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..87ad220a3 --- /dev/null +++ b/ru/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, как реагировать в случае возникновения проблем. +--- + +# 🧾 진단 diff --git a/ru/origin/plazma/administration/diagnosis/plugins.md b/ru/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..6e8d1b17a --- /dev/null +++ b/ru/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, как исправить неполадки с работой плагина. +--- + +# 📜 플러그인 diff --git a/ru/origin/plazma/administration/expert/README.md b/ru/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..794b7ccc5 --- /dev/null +++ b/ru/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о профессиональном подходе к работе с Plazma. +--- + +# 🎓 Глубокое изучение diff --git a/ru/origin/plazma/administration/expert/fix-exploits.md b/ru/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..ae4c86b36 --- /dev/null +++ b/ru/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о известных уязвимостях и способах их устранения. +--- + +# ⚠️ Известные уязвимости и способы их устранения diff --git a/ru/origin/plazma/administration/expert/optimize.md b/ru/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..3b5993237 --- /dev/null +++ b/ru/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, как оптимизировать Plazma. +--- + +# 🧹 Оптимизация diff --git a/ru/origin/plazma/administration/expert/proxy.md b/ru/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..6ed061fed --- /dev/null +++ b/ru/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, как безопасно настроить платформу прокси "Velocity". +--- + +# 🔀 Прокси diff --git a/ru/origin/plazma/administration/expert/vanillaize.md b/ru/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..0903c90e3 --- /dev/null +++ b/ru/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Узнайте, как восстановить патч Paper и ваниль. +--- + +# ↩️ Ваниль + +{% hint style="warning" %} + +**Paper не добавляет вариантов выбора в большинстве патчей по исправлению ошибок в ванильной версии.** + +Plazma в настоящее время разрабатывает возможность отключения таких исправлений ошибок. + +Следовательно, этот гид все еще находится в процессе написания, и информация может измениться в любое время. + +{% endhint %} diff --git a/ru/origin/plazma/administration/expert/xray.md b/ru/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..f9ad1927d --- /dev/null +++ b/ru/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Ознакомьтесь с различными встроенными методами блокировки X-лучей. +--- + +# 🩻 Блокировка X-лучей diff --git a/ru/origin/plazma/administration/faq.md b/ru/origin/plazma/administration/faq.md new file mode 100644 index 000000000..5be547cda --- /dev/null +++ b/ru/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Узнайте ответы на часто задаваемые вопросы. +--- + +# ⁉️ Часто задаваемые вопросы + +{% hint style="info" %} + +**Не можете найти нужный ответ?** + +[Официальный сервер Discord](https://discord.gg/MmfC52K8A8) или [Обсуждения на GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - задайте вопросы сообществу! + +{% endhint %} + +### Plazma не запускается + +Если в консоли выводится сообщение `no main manifest attribute, in plazma-(version).jar`,\ +значит загруженный файл является файлом API для разработки, и вам нужно скачать **Reobf Paperweight** с GitHub страницы. + +Для получения подробной информации посетите следующую страницу. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### При запуске сервера появляется предупреждение + +Plazma содержит некоторые нестабильные патчи и всегда может некорректно работать, поэтому при запуске сервера выводится следующее предупреждение. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Это предупреждение можно отключить с помощью системного свойства [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Для получения подробной информации посетите следующую страницу. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Доступно с версии 1.20.1 diff --git a/ru/origin/plazma/administration/getting-started/README.md b/ru/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..29b1fa26b --- /dev/null +++ b/ru/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Узнайте, как создать сервер с помощью Plazma. +--- + +# 👟 Начало работы + +Для стабильного использования Plazma система должна соответствовать следующим требованиям. + +| | Минимальные | Рекомендуемые | +| :---------: | ----------- | ------------- | +| Архитектура | x64 | - | +| ОЗУ | 8 ГБ | 16 ГБ | +| Хранилище | 1 ГБ | 8 ГБ | +| JDK | 17 | 21 | + +Для удобного редактирования конфигурационных файлов рекомендуется установить редактор, такой как [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Правильный вывод" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' не является внутренней или внешней командой, исполняемой программой или +пакетным файлом. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Сначала загрузите **JDK 21** в формате `.msi` с [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Запустите загруженного мастера установки и нажмите `Далее`. +3. После этого активируйте `Set JAVA_HOME variable` в меню, отображаемом в левом центре окна, и нажмите `Далее`. +4. Нажмите `Установить`, чтобы завершить установку JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Затем выполните следующую команду в терминале для установки JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Загрузка Plazma + +Plazma предоставляет несколько видов исполняемых файлов. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Подробнее + +Имя исполняемого файла должно быть `plazma-(менеджер версий)-1.20.4-R0.1-SNAPSHOT-(тип маппинга).jar`. + +- **Тип маппинга**\ + Маппинг - это своего рода карта, соединяющая реальный код Minecraft и обфусцированный код. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-маппинг, это маппинг для ванильного Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Менеджер версий**\ + Менеджер версий - это лаунчер сервера, который нужен для запуска сервера и патчинга файлов. + - **Paperclip**\ + Разработанный командой PaperMC администратор, который загружает библиотеки и применяет патчи к серверу. + - **Bundler**\ + Менеджер версий Vanilla Minecraft. + +
+ +*** + +## 3. Создание скрипта запуска + +Для удобного запуска Plazma и автоматического перезапуска сервера необходимо создать [скрипт запуска](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Вы можете скачать скрипт запуска, нажав на кнопку загрузки в левом нижнем углу.\ +**Убедитесь, что загруженный скрипт соответствует вашей операционной системе.** + +*** + +## 4. Очистка файлов + +Теперь переместите скачанный скрипт запуска и Plazma в новую папку. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Теперь запустите скрипт запуска. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Соглашение с EULA + +После запуска скрипта в папке будет создан файл `eula.txt`. + +EULA[^9] - это лицензионное соглашение, с которым вы соглашаетесь при использовании услуг Mojang Studios[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Чтобы согласиться с EULA, измените `eula=false` на `eula=true` в файле `eula.txt` и сохраните его. + +*** + +## 6. Разрешение внешних подключений (Windows) + +Современные операционные системы по умолчанию блокируют внешние подключения с помощью **брандмауэра** и **маршрутизатора**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Если ваш роутер не поддерживает UPnP, вам нужно будет искать инструкции для вашего конкретного роутера. + +Также можно использовать [Ngrok](https://ngrok.com/), чтобы создать временный адрес. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Проверка необходимости перенаправления портов + +Введите следующее в окне выполнения и запустите его. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Если вывод `True`, то можно заканчивать здесь, если `False`, то нужно настроить перенаправление портов. + +### 6.2 Подключение к серверу + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Адрес для подключения к серверу можно найти [здесь](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +После этого, перезапустите сервер, и Plazma автоматически попытается пробросить порты. + +Ниже приведены возможные сообщения в консоли в зависимости от результата UPnP, они будут отображаться как `[UPnP] (сообщение)` в консоли. + +| Сообщение | Значение | +| -------------------------------- | ------------------------------------------------------- | +| `Успешно открыт порт (порт)` | Проброс порта выполнен успешно. | +| `Порт (порт) уже открыт` | Другой сервис уже использует этот порт. | +| `Не удалось открыть порт (порт)` | Не удалось выполнить проброс порта. | +| `Служба недоступна` | Маршрутизатор не поддерживает UPnP. | + +После завершения работы сервера Plazma автоматически закроет порт. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Скачайте ZIP-файл `Windows (64-bit)` с [официального сайта Ngrok](https://ngrok.com/download). +2. Поместите скачанный Ngrok в папку сервера. +3. Создайте [токен аутентификации](https://dashboard.ngrok.com/get-started/your-authtoken) на панели управления Ngrok. +4. Выполните команду, отображаемую в `Command Line` из папки сервера. +5. Добавьте `start /b ngrok tcp --region jp 25565` в верхней части скрипта запуска, и `taskkill /f /t /im ngrok.exe` в нижней части. +6. Из строки `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` возьмите `0.tcp.jp.ngrok.io:12345` как адрес сервера. +7. Теперь вы можете подключиться к серверу с внешнего источника по этому адресу. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Например, если после выполнения команды у вас отобразится + +```log +Windows IP Configuration + +Ethernet adapter Ethernet: + + Connection-specific DNS Suffix . . . . . : + IPv4 Address. . . . . . . . . . . : 192.168.3.7 + Subnet Mask . . . . . . . . . . . : 255.255.255.0 + Default Gateway . . . . . . . . . : 192.168.3.1 + +``` + +Используйте `192.168.3.7`, отображенный как IPv4 адрес, для подключения к серверу локально. + +Если сервер и игра запущены на одном компьютере, вы можете использовать `localhost` для подключения. +{% endtab %} +{% endtabs %} + +## 7. Развиваться + +Если сервер успешно запущен и функционирует правильно, теперь настало время настроить сервер под себя. + +Изучите этот руководство, чтобы узнать, как настроить сервер по вашему усмотрению. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, на котором основан Plazma, также основан на Spigot, который в свою очередь является официальной платформой для серверов. + +[^3]: Комбинация клавиш Windows + R + +[^4]: Для Linux используйте `java --version` в терминале + +[^5]: JRE является одним из проектов с открытым исходным кодом и имеет несколько вариантов, подобно платформе Minecraft сервера. + +[^6]: Обычно известен как **запускатель**. + +[^7]: Активируя "Автоматический перезапуск", сервер будет перезапускаться автоматически. Для завершения работы используйте `Control + C`. + +[^8]: Не рекомендуется использовать более половины ресурсов системы. + + Например, если общий объем памяти системы составляет 8 ГБ, не рекомендуется устанавливать больше 4 ГБ. + +[^9]: EULA, Лицензионное соглашение конечного пользователя. Подробнее на [официальном сайте Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорация Microsoft. + +[^11]: В соответствии с Законом о развитии игровой индустрии Республики Корея, статья 32, пункт 9, **Корейская компания Microsoft** вправе предъявить иск в судебном порядке. + +[^12]: Universal Plug & Play. Purpur, входящий в Plazma, автоматически взаимодействует с маршрутизатором через эту технологию, открывая порты только при работе сервера, что устраняет необходимость вручную настраивать проброс портов. + +[^13]: Если у вас нет учетной записи, зарегистрируйтесь в Ngrok через учетную запись Google или GitHub. diff --git a/ru/origin/plazma/administration/getting-started/customization.md b/ru/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..ebb166dd6 --- /dev/null +++ b/ru/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,115 @@ +--- +description: Узнайте, как настроить сервер. +--- + +# 🎨 Настройка пользовательского интерфейса + +Причина использования модифицированной серверной платформы, такой как Plazma, вместо официальной серверной платформы от Mojang Studios, заключается в том, что это позволяет осуществлять мощную **пользовательскую настройку**. + +Ниже приведены различные способы настройки и использования Plazma. + +## Изменение настроек + +Самым основным способом настройки Plazma является изменение конфигурации. + +Plazma предоставляет мощные настройки, начиная от механики игры до свойств мобов и т. д. + +Для получения информации о конфигурации Plazma обратитесь к следующей странице. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Использование плагинов + +{% hint style="success" %} + +**Plazma поддерживает все плагины на основе бумаги.** + +Для некоторых плагинов Spigot, начиная с версии 1.20.5 из-за изменений в сопоставлении Paper, некоторые функции могут не работать, но большинство плагинов, основанных на Paper, такие как Paper, Pufferfish и Purpur, работают в Plazma, и если они не работают должным образом, это ошибка Plazma, поэтому пожалуйста, [сообщите об этом нам.](../diagnosis/plugins.md) + +{% endhint %} + +Это главная причина использования Plazma и самый мощный способ настройки Plazma. +Мощная экосистема плагинов Plazma позволяет легко настраивать сервер. + +Существует несколько способов поиска и загрузки плагинов. Некоторые плагины загружаются на общедоступные репозитории, а некоторые загружаются на GitHub или собственные сайты. + +{% hint style="caution" %} + +**Плагины могут иметь прямой доступ к системе!** + +Прежде чем применять плагины, всегда убедитесь в их безопасности с помощью сервисов, таких как VirusTotal, или загружайте плагины из надежных источников. + +{% endhint %} + +Существует несколько сервисов для загрузки плагинов. Среди них, [Форум SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) и другие сервисы проводят проверку плагинов перед их загрузкой, чтобы обеспечить распространение только безопасных плагинов. + +### Применение плагинов + +После загрузки плагина наступает время его применения. + +1. Плагины представлены в формате `.jar` или `Java Executable File`.\ + Некоторые плагины могут быть в виде архивных файлов, в таком случае распакуйте их и используйте файл с `bukkit`, `spigot` или `paper` в названии, если есть файл с `fat`, используйте его. +2. Поместите загруженный файл в папку `plugins` сервера и перезапустите (или запустите) сервер. +3. При запуске Plazma в консоли появится новый вывод. + Это означает, что Plazma успешно загрузил плагины. +4. Несмотря на успешную загрузку плагинов Plazma, они могут не запускаться. + С помощью команды `/plugins` можно просмотреть загруженные плагины на сервере. + Если название установленного плагина не красное, + а зеленое, значит плагин успешно загружен. + +Если плагины не загружаются правильно, вы можете найти решение на следующей странице. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Использование датапаков + +Датапаки - это способ настройки Minecraft, аналогичный [ресурс-пакам](#user-content-fn-1)[^1]. + +С их помощью можно добавлять новые сущности и вызовы вызовов в игру и изменять части игры. + +{% hint style="caution" %} + +**Датапаки могут повредить мир!** + +Некорректно работающие датапаки могут повредить мир без возможности восстановления. + +Поэтому перед применением датапаков рекомендуется создать резервную копию мира. + +{% endhint %} + +Датапаки также можно найти на различных сервисах, таких как [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) и других. + +После загрузки датапака его можно применить, поместив в папку `datapacks` мира сервера. +Если папки нет, создайте ее и добавьте датапак. + +{% hint style="warning" %} + +**Некоторые [датапаки](#user-content-fn-2)[^2] могут не применяться правильно при первом применении.** + +Для этого рекомендуется **2 раза** перезапустить сервер. + +{% endhint %} + +Датапаки могут легко повредиться при обновлении Minecraft. + +Особенно если датапак полностью поврежден, сервер может выйти из строя, поэтому перед обновлением сервера важно провести достаточное тестирование. + +{% hint style="info" %} + +**После команды запуска сервера добавьте `safeMode`, чтобы отключить все датапаки перед запуском сервера.** + +[Дополнительную информацию смотрите в `Референс > Аргументы и свойства`.](../reference/arguments.md) + +{% endhint %} + +Примененные датапаки можно проверить с помощью команды `/datapack list`. + +*** + +[^1]: Или для Minecraft: Bedrock Edition - аддоны. + +[^2]: Добавление новых сущностей и т.д. diff --git a/ru/origin/plazma/administration/getting-started/next-step.md b/ru/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..113e1ff7e --- /dev/null +++ b/ru/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Узнайте, как настроить сервер. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Ниже приведены различные способы настройки и использования Plazma. + +## Изменение настроек + +Самым основным способом настройки Plazma является изменение конфигурации. + +Plazma предоставляет мощные настройки, начиная от механики игры до свойств мобов и т. д. + +Для получения информации о конфигурации Plazma обратитесь к следующей странице. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Использование плагинов + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Это главная причина использования Plazma и самый мощный способ настройки Plazma. Мощная экосистема плагинов Plazma позволяет легко настраивать сервер. + +Существует несколько способов поиска и загрузки плагинов. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Существует несколько сервисов для загрузки плагинов. Среди них, [Форум SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) и другие сервисы проводят проверку плагинов перед их загрузкой, чтобы обеспечить распространение только безопасных плагинов. + +### Применение плагинов + +После загрузки плагина наступает время его применения. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Поместите загруженный файл в папку `plugins` сервера и перезапустите (или запустите) сервер. +3. При запуске Plazma в консоли появится новый вывод. Это означает, что Plazma успешно загрузил плагины. +4. Несмотря на успешную загрузку плагинов Plazma, они могут не запускаться. С помощью команды `/plugins` можно просмотреть загруженные плагины на сервере. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Если плагины не загружаются правильно, вы можете найти решение на следующей странице. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Использование датапаков + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +С их помощью можно добавлять новые сущности и вызовы вызовов в игру и изменять части игры. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Некорректно работающие датапаки могут повредить мир без возможности восстановления. + +Поэтому перед применением датапаков рекомендуется создать резервную копию мира. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +После загрузки датапака его можно применить, поместив в папку `datapacks` мира сервера. Если папки нет, создайте ее и добавьте датапак. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Для этого рекомендуется **2 раза** перезапустить сервер. +{% endhint %} + +Датапаки могут легко повредиться при обновлении Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Примененные датапаки можно проверить с помощью команды `/datapack list`. + +*** + +## Оптимизация + +Plazma содержит множество патчей оптимизации. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Прокси + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Для информации по безопасной и правильной настройке прокси смотрите страницу ниже. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Безопасность + +С развитием модов Minecraft легко получить [движок для атаки уязвимостей](#user-content-fn-3). + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Настройка разрешений + +Для некоторых административных команд плагинов могут существовать уязвимости из-за неправильных настроек разрешений. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Блокировка X-Ray + +X-Ray является одной из уязвимостей, легко доступных даже в базовом оптимизированном клиенте. + +Plazma предоставляет конфигурацию по блокировке X-Ray по умолчанию. + +Для информации о методах и объяснениях блокировки X-Ray смотрите страницу ниже. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Белый список + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Для просмотра списка игроков, которым разрешен доступ, используйте `/whitelist query`. + +*** + +[^1]: Или для Minecraft: Bedrock Edition - аддоны. + +[^2]: Добавление новых сущностей и т.д. + +[^3]: Обычно называется "читерством". + +[^4]: В случае неоптимизированной конфигурации, старого Plazma или в случае новых уязвимостей блокировка может быть недоступна. + +[^5]: При подключении игрока к серверу он проходит через прокси-сервер Ngrok, и каждый раз при перезапуске выдается новый адрес Ngrok. diff --git a/ru/origin/plazma/administration/reference/README.md b/ru/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..18c03a1ee --- /dev/null +++ b/ru/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Узнайте о методах настройки, предоставляемых по умолчанию в Plazma. +--- + +# 📜 리퍼런스 + +Plazma предоставляет различные методы настройки. + +Из них четыре метода можно использовать немедленно без дополнительных действий. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Официальный сервер Discord](https://discord.gg/MmfC52K8A8) или [Обсуждения на GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - задайте вопросы сообществу! +{% endhint %} + +*** + +## 🖥️ Команды + +> Команды позволяют собирать информацию в игре или настраивать игровое окружение. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Права + +> Права определяют диапазон взаимодействия игрока. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Параметры и атрибуты + +> Параметры и атрибуты оказывают общее влияние на функционирование Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Конфигурация + +> Конфигурация является основным способом настройки Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/ru/origin/plazma/administration/reference/arguments.md b/ru/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..99abc2635 --- /dev/null +++ b/ru/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Изучите начальные аргументы и системные свойства. +--- + +# 🎛️ Аргументы и свойства + +Начальные аргументы и свойства системы - это значения, добавляемые к [командам, используемым](#user-content-fn-1)[^1] в выполнении Plazma, они имеют общее влияние на работу Plazma. + +[위치 추가 명령어](#user-content-fn-2)[^2]에 따라 **시작 매개 변수**와 **시스템 속성**으로 분리됩니다. + +*** + +## Системные свойства + +Системные свойства вводятся перед `-jar` и обрабатываются в JVM до инициализации Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Использование + +Системные свойства вводятся как Java-аргументы между `java` и `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` указывает, что этот аргумент не встроен в JVM, а добавлен в Plazma как специальный аргумент, + +값을 입력하지 않으면 값이 [`true`로 설정됩니다](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Все системные свойства + +#### `convertLegacySigns` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Обновляет отключенный формат табличек. + +#### `debug.entities` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает отладочные журналы для информации об энтити. + +#### `debug.rewriteForIDE` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает NMS ревизию для правильной загрузки отладочной информации в IDE и автоматической перекомпиляции внутренней версии. + +#### `disable.watchdog` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает систему предупреждений Watchdog в Spigot. + +#### `letMeReload` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает подтверждение команды `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Если вы разработчик плагина и вам нужно обновить плагин, используйте горячую замену вместо команды `/reload`. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает систему приоритета классов плагина. + +Это полезно в случае проблем с плагином Shade. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает систему консолидации Netty flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **По умолчанию**: `750` + +Разбивает сущности на несколько пакетов для передачи, если их количество больше установленного значения. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **По умолчанию**: `8192` + +Устанавливает максимальный размер пакета, который сервер может принять за один раз. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает проверку версии Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Это может привести к постоянному повреждению файлов мира и краху механики игры. + +Все проблемы, возникшие при использовании этого, лежат на вас, и Plamza не предоставит никакой поддержки по этому поводу. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **По умолчанию**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **По умолчанию**: `80` + +Устанавливает максимальную длину строки на табличке. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **По умолчанию**: `(версия мира) + 1` + +Устанавливает версию обновления мира, которую нужно предзагрузить. + +Это полезно при необходимости обновить большое количество чанков, но в других случаях не используется. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Boolean` +- **По умолчанию**: `True` + +Включает обработку комментариев в YAML файлах по умолчанию. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **По умолчанию**: `30` + +Когда игрок не отправляет данные в течение указанного времени (в секундах), он будет отключен. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Игнорирует комментарии в свойствах сервера. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает отладочные журналы для синхронной загрузки чанков. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает [стандартную систему записи чанков Minecraft](#user-content-fn-10)[^10]. + +Это приводит к последовательному сохранению каждого чанка, что сильно снижает производительность. + +#### `Paper.explicit-flush` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает явную очистку сетевого канала. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Тип**: `Boolean` +- **По умолчанию**: `false` + +Отключает брендинг Plazma и вместо этого использует стандартную иконку сервера. + +#### `Plazma.useVanillaConfiguration` + +- **Тип**: `Boolean` +- **По умолчанию**: `false` +- **Конфликт**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Это может серьезно повлиять на безопасность и производительность сервера. + +Все проблемы, возникающие при использовании этого атрибута, лежат на администраторе сервера. +{% endhint %} + +Передает изначальную настройку в качестве значений, предоставленных Mojang. + +Это отключает все патчи, исправляющие уязвимости, примененные в Paper. + +Патчи уязвимостей можно снова активировать в конфигурации Paper или Plazma. + +#### `Plazma.vanillaize` + +- **Тип**: `Boolean` +- **По умолчанию**: `true` +- **Конфликт**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Устанавливает изначальную настройку ближе к стандартной. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Используемое свойство остановлено + +Нижеуказанные системные свойства являются устаревшими. + +#### `timings.bypassMax` + +- **Тип**: `Boolean` +- **По умолчанию**: `false` +- **Устарело**: Timings был полностью удален из Plazma + +Определяет, может ли превышаться максимальное значение, передаваемое в API Timings Aikar. + +Даже если это будет сделано, если не обрабатывается исключение API, будет применено ограничение скорости. + +*** + +## Начальный аргумент + +Начальный аргумент вводится после `-jar *.jar` для инициализации Plazma и обработки вместе с ним. + +### Использование + +Системные свойства вводятся в качестве аргументов программы после `-jar *.jar`. + +Например, если вы хотите применить начальный аргумент `nogui`,\ +введите следующее, и Plazma обработает аргумент `nogui` во время инициализации. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Полный начальный аргумент + +#### `bukkit-settings` + +- **Псевдоним**: `b` +- **По умолчанию**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Псевдоним**: `c` +- **По умолчанию**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Псевдоним**: `c` +- **По умолчанию**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Запускает сервер в режиме демонстрации. + +#### `eraseCache` + +Удаляет оставшиеся файлы кэша после обновления мира. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Псевдоним**: `?` + +Выводит полный список аргументов и их описание в Plazma. + +#### `initSettings` + +Создает только файл конфигурации и завершает работу сервера. + +#### `jfrProfile` + +Активирует профилирование JFR. + +#### `max-players` + +- **Псевдонимы**: `s`, `size` +- **По умолчанию**: `(свойства сервера)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Отключает графическую панель интерфейса. + +#### `nojline` + +Отключите JLine и используйте консоль Vanilla. + +#### `online-mode` + +- **Псевдоним**: `o` +- **По умолчанию**: `(свойства сервера)` + +Выберите, следует ли проверять игроков на Mojang-сервере аутентификации. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Псевдоним**: `paper` +- **По умолчанию**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Устанавливает местоположение отключенного файла конфигурации PaperSpigot. + +Используется для переноса существующей конфигурации в новый файл конфигурации, после чего не используется. + +#### `paper-settings-directory` + +- **Псевдоним**: `paper-dir` +- **По умолчанию**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Псевдоним**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Псевдоним**: `p` +- **По умолчанию**: `plugins` + +Устанавливает расположение папки плагинов. + +#### `pufferfish-settings` + +- **Псевдоним**: `pufferfish` +- **По умолчанию**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Псевдоним**: `purpur` +- **По умолчанию**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Запускает сервер в полностью Vanilla режиме (без модификаций). + +#### `server-ip` + +- **Псевдонимы**: `h`, `host` +- **По умолчанию**: `(свойства сервера)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Псевдонимы**: `p`, `port` +- **По умолчанию**: `(свойства сервера)` + +Устанавливает порт сервера. + +#### `server-name` + +- **По умолчанию**: `A Plazma Server` + +Устанавливает имя сервера. + +#### `spigot-settings` + +- **Псевдоним**: `S` +- **По умолчанию**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Псевдоним**: `v` + +Отображает версию Plazma. + +#### `world-dir` + +- **Псевдонимы**: `W`, `universe`, `world-container` +- **По умолчанию**: `(папка сервера)` + +Устанавливает местоположение, где хранятся файлы мира. + +#### `world-name` + +- **Псевдонимы**: `w`, `world` +- **По умолчанию**: `(свойства сервера)` + +Устанавливает имя файла мира. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Позиция обработки аргументов изменяется в зависимости от добавленного расположения. + +[^3]: Например, если вы хотите установить `Plazma.iKnowWhatIAmDoing` в `true`, просто введите `-DPlazma.iKnowWhatIAmDoing`, вместо `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Например, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Детектор событий. + +[^6]: Детектор событий. + +[^7]: Клиент. + +[^8]: Сигнал, указывающий на успешное соединение с сервером, подобно сердечным сокращениям. + +[^9]: С помощью функции Purpur AFK Kick можно выгнать игроков, покинувших место. + +[^10]: Система синхронной записи чанков, Sync Chunk Write System. + +[^11]: `ВНИМАНИЕ! Plazma может вызвать неожиданные проблемы, поэтому обязательно тщательно протестируйте его перед использованием на публичном сервере.` + +[^12]: В игре `Мировая оптимизация` также работает по тому же принципу. + +[^13]: Администраторы уровня 2 и выше исключаются. + +[^14]: Протокол интернета, IP. diff --git a/ru/origin/plazma/administration/reference/commands.md b/ru/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..dc01b2d83 --- /dev/null +++ b/ru/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о доступных командах в Plazma. +--- + +# 🖥️ Команды diff --git a/ru/origin/plazma/administration/reference/configurations/README.md b/ru/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..8694de61f --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Конфигурация является основным способом настройки Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Атрибут + +> Атрибут - это базовый конфигурационный файл, предоставляемый Minecraft. Используя атрибут, вы можете изменить основные механизмы игры. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Конфигурация Bukkit + +> Конфигурация Bukkit - это базовый конфигурационный файл, предоставляемый Plazma. Используя конфигурацию Bukkit, вы можете изменить основные механизмы сервера Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Конфигурация Spigot + +> Конфигурация Spigot позволяет изменить детальные механизмы игры, обработку игроков, работу команд и сообщения. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Конфигурация Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Конфигурация Pufferfish + +> Конфигурация Pufferfish позволяет изменить обработку мира и сущностей Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Конфигурация Purpur + +> Атрибут Purpur позволяет изменить основные данные игры. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Конфигурация Plazma + +> Конфигурация Plazma позволяет настраивать функционал Plazma. + +{% content-ref url="plazma/" %} +[плазма](plazma/) +{% endcontent-ref %} + +*** diff --git a/ru/origin/plazma/administration/reference/configurations/bukkit.md b/ru/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e18731d07 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ru/origin/plazma/administration/reference/configurations/paper/README.md b/ru/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..6ab22a1ee --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте назначение каждого файла в папке config. +--- + +# 🛩️ Бумага diff --git a/ru/origin/plazma/administration/reference/configurations/paper/global.md b/ru/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..f44506374 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ru/origin/plazma/administration/reference/configurations/paper/world.md b/ru/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..eb084c169 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Узнайте, что означает каждый узел в paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Мир по миру diff --git a/ru/origin/plazma/administration/reference/configurations/plazma/README.md b/ru/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..8e40a6a48 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте назначение каждого файла в папке config. +--- + +# ✨ Плазма diff --git a/ru/origin/plazma/administration/reference/configurations/plazma/global.md b/ru/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..33588c0a7 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/ru/origin/plazma/administration/reference/configurations/plazma/world.md b/ru/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..418383a28 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ru/origin/plazma/administration/reference/configurations/plazma/worlds.md b/ru/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..b61ab15ca --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в plazma-world.yml. +--- + +# ✨ Плазма (структура мира) diff --git a/ru/origin/plazma/administration/reference/configurations/property.md b/ru/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..c69b2511c --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в server.properties. +--- + +# 🪨 Server.properties diff --git a/ru/origin/plazma/administration/reference/configurations/pufferfish.md b/ru/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..9d10495cd --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в pufferfish.yml. +--- + +# 🐡 Кольцеголов diff --git a/ru/origin/plazma/administration/reference/configurations/purpur/README.md b/ru/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..f16c91dc9 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в purpur.yml. +--- + +# 🦑 Пурпур diff --git a/ru/origin/plazma/administration/reference/configurations/purpur/global.md b/ru/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..ff9fb08fe --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/ru/origin/plazma/administration/reference/configurations/purpur/world.md b/ru/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..28ca9c296 --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/ru/origin/plazma/administration/reference/configurations/spigot.md b/ru/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..7c1d5e3ba --- /dev/null +++ b/ru/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в spigot.yml. +--- + +# 🚰 Спигот diff --git a/ru/origin/plazma/administration/reference/permissions.md b/ru/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..f837e882e --- /dev/null +++ b/ru/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Узнайте о разрешениях Plazma. +--- + +# 🛡️ Разрешение + +Права - это простой инструмент безопасности, который определяет диапазон взаимодействия игроков на сервере. + +Для правильного использования и удобного изменения прав необходимо использовать плагины, такие как [LuckPerms](https://luckperms.net). + +*** + +## Понимание базовой системы прав + +В Minecraft предоставляются базовые группы управления правами. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Игроки**\ + Это общая группа прав, предоставляемая всем игрокам. +2. **Посредники**\ + Могут игнорировать защиту спавна. +3. **Администраторы мира**\ + Могут использовать все команды и командные блоки, связанные с управлением миром.\ + Это базовая группа прав, применяемая к датапакам и командным блокам. +4. **Администраторы**\ + Могут использовать все команды, связанные с управлением игроками. +5. **Главные администраторы**\ + Могут использовать все команды, включая управление сервером.\ + Это базовая группа прав, применяемая к консоли и администраторам. + +*** + +## Настройка прав + +*** + +## Все права + +*** + +#### `allow.ride.(Namespaced Key)` + +- **По умолчанию**: `Нет` + +Позволяет игрокам усаживаться на существо, присаживаясь и взаимодействуя с ним. + +Когда игрок садится на существо, он может управлять его движением с помощью клавиш перемещения и прыгать или летать с помощью клавиши прыжка. + +В `(Namespaced Key)` указывается [Namespaced ID](#user-content-fn-2)[^2] существа. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **По умолчанию**: `Нет` + +Позволяет игрокам использовать особые навыки существа, на котором они находятся. + +Не все существа могут использовать особые навыки. Смотрите список всех доступных особых навыков ниже. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Поделитесь своими идеями на [Plazma Discord](https://plazmamc.org/discord) или [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Посмотреть текущие доступные особые навыки + +- **`crepper`**\ + При нажатии клавиши прыжка существо взрывается.\ + Если у игрока есть право `allow.powered.creeper`, он может зарядить взрыв, удерживая клавишу прыжка. +- **`dolphin`**\ + При нажатии клавиши прыжка существо делает рывок. +- **`phantom`**\ + При нажатии клавиши прыжка существо выпускает огонь. +- **`wither`**\ + При взаимодействии существо выпускает головы витера. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/credits (Игрок)`](commands.md#credits). + +Добавив `.other` после названия права, можно разрешить использовать его другим игрокам. + +#### `bukkit.command.demo` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/demo (Игрок)`](commands.md#demo). + +Добавив `.other` после названия права, можно разрешить использовать его другим игрокам. + +#### `bukkit.command.ping` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/ping (Игрок)`](commands.md#ping). + +Добавив `.other` после названия права, можно разрешить использовать его другим игрокам. + +#### `bukkit.command.ram` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/rambar (Игрок)`](commands.md#rambar). + +Добавив `.other` после названия права, можно разрешить использовать его другим игрокам. + +#### `bukkit.command.restart` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/tpsbar (Игрок)`](commands.md#tpsbar). + +Добавив `.other` после названия права, можно разрешить использовать его другим игрокам. + +#### `bukkit.command.timings` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Для аналогичной функциональности смотрите [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **По умолчанию**: `Администратор мира` + +Позволяет использовать команду `/gamemode (GameMode) (Игрок)`. + +Добавив `.other` после названия права, можно разрешить использовать его другим игрокам. + +#### `paper.antixray.bypass` + +- **По умолчанию**: `Нет` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Это позволяет улучшить производительность обеих сторон. + +> Для получения информации о настройке X-Ray обратитесь к следующей странице. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **По умолчанию**: `Нет` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **По умолчанию**: `Нет` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **По умолчанию**: `Нет` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **По умолчанию**: `Нет` + +Позволяет использовать [MiniMessage теги](https://docs.advntr.dev/minimessage/format.html) на наковальнях. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **По умолчанию**: `Нет` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **По умолчанию**: `Нет` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **По умолчанию**: `Нет` + +Исключает игроков из списка целей для выгрузки из-за бездействия. + +#### `purpur.debug.f3n` + +- **По умолчанию**: `Администратор мира` + +Позволяет игрокам изменять режим игры клавишей `F3 + N`. + +Это действие возможно только при наличии соответствующего разрешения. + +#### `purpur.drop.spawners` + +- **По умолчанию**: `Нет` + +При добыче спаунерного блока игроки получат сам спаунерный блок. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **По умолчанию**: `Нет` + +Изменяет размер эндерсундука. + +В `(NumberString)` можно указать `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **По умолчанию**: `Нет` + +Позволяет использовать тотем бессмертия из инвентаря. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **По умолчанию**: `Нет` + +Разрешить игроку игнорировать ограничение на количество подключений. + +#### `purpur.mending_shift_click` + +- **По умолчанию**: `Нет` + +Разрешить игроку починить предмет, который он держит, когда он `приседает и взаимодействует`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **По умолчанию**: `Нет` + +Разрешить игроку устанавливать спаунеры. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **По умолчанию**: `Нет` + +Позволить игроку мгновенно телепортироваться при использовании портала в Нижний мир. + +#### `purpur.sign.color` + +- **По умолчанию**: `Нет` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **По умолчанию**: `Нет` + +Разрешить использование кода`(&o)` для шифрования на указателях. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **По умолчанию**: `Нет` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **По умолчанию**: `Нет` + +Разрешить игрокам `взаимодействовать` с TNT ножницами, чтобы предотвратить взрыв. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Предоставляемые разрешения + +#### `plazma.bypass.ncr-require` + +- **По умолчанию**: `Нет` + +Разрешить игрокам подключаться, даже если у них не установлен мод [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Оператор. + +[^2]: Например: `ender_dragon` diff --git a/ru/origin/plazma/adminstration/README.md b/ru/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..7369a9262 --- /dev/null +++ b/ru/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Создайте свой собственный сервер с помощью Plazma. +--- + +# ⚒️ Руководство по управлению сервером diff --git a/ru/origin/plazma/adminstration/expert/README.md b/ru/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..794b7ccc5 --- /dev/null +++ b/ru/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о профессиональном подходе к работе с Plazma. +--- + +# 🎓 Глубокое изучение diff --git a/ru/origin/plazma/adminstration/expert/fix-exploits.md b/ru/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..ae4c86b36 --- /dev/null +++ b/ru/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о известных уязвимостях и способах их устранения. +--- + +# ⚠️ Известные уязвимости и способы их устранения diff --git a/ru/origin/plazma/adminstration/expert/optimize.md b/ru/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..3b5993237 --- /dev/null +++ b/ru/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, как оптимизировать Plazma. +--- + +# 🧹 Оптимизация diff --git a/ru/origin/plazma/adminstration/expert/vanillaize.md b/ru/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..4af19599d --- /dev/null +++ b/ru/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Узнайте, как восстановить патч Paper и ваниль. +--- + +# ↩️ Ваниль + +{% hint style="warning" %} + +### Paper не предлагает вариантов для большинства патчей по устранению ошибок в ванильных. + +Plazma в настоящее время разрабатывает возможность отключения таких исправлений ошибок. + +Следовательно, этот гид все еще находится в процессе написания, и информация может измениться в любое время. +{% endhint %} diff --git a/ru/origin/plazma/adminstration/faq.md b/ru/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..7a156a644 --- /dev/null +++ b/ru/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Узнайте ответы на часто задаваемые вопросы. +--- + +# ⁉️ Часто задаваемые вопросы + +{% hint style="info" %} + +### Не можете найти нужный ответ? + +Задайте вопрос сообществу через [официальный сервер Discord](https://discord.gg/MmfC52K8A8) или [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### При выполнении появляется сообщение, но ничего не происходит + +Если в консоли выводится сообщение `no main manifest attribute, in plazma-(version).jar`,\ +значит загруженный файл является файлом API для разработки, и вам нужно скачать **Reobf Paperweight** с GitHub страницы. + +Для получения подробной информации посетите следующую страницу. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### При запуске сервера появляется предупреждение + +Plazma содержит некоторые нестабильные патчи и всегда может некорректно работать, поэтому при запуске сервера выводится следующее предупреждение. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Это предупреждение можно отключить с помощью системного свойства [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Для получения подробной информации посетите следующую страницу. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Доступно с версии 1.20.1 diff --git a/ru/origin/plazma/adminstration/getting-started/README.md b/ru/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..2be17a4a2 --- /dev/null +++ b/ru/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Узнайте, как создать сервер с помощью Plazma. +--- + +# 👟 Начало работы + +Для стабильного использования Plazma система должна соответствовать следующим требованиям. + +| | Минимальные | Рекомендуемые | +| :---------: | ----------: | ------------: | +| Архитектура | x64 | - | +| ОЗУ | 8 ГБ | 16 ГБ | +| Хранилище | 1 ГБ | 8 ГБ | +| JRE | 17 | 21 | + +Для удобного редактирования конфигурационных файлов рекомендуется установить редактор, такой как [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Установка JRE + +Как следует из названия, Minecraft: **"Java"** Edition разработан на Java, поэтому для запуска необходим JRE[^1]. + +Поскольку Plazma основана на официальной серверной платформе Mojang Studios[^2], для использования Plazma также требуется установить JRE. + +### 1.1 Проверка наличия JRE + +Чтобы узнать, установлен ли JRE на вашей системе, введите [`cmd /k java --version`](#user-content-fn-4)[^4] в окне выполнения и запустите его. + +Если вывод выглядит как указано ниже, переходите к [Шагу 2](setup.md#id-2). + +{% code title="Правильный вывод" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Если вывод не соответствует указанному или вы видите что-то подобное, значит JRE отсутствует или слишком старый, и вам нужно выполнить [Шаг 1.2](setup.md#id-1.2). + +{% code title="JRE не установлен" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE слишком старый" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Установка JRE + +В этом руководстве мы используем Azul Zulu в качестве одного из вариантов JRE[^5]. + +После установки выполните снова [Шаг 1.1](setup.md#id-1.1), чтобы убедиться, что установка прошла успешно. + +{% tabs %} +{% tab title="Windows" %} + +1. Сначала загрузите **JDK 21** в формате `.msi` с [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Запустите загруженного мастера установки и нажмите `Далее`. +3. После этого активируйте `Set JAVA_HOME variable` в меню, отображаемом в левом центре окна, и нажмите `Далее`. +4. Нажмите `Установить`, чтобы завершить установку JRE. + {% endtab %} + +{% tab title="macOS" %} +Загрузите установочный мастер **JDK 21** в формате `.dmg` с [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) и выполните установку JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Сначала выполните следующую команду в терминале, чтобы добавить репозиторий Azul Zulu в APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Затем выполните следующую команду в терминале для установки JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Выполните следующую команду для установки JRE. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Загрузка Plazma + +Plazma предоставляет несколько видов исполняемых файлов. + +{% hint style="warning" %} + +### В большинстве случаев используйте `Reobf Paperclip`. + +Следующая информация предназначена для разработчиков или тех, кто интересуется особенностями каждого вида.\ +Если вы обычный пользователь, то можно перейти к [Шагу 3](setup.md#id-3) без проблем. +{% endhint %} + +
+ +Подробнее + +Имя исполняемого файла должно быть `plazma-(менеджер версий)-1.20.4-R0.1-SNAPSHOT-(тип маппинга).jar`. + +- **Тип маппинга**\ + Маппинг - это своего рода карта, соединяющая реальный код Minecraft и обфусцированный код. + - **Reobf**\ + Реобфускация, также известная как маппинг Spigot, используется в большинстве плагинов NMS.\ + Начиная с версии 1.20.5, ее использование будет прекращено. + - **Mojmap**\ + Маппинг Mojang, маппинг Vanilla Minecraft. +- **Менеджер версий**\ + Менеджер версий - это лаунчер сервера, который нужен для запуска сервера и патчинга файлов. + - **Paperclip**\ + Разработанный командой PaperMC администратор, который загружает библиотеки и применяет патчи к серверу. + - **Bundler**\ + Менеджер версий Vanilla Minecraft. + +
+ +*** + +## 3. Создание скрипта запуска + +Для удобного запуска Plazma и автоматического перезапуска сервера необходимо создать [скрипт запуска](#user-content-fn-6)[^6]. + +Вы можете создать скрипт запуска через [Flags.sh](https://flags.sh). Просто укажите необходимый объем памяти для Plazma[^8], и команда будет оптимизирована автоматически. + +Вы можете скачать скрипт запуска, нажав на кнопку загрузки в левом нижнем углу.\ +**Убедитесь, что загруженный скрипт соответствует вашей операционной системе.** + +*** + +## 4. Очистка файлов + +Теперь переместите скачанный скрипт запуска и Plazma в новую папку. + +{% hint style="warning" %} + +### Имя папки должно быть без пробелов и на английском языке. + +В противном случае Plazma или JRE могут работать некорректно. +{% endhint %} + +Теперь запустите скрипт запуска. Для Windows обязательно выберите **Разрешить** в окне выбора разрешения брандмауэра. + +*** + +## 5. Соглашение с EULA + +После запуска скрипта в папке будет создан файл `eula.txt`. + +EULA[^9] - это лицензионное соглашение, с которым вы соглашаетесь при использовании услуг Mojang Studios[^10]. + +Если вы не согласны с EULA, сервер не запустится, и в случае нарушения EULA могут быть применены меры наказания, такие как блокировка аккаунта[^11]. + +Чтобы согласиться с EULA, измените `eula=false` на `eula=true` в файле `eula.txt` и сохраните его. + +*** + +## 6. Разрешение внешних подключений (Windows) + +Современные операционные системы по умолчанию блокируют внешние подключения с помощью **брандмауэра** и **маршрутизатора**. + +Для Windows, так как вы уже разрешили брандмауэру в [Шаге 3](setup.md#id-3), вам нужно только настроить перенаправление портов. + +{% hint style="info" %} + +### В данном руководстве предполагается, что у вас установлена Windows и вы используете роутер с поддержкой [**UPnP**](#user-content-fn-12)[^12]. + +Если ваш роутер не поддерживает UPnP, вам нужно будет искать инструкции для вашего конкретного роутера. + +Также можно использовать [Ngrok](https://ngrok.com/), чтобы создать временный адрес. +{% endhint %} + +{% hint style="warning" %} + +### Для Linux или macOS и других операционных систем на базе (почти) UNIX настройка брандмауэра зависит от службы, поэтому вам нужно будет искать инструкции самостоятельно. + +{% endhint %} + +### 6.1 Проверка необходимости перенаправления портов + +Введите следующее в окне выполнения и запустите его. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Если вывод `True`, то можно заканчивать здесь, если `False`, то нужно настроить перенаправление портов. + +### 6.2 Подключение к серверу + +{% tabs %} +{% tab title="Подключение с внешнего источника" %} +Если не требуется проброс портов или проброс портов уже настроен успешно, вы можете подключиться к серверу. + +Адрес для подключения к серверу можно найти [здесь](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Попытка проброса портов через UPnP" %} +В файле `purpur.yml` сервера активируйте `network.upnp-port-forwarding` на `true`. + +После этого, перезапустите сервер, и Plazma автоматически попытается пробросить порты. + +Ниже приведены возможные сообщения в консоли в зависимости от результата UPnP, они будут отображаться как `[UPnP] (сообщение)` в консоли. + +| Сообщение | Значение | +| -------------------------------- | --------------------------------------- | +| `Успешно открыт порт (порт)` | Проброс порта выполнен успешно. | +| `Порт (порт) уже открыт` | Другой сервис уже использует этот порт. | +| `Не удалось открыть порт (порт)` | Не удалось выполнить проброс порта. | +| `Служба недоступна` | Маршрутизатор не поддерживает UPnP. | + +После завершения работы сервера Plazma автоматически закроет порт. +{% endtab %} + +{% tab title="Создание временного адреса с помощью Ngrok" %} +Использование Ngrok удобно для кратковременного тестирования, участия или игры с друзьями. + +1. Скачайте ZIP-файл `Windows (64-bit)` с [официального сайта Ngrok](https://ngrok.com/download). +2. Поместите скачанный Ngrok в папку сервера. +3. Создайте [токен аутентификации](https://dashboard.ngrok.com/get-started/your-authtoken) на панели управления Ngrok. +4. Выполните команду, отображаемую в `Command Line` из папки сервера. +5. Добавьте `start /b ngrok tcp --region jp 25565` в верхней части скрипта запуска, и `taskkill /f /t /im ngrok.exe` в нижней части. +6. Из строки `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` возьмите `0.tcp.jp.ngrok.io:12345` как адрес сервера. +7. Теперь вы можете подключиться к серверу с внешнего источника по этому адресу. + {% endtab %} + +{% tab title="Подключение с локального источника" %} +Если вы хотите подключиться к серверу локально, выполните `cmd /k ipconfig` в командной строке для получения `IPv4 адреса` и используйте его для подключения. + +Например, если после выполнения команды у вас отобразится + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Используйте `192.168.3.7`, отображенный как IPv4 адрес, для подключения к серверу локально. + +Если сервер и игра запущены на одном компьютере, вы можете использовать `localhost` для подключения. +{% endtab %} +{% endtabs %} + +## 7. Этап развития + +Если сервер успешно запущен и функционирует правильно, теперь настало время настроить сервер под себя. + +Узнайте, как настроить сервер, следуя данному руководству. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, среда выполнения Java. + +[^2]: Paper, на котором основан Plazma, также основан на Spigot, который в свою очередь является официальной платформой для серверов. + +[^3]: Комбинация клавиш Windows + R + +[^4]: Для Linux используйте `java --version` в терминале + +[^5]: JRE является одним из проектов с открытым исходным кодом и имеет несколько вариантов, подобно платформе Minecraft сервера. + +[^6]: Обычно известен как **запускатель**. + +[^7]: Активируя "Автоматический перезапуск", сервер будет перезапускаться автоматически. Для завершения работы используйте `Control + C`. + +[^8]: Не рекомендуется использовать более половины ресурсов системы. + + Например, если общий объем памяти системы составляет 8 ГБ, не рекомендуется устанавливать больше 4 ГБ. + +[^9]: EULA, Лицензионное соглашение конечного пользователя. Подробнее на [официальном сайте Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорация Microsoft. + +[^11]: В соответствии с Законом о развитии игровой индустрии Республики Корея, статья 32, пункт 9, **Корейская компания Microsoft** вправе предъявить иск в судебном порядке. + +[^12]: Universal Plug & Play. Purpur, входящий в Plazma, автоматически взаимодействует с маршрутизатором через эту технологию, открывая порты только при работе сервера, что устраняет необходимость вручную настраивать проброс портов. + +[^13]: Если у вас нет учетной записи, зарегистрируйтесь в Ngrok через учетную запись Google или GitHub. diff --git a/ru/origin/plazma/adminstration/getting-started/customization.md b/ru/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..80fc57cf5 --- /dev/null +++ b/ru/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, как настроить сервер. +--- + +# 🎨 Настройка пользовательского интерфейса diff --git a/ru/origin/plazma/adminstration/reference/arguments.md b/ru/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..0ea9d4aef --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Изучите начальные аргументы и системные свойства. +--- + +# 🎛️ Аргументы и свойства + +Начальные переменные и системные свойства - это значения, добавляемые к [командам](#user-content-fn-1)[^1], используемым для запуска Plazma, которые позволяют изменять неизменяемые значения после запуска Plazma. + +В зависимости от [места добавления к команде](#user-content-fn-2)[^2], они разделяются на **начальные аргументы** и **системные свойства**. + +*** + +## Системные свойства + +Системные свойства вводятся перед `-jar` и обрабатываются в JVM до инициализации Plazma. + +{% hint style="warning" %} + +### Изменение системных свойств может изменить работу Plazma и JVM, что может сильно повлиять на игру! + +Если вы не уверены, какую роль выполняет каждое системное свойство, **никогда не используйте их!** +{% endhint %} + +### Использование + +Системные свойства вводятся как Java-аргументы между `java` и `-jar`. + +Например, если вы хотите применить системное свойство `Plazma.dummyProperty`,\ +введите следующее, чтобы значение `37` было добавлено к следующему свойству инициализации Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` указывает, что этот аргумент не встроен в JVM, а добавлен в Plazma как специальный аргумент, + +если не указать значение, оно будет [установлено в `true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Платформа сервера Paperweight использует точку в именах свойств для разделения системных свойств для каждой платформы. + +В некоторых терминалах, таких как Windows Powershell, эти аргументы могут не приниматься, поэтому необходимо добавить `"` в начало и конец аргумента. [^4] +{% endhint %} + +### Все системные свойства + +#### `convertLegacySigns` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Обновляет отключенный формат табличек. + +#### `debug.entities` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает отладочные журналы для информации об энтити. + +#### `debug.rewriteForIDE` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает NMS ревизию для правильной загрузки отладочной информации в IDE и автоматической перекомпиляции внутренней версии. + +#### `disable.watchdog` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает систему предупреждений Watchdog в Spigot. + +#### `letMeReload` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает подтверждение команды `/reload`. + +{% hint style="danger" %} + +### Команда `/reload` крайне нестабильна, поэтому все проблемы, возникающие после использования `/reload`, являются вашей ответственностью. + +Если вы разработчик плагина и вам нужно обновить плагин, используйте горячую замену вместо команды `/reload`. +{% endhint %} + +#### `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` + +Отключает систему приоритета классов плагина. + +Это полезно в случае проблем с плагином Shade. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает систему консолидации Netty flush. + +#### `Paper.excessiveTELimit` + +- **Тип**: `Integer` +- **По умолчанию**: `750` + +Разбивает сущности на несколько пакетов для передачи, если их количество больше установленного значения. + +#### `Paper.filterThreshold` + +- **Тип**: `Integer` +- **По умолчанию**: `8192` + +Устанавливает максимальный размер пакета, который сервер может принять за один раз. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Отключает проверку версии Java. + +{% hint style="danger" %} + +### Это позволит JVM попытаться получить доступ к несуществующему коду! + +Это может привести к постоянному повреждению файлов мира и краху механики игры. + +Все проблемы, возникшие при использовании этого, лежат на вас, и Plamza не предоставит никакой поддержки по этому поводу. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Тип**: `Integer` +- **По умолчанию**: `64` + +Устанавливает ограничение на название канала плагина. + +#### `Paper.maxSignLength` + +- **Тип**: `Integer` +- **По умолчанию**: `80` + +Устанавливает максимальную длину строки на табличке. + +#### `Paper.minPrecachedDatafixVersion` + +- **Тип**: `Integer` +- **По умолчанию**: `(версия мира) + 1` + +Устанавливает версию обновления мира, которую нужно предзагрузить. + +Это полезно при необходимости обновить большое количество чанков, но в других случаях не используется. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Boolean` +- **По умолчанию**: `True` + +Включает обработку комментариев в YAML файлах по умолчанию. + +#### `Paper.playerConnection.keepAlive` + +- **Тип**: `Integer` +- **По умолчанию**: `30` + +Когда игрок не отправляет данные в течение указанного времени (в секундах), он будет отключен. + +В обычных случаях игра[^7] продолжает отправлять [сигналы сердцебиения](#user-content-fn-8)[^8] на сервер, поэтому [игрок не будет отключен,](#user-content-fn-9)[^9] но если игра не отвечает, сервер рассматривает это как сбой игры и отключает игрока. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Игнорирует комментарии в свойствах сервера. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает отладочные журналы для синхронной загрузки чанков. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает [стандартную систему записи чанков Minecraft](#user-content-fn-10)[^10]. + +Это приводит к последовательному сохранению каждого чанка, что сильно снижает производительность. + +#### `Paper.explicit-flush` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Включает явную очистку сетевого канала. + +#### `Paper.strict-thread-checks` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Всегда регистрирует ошибки, возникшие не в главном потоке. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +Предупреждает, если запланированная задача имеет слишком большую задержку. + +#### `Paperclip.patchOnly` + +- **Тип**: `Boolean` +- **По умолчанию**: `False` + +При использовании стандартного исполняемого файла применяет только патчи, не запуская сервер. + +#### `Plazma.aggressiveOptimize` + +- **Тип**: `Boolean` +- **По умолчанию**: `false` + +{% hint style="warning" %} + +### Это свойство будет перемещено в начальные аргументы после версии 1.20.5. + +{% endhint %} + +Ужесточает применение начальной оптимизации конфигурации при первом запуске после 1.20.5. + +При активации сервер становится быстрее и безопаснее, но это может заблокировать некоторые механики или сильно повлиять на игровой процесс. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Тип**: `Boolean` +- **По умолчанию**: `false` + +Подавляет предупреждение[^11], появляющееся при инициализации Plazma. + +### Используемое свойство остановлено + +Нижеуказанные системные свойства являются устаревшими. + +#### `timings.bypassMax` + +- **Тип**: `Boolean` +- **По умолчанию**: `false` +- **Устарело**: Timings был полностью удален из Plazma + +Определяет, может ли превышаться максимальное значение, передаваемое в API Timings Aikar. + +Даже если это будет сделано, если не обрабатывается исключение API, будет применено ограничение скорости. + +*** + +## Начальный аргумент + +Начальный аргумент вводится после `-jar *.jar` для инициализации Plazma и обработки вместе с ним. + +### Использование + +Системные свойства вводятся в качестве аргументов программы после `-jar *.jar`. + +Например, если вы хотите применить начальный аргумент `nogui`,\ +введите следующее, и Plazma обработает аргумент `nogui` во время инициализации. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Полный начальный аргумент + +#### `bukkit-settings` + +- **Псевдоним**: `b` +- **По умолчанию**: `bukkit.yml` + +Устанавливает имя и расположение [файла конфигурации Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Псевдоним**: `c` +- **По умолчанию**: `commands.yml` + +Устанавливает имя и расположение [файла конфигурации команд Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Псевдоним**: `c` +- **По умолчанию**: `server.properties` + +Устанавливает имя и расположение [файла свойств сервера](../reference/configurations/property.md). + +#### `demo` + +Запускает сервер в режиме демонстрации. + +#### `eraseCache` + +Удаляет оставшиеся файлы кэша после обновления мира. + +#### `forceUpgrade` + +Принудительно [обновляет](#user-content-fn-12)[^12] мир, игнорируя версию. + +#### `help` + +- **Псевдоним**: `?` + +Выводит полный список аргументов и их описание в Plazma. + +#### `initSettings` + +Создает только файл конфигурации и завершает работу сервера. + +#### `jfrProfile` + +Активирует профилирование JFR. + +#### `max-players` + +- **Псевдонимы**: `s`, `size` +- **По умолчанию**: `(свойства сервера)` + +Устанавливает максимальное количество [игроков](#user-content-fn-14)[^14]. + +#### `nogui` + +Отключает графическую панель интерфейса. + +#### `nojline` + +Отключите JLine и используйте консоль Vanilla. + +#### `online-mode` + +- **Псевдоним**: `o` +- **По умолчанию**: `(свойства сервера)` + +Выберите, следует ли проверять игроков на Mojang-сервере аутентификации. + +**При использовании не Velocity или другого прокси [EULA](../getting-started/README.md#id-5) может быть нарушена.** + +#### `paper-settings` + +- **Псевдоним**: `paper` +- **По умолчанию**: `paper.yml` + +{% hint style="warning" %} + +### Этот аргумент больше не используется после 1.19.4 + +{% endhint %} + +Устанавливает местоположение отключенного файла конфигурации PaperSpigot. + +Используется для переноса существующей конфигурации в новый файл конфигурации, после чего не используется. + +#### `paper-settings-directory` + +- **Псевдоним**: `paper-dir` +- **По умолчанию**: `config` + +Устанавливает имя и расположение папки, где находятся [файлы конфигурации Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Псевдоним**: `plazma-dir` + +Устанавливает имя и расположение папки, где находятся [файлы конфигурации Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Псевдоним**: `p` +- **По умолчанию**: `plugins` + +Устанавливает расположение папки плагинов. + +#### `pufferfish-settings` + +- **Псевдоним**: `pufferfish` +- **По умолчанию**: `pufferfish.yml` + +Устанавливает имя и расположение [файла конфигурации Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Псевдоним**: `purpur` +- **По умолчанию**: `purpur.yml` + +Устанавливает имя и расположение [файла конфигурации Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Запускает сервер в полностью Vanilla режиме (без модификаций). + +#### `server-ip` + +- **Псевдонимы**: `h`, `host` +- **По умолчанию**: `(свойства сервера)` + +Устанавливает имя хоста сервера или [адрес протокола интернета](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Псевдонимы**: `p`, `port` +- **По умолчанию**: `(свойства сервера)` + +Устанавливает порт сервера. + +#### `server-name` + +- **По умолчанию**: `A Plazma Server` + +Устанавливает имя сервера. + +#### `spigot-settings` + +- **Псевдоним**: `S` +- **По умолчанию**: `spigot.yml` + +Устанавливает имя и расположение [файла конфигурации Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Псевдоним**: `v` + +Отображает версию Plazma. + +#### `world-dir` + +- **Псевдонимы**: `W`, `universe`, `world-container` +- **По умолчанию**: `(папка сервера)` + +Устанавливает местоположение, где хранятся файлы мира. + +#### `world-name` + +- **Псевдонимы**: `w`, `world` +- **По умолчанию**: `(свойства сервера)` + +Устанавливает имя файла мира. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Позиция обработки аргументов изменяется в зависимости от добавленного расположения. + +[^3]: Например, если вы хотите установить `Plazma.iKnowWhatIAmDoing` в `true`, просто введите `-DPlazma.iKnowWhatIAmDoing`, вместо `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Например, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Детектор событий. + +[^6]: Детектор событий. + +[^7]: Клиент. + +[^8]: Сигнал, указывающий на успешное соединение с сервером, подобно сердечным сокращениям. + +[^9]: С помощью функции Purpur AFK Kick можно выгнать игроков, покинувших место. + +[^10]: Система синхронной записи чанков, Sync Chunk Write System. + +[^11]: `ВНИМАНИЕ! Plazma может вызвать неожиданные проблемы, поэтому обязательно тщательно протестируйте его перед использованием на публичном сервере.` + +[^12]: В игре `Мировая оптимизация` также работает по тому же принципу. + +[^13]: Протокол интернета, IP. + +[^14]: Администраторы уровня 2 и выше исключаются. diff --git a/ru/origin/plazma/adminstration/reference/commands.md b/ru/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..dc01b2d83 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о доступных командах в Plazma. +--- + +# 🖥️ Команды diff --git a/ru/origin/plazma/adminstration/reference/configurations/bukkit.md b/ru/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e18731d07 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/ru/origin/plazma/adminstration/reference/configurations/paper/README.md b/ru/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..6ab22a1ee --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте назначение каждого файла в папке config. +--- + +# 🛩️ Бумага diff --git a/ru/origin/plazma/adminstration/reference/configurations/paper/global.md b/ru/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..5485f765b --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в paper-global.yml. +--- + +# 🛩️ Бумага (глобальная конфигурация) diff --git a/ru/origin/plazma/adminstration/reference/configurations/paper/world.md b/ru/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..df6636a0b --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в paper-world.yml. +--- + +# 🛩️ Бумага (состав мира) diff --git a/ru/origin/plazma/adminstration/reference/configurations/plazma/README.md b/ru/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..8e40a6a48 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Узнайте назначение каждого файла в папке config. +--- + +# ✨ Плазма diff --git a/ru/origin/plazma/adminstration/reference/configurations/plazma/global.md b/ru/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..070332cf5 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в plazma-global.yml. +--- + +# ✨ Плазма (глобальная конфигурация) diff --git a/ru/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/ru/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..11d6a6768 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Мировая структура diff --git a/ru/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/ru/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..b61ab15ca --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в plazma-world.yml. +--- + +# ✨ Плазма (структура мира) diff --git a/ru/origin/plazma/adminstration/reference/configurations/property.md b/ru/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..c69b2511c --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в server.properties. +--- + +# 🪨 Server.properties diff --git a/ru/origin/plazma/adminstration/reference/configurations/pufferfish.md b/ru/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..9d10495cd --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в pufferfish.yml. +--- + +# 🐡 Кольцеголов diff --git a/ru/origin/plazma/adminstration/reference/configurations/purpur/README.md b/ru/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..f16c91dc9 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в purpur.yml. +--- + +# 🦑 Пурпур diff --git a/ru/origin/plazma/adminstration/reference/configurations/purpur/global.md b/ru/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..01b52404f --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в purpur.yml. +--- + +# 🦑 Пурпур (глобальная структура) diff --git a/ru/origin/plazma/adminstration/reference/configurations/purpur/world.md b/ru/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..98a547468 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Выясните, что означает каждый узел в purpur.yml. +--- + +# 🦑 Пурпур (состав мира) diff --git a/ru/origin/plazma/adminstration/reference/configurations/spigot.md b/ru/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..7c1d5e3ba --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Узнайте, что означает каждый узел в spigot.yml. +--- + +# 🚰 Спигот diff --git a/ru/origin/plazma/adminstration/reference/permissions.md b/ru/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..11b4c56b1 --- /dev/null +++ b/ru/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Узнайте о разрешениях Plazma. +--- + +# 🛡️ Разрешение diff --git a/ru/origin/plazma/developers.md b/ru/origin/plazma/developers.md new file mode 100644 index 000000000..c09a504c9 --- /dev/null +++ b/ru/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Разработайте сторонний проект с использованием Plazma. +--- + +# ⚙️ Руководство для разработчиков diff --git a/ru/origin/thunderbolt/README.md b/ru/origin/thunderbolt/README.md new file mode 100644 index 000000000..47f071053 --- /dev/null +++ b/ru/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt - это платформа на основе Plazma, которая позволяет использовать экспериментальные патчи, разделяя их на Flavor, чтобы пользователи могли использовать их напрямую. +--- + +# 🌩️ Руководство по использованию Thunderbolt diff --git a/ru/origin/volt/README.md b/ru/origin/volt/README.md new file mode 100644 index 000000000..d20af3925 --- /dev/null +++ b/ru/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt - это шаблон с открытым исходным кодом, который позволяет разрабатывать собственную платформу сервера Paperweight на основе Plazma. +--- + +# ⚡ Руководство по разработке Volt diff --git a/sk/origin/README.md b/sk/origin/README.md new file mode 100644 index 000000000..0004b960d --- /dev/null +++ b/sk/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Ak máte otázky, prosím, položte ich cez Discord alebo GitHub Diskusie. +--- + +# 🏠 Vitajte v portáli Docs + +{% hint style="info" %} + +**Dokumentácia k Plazme je momentálne preložená strojovo.** + +[![Stav prekladu](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Zúčastnite sa prekladu dokumentov na [https://translate.plazmamc.org/](https://translate.plazmamc.org/) a pomôžte vylepšiť dokumenty. + +{% endhint %} + +### Ak sa vyskytli problémy počas používania Plazmy? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Ak máte záujem o Thunderbolt, prečítajte si viac. + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Ak chcete vytvoriť vlastnú serverovú platformu pomocou Volta, prečítajte si viac. + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Ak potrebujete viac informácií týkajúcich sa Minecraftu. + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/sk/origin/SUMMARY.md b/sk/origin/SUMMARY.md new file mode 100644 index 000000000..191f62838 --- /dev/null +++ b/sk/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Obsah + +- [🏠 Vítejte v portálu dokumentace](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Dokumentace k použití Plazma](plazma/README.md) +- [❓ Čo je Plazma?](plazma/about/README.md) + - [⬇️ Stiahnuť](plazma/about/downloads.md) + - [✅ Podpora verzií](plazma/about/supported-versions.md) +- [⚒️ Príručka pre správcov serverov](plazma/administration/README.md) + - [👟 Začíname](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referencia](plazma/administration/reference/README.md) + - [🖥️ Príkazy](plazma/administration/reference/commands.md) + - [🛡️ Oprávnenia](plazma/administration/reference/permissions.md) + - [🎛️ Argumenty a vlastnosti](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Vlastnosť](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Globálne nastavenie](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfigurácie podľa sveta](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Globálne nastavenie](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfigurácie podľa sveta](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Globálne nastavenie](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfigurácie podľa sveta](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Pokročilé](plazma/administration/expert/README.md) + - [🧹 Optimalizácia](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanillaizácia](plazma/administration/expert/vanillaize.md) + - [🩻 Blokovanie X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Zraniteľnosť a riešenia](plazma/administration/expert/fix-exploits.md) + - [⁉️ Často kladené otázky](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Vývojárska príručka](plazma/developers.md) + - [✏️ Prispejte](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Sprievodca použitím Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Príručka vývoja Volta](volt/README.md) + +## Rôzne + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Stiahnuť všetko](plazma/about/downloads-all.md) diff --git a/sk/origin/miscellaneous/README.md b/sk/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/sk/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/sk/origin/plazma/README.md b/sk/origin/plazma/README.md new file mode 100644 index 000000000..3c9b9c268 --- /dev/null +++ b/sk/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma je open source serverová platforma pre Minecraft: Java Edition, ktorá pridáva experimentálne optimalizácie založené na papieri a možnosť personalizácie rôznych herných mechanizmov." +--- + +# ✨ Plazma Používateľská príručka + +## 👋 Vitajte v Plazma Príručke + +Vitajte v Plazma Používateľskej príručke! + +{% hint style="info" %} + +**Nie je možné vyriešiť problém cez návod?** + +[Oficiálny Discord server](https://discord.gg/MmfC52K8A8) alebo sa obráťte na komunitu cez [GitHub Diskusie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### O Plazma + +> Zistite viac o platforme Plazma. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Pre Administrátorov + +> Vytvorte si vlastný server pomocou Plazma. + +{% content-ref url="administration/" %} +[administrácia](administration/) +{% endcontent-ref %} + +### Pre Vývojárov + +> Vyskúšajte vyvíjať tretie strany projekty s Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/sk/origin/plazma/about/README.md b/sk/origin/plazma/about/README.md new file mode 100644 index 000000000..a63386887 --- /dev/null +++ b/sk/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Zistite viac o platforme Plazma. +--- + +# ❓ Čo je Plazma? + +- **Plazma** je serverová platforma založená na [Paper](https://github.com/PaperMC/Paper), ktorá získava výhody z [Andromeda](https://github.com/EarendelArchived/Andromeda) a [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Snažíme sa vždy poskytovať vysokú stabilitu a výkonnosť, rýchle aktualizácie a bohaté funkcie. + +## 📋 Ciele Plazmy + +- Snažíme sa o rýchle aktualizácie a vytvorenie serverovej platformy s vysokou stabilitou. +- Snažíme sa poskytnúť bohaté funkcie a výkonnosť, ktorá sa nezaostáva za platformou pre módy. +- Snažíme sa vytvoriť voľnú platformu, ktorá umožňuje prispôsobiť aj patche pre vanilla. + +## ⚙️ Kľúčové vlastnosti + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Najrýchlejšie aktualizácie**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) zabezpečuje, že záplaty v Plazme sú vždy aktuálne, čo z nej robí platformu s najrýchlejšími aktualizáciami medzi serverovými platformami založenými na Paper. +6. **Optimalizované základné konfiguračné súbory**\ + Prednastavené konfiguračné súbory sú optimalizované, takže nie je potrebné ich ďalej upravovať. +7. **Systémové vlákna fungujúce systematicky**\ + Asynchrónne spracovanie systémových mechanizmov mimo herné mechanizmy pomáha optimalizovať server tým, že znižuje [čas oneskorenia](#user-content-fn-4)[^4]. +8. **Blokovanie zbytočného použitia pamäte**\ + Združenie dát s podobnými hodnotami do jedného záznamu znižuje spotrebu pamäte. + +## ✨ Príklady využitia + +- **Platforma správne spracujúca aj zložité zásuvné moduly**\ + Plazma je používaná na serveroch vývojára [IPECTER](https://github.com/IPECTER).\ + Má vlastné zásuvné moduly fungujúce cez NMS a reflexiu, s veľkým množstvom veľkých dátových balíkov,\ + ajak pre viac ako 100 hráčov bez poklesu výkonu. +- **Platforma udržiavajúca rýchly výkon aj na RPG serveroch**\ + Na jednom zhluku udržala 100 hráčov bez poklesu TPS a na 4 zhlukoch mohlo 250 hráčov hrať plynulo. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Mnoho streamerov vybralo platformu**\ + Je to vybrané ako kôš pre divácku účasť mnohých streamerov. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Stiahnuť + +Na nasledujúcej stránke si môžete stiahnuť Plazmu. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Chcete vedieť viac o podporovaných verziách? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Pluginy pre Bukkit, CraftBukkit, Spigot a záplaty pre Paper, Pufferfish, Purpur. + +[^2]: Pod Microsoft Corporation. + +[^3]: Ak deaktivujete systém na hlásenie chatu, chat bude spracovávaný iba na serveri a zabránite sledovaniu chatu od Mojangu. + +[^4]: Čas, počas ktorého systémový mechanizmus funguje a hra je pozastavená. diff --git a/sk/origin/plazma/about/downloads-all.md b/sk/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..f1caa15df --- /dev/null +++ b/sk/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma spustiteľný súbor stiahnuť celý +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Verzia | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/sk/origin/plazma/about/downloads.md b/sk/origin/plazma/about/downloads.md new file mode 100644 index 000000000..74f98ed97 --- /dev/null +++ b/sk/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Stiahnite si teraz Plazmu a vyskúšajte ju sami. +--- + +# ⬇️ Stiahnuť + +#### Chcete vedieť viac o podporovaných verziách? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Nižšie uvedené súbory na stiahnutie sú pre bežného používateľa.** + +Ak ste vývojár a potrebujete iný formát súboru, pozrite si nižšie uvedenú stránku. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VerziaStiahnuť
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Stiahnuť +
1.20.1 + Stiahnuť +
1.19.4 + Stiahnuť +
+ +*** diff --git a/sk/origin/plazma/about/patches-list.md b/sk/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..e03f3707e --- /dev/null +++ b/sk/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o všetkých funkciách pridaných do Plazmy. +--- + +# 📑 Obsiahnuté záplaty diff --git a/sk/origin/plazma/about/supported-versions.md b/sk/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..45bb96177 --- /dev/null +++ b/sk/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Zistite, ktorú verziu Minecraft: Java Edition podporuje Plazma." +--- + +# ✅ Stav podpory verzie + +{% hint style="info" %} + +**Plazma sa vyvíja od verzie 1.19.4 a nižšie verzie ako 1.19.4 nie sú vyvíjané.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: +[atv]: https://badge.plazmamc.org/2/podporovaný +[fse]: https://badge.plazmamc.org/6/podpora%20funkcií%20zastavená +[eol]: https://badge.plazmamc.org/4/podpora%20ukončená +[ukn]: https://badge.plazmamc.org/0/Žiadne%20informácie +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/štandardný +[100]: https://badge.plazmamc.org/percent/100 + +![čaká na uvoľnenie][wtr] ![vo vývoji][idv] ![podporovaný][atv] ![podpora funkcií zastavená][fse] ![podpora ukončená][eol] + +| Verzia | Stabilita a podpora funkcií | Stav zostavenia | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![stav zostavenia](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Stav zostavenia](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Stav zostavenia](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/sk/origin/plazma/administration/README.md b/sk/origin/plazma/administration/README.md new file mode 100644 index 000000000..33d30c1d1 --- /dev/null +++ b/sk/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Vytvorte si vlastný server pomocou Plazma. +--- + +# ⚒️ Sprievodca správou servera diff --git a/sk/origin/plazma/administration/diagnosis/README.md b/sk/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..11be35f5b --- /dev/null +++ b/sk/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, ako sa vyrovnať s problémom, keď k němu dojde. +--- + +# 🧾 진단 diff --git a/sk/origin/plazma/administration/diagnosis/plugins.md b/sk/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..45574840a --- /dev/null +++ b/sk/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Zistite, ako vyriešiť problémy s fungovaním pluginov, keď nefungujú správne. +--- + +# 📜 플러그인 diff --git a/sk/origin/plazma/administration/expert/README.md b/sk/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..dbfd0fc0d --- /dev/null +++ b/sk/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o profesionálnom spôsobe práce s Plazmou. +--- + +# 🎓 Hlbšie diff --git a/sk/origin/plazma/administration/expert/fix-exploits.md b/sk/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..2f4e6e7e4 --- /dev/null +++ b/sk/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o známych zraniteľnostiach a spôsoboch ich riešenia. +--- + +# ⚠️ Známe zraniteľnosti a spôsob ich riešenia diff --git a/sk/origin/plazma/administration/expert/optimize.md b/sk/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..d30824902 --- /dev/null +++ b/sk/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Zistite, ako optimalizovať Plazmu. +--- + +# 🧹 Optimalizácia diff --git a/sk/origin/plazma/administration/expert/proxy.md b/sk/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..b3d63004e --- /dev/null +++ b/sk/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Zistite, ako bezpečne nastaviť platformu „Velocity“ pre proxy. +--- + +# 🔀 Proxy diff --git a/sk/origin/plazma/administration/expert/vanillaize.md b/sk/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..a71afa5b5 --- /dev/null +++ b/sk/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Zistite, ako obnoviť patch Paper a Vanilla. +--- + +# ↩️ Vanillaizovať + +{% hint style="warning" %} + +**Paper neobsahuje možnosti pridania väčšiny záplat na opravu chýb v vanilke.** + +Plazma momentálne vyvíja možnosť deaktivovať takéto opravy chýb. + +Preto je tento sprievodca stále v procese úprav a informácie sa môžu meniť. + +{% endhint %} diff --git a/sk/origin/plazma/administration/expert/xray.md b/sk/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..91924c3e0 --- /dev/null +++ b/sk/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o rôznych vstavaných spôsoboch blokovania röntgenových lúčov. +--- + +# 🩻 Blokovanie röntgenových lúčov diff --git a/sk/origin/plazma/administration/faq.md b/sk/origin/plazma/administration/faq.md new file mode 100644 index 000000000..0e07e00d6 --- /dev/null +++ b/sk/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Zistite odpovede na často kladené otázky. +--- + +# ⁉️ Často kladené otázky + +{% hint style="info" %} + +**Nenašli ste požadovanú odpoveď?** + +[Oficiálny Discord server](https://discord.gg/MmfC52K8A8) alebo sa obráťte na komunitu cez [GitHub Diskusie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma sa nezačína + +Ak sa zobrazí chyba `no main manifest attribute, in plazma-(version).jar`,\ +súbor, ktorý ste stiahli, je vývojovým API súborom a musíte si stiahnuť **Reobf Paperweight** z GitHub stránky. + +Ak chcete získať viac informácií, pozrite si nasledujúcu stránku. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Pri spustení servera sa zobrazuje upozornenie + +Plazma obsahuje niektoré nestabilné zmeny a môže sa vždy chybovať, preto sa pri spustení servera zobrazuje nasledujúce upozornenie. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Toto upozornenie je možné deaktivovať pomocou systémového vlastnosti [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Ak chcete získať viac informácií, pozrite si nasledujúcu stránku. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostupné od verzie 1.20.1 diff --git a/sk/origin/plazma/administration/getting-started/README.md b/sk/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..b2ca351d3 --- /dev/null +++ b/sk/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Zistite, ako vytvoriť server pomocou Plazma. +--- + +# 👟 Začnite + +Pre stabilné používanie Plazma musí systém spĺňať nasledujúce požiadavky. + +| | Minimálne | Odporúčané | +| :-------------: | --------- | ---------- | +| Architektúra | x64 | - | +| RAM | 8GB | 16GB | +| Úložný priestor | 1GB | 8GB | +| JDK | 17 | 21 | + +Na pohodlnú úpravu konfiguračných súborov je dobré nainštalovať editor ako [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Správny výstup" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' nie je interný ani externý príkaz, spustiteľný program alebo +súbor s príkazmi. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Najprv si stiahnite **JDK 21** vo formáte `.msi` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Spustite stiahnuté inštalačné sprievodcu a kliknite na `Ďalej`. +3. **V ľavom strede okna sa zobrazí ponuka, aktivujte `Nastaviť JAVA_HOME premennú`,** potom kliknite na `Ďalej`. +4. Kliknutím na `Inštalovať` dokončite inštaláciu JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Potom spustite nasledujúci príkaz v termináli na inštaláciu JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Stiahnutie Plazmy + +Plazma ponúka rôzne typy spustiteľných súborov. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Zobraziť viac + +Názov spustiteľného súboru je stanovený ako `plazma-(verzia manažéra)-1.20.4-R0.1-SNAPSHOT-(forma mapovania).jar`. + +- **Forma mapovania**\ + Mapovanie je akýsi sprievodca medzi reálnym kódom Minecraftu a znečisteným kódom. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, mapovanie pre Vanilla Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Manažér verzií**\ + Manažér verzií je akýsi sprievodca pre beh servera, ktorý je potrebný na spustenie knižníc a aktualizáciu serverových súborov. + - **Paperclip**\ + Vyvinutý tímom PaperMC pre Paper a ďalšie odvodené platformy, slúži na sťahovanie knižníc a aplikovanie aktualizácií na server. + - **Bundler**\ + Manažér verzií pre vanilla Minecraft. + +
+ +*** + +## 3. Vytvorenie štartovacieho skriptu + +Pre jednoduché spustenie Plazmy a automatické reštartovanie servera musíte vytvoriť [štartovací skript](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Štartovací skript môžete stiahnuť pomocou tlačidla na stiahnutie v ľavom dolnom rohu.\ +**Skontrolujte, či stiahnutý štartovací skript zodpovedá vašej operačnej sústave.** + +*** + +## 4. Upratanie súborov + +Presuňte stiahnutý štartovací skript a Plazmu do nového priečinka. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Spustite štartovací skript. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Súhlas s EULA + +Po prvom spustení štartovacieho skriptu sa v priečinku vytvorí `eula.txt`. + +EULA[^9] je licenčná zmluva, ktorú musíte akceptovať pri používaní služieb [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Pre súhlas s EULA zmeňte v súbore `eula.txt` `eula=false` na `eula=true` a uložte zmeny. + +*** + +## 6. Povolenie externého prístupu (Windows) + +Moderne operačné systémy blokujú externé prístupy pomocou **firewallu** a **routeru**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Ak váš router nepodporuje UPnP, musíte si vyhľadať informácie pre jednotlivé panely routerov. + +Alternatívne môžete vytvoriť dočasnú adresu pomocou [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Overenie potreby port forwardingu + +Zadajte a spustite nasledujúci príkaz do konzoly. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ak výstup je `True`, nie je potrebné nič ďalej, ak je `False`, je potrebné nastaviť port forwarding. + +### 6.2 Pripojenie na server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Adresu na pripojenie na server môžete nájsť [tu](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Potom reštartujte server a Plazma automaticky skúsi nastaviť port forwarding. + +Úspech UPnP záleží na správe zobrazených správ v konzole, kde sa zobrazí `[UPnP] (správa)`. + +| Správa | Význam | +| ----------------------------------- | --------------------------------------------- | +| `Úspešne otvorený port (port)` | Port forwarding úspešný. | +| `Port (port) je už otvorený` | Iná služba používa daný port. | +| `Nepodarilo sa otvoriť port (port)` | Port forwarding zlyhal. | +| `Služba nie je dostupná` | Router nepodporuje UPnP. | + +Po vypnutí servera Plazma automaticky zatvorí port. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Stiahnite si ZIP súbor pre `Windows (64-bit)` z [Ngrok stránky](https://ngrok.com/download). +2. Vložte stiahnutý Ngrok do priečinka so serverom. +3. Na [Ngrok nástenke](https://dashboard.ngrok.com/get-started/your-authtoken) vygenerujte [autentifikačný token](#user-content-fn-13)[^13]. +4. V serverovom priečinku spustite príkazy zobrazené v `Command Line`. +5. Na začiatok spustite príkaz `start /b ngrok tcp --region jp 25565` a na koniec pridajte `taskkill /f /t /im ngrok.exe`. +6. Adresa servera bude `0.tcp.jp.ngrok.io:12345` zobrazená v konzole ako `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`. +7. Teraz môžete pristupovať k adrese zvonka. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Napríklad, po vykonaní príkazu sa zobrazí nasledovné: + +```log +Windows IP Configuration + +Ethernet adapter Ethernet: + + Sufix pre DNS spojenie. . . . . . . : + IPv4 adresa. . . . . . . . . : 192.168.3.7 + Maskovacia podsieť . . . . . . . : 255.255.255.0 + Predvolená brána . . . . . . : 192.168.3.1 + +``` + +Ak sa pokúsite pripojiť cez zobrazenú `192.168.3.7` IPv4 adresu, môžete sa pripojiť k serveru z lokálneho počítača. + +Ak server a hra bežia na rovnakom PC, môžete sa pripojiť cez `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Rastúci + +Ak ste úspešne spustili server a funguje správne, je čas prispôsobiť si server podľa vašich potrieb. + +Zistite, ako prispôsobiť server pomocou nasledujúceho návodu. + +{% content-ref url="dalsi-krok.md" %} +[dalsi-krok.md](dalsi-krok.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, na ktorom je založený Plazma, je založený na Spigot a Spigot je založený na oficiálnej platforme servera. + +[^3]: Klávesová skratka Windows + R + +[^4]: V prípade Linuxu použite v termináli príkaz `java --version` + +[^5]: JRE je jedným z open source projektov a existuje viacero verzií ako napríklad Minecraft server platforma. + +[^6]: Je všeobecne známe ako **spúšťač**. + +[^7]: Ak povolíte „Automatické reštartovanie“, server sa automaticky reštartuje. Môžete ho ukončiť stlačením `Control + C`. + +[^8]: Neprekračujte polovicu systému, nie je to odporúčané. + + Napríklad, keď je celková kapacita pamäte systému 8 GB, nie je odporúčané nastaviť ju na viac ako 4 GB. + +[^9]: Zmluva o licencii koncového používateľa, End-User License Agreement. Pre viac informácií navštívte [domovskú stránku Minecraftu](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Spoločnosť Microsoft Corporation. + +[^11]: V prípade Južnej Kórey je podľa zákona o podpore herného priemyslu § 32 ods. 1 písm. 9 možné podať právne námietky proti spoločnosti **Kórejská spoločnosť Microsoft**. + +[^12]: Universal Plug & Play. Purpur zahrnutý v Plazme komunikuje s routrom automaticky cez túto technológiu a otvára porty len v prípade, že je server spustený, preto nie je potrebné manuálne nastavovať port forwarding. + +[^13]: Ak nemáte účet, zaregistrujte sa na Ngrok cez účet Google alebo GitHub. diff --git a/sk/origin/plazma/administration/getting-started/customization.md b/sk/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..d5b84ba26 --- /dev/null +++ b/sk/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,116 @@ +--- +description: Zistite, ako prispôsobiť server používateľským preferenciám. +--- + +# 🎨 Používateľské nastavenie + +Dôvodom, prečo používame upravenú serverovú platformu ako Plazma namiesto oficiálnej serverovej platformy poskytovanej spoločnosťou Mojang Studios, je možnosť veľmi silnej **personalizácie**. + +Nižšie sú uvedené rôzne spôsoby, ako personalizovať a využívať Plazmu. + +## Úprava konfigurácie + +Najzákladnejším spôsobom, ako personalizovať Plazmu, je úprava konfigurácie. + +Plazma poskytuje silné nastavenia konfigurácie od mechaniky hry po vlastnosti monštrum. + +Pre viac informácií o konfiguráciách v Plazme navštívte nasledujúcu stránku. + +{% content-ref url="../reference/configurations/" %} +[konfigurácie](../reference/configurations/) +{% endcontent-ref %} + +## Použitie pluginov + +{% hint style="success" %} + +**Plazma podporuje všetky základné pluginy Paperu.** + +V prípade pluginov Spigotu od verzie 1.20.5 sa môžu niektoré pluginy nesprávne správať kvôli zmenám v mapovaní Paperu. Avšak väčšina pluginov založených na Papere ako napríklad Paper, Pufferfish a Purpur by mali fungovať aj v Plazme. Ak by sa niektorý plugin nesprávne správal, ide o chybu v Plazme, preto nahláste [prosím](../diagnosis/plugins.md). + +{% endhint %} + +Je to hlavný dôvod, prečo používať Plazmu a zároveň najúčinnejší spôsob, ako prispôsobiť Plazmu pre používateľa. +Silný ekosystém pluginov Plazmy umožňuje jednoduchú personalizáciu servera. + +Existuje niekoľko spôsobov, ako nájsť a stiahnuť pluginy. Niektoré pluginy sú nahrané na verejných úložiskách, zatiaľ čo iné sú nahrané na GitHub alebo na vlastné stránky. + +{% hint style="caution" %} + +**Pluginy majú priamy prístup k systému!** + +Pred použitím pluginov vždy overte ich bezpečnosť pomocou služieb ako VirusTotal alebo stiahnite pluginy z dôveryhodných zdrojov. + +{% endhint %} + +Na stiahnutie pluginov je k dispozícii viacero služieb. Medzi ne patria [SpigotMC Fórum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) a ďalšie služby, ktoré pred zverejnením pluginov prechádzajú kontrolou a zabezpečujú, že sa šíria iba bezpečné pluginy. + +### Aplikácia pluginov + +Ak ste plugin stiahli, je čas ho aplikovať. + +1. Pluginy sú vo formáte `.jar` alebo `Java Executable File`.\ + Niektoré pluginy môžu byť aj v archíve, v takom prípade + rozbaľte archív a ak názov obsahuje `bukkit`, `spigot` alebo `paper`, + použite súbor s príponou `fat`. +2. Stiahnutý súbor vložte do priečinka `plugins` vo vašom serverovom priečinku a (re)štartujte server. +3. Po spustení Plazmy sa na konzole zobrazí nový obsah. + Toto znamená, že Plazma úspešne načítala pluginy. +4. Aj keď Plazma úspešne načíta pluginy, nemusia sa automaticky spustiť. + Pomocou príkazu `/plugins` môžete zistiť, ktoré pluginy sú načítané na serveri. + Ak meno nainštalovaného pluginu nie je červené, ale zelené, znamená to, že plugin bol úspešne načítaný. + +Ak sa plugin nenačíta správne, nájdete riešenia na nasledujúcej stránke. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Použitie Datapackov + +Datapacky sú spôsob, ako prispôsobiť Minecraft podobne ako [Resource Packs](#user-content-fn-1). + +Pomocou Datapackov môžete pridávať nové skupiny bytostí a výzvy do hry a upravovať časť hry. + +{% hint style="caution" %} + +**Datapacky môžu poškodiť svet!** + +Niektoré chybné datapacky môžu poškodiť svet a toto poškodenie je nezvratné. + +Preto sa odporúča zálohovať svet pred aplikáciou Datapackov. + +{% endhint %} + +Datapacky sú dostupné na viacerých službách ako [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) a ďalšie. + +Po stiahnutí Datapacku ho vložte do priečinka `datapacks` vo vašom serverovom priečinku. +Ak priečinok neexistuje, vytvorte ho a pridajte doň Datapack. + +{% hint style="warning" %} + +**Niektoré [Datapacky](#user-content-fn-2) sa môžu pri prvom použití nenačítať správne.** + +V takom prípade sa odporúča server **2-krát** reštartovať. + +{% endhint %} + +Datapacky môžu byť ľahko poškodené pri aktualizácii verzie Minecraftu. + +Najmä ak je Datapack úplne poškodený, môže spôsobiť pád servera, preto je dôležité pred aktualizáciou servera dôkladne testovať. + +{% hint style="info" %} + +**Po spustení servera s príkazom `safeMode` za serverom môžete vypnúť všetky Datapacky a znova spustiť server.** + +[Pre viac informácií pozrite `Referencie > Argumenty`.](../reference/arguments.md) + +{% endhint %} + +Nainštalované Datapacky môžete overiť príkazom `/datapack list`. + +*** + +[^1]: Alebo pomocou prídavného softvéru pre Minecraft: Bedrock Edition. + +[^2]: Pridanie nových skupín bytostí a podobne. diff --git a/sk/origin/plazma/administration/getting-started/next-step.md b/sk/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..d4e15c03f --- /dev/null +++ b/sk/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Zistite, ako prispôsobiť server používateľským preferenciám. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Nižšie sú uvedené rôzne spôsoby, ako personalizovať a využívať Plazmu. + +## Úprava konfigurácie + +Najzákladnejším spôsobom, ako personalizovať Plazmu, je úprava konfigurácie. + +Plazma poskytuje silné nastavenia konfigurácie od mechaniky hry po vlastnosti monštrum. + +Pre viac informácií o konfiguráciách v Plazme navštívte nasledujúcu stránku. + +{% content-ref url="../reference/configurations/" %} +[konfigurácie](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Použitie pluginov + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Je to hlavný dôvod, prečo používať Plazmu a zároveň najúčinnejší spôsob, ako prispôsobiť Plazmu pre používateľa. Silný ekosystém pluginov Plazmy umožňuje jednoduchú personalizáciu servera. + +Existuje niekoľko spôsobov, ako nájsť a stiahnuť pluginy. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Na stiahnutie pluginov je k dispozícii viacero služieb. Medzi ne patria [SpigotMC Fórum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) a ďalšie služby, ktoré pred zverejnením pluginov prechádzajú kontrolou a zabezpečujú, že sa šíria iba bezpečné pluginy. + +### Aplikácia pluginov + +Ak ste plugin stiahli, je čas ho aplikovať. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Stiahnutý súbor vložte do priečinka `plugins` vo vašom serverovom priečinku a (re)štartujte server. +3. Po spustení Plazmy sa na konzole zobrazí nový obsah. Toto znamená, že Plazma úspešne načítala pluginy. +4. Aj keď Plazma úspešne načíta pluginy, nemusia sa automaticky spustiť. Pomocou príkazu `/plugins` môžete zistiť, ktoré pluginy sú načítané na serveri. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Ak sa plugin nenačíta správne, nájdete riešenia na nasledujúcej stránke. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Použitie Datapackov + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Pomocou Datapackov môžete pridávať nové skupiny bytostí a výzvy do hry a upravovať časť hry. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Niektoré chybné datapacky môžu poškodiť svet a toto poškodenie je nezvratné. + +Preto sa odporúča zálohovať svet pred aplikáciou Datapackov. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Po stiahnutí Datapacku ho vložte do priečinka `datapacks` vo vašom serverovom priečinku. Ak priečinok neexistuje, vytvorte ho a pridajte doň Datapack. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +V takom prípade sa odporúča server **2-krát** reštartovať. +{% endhint %} + +Datapacky môžu byť ľahko poškodené pri aktualizácii verzie Minecraftu. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Nainštalované Datapacky môžete overiť príkazom `/datapack list`. + +*** + +## Optimalizácia + +V Plazme bolo aplikovaných veľa optimalizačných záplat. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Pre informácie o bezpečnom a správnom nastavení proxy navštívte nasledujúcu stránku. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Bezpečnosť + +V Minecraftu je možné ľahko získať [engine na útok zraniteľnosti](#user-content-fn-3)[^3] aj online, pretože modifikácie sú rozvinuté. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Nastavenie oprávnení + +V niektorých prípadoch môžu existovať zraniteľnosti, ak nie sú správne nastavené oprávnenia pre administrátorské príkazy pluginov. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Blokovanie X-Ray + +X-Ray je jednou z ľahko dostupných zraniteľností, ktoré možno používať aj v základnom optimalizačnom klientovi. + +Plazma poskytuje konfiguráciu na blokovanie X-Ray. + +Pre informácie o spôsobe a popise blokovania X-Ray navštívte nasledujúcu stránku. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Whitelist + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Na zobrazenie hráčov, ktorým je povolený prístup, použite `/whitelist query`. + +*** + +[^1]: Alebo pomocou prídavného softvéru pre Minecraft: Bedrock Edition. + +[^2]: Pridanie nových skupín bytostí a podobne. + +[^3]: Všeobecne sú nazývané "hacky". + +[^4]: V prípade neoptimalizovanej konfigurácie, starého Plazmu alebo nových objavených zraniteľností môže byť blokovanie nefunkčné. + +[^5]: Hráči sa pripájajú na server cez Ngrok proxy server a každý reštart generuje novú adresu Ngrok. diff --git a/sk/origin/plazma/administration/reference/README.md b/sk/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..0347c1934 --- /dev/null +++ b/sk/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Zistite, ako používať základné možnosti prispôsobenia v Plazme. +--- + +# 📜 리퍼런스 + +V Plazme je k dispozícii niekoľko spôsobov prispôsobenia. + +Z týchto možností je 4 spôsoby prispôsobenia, ktoré môžete použiť priamo bez ďalších úprav. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Oficiálny Discord server](https://discord.gg/MmfC52K8A8) alebo sa obráťte na komunitu cez [GitHub Diskusie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Príkazy + +> Príkazy umožňujú zbierať informácie vo vnútri hry alebo prispôsobiť herné prostredie. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Oprávnenia + +> Oprávnenia určujú rozsah interakcie hráčov. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumenty a vlastnosti + +> Argumenty a vlastnosti ovplyvňujú celkový chod Plazmy. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigurácia + +> Konfigurácia je základným spôsobom prispôsobenia Plazmy. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/sk/origin/plazma/administration/reference/arguments.md b/sk/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..3b084008f --- /dev/null +++ b/sk/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Zistite viac o počiatočných argumentoch a systémových vlastnostiach. +--- + +# 🎛️ Argumenty a vlastnosti + +Začiatočné argumenty a vlastnosti systému predstavujú hodnoty, ktoré sa pridávajú k [príkazom používaným na spustenie Plazmy](#user-content-fn-1)[^1], čo celkovo ovplyvňuje fungovanie Plazmy. + +[Pozícia pridania príkazu](#user-content-fn-2)[^2] rozdeľuje **štartový argument** a **vlastnosti systému**. + +*** + +## Systémová vlastnosť + +Systémová vlastnosť je hodnota spracovaná v JVM pred inicializáciou Plazmy pred `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Použitie + +Systémová vlastnosť sa zadáva ako Java argument medzi `java` a `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` označuje, že tento argument nie je vstavaný do JVM, ale je špecifický pre Plazmu a + +Ak nezadáte žiadnu hodnotu do vlastnosti, hodnota sa nastaví na [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Všetky systémové vlastnosti + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktualizuje zastaraný formát tabúľ. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o entitách. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje NMS revíziu pre IDE na správne načítanie debugovacích informácií a automatický remapovanie vnútorných verzií. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje systém upozornení Watchdog v Spigote. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje potvrdenie príkazu `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Ak ste vývojár pluginov a musíte aktualizovať pluginy, použite hotswap namiesto príkazu `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje pluginy, ktoré používajú štandardný výstup a vstup. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Upozorní pri detekcii zastaraného formátovania v chatových komponentoch. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje overovanie vzoru servera pri pripájaní hráča. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o chýbajúcich kľúčoch v NBT objektoch. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o neplatných profiloch lebiek. + +Toto zaznamenáva všetky neplatné lebky v svete spolu s ich polohou. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje triedny prioritizačný systém pluginov. + +Užitočné pri problémoch so zatienením pluginov. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje systém zlučovania Netty flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Predvolená hodnota**: `750` + +Ak entita presiahne stanovenú hodnotu, bude odoslaná ako viacero paketov. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Predvolená hodnota**: `8192` + +Nastavuje maximálnu veľkosť paketu, ktorú server môže prijať naraz. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje kontrolu verzie Javy. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Môže to trvalo poškodiť súbory v hre a spôsobiť zlyhanie hry. + +Všetky problémy spôsobené týmto opatrením sú plne zodpovednosťou používateľa a Plazma neposkytuje žiadnu podporu! +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Predvolená hodnota**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Predvolená hodnota**: `80` + +Nastavuje maximálnu dĺžku textu na jednom riadku tabule. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Predvolená hodnota**: `(verzia sveta) + 1` + +Nastavuje verziu údajov, ktoré sa majú najskôr aktualizovať pri inicializácii sveta. + +Užitočné pri hromadnom aktualizovaní blokov, inak sa nepoužíva. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `True` + +Aktivuje spracovanie komentárov v YAML súboroch. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Predvolená hodnota**: `30` + +Ak hráč neodosielal žiadne dáta počas určeného času (v sekundách), hráča vyhodí zo servera. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Ignoruje komentáre vlastností servera. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o synchronizovaní chunkov. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje [štandardný systém zápisu chunkov](#user-content-fn-10)[^10] v Minecrafte. + +Tento systém ukladá každý chunk postupne, čo spôsobuje veľký výkonový pokles. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje Explicit Flushing v sieťovom kanáli. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Vždy zaznamenáva chyby, ktoré nevznikli v hlavnom vlákne. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Ak sú naplánované úlohy príliš dlho čakajú, vypíše sa varovanie. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Ak sa používa predvolený spustiteľný súbor, aplikuje sa iba záplatovanie bez spustenia servera. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +Posilňuje optimalizáciu počiatočnej konfigurácie. + +Jeho aktivácia spôsobuje, že server sa stáva rýchlejším a bezpečnejším, no môže mať výrazný vplyv na hrateľnosť hry. + +#### `Plazma.disableConfigOptimization` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` +- **Konflikt**: `Plazma.aggressiveOptimize` + +Neoptimalizuje počiatočnú konfiguráciu. + +Toto nastavenie používa predvolenú konfiguráciu Paperu. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` + +Deaktivuje značenie Plazma a používa základný serverový ikonu. + +#### `Plazma.useVanillaConfiguration` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Toto môže mať veľký vplyv na bezpečnosť a výkon servera. + +Všetky problémy, ktoré spôsobí použitie tejto vlastnosti sú zodpovednosťou správcu servera. +{% endhint %} + +Poskytuje počiatočnú konfiguráciu s predvolenými hodnotami od Mojangu. + +Toto deaktivuje všetky záplaty na chyby, ktoré boli aplikované v Paperi. + +Chybové opravy môžu byť opäť aktivované v Paper konfigurácii alebo Plazma konfigurácii. + +#### `Plazma.vanillaize` + +- **Typ**: `Boolean` +- **Predvolené nastavenie**: `true` +- **Konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Nastavuje počiatočnú konfiguráciu približne k základným hodnotám. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Použitá zastaraná vlastnosť + +Nižšie uvedené systémové vlastnosti sú zastarané. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` +- **OBSOLETE**: Po odstránení Timings z Plazma + +Rozhoduje, či môže byť prekročená maximálna hodnota, ktorá sa môže posielať do Aikarho Timings API. + +Ak nie je v API spracovaná výnimka, aplikuje sa obmedzenie rýchlosti. + +*** + +## Argument štartu + +Argument štartu je hodnota, ktorá sa zadáva za `-jar *.jar` a inicializuje sa spolu s Plazmou. + +### Spôsob použitia + +Systémové vlastnosti sa zadávajú ako programové argumenty za `-jar *.jar`. + +Napríklad, ak chcete použiť argument štartu `nogui`,\ +plazma bude tento argument spracovávať počas inicializácie nasledovne: + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Celkový argument štartu + +#### `bukkit-settings` + +- **Alias**: `b` +- **Predvolená hodnota**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Predvolená hodnota**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Predvolená hodnota**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Spustí server v demo svete. + +#### `eraseCache` + +Odstráni zostávajúce cache súbory po aktualizácii sveta. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Zobrazí všetky argumenty štartu a ich popis v Plazme. + +#### `initSettings` + +Vytvorí len konfiguračné súbory a vypne server. + +#### `jfrProfile` + +Aktivuje JFR profilovanie. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Predvolená hodnota**: `(vlastnosť servera)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Vypne grafický rozhranie Plazmy. + +#### `nojline` + +Vypne JLine a použije základnú konzolu. + +#### `online-mode` + +- **Alias**: `o` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Určuje, či sa majú hráči overovať prostredníctvom Mojang autentizačných serverov. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Predvolená hodnota**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Nastavuje umiestnenie [konfiguračného súboru PaperSpigot](../reference/configurations/paper/README.md), ktorý bol zastavený. + +Slúži na prenesenie existujúcej konfigurácie do nového súboru a následne sa nepoužíva. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Predvolená hodnota**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Predvolená hodnota**: `plugins` + +Nastavuje umiestnenie priečinka s pluginmi. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Predvolená hodnota**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Predvolená hodnota**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Spustí server v úplnom vanilla režime. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Predvolená hodnota**: `(vlastnosť servera)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Nastavuje port servera. + +#### `server-name` + +- **Predvolená hodnota**: `A Plazma Server` + +Nastavuje názov servera. + +#### `spigot-settings` + +- **Alias**: `S` +- **Predvolená hodnota**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Vypíše verziu Plazmy. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Predvolená hodnota**: `(priečinok servera)` + +Nastavuje umiestnenie súborov sveta. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Nastavuje názov súboru sveta. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Podľa umiestnenia pridaných argumentov sa mení miesto, kde sa argumenty spracovávajú. + +[^3]: Napríklad, ak chcete nastaviť `Plazma.iKnowWhatIAmDoing` na `true`, môžete namiesto `-DPlazma.iKnowWhatIAmDoing=true` použiť len `-DPlazma.iKnowWhatIAmDoing` a stále to bude fungovať. + +[^4]: Napríklad, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor udalostí. + +[^6]: Detektor udalostí. + +[^7]: Klient. + +[^8]: Signál signalizujúci, že je server správne pripojený, podobne ako srdcový rytmus. + +[^9]: Použitím funkcie AFK vyhadzovania v Purpure môžete vyhadzovať aj hráčov, ktorí sú neprítomní. + +[^10]: Systém zápisu synchronizovaných blokov, Sync Chunk Write System. + +[^11]: `VAROVANIE! Plazma môže spôsobiť neočakávané problémy, preto sa uistite, že ju dôkladne otestujete pred použitím na verejnom serveri.` + +[^12]: V hre `svetová optimalizácia` funguje rovnakým spôsobom. + +[^13]: `Úroveň 2` alebo vyšší administrátori sú vylúčení. + +[^14]: Internetový protokol, IP. diff --git a/sk/origin/plazma/administration/reference/commands.md b/sk/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..5c338a4d8 --- /dev/null +++ b/sk/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Zistite dostupné príkazy v aplikácii Plazma. +--- + +# 🖥️ Príkazy diff --git a/sk/origin/plazma/administration/reference/configurations/README.md b/sk/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..bcbe773db --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigurácia je základným spôsobom prispôsobenia Plazmy. +--- + +# 🧾 구성 + +*** + +## 🪨 Vlastnosti + +> Vlastnosti sú základným konfiguračným súborom poskytovaným v hre Minecraft. Pomocou vlastností môžete zmeniť základné mechanizmy hry. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Konfigurácia + +> Bukkit Konfigurácia je základným konfiguračným súborom poskytovaným v Plazme. Pomocou Bukkit Konfigurácie môžete zmeniť základné mechanizmy Minecraft servera. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Konfigurácia + +> Spigot Konfigurácia umožňuje upravovať detailné mechanizmy hry, spracovanie hráčov, fungovanie príkazov a správy. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Konfigurácia + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish Konfigurácia umožňuje zmeniť spracovanie svetov a entít v Plazme. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Konfigurácia + +> Purpur Vlastnosti umožňujú upravovať základné údaje hry. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Konfigurácia + +> Plazma Konfigurácia umožňuje prispôsobiť funkcie Plazmy. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/sk/origin/plazma/administration/reference/configurations/bukkit.md b/sk/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..3352e1046 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/sk/origin/plazma/administration/reference/configurations/paper/README.md b/sk/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..41e980037 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, na čo slúži každý súbor v priečinku config. +--- + +# 🛩️ Papier diff --git a/sk/origin/plazma/administration/reference/configurations/paper/global.md b/sk/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..edb19368d --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Skontrolujte, čo znamená každý uzol v paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/sk/origin/plazma/administration/reference/configurations/paper/world.md b/sk/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..2ef57d381 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Zistite, čo znamená každý uzol v súbore paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +svetový diff --git a/sk/origin/plazma/administration/reference/configurations/plazma/README.md b/sk/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e2773fc41 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, na čo slúži každý súbor v priečinku config. +--- + +# ✨ Plazma diff --git a/sk/origin/plazma/administration/reference/configurations/plazma/global.md b/sk/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..8e6ab100a --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v súbore plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/sk/origin/plazma/administration/reference/configurations/plazma/world.md b/sk/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..7036db1a7 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/sk/origin/plazma/administration/reference/configurations/plazma/worlds.md b/sk/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a500b9378 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v plazma-world.yml. +--- + +# ✨ Plazma (zloženie sveta) diff --git a/sk/origin/plazma/administration/reference/configurations/property.md b/sk/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..1250c7ee0 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol server.properties. +--- + +# 🪨 Server.properties diff --git a/sk/origin/plazma/administration/reference/configurations/pufferfish.md b/sk/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..782f068e6 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/sk/origin/plazma/administration/reference/configurations/purpur/README.md b/sk/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..c97eae1b3 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v purpur.yml. +--- + +# 🦑 Purpur diff --git a/sk/origin/plazma/administration/reference/configurations/purpur/global.md b/sk/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..92e56e381 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/sk/origin/plazma/administration/reference/configurations/purpur/world.md b/sk/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..113f00ac0 --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/sk/origin/plazma/administration/reference/configurations/spigot.md b/sk/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..427a378fc --- /dev/null +++ b/sk/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v spigot.yml. +--- + +# 🚰 Spigot diff --git a/sk/origin/plazma/administration/reference/permissions.md b/sk/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..d32c81792 --- /dev/null +++ b/sk/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Zistite viac o oprávneniach aplikácie Plazma. +--- + +# 🛡️ Oprávnenia + +Oprávnenie je jednoduchý bezpečnostný nástroj na nastavenie rozsahu interakcie hráčov na serveri. + +Na správne využívanie oprávnení a jednoduchú úpravu je potrebné použiť pluginy ako [LuckPerms](https://luckperms.net). + +*** + +## Porozumenie základnému systému oprávnení + +V Minecrafte sú k dispozícii základné správcovské skupiny oprávnení. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Hráč**\ + Je to skupina oprávnení, ktorá je bežne pridelená každému hráčovi. +2. **Mediátor**\ + Môže ignorovať ochranu spawnu. +3. **Správca sveta**\ + Môže používať všetky príkazy a príkazové bloky súvisiace so správou sveta.\ + Je to základná skupina oprávnení, ktorá sa automaticky aplikuje na datapacky a príkazové bloky. +4. **Administrátor**\ + Môže používať všetky príkazy súvisiace s riadením hráčov. +5. **Hlavný administrátor**\ + Môže používať všetky príkazy vrátane správy servera.\ + Je to základná skupina oprávnení, ktorá sa automaticky aplikuje na konzolu a administrátorov. + +*** + +## Nastavenie oprávnení + +*** + +## Celkové oprávnenia + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Predvolené**: `None` + +Umožňuje hráčovi sedieť na entite a interagovať s ňou skrčením. + +Keď hráč sedí na entite, môže ju ovládať pohybom klávesnice a skákať alebo lietať stlačením skoku. + +V `(Namespaced Key)` sa zapisuje [Namespaced ID](#user-content-fn-2)[^2] entity. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Predvolené**: `None` + +Umožňuje hráčovi používať špeciálne schopnosti entity, na ktorej sedí. + +Nie všetky entity majú dostupné špeciálne schopnosti. Pre zoznam všetkých dostupných špeciálnych schopností sa pozrite nižšie. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Zdieľajte svoje nápady na [Plazma Discord](https://plazmamc.org/discord) alebo [GitHub Diskusie](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Prezrite si aktuálne dostupné špeciálne schopnosti + +- **`crepper`**\ + Pri stlačení klávesu skoku exploduje.\ + Ak hráč má oprávnenie `allow.powered.creeper`, môže držaním klávesu skoku nabíjať výbuch. +- **`dolphin`**\ + Pri stlačení klávesu skoku pláva rýchlejšie. +- **`phantom`**\ + Pri stlačení klávesu skoku vystreľuje plamene. +- **`wither`**\ + Pri interakcii vystreľuje hlavy withera. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/compass` príkaz](commands.md#compass). + +#### `bukkit.command.credits` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/credits (Hráč)` príkaz](commands.md#credits). + +Ak zadáte za názvom oprávnenia `.other`, môže ho používať aj iný hráč. + +#### `bukkit.command.demo` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/demo (Hráč)` príkaz](commands.md#demo). + +Ak zadáte za názvom oprávnenia `.other`, môže ho používať aj iný hráč. + +#### `bukkit.command.ping` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/ping (Hráč)` príkaz](commands.md#ping). + +Ak zadáte za názvom oprávnenia `.other`, môže ho používať aj iný hráč. + +#### `bukkit.command.ram` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/ram` príkaz](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/rambar (Hráč)` príkaz](commands.md#rambar). + +Ak zadáte za názvom oprávnenia `.other`, môže ho používať aj iný hráč. + +#### `bukkit.command.restart` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/restart` príkaz](commands.md#restart). + +#### `bukkit.command.tps` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/tps` príkaz](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/tpsbar (Hráč)` príkaz](commands.md#tpsbar). + +Ak zadáte za názvom oprávnenia `.other`, môže ho používať aj iný hráč. + +#### `bukkit.command.timings` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/timings` príkaz](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Pre podobné príkazy sa pozrite na [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/uptime` príkaz](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Predvolené**: `Správca sveta` + +Umožňuje používať [`/gamemode (GameMode) (Hráč)` príkaz](commands.md#gamemode). + +Ak zadáte za názvom oprávnenia `.other`, môže ho používať aj iný hráč. + +#### `paper.antixray.bypass` + +- **Predvolené**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Týmto sa zlepší výkon pre obidve strany. + +> Pre informácie o nastavení X-Ray pozrite nižšie uvedenú stránku. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Predvolené**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Predvolené**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Predvolené**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Predvolené**: `None` + +Umožňuje používať [MiniMessage značky](https://docs.advntr.dev/minimessage/format.html) na kovadle. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Predvolené**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Predvolené**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Predvolené**: `None` + +Vylučuje hráčov z vypnutia pri nečinnosti. + +#### `purpur.debug.f3n` + +- **Predvolené**: `Správca sveta` + +Umožňuje hráčovi zmeniť herný režim klávesami `F3 + N`. + +Funguje len ak má príslušné oprávnenie pre daný herný režim. + +#### `purpur.drop.spawners` + +- **Predvolené**: `None` + +Pri ťažení bloku spawnu s nastaveným predmetom ho hráč vyhadzuje. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Predvolené**: `None` + +Mení veľkosť ender bedne. + +V `(NumberString)` je možné zadať `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Predvolené**: `None` + +Umožňuje fungovanie totemu neumierania aj v prípade, že je v inventári. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Predvolené**: `None` + +Umožňuje hráčovi ignorovať obmedzenie počtu pripojených používateľov. + +#### `purpur.mending_shift_click` + +- **Predvolené**: `None` + +Umožňuje hráčovi opraviť predmet, ktorý drží, keď `kľakne a interaguje`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Predvolené**: `None` + +Umožňuje hráčovi inštalovať spawnery. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Predvolené**: `None` + +Umožňuje hráčovi okamžite sa presunúť pri použití Nether portálu. + +#### `purpur.sign.color` + +- **Predvolené**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Predvolené**: `None` + +Povoliť použitie kódu znečitateľnosti `(&o)` na značkách. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Predvolené**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Predvolené**: `None` + +Povoliť hráčovi zabrániť výbuchu TNT pomocou `interakcie` so špongiou. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Plánované oprávnenia + +#### `plazma.bypass.ncr-require` + +- **Predvolené**: `None` + +Povoliť hráčovi pripojiť sa aj keď nemá nainštalovaný mód [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operátor. + +[^2]: Napr.: `ender_dragon` diff --git a/sk/origin/plazma/adminstration/README.md b/sk/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..33d30c1d1 --- /dev/null +++ b/sk/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Vytvorte si vlastný server pomocou Plazma. +--- + +# ⚒️ Sprievodca správou servera diff --git a/sk/origin/plazma/adminstration/expert/README.md b/sk/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..dbfd0fc0d --- /dev/null +++ b/sk/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o profesionálnom spôsobe práce s Plazmou. +--- + +# 🎓 Hlbšie diff --git a/sk/origin/plazma/adminstration/expert/fix-exploits.md b/sk/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..2f4e6e7e4 --- /dev/null +++ b/sk/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o známych zraniteľnostiach a spôsoboch ich riešenia. +--- + +# ⚠️ Známe zraniteľnosti a spôsob ich riešenia diff --git a/sk/origin/plazma/adminstration/expert/optimize.md b/sk/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..d30824902 --- /dev/null +++ b/sk/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Zistite, ako optimalizovať Plazmu. +--- + +# 🧹 Optimalizácia diff --git a/sk/origin/plazma/adminstration/expert/vanillaize.md b/sk/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..f6f4ca4da --- /dev/null +++ b/sk/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Zistite, ako obnoviť patch Paper a Vanilla. +--- + +# ↩️ Vanillaizovať + +{% hint style="warning" %} + +### Paper neponúka možnosti väčšiny opráv chýb v Vanilla. + +Plazma momentálne vyvíja možnosť deaktivovať takéto opravy chýb. + +Preto je tento sprievodca stále v procese úprav a informácie sa môžu meniť. +{% endhint %} diff --git a/sk/origin/plazma/adminstration/faq.md b/sk/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..115c6c088 --- /dev/null +++ b/sk/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Zistite odpovede na často kladené otázky. +--- + +# ⁉️ Často kladené otázky + +{% hint style="info" %} + +### Nenašli ste požadovanú odpoveď? + +Skúste sa obrátiť na komunitu cez [Oficiálny Discord server](https://discord.gg/MmfC52K8A8) alebo [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Problém s vykonaním a zobrazením správy + +Ak sa zobrazí chyba `no main manifest attribute, in plazma-(version).jar`,\ +súbor, ktorý ste stiahli, je vývojovým API súborom a musíte si stiahnuť **Reobf Paperweight** z GitHub stránky. + +Ak chcete získať viac informácií, pozrite si nasledujúcu stránku. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Pri spustení servera sa zobrazuje upozornenie + +Plazma obsahuje niektoré nestabilné zmeny a môže sa vždy chybovať, preto sa pri spustení servera zobrazuje nasledujúce upozornenie. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Toto upozornenie je možné deaktivovať pomocou systémového vlastnosti [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Ak chcete získať viac informácií, pozrite si nasledujúcu stránku. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Dostupné od verzie 1.20.1 diff --git a/sk/origin/plazma/adminstration/getting-started/README.md b/sk/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..c973cab61 --- /dev/null +++ b/sk/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Zistite, ako vytvoriť server pomocou Plazma. +--- + +# 👟 Začnite + +Pre stabilné používanie Plazma musí systém spĺňať nasledujúce požiadavky. + +| | Minimálne | Odporúčané | +| :-------------: | --------: | ---------: | +| Architektúra | x64 | - | +| RAM | 8GB | 16GB | +| Úložný priestor | 1GB | 8GB | +| JRE | 17 | 21 | + +Na pohodlnú úpravu konfiguračných súborov je dobré nainštalovať editor ako [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Inštalácia JRE + +Ako názov napovedá, Minecraft: **"Java"** Edition je vyvíjaná v Jave a na jej spustenie je potrebný JRE[^1]. + +Plazma je oficiálna serverová platforma od Mojang Studios [založená na](#user-content-fn-2)[^2], preto aj pre použitie Plazma je potrebná inštalácia JRE. + +### 1.1 Overenie JRE + +Ak chcete overiť prítomnosť JRE v systéme, zadajte v [spustiteľnom okne](#user-content-fn-3)[^3] príkaz [`cmd /k java --version`](#user-content-fn-4)[^4] a spustite ho. + +Ak sa zobrazí správny výstup, prejdite na [2. krok](setup.md#id-2). + +{% code title="Správny výstup" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Ak sa výstup nezhoduje s vyššie uvedeným, alebo sa zobrazí nasledovné, znamená to, že JRE chýba alebo je príliš starý a je potrebné vykonať [1.2 krok](setup.md#id-1.2). + +{% code title="JRE nie je nainštalovaná" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE je príliš starý" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Inštalácia JRE + +V tomto sprievodcovi používame Azul Zulu ako [jednu z možností](#user-content-fn-5)[^5] pre JRE. + +Po inštalácii skontrolujte, či bola inštalácia úspešne dokončená, opakovane vykonajte [krok 1.1](setup.md#id-1.1). + +{% tabs %} +{% tab title="Windows" %} + +1. Najprv si stiahnite **JDK 21** vo formáte `.msi` z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Spustite stiahnuté inštalačné sprievodcu a kliknite na `Ďalej`. +3. **V ľavom strede okna sa zobrazí ponuka, aktivujte `Nastaviť JAVA_HOME premennú`,** potom kliknite na `Ďalej`. +4. Kliknutím na `Inštalovať` dokončite inštaláciu JRE. + {% endtab %} + +{% tab title="macOS" %} +Stiahnite si **JDK 21** vo formáte `.dmg` a nainštalujte JRE pomocou inštalačného sprievodcu z [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu). +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Najprv spustite nasledujúci príkaz v termináli na pridanie Azul Zulu repozitára do APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Potom spustite nasledujúci príkaz v termináli na inštaláciu JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Môžete nainštalovať JRE pomocou nasledujúceho príkazu. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Stiahnutie Plazmy + +Plazma ponúka rôzne typy spustiteľných súborov. + +{% hint style="warning" %} + +### Väčšinou sa používa `Reobf Paperclip`. + +Informácie nižšie sú určené pre vývojárov alebo tých, ktorí sa zaujímajú o jednotlivé typy.\ +Pre bežného používateľa nie je potrebné sa zaoberať [krokom 3](setup.md#id-3). +{% endhint %} + +
+ +Zobraziť viac + +Názov spustiteľného súboru je stanovený ako `plazma-(verzia manažéra)-1.20.4-R0.1-SNAPSHOT-(forma mapovania).jar`. + +- **Forma mapovania**\ + Mapovanie je akýsi sprievodca medzi reálnym kódom Minecraftu a znečisteným kódom. + - **Reobf**\ + Reobfuskácia, známa aj ako Spigot mapovanie, sa používa vo väčšine NMS pluginov.\ + Od verzie 1.20.5 sa prestane používať. + - **Mojmap**\ + Mojang mapovanie, vanilla Minecraft mapovanie. +- **Manažér verzií**\ + Manažér verzií je akýsi sprievodca pre beh servera, ktorý je potrebný na spustenie knižníc a aktualizáciu serverových súborov. + - **Paperclip**\ + Vyvinutý tímom PaperMC pre Paper a ďalšie odvodené platformy, slúži na sťahovanie knižníc a aplikovanie aktualizácií na server. + - **Bundler**\ + Manažér verzií pre vanilla Minecraft. + +
+ +*** + +## 3. Vytvorenie štartovacieho skriptu + +Pre jednoduché spustenie Plazmy a automatické reštartovanie servera musíte vytvoriť [štartovací skript](#user-content-fn-6)[^6]. + +Pomocou [Flags.sh](https://flags.sh) môžete [vytvoriť štartovací skript.](#user-content-fn-7)[^7]\ +Pri zadávaní pamäte pre Plazmu [(^8)](#user-content-fn-8)[^8] sa príkaz automaticky optimalizuje. + +Štartovací skript môžete stiahnuť pomocou tlačidla na stiahnutie v ľavom dolnom rohu.\ +**Skontrolujte, či stiahnutý štartovací skript zodpovedá vašej operačnej sústave.** + +*** + +## 4. Upratanie súborov + +Presuňte stiahnutý štartovací skript a Plazmu do nového priečinka. + +{% hint style="warning" %} + +### Názov priečinka musí byť bez medzier a nastavený v angličtine. + +Inak by Plazma alebo JRE mohli nesprávne fungovať. +{% endhint %} + +Spustite štartovací skript. V prípade Windows, pri výbere povolení firewallu, je nutné vybrať **Povoliť**. + +*** + +## 5. Súhlas s EULA + +Po prvom spustení štartovacieho skriptu sa v priečinku vytvorí `eula.txt`. + +EULA[^9] je licenčná zmluva, ktorú musíte akceptovať pri používaní služieb [Mojang Studios](#user-content-fn-10)[^10]. + +Ak nesúhlasíte s EULA, nemôžete spustiť server a v prípade porušenia EULA môžete čeliť sankciám, ako je uzavretie účtu a podobne [trestom.](#user-content-fn-11)[^11] + +Pre súhlas s EULA zmeňte v súbore `eula.txt` `eula=false` na `eula=true` a uložte zmeny. + +*** + +## 6. Povolenie externého prístupu (Windows) + +Moderne operačné systémy blokujú externé prístupy pomocou **firewallu** a **routeru**. + +V prípade Windows, keďže ste povolili firewall v [kroku 3](setup.md#id-3), stačí nastaviť port forwarding. + +{% hint style="info" %} + +### V tomto sprievodcovi predpokladáme použitie operačného systému Windows a [**UPnP**](#user-content-fn-12)[^12] schopného routera. + +Ak váš router nepodporuje UPnP, musíte si vyhľadať informácie pre jednotlivé panely routerov. + +Alternatívne môžete vytvoriť dočasnú adresu pomocou [Ngrok](https://ngrok.com/). +{% endhint %} + +{% hint style="warning" %} + +### Pre operačné systémy Linux alebo macOS a podobné (polo) UNIX systémy je potrebné vyhľadať informácie o nastaveniach firewallu pre jednotlivé služby. + +{% endhint %} + +### 6.1 Overenie potreby port forwardingu + +Zadajte a spustite nasledujúci príkaz do konzoly. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Ak výstup je `True`, nie je potrebné nič ďalej, ak je `False`, je potrebné nastaviť port forwarding. + +### 6.2 Pripojenie na server + +{% tabs %} +{% tab title="Externé pripojenie" %} +Ak nie je potrebný port forwarding alebo ste ho už nastavili, môžete sa teraz pripojiť na server. + +Adresu na pripojenie na server môžete nájsť [tu](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Pokus o UPnP port forwarding" %} +V súbore `purpur.yml` vo vašom serverovom priečinku aktivujte `network.upnp-port-forwarding` na `true`. + +Potom reštartujte server a Plazma automaticky skúsi nastaviť port forwarding. + +Úspech UPnP záleží na správe zobrazených správ v konzole, kde sa zobrazí `[UPnP] (správa)`. + +| Správa | Význam | +| ----------------------------------- | ----------------------------- | +| `Úspešne otvorený port (port)` | Port forwarding úspešný. | +| `Port (port) je už otvorený` | Iná služba používa daný port. | +| `Nepodarilo sa otvoriť port (port)` | Port forwarding zlyhal. | +| `Služba nie je dostupná` | Router nepodporuje UPnP. | + +Po vypnutí servera Plazma automaticky zatvorí port. +{% endtab %} + +{% tab title="Ngrok pre vytvorenie dočasnej adresy" %} +Ngrok je užitočný pre krátkodobé testovanie, zdieľanie s priateľmi a podobne. + +1. Stiahnite si ZIP súbor pre `Windows (64-bit)` z [Ngrok stránky](https://ngrok.com/download). +2. Vložte stiahnutý Ngrok do priečinka so serverom. +3. Na [Ngrok nástenke](https://dashboard.ngrok.com/get-started/your-authtoken) vygenerujte [autentifikačný token](#user-content-fn-13)[^13]. +4. V serverovom priečinku spustite príkazy zobrazené v `Command Line`. +5. Na začiatok spustite príkaz `start /b ngrok tcp --region jp 25565` a na koniec pridajte `taskkill /f /t /im ngrok.exe`. +6. Adresa servera bude `0.tcp.jp.ngrok.io:12345` zobrazená v konzole ako `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`. +7. Teraz môžete pristupovať k adrese zvonka. + {% endtab %} + +{% tab title="Pripojenie z lokálneho počítača" %} +Ak sa snažíte pripojiť sa k serveru z lokálneho počítača, môžete sa pripojiť pomocou `IPv4 adresa` zobrazená po spustení príkazu `cmd /k ipconfig` v príkazovom riadku. + +Napríklad, po vykonaní príkazu sa zobrazí nasledovné: + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Ak sa pokúsite pripojiť cez zobrazenú `192.168.3.7` IPv4 adresu, môžete sa pripojiť k serveru z lokálneho počítača. + +Ak server a hra bežia na rovnakom PC, môžete sa pripojiť cez `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Stupeň rozvoja + +Ak ste úspešne spustili server a funguje správne, je čas prispôsobiť si server podľa vašich potrieb. + +Zistite, ako prispôsobiť server pomocou nasledujúceho sprievodcu. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime prostredie, Java Runtime Environment. + +[^2]: Paper, na ktorom je založený Plazma, je založený na Spigot a Spigot je založený na oficiálnej platforme servera. + +[^3]: Klávesová skratka Windows + R + +[^4]: V prípade Linuxu použite v termináli príkaz `java --version` + +[^5]: JRE je jedným z open source projektov a existuje viacero verzií ako napríklad Minecraft server platforma. + +[^6]: Je všeobecne známe ako **spúšťač**. + +[^7]: Ak povolíte „Automatické reštartovanie“, server sa automaticky reštartuje. Môžete ho ukončiť stlačením `Control + C`. + +[^8]: Neprekračujte polovicu systému, nie je to odporúčané. + + Napríklad, keď je celková kapacita pamäte systému 8 GB, nie je odporúčané nastaviť ju na viac ako 4 GB. + +[^9]: Zmluva o licencii koncového používateľa, End-User License Agreement. Pre viac informácií navštívte [domovskú stránku Minecraftu](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Spoločnosť Microsoft Corporation. + +[^11]: V prípade Južnej Kórey je podľa zákona o podpore herného priemyslu § 32 ods. 1 písm. 9 možné podať právne námietky proti spoločnosti **Kórejská spoločnosť Microsoft**. + +[^12]: Universal Plug & Play. Purpur zahrnutý v Plazme komunikuje s routrom automaticky cez túto technológiu a otvára porty len v prípade, že je server spustený, preto nie je potrebné manuálne nastavovať port forwarding. + +[^13]: Ak nemáte účet, zaregistrujte sa na Ngrok cez účet Google alebo GitHub. diff --git a/sk/origin/plazma/adminstration/getting-started/customization.md b/sk/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..590bcf18c --- /dev/null +++ b/sk/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Zistite, ako prispôsobiť server používateľským preferenciám. +--- + +# 🎨 Používateľské nastavenie diff --git a/sk/origin/plazma/adminstration/reference/arguments.md b/sk/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..5aeeca1df --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Zistite viac o počiatočných argumentoch a systémových vlastnostiach. +--- + +# 🎛️ Argumenty a vlastnosti + +Počiatočné argumenty a systémové vlastnosti sú hodnoty pridávané k [príkazom používaným pri spustení Plazmy](#user-content-fn-1)[^1], ktoré umožňujú zmeniť hodnoty, ktoré nemožno zmeniť po spustení Plazmy. + +V závislosti na [mieste pridania k príkazu](#user-content-fn-2)[^2] sa rozlišujú na **počiatočné argumenty** a **systémové vlastnosti**. + +*** + +## Systémová vlastnosť + +Systémová vlastnosť je hodnota spracovaná v JVM pred inicializáciou Plazmy pred `-jar`. + +{% hint style="warning" %} + +### Úprava systémových vlastností môže ovplyvniť fungovanie Plazmy a JVM a môže mať veľký vplyv na hru! + +Ak nie ste istí, akú úlohu zohráva každá systémová vlastnosť, **nepoužívajte ich!** +{% endhint %} + +### Použitie + +Systémová vlastnosť sa zadáva ako Java argument medzi `java` a `-jar`. + +Napríklad, ak chcete použiť systémovú vlastnosť `Plazma.dummyProperty`, +zadajte ju nasledovne a hodnota `37` bude pridaná do Plazmy po inicializácii. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` označuje, že tento argument nie je vstavaný do JVM, ale je špecifický pre Plazmu a + +ak nezadáte žiadnu hodnotu, bude hodnota [`true` nastavená.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platforma Paperweight používa bodku v názve vlastnosti na rozlíšenie systémových vlastností pre každú platformu. + +V niektorých termináloch, ako je Windows Powershell, môže byť potrebné pridať `"` na oba konce argumentu, pretože niektoré terminály tieto argumenty nepodporujú.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Všetky systémové vlastnosti + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktualizuje zastaraný formát tabúľ. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o entitách. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje NMS revíziu pre IDE na správne načítanie debugovacích informácií a automatický remapovanie vnútorných verzií. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje systém upozornení Watchdog v Spigote. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje potvrdenie príkazu `/reload`. + +{% hint style="danger" %} + +### Pokiaľ ide o príkaz `/reload`, je veľmi nestabilný, preto všetky problémy po jeho použití sú plne zodpovednosťou používateľa. + +Ak ste vývojár pluginov a musíte aktualizovať pluginy, použite hotswap namiesto príkazu `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje pluginy, ktoré používajú štandardný výstup a vstup. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Upozorní pri detekcii zastaraného formátovania v chatových komponentoch. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje overovanie vzoru servera pri pripájaní hráča. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o chýbajúcich kľúčoch v NBT objektoch. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o neplatných profiloch lebiek. + +Toto zaznamenáva všetky neplatné lebky v svete spolu s ich polohou. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje obmedzenie na 128 pluginových kanálov na hráča[^5]. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje triedny prioritizačný systém pluginov. + +Užitočné pri problémoch so zatienením pluginov. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje systém zlučovania Netty flush. + +#### `Paper.excessiveTELimit` + +- **Typ**: `Integer` +- **Predvolená hodnota**: `750` + +Ak entita presiahne stanovenú hodnotu, bude odoslaná ako viacero paketov. + +#### `Paper.filterThreshold` + +- **Typ**: `Integer` +- **Predvolená hodnota**: `8192` + +Nastavuje maximálnu veľkosť paketu, ktorú server môže prijať naraz. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Deaktivuje kontrolu verzie Javy. + +{% hint style="danger" %} + +### Týmto spôsobom môže JVM pristupovať k neexistujúcemu kódu! + +Môže to trvalo poškodiť súbory v hre a spôsobiť zlyhanie hry. + +Všetky problémy spôsobené týmto opatrením sú plne zodpovednosťou používateľa a Plazma neposkytuje žiadnu podporu! +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Typ**: `Integer` +- **Predvolená hodnota**: `64` + +Nastavuje obmedzenie názvu kanála pluginu[^6]. + +#### `Paper.maxSignLength` + +- **Typ**: `Integer` +- **Predvolená hodnota**: `80` + +Nastavuje maximálnu dĺžku textu na jednom riadku tabule. + +#### `Paper.minPrecachedDatafixVersion` + +- **Typ**: `Integer` +- **Predvolená hodnota**: `(verzia sveta) + 1` + +Nastavuje verziu údajov, ktoré sa majú najskôr aktualizovať pri inicializácii sveta. + +Užitočné pri hromadnom aktualizovaní blokov, inak sa nepoužíva. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `True` + +Aktivuje spracovanie komentárov v YAML súboroch. + +#### `Paper.playerConnection.keepAlive` + +- **Typ**: `Integer` +- **Predvolená hodnota**: `30` + +Ak hráč neodosielal žiadne dáta počas určeného času (v sekundách), hráča vyhodí zo servera. + +V bežných prípadoch hra[^7] neustále posiela [signály srdca](#user-content-fn-8)[^8] na server, takže [nedochádza k vyhodeniu,](#user-content-fn-9)[^9] ale ak hra nereaguje, server považuje hru za zhroucenú a prestane spracovávať hráča a vyhodí ho. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Ignoruje komentáre vlastností servera. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje záznamy debugovacích informácií o synchronizovaní chunkov. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje [štandardný systém zápisu chunkov](#user-content-fn-10)[^10] v Minecrafte. + +Tento systém ukladá každý chunk postupne, čo spôsobuje veľký výkonový pokles. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Aktivuje Explicit Flushing v sieťovom kanáli. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Vždy zaznamenáva chyby, ktoré nevznikli v hlavnom vlákne. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Ak sú naplánované úlohy príliš dlho čakajú, vypíše sa varovanie. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `False` + +Ak sa používa predvolený spustiteľný súbor, aplikuje sa iba záplatovanie bez spustenia servera. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` + +{% hint style="warning" %} + +### Táto vlastnosť sa presunie ako počiatočný argument po verzii 1.20.5. + +{% endhint %} + +Pri prvom spustení sa prísnejšie uplatnia konfiguračné optimalizácie. + +Ak je aktivovaný, server sa stane rýchlejším a bezpečnejším, ale môže blokovať niektoré hrateľné prvky alebo mať významný vplyv na hranie hry. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` + +Potláča upozornenia[^11], ktoré sa zobrazujú pri inicializácii Plazmy. + +### Použitá zastaraná vlastnosť + +Nižšie uvedené systémové vlastnosti sú zastarané. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Predvolená hodnota**: `false` +- **OBSOLETE**: Po odstránení Timings z Plazma + +Rozhoduje, či môže byť prekročená maximálna hodnota, ktorá sa môže posielať do Aikarho Timings API. + +Ak nie je v API spracovaná výnimka, aplikuje sa obmedzenie rýchlosti. + +*** + +## Argument štartu + +Argument štartu je hodnota, ktorá sa zadáva za `-jar *.jar` a inicializuje sa spolu s Plazmou. + +### Spôsob použitia + +Systémové vlastnosti sa zadávajú ako programové argumenty za `-jar *.jar`. + +Napríklad, ak chcete použiť argument štartu `nogui`,\ +plazma bude tento argument spracovávať počas inicializácie nasledovne: + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Celkový argument štartu + +#### `bukkit-settings` + +- **Alias**: `b` +- **Predvolená hodnota**: `bukkit.yml` + +Nastavuje názov a umiestnenie [konfiguračného súboru Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Predvolená hodnota**: `commands.yml` + +Nastavuje názov a umiestnenie [konfiguračného súboru príkazov Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Predvolená hodnota**: `server.properties` + +Nastavuje názov a umiestnenie [súboru vlastností servera](../reference/configurations/property.md). + +#### `demo` + +Spustí server v demo svete. + +#### `eraseCache` + +Odstráni zostávajúce cache súbory po aktualizácii sveta. + +#### `forceUpgrade` + +Vynúti [aktualizáciu](#user-content-fn-12)[^12] sveta bez ohľadu na verziu. + +#### `help` + +- **Alias**: `?` + +Zobrazí všetky argumenty štartu a ich popis v Plazme. + +#### `initSettings` + +Vytvorí len konfiguračné súbory a vypne server. + +#### `jfrProfile` + +Aktivuje JFR profilovanie. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Nastavuje maximálny počet [hráčov](#user-content-fn-14)[^14], ktorí sú povolení na serveri. + +#### `nogui` + +Vypne grafický rozhranie Plazmy. + +#### `nojline` + +Vypne JLine a použije základnú konzolu. + +#### `online-mode` + +- **Alias**: `o` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Určuje, či sa majú hráči overovať prostredníctvom Mojang autentizačných serverov. + +**Ak nie je použitý Velocity alebo iný proxy, môže to byť porušením [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Predvolená hodnota**: `paper.yml` + +{% hint style="warning" %} + +### Tento argument je po verzii 1.19.4 OBSOLOVANÝ + +{% endhint %} + +Nastavuje umiestnenie [konfiguračného súboru PaperSpigot](../reference/configurations/paper/README.md), ktorý bol zastavený. + +Slúži na prenesenie existujúcej konfigurácie do nového súboru a následne sa nepoužíva. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Predvolená hodnota**: `config` + +Nastavuje názov a umiestnenie priečinka, kde sa nachádza [konfiguračný súbor Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Nastavuje názov a umiestnenie priečinka, kde sa nachádza [konfiguračný súbor Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Predvolená hodnota**: `plugins` + +Nastavuje umiestnenie priečinka s pluginmi. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Predvolená hodnota**: `pufferfish.yml` + +Nastavuje názov a umiestnenie [konfiguračného súboru Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Predvolená hodnota**: `purpur.yml` + +Nastavuje názov a umiestnenie [konfiguračného súboru Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Spustí server v úplnom vanilla režime. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Nastavuje názov hostiteľa servera alebo [IP adresu](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Nastavuje port servera. + +#### `server-name` + +- **Predvolená hodnota**: `A Plazma Server` + +Nastavuje názov servera. + +#### `spigot-settings` + +- **Alias**: `S` +- **Predvolená hodnota**: `spigot.yml` + +Nastavuje názov a umiestnenie [konfiguračného súboru Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Vypíše verziu Plazmy. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Predvolená hodnota**: `(priečinok servera)` + +Nastavuje umiestnenie súborov sveta. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Predvolená hodnota**: `(vlastnosť servera)` + +Nastavuje názov súboru sveta. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Podľa umiestnenia pridaných argumentov sa mení miesto, kde sa argumenty spracovávajú. + +[^3]: Napríklad, ak chcete nastaviť `Plazma.iKnowWhatIAmDoing` na `true`, môžete namiesto `-DPlazma.iKnowWhatIAmDoing=true` použiť len `-DPlazma.iKnowWhatIAmDoing` a stále to bude fungovať. + +[^4]: Napríklad, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektor udalostí. + +[^6]: Detektor udalostí. + +[^7]: Klient. + +[^8]: Signál signalizujúci, že je server správne pripojený, podobne ako srdcový rytmus. + +[^9]: Použitím funkcie AFK vyhadzovania v Purpure môžete vyhadzovať aj hráčov, ktorí sú neprítomní. + +[^10]: Systém zápisu synchronizovaných blokov, Sync Chunk Write System. + +[^11]: `VAROVANIE! Plazma môže spôsobiť neočakávané problémy, preto sa uistite, že ju dôkladne otestujete pred použitím na verejnom serveri.` + +[^12]: V hre `svetová optimalizácia` funguje rovnakým spôsobom. + +[^13]: Internetový protokol, IP. + +[^14]: `Úroveň 2` alebo vyšší administrátori sú vylúčení. diff --git a/sk/origin/plazma/adminstration/reference/commands.md b/sk/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..5c338a4d8 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Zistite dostupné príkazy v aplikácii Plazma. +--- + +# 🖥️ Príkazy diff --git a/sk/origin/plazma/adminstration/reference/configurations/bukkit.md b/sk/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..3352e1046 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/sk/origin/plazma/adminstration/reference/configurations/paper/README.md b/sk/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..41e980037 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, na čo slúži každý súbor v priečinku config. +--- + +# 🛩️ Papier diff --git a/sk/origin/plazma/adminstration/reference/configurations/paper/global.md b/sk/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..b8d74bff2 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Skontrolujte, čo znamená každý uzol v paper-global.yml. +--- + +# 🛩️ Paper (celosvetová konfigurácia) diff --git a/sk/origin/plazma/adminstration/reference/configurations/paper/world.md b/sk/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..849de002f --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v súbore paper-world.yml. +--- + +# 🛩️ Papier (zloženie sveta) diff --git a/sk/origin/plazma/adminstration/reference/configurations/plazma/README.md b/sk/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e2773fc41 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, na čo slúži každý súbor v priečinku config. +--- + +# ✨ Plazma diff --git a/sk/origin/plazma/adminstration/reference/configurations/plazma/global.md b/sk/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..0f2955a4b --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v súbore plazma-global.yml. +--- + +# ✨ Plazma (globálna konfigurácia) diff --git a/sk/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/sk/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..1189981f0 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Svetová štruktúra diff --git a/sk/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/sk/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a500b9378 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v plazma-world.yml. +--- + +# ✨ Plazma (zloženie sveta) diff --git a/sk/origin/plazma/adminstration/reference/configurations/property.md b/sk/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..1250c7ee0 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol server.properties. +--- + +# 🪨 Server.properties diff --git a/sk/origin/plazma/adminstration/reference/configurations/pufferfish.md b/sk/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..782f068e6 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/sk/origin/plazma/adminstration/reference/configurations/purpur/README.md b/sk/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..c97eae1b3 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v purpur.yml. +--- + +# 🦑 Purpur diff --git a/sk/origin/plazma/adminstration/reference/configurations/purpur/global.md b/sk/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..b978b7b6b --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v purpur.yml. +--- + +# 🦑 Purpurová (globálna štruktúra) diff --git a/sk/origin/plazma/adminstration/reference/configurations/purpur/world.md b/sk/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..6c05d9a77 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v purpur.yml. +--- + +# 🦑 Purpurová (svetová zložka) diff --git a/sk/origin/plazma/adminstration/reference/configurations/spigot.md b/sk/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..427a378fc --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Zistite, čo znamená každý uzol v spigot.yml. +--- + +# 🚰 Spigot diff --git a/sk/origin/plazma/adminstration/reference/permissions.md b/sk/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..2e0a28e91 --- /dev/null +++ b/sk/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Zistite viac o oprávneniach aplikácie Plazma. +--- + +# 🛡️ Oprávnenia diff --git a/sk/origin/plazma/developers.md b/sk/origin/plazma/developers.md new file mode 100644 index 000000000..8ec618f96 --- /dev/null +++ b/sk/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Vyskúšajte vyvíjať tretie strany projekty s Plazma. +--- + +# ⚙️ Sprievodca vývojára diff --git a/sk/origin/thunderbolt/README.md b/sk/origin/thunderbolt/README.md new file mode 100644 index 000000000..745b67644 --- /dev/null +++ b/sk/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt je serverová platforma založená na Plazme, ktorá umožňuje používať experimentálne záplaty ako Flavor priamo. +--- + +# 🌩️ Sprievodca používaním Thunderbolt diff --git a/sk/origin/volt/README.md b/sk/origin/volt/README.md new file mode 100644 index 000000000..017b6d126 --- /dev/null +++ b/sk/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt je open source šablóna, ktorá vám umožňuje vyvíjať vlastnú platformu servera Paperweight založenú na Plazme. +--- + +# ⚡ Sprievodca vývojom Volta diff --git a/sq/origin/README.md b/sq/origin/README.md new file mode 100644 index 000000000..37d2e9e3d --- /dev/null +++ b/sq/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Nëse keni pyetje, ju lutemi pyetni nëpërmjet Discord ose bisedimeve në GitHub. +--- + +# 🏠 Mirësevini në Portalin e Dokumentacionit + +{% hint style="info" %} + +**Dokumenti i Plazmas është aktualisht në gjendje përkthimi me makinë.** + +[![Statusi i Përkthimit](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) duke pjesëmarrë në përkthimin e dokumentave në [https://translate.plazmamc.org/](https://translate.plazmamc.org/) për të përmirësuar dokumentin. + +{% endhint %} + +### Nëse ka ndodhur ndonjë problem gjatë përdorimit të Plazmës? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Nëse keni interes për Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Nëse dëshironi të krijoni platformën tuaj të serverit me Volt? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Nëse kërkoni më shumë informacione lidhur me Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/sq/origin/SUMMARY.md b/sq/origin/SUMMARY.md new file mode 100644 index 000000000..f5fce2c38 --- /dev/null +++ b/sq/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Tabela e përmbajtjes + +- [🏠 Mirësevini në Portalin e Dokumentave](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Dokumentet e Përdorimit të Plazmës](plazma/README.md) +- [❓ Ç'është Plazma?](plazma/about/README.md) + - [⬇️ Shkarko](plazma/about/downloads.md) + - [✅ Stati i Mbështetjes së Versioneve](plazma/about/supported-versions.md) +- [⚒️ Udhëzues për menaxhimin e serverit](plazma/administration/README.md) + - [👟 Filloni](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referenca](plazma/administration/reference/README.md) + - [🖥️ Komandat](plazma/administration/reference/commands.md) + - [🛡️ Lejet](plazma/administration/reference/permissions.md) + - [🎛️ Argumentet dhe atributet](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Atribute](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Konfigurimi global](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Konfigurimi sipas botës](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Konfigurimi global](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Konfigurimi sipas botës](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Konfigurimi global](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Konfigurimi sipas botës](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Specializimi](plazma/administration/expert/README.md) + - [🧹 Optimizimi](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Bëhu si Vanilla](plazma/administration/expert/vanillaize.md) + - [🩻 Bllokim i X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Dështimet dhe zgjidhjet](plazma/administration/expert/fix-exploits.md) + - [⁉️ Pyetje të shpeshta](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Udhezues për Zhvilluesit](plazma/developers.md) + - [✏️ Kontribuoni](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Udhezuesi i Përdorimit të Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Udhezuesi i Zhvillimit të Volt](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Shkarko të gjithën](plazma/about/downloads-all.md) diff --git a/sq/origin/miscellaneous/README.md b/sq/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/sq/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/sq/origin/plazma/README.md b/sq/origin/plazma/README.md new file mode 100644 index 000000000..608abcc00 --- /dev/null +++ b/sq/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma është një platformë serveri open-source për Minecraft: Java Edition që shton optimizimin eksperimental të bazuar në letër dhe shumë mekanizma të personalizuar të lojërave." +--- + +# ✨ Dokumentet e Përdorimit të Plazmës + +## 👋 Mirë se vini te Dokumentet e Plazmës + +Mirë se erdhët te Dokumentet e Përdorimit të Plazmës! + +{% hint style="info" %} + +**A mund të zgjidhni problemin përmes manualit?** + +[Serveri Zyrtar i Discord-it](https://discord.gg/MmfC52K8A8) ose [Diskutimet në GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) për të pyetur komunitetin! + +{% endhint %} + +### Rreth Plazmës + +> Mësoni më shumë për platformën e serverit Plazma. + +{% content-ref url="about/" %} +[rreth](about/) +{% endcontent-ref %} + +### Për Administratorët + +> Krijo serverin tënd duke përdorur Plazmën. + +{% content-ref url="administration/" %} +[administrata](administration/) +{% endcontent-ref %} + +### Për Zhvilluesit + +> Zhvillo projekte të treta duke përdorur Plazmën. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/sq/origin/plazma/about/README.md b/sq/origin/plazma/about/README.md new file mode 100644 index 000000000..0b6069d25 --- /dev/null +++ b/sq/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Mësoni më shumë për platformën e serverit Plazma. +--- + +# ❓ Çfarë është Plazma? + +- **Plazma** është një platformë serveri bazuar në [Paper](https://github.com/PaperMC/Paper) që merr vetëm avantazhet nga [Andromeda](https://github.com/EarendelArchived/Andromeda) dhe [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Duke punuar për të siguruar gjithmonë stabilitet të lartë, performancë të fuqishme, përditësime të shpejta dhe një gamë të gjerë funksionalitetesh. + +## 📋 Synimi i Plazma + +- Duke punuar për të bërë platformën e serverit me përditësime të shpejta dhe stabilitet të lartë. +- Duke punuar për të ofruar një gamë të gjerë funksionalitetesh dhe performancë të fuqishme, si platforma e modit. +- Duke punuar për të krijuar një platformë të lirë që mund të përshtatet sipas patch-ave të Vanilla. + +## ⚙️ Pika kryesore + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Përditësimi më i shpejtë**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) siguron që patch-et e përfshira në Plazma gjithmonë mbeten të përditësuara, duke ofruar një nga përditësimet më të shpejta në platformën e serverit të bazuar në Paper. +6. **Optimizimi i konfigurimit fillestar**\ + Konfiguracionet fillestare janë të optimizuara, duke ju kursyer nevojën për të optimizuar manualisht konfiguracionet. +7. **Funksionimi i organizuar me shumë threada**\ + Sistemi i përdorur për mekanizmat që nuk kanë lidhje me lojën është asinkron, duke zvogëluar kohën e vonuar dhe duke optimizuar serverin. +8. **Bllokimi i përdorimit të hapësirës së panevojshme**\ + Të dhënat me vlera të ngjashme janë të bashkuara për të zvogëluar përdorimin e memorjes. + +## ✨ Rastet e përdorimit + +- **Platforma që trajton shtojcat e komplikuara në mënyrë të saktë**\ + Plazma është e përdorur në serverin e [IPECTER](https://github.com/IPECTER) të zhvilluesit.\ + Me shtojcat e veta që funksionojnë me NMS dhe reflektim, dhe me një numër të madh të paketave të dhënash komplekse dhe të mëdha,\ + ëndërsa pranon më shumë se 100 lojtarë pa rënien e performancës. +- **Platforma që mbajti performancën e shpejtë edhe në serverët RPG**\ + Në një klaster të vetëm, 100 lojtarë janë mbajtur në mënyrë stabile pa rënien e TPS,\ + në 4 klasterë, një total prej 250 lojtarëve kanë luajtur në një mënyrë të këndshme. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Platforma e zgjedhur nga shumë transmetues**\ + Është zgjedhur si një ndërrues pjesëmarrësish nga shumë transmetues. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Shkarko + +Në faqen më poshtë mund të shkarkoni Plazma. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Dëshironi të merrni informacione të detajuara për mbështetjen e versioneve? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Shtojcat e Bukkit, CraftBukkit, Spigot dhe Paper, Pufferfish, Purpur. + +[^2]: Microsoft Corporation. + +[^3]: Nëse deaktivizohet sistemi i raportimit të bisedave, biseda përpunohet vetëm në server duke parandaluar gjurmimin e bisedave nga Mojang. + +[^4]: Koha kur loja ndalet për një moment për të lejuar funksionimin e mekanizmave të sistemit. diff --git a/sq/origin/plazma/about/downloads-all.md b/sq/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..296b37ac1 --- /dev/null +++ b/sq/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma ekzekutues i shkarkimit i plotë +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Versioni | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/sq/origin/plazma/about/downloads.md b/sq/origin/plazma/about/downloads.md new file mode 100644 index 000000000..9c87c3a1e --- /dev/null +++ b/sq/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Shkarkoni Plazma tani dhe provoni të përdorni në mënyrë direkte. +--- + +# ⬇️ Shkarko + +#### Dëshironi të merrni informacione të detajuara për mbështetjen e versioneve? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Shkarkimi i mëposhtëm është një skedar ekzekutues për përdoruesit e zakonshëm.** + +Nëse jeni zhvillues dhe keni nevojë për një formë tjetër skedari, ju lutemi, referohuni në faqen e mëposhtme. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersioniShkarko
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + shkarko +
1.20.1 + shkarko +
1.19.4 + shkarko +
+ +*** diff --git a/sq/origin/plazma/about/patches-list.md b/sq/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..d5330e7b7 --- /dev/null +++ b/sq/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Mësoni më shumë për të gjitha funksionet e shtuara në Plazma. +--- + +# 📑 Përfshirë Patch-et diff --git a/sq/origin/plazma/about/supported-versions.md b/sq/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..e7effcbdb --- /dev/null +++ b/sq/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Zbuloni versionin e Minecraft: Java Edition që mbështetet në Plazma." +--- + +# ✅ Statusi i mbështetjes së versionit + +{% hint style="info" %} + +**Plazma është zhvilluar nga versioni 1.19.4 dhe më pas, versionet më të vjetra se 1.19.4 nuk janë të zhvilluara.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Prishtina%20në%20pritje +[idv]: https://badge.plazmamc.org/1/ndër%20zhvillim +[atv]: https://badge.plazmamc.org/2/në%20mbështetje +[fse]: https://badge.plazmamc.org/6/ndërprerja%20e%20mbështetjes%20së%20funksioneve +[eol]: https://badge.plazmamc.org/4/përfundimi%20i%20mbështetjes +[ukn]: https://badge.plazmamc.org/0/No%20info +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: https://badge.plazmamc.org/percent/100 + +![në pritje të lëshimit][wtr] ![në zhvillim][idv] ![në mbështetje][atv] ![ndërprerja e mbështetjes së funksioneve][fse] ![përfundimi i mbështetjes][eol] + +| Versioni | Stabiliteti dhe mbështetja e funksioneve | Statusi i ndërtimit | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![statusi i ndërtimit](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Gjendja e ndërtimit](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Gjendja e ndërtimit](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/sq/origin/plazma/administration/README.md b/sq/origin/plazma/administration/README.md new file mode 100644 index 000000000..cba2d4d79 --- /dev/null +++ b/sq/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Krijo serverin tënd duke përdorur Plazmën. +--- + +# ⚒️ Udhëzues për menaxhimin e serverit diff --git a/sq/origin/plazma/administration/diagnosis/README.md b/sq/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..4928d969f --- /dev/null +++ b/sq/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Merrni informacion mbi se si të trajtoni problemet kur ato shfaqen. +--- + +# 🧾 진단 diff --git a/sq/origin/plazma/administration/diagnosis/plugins.md b/sq/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..37ddfd561 --- /dev/null +++ b/sq/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Mësoni se si të zgjidhni problemet kur plugini nuk funksionon si duhet. +--- + +# 📜 플러그인 diff --git a/sq/origin/plazma/administration/expert/README.md b/sq/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..5780cc8ff --- /dev/null +++ b/sq/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Mësoni se si të trajtoni Plazma në mënyrë profesionale. +--- + +# 🎓 thellë diff --git a/sq/origin/plazma/administration/expert/fix-exploits.md b/sq/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..f8f5e5d40 --- /dev/null +++ b/sq/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Mësoni për të dhënat e dobëta të njohura dhe mënyrën për t'i zgjidhur. +--- + +# ⚠️ Të dhënat e dobëta të njohura dhe mënyra për t'i zgjidhur diff --git a/sq/origin/plazma/administration/expert/optimize.md b/sq/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..89c429350 --- /dev/null +++ b/sq/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Mësoni se si të optimizoni Plazma-n. +--- + +# 🧹 Optimizimi maksimal diff --git a/sq/origin/plazma/administration/expert/proxy.md b/sq/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..770d4b82c --- /dev/null +++ b/sq/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Mësoni si të konfiguroni platformën e proksisë "Velocity" në mënyrë të sigurt. +--- + +# 🔀 Proksi diff --git a/sq/origin/plazma/administration/expert/vanillaize.md b/sq/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..0ce636fa8 --- /dev/null +++ b/sq/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Mësoni se si të riktheni rregullimin e letër dhe vaniljes. +--- + +# ↩️ Vanilizimi + +{% hint style="warning" %} + +**Paper nuk ka shtuar opsionet në shumicën e rregullimeve për gabimet e vanilës.** + +Plazma aktualisht po zhvillon mundësinë për të çaktivizuar zgjidhjet e këtyre gabimeve. + +Prandaj, kjo udhëzues është ende në proces shkrimi dhe informacioni mund të ndryshojë në çdo kohë. + +{% endhint %} diff --git a/sq/origin/plazma/administration/expert/xray.md b/sq/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..21d689588 --- /dev/null +++ b/sq/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Mësoni për disa mënyra të brendshme për të bllokuar X-Ray. +--- + +# 🩻 Bllokim i X-Ray diff --git a/sq/origin/plazma/administration/faq.md b/sq/origin/plazma/administration/faq.md new file mode 100644 index 000000000..4044cbecb --- /dev/null +++ b/sq/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Merrni informacion mbi pyetjet e shpeshta. +--- + +# ⁉️ Pyetje të shpeshta + +{% hint style="info" %} + +**Nuk mund të gjeni përgjigjen që kërkoni?** + +[Serveri Zyrtar i Discord-it](https://discord.gg/MmfC52K8A8) ose [Diskutimet në GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) për të pyetur komunitetin! + +{% endhint %} + +### Plazma nuk fillon + +Nëse shfaqet `no main manifest attribute, në plazma-(version).jar`,\ +skedari i shkarkuar është skedar API zhvillimi, duhet të shkarkoni **Reobf Paperweight** nga faqja e GitHub. + +Për të mësuar më shumë, konsultoni faqen në vijim. + +{% content-ref url="getting-started/" %} +[fillimi](getting-started#id-2) +{% endcontent-ref %} + +### Një sinjalizim shfaqet çdo herë që fillon serveri + +Plazma përmban disa patch-e të paqëndrueshme dhe gjithmonë mund të ketë gabime, prandaj shfaq këtë sinjalizim në fillimin e serverit. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Këtë sinjalizim mund ta çaktivizoni duke përdorur atributin e sistemit [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Për të mësuar më shumë, konsultoni faqen në vijim. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponueshëm nga versioni 1.20.1 diff --git a/sq/origin/plazma/administration/getting-started/README.md b/sq/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..73a28eb8e --- /dev/null +++ b/sq/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Mësoni si të krijoni një server me Plazma. +--- + +# 👟 Filloni + +Për të përdorur Plazma-n në mënyrë stabile, sistemi duhet të plotësojë këto kërkesa: + +| | Minimumi | Rekomanduar | +| :-----------------: | -------- | ----------- | +| Arkitektura | x64 | - | +| RAM | 8GB | 16GB | +| Hapësira e ruajtjes | 1GB | 8GB | +| JDK | 17 | 21 | + +Për të bërë ndryshime të lehta në dosjet e konfigurimit, është gjithashtu e mirë të instaloni një redaktues si [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Shfaqja e saktë" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' nuk është një komandë, program i ekzekutueshëm i brendshëm ose i jashtëm, ose +skedar i shkëputur. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Fillimisht, shkarkoni **JDK 21** nga [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) në formatin `.msi`. +2. Ekzekutoni magjistrin e instalimit të shkarkuar dhe klikoni "Vazhdo". +3. Aktivizoni opsionin `Set JAVA_HOME variable` në mes të shiritit të menysë në të majtë dhe klikoni "Vazhdo". +4. Klikoni "Instalo" për të përfunduar instalimin e JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Pastaj, instaloni JRE duke ekzekutuar komandën e mëposhtme në terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Shkarkimi i Plazmasë + +Plazma ofron një gamë të gjerë skedarësh ekzekutues. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Më shumë informacion + +Emri i skedarit ekzekutues është `plazma-(menaxheri i versionit)-1.20.4-R0.1-SNAPSHOT-(forma e mapimit).jar`. + +- **Forma e mapimit**\ + Mapimi është një lloj hartimi që lidh kodin real të Minecraft me kodin e zbehur. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapimi, është mapimi i Minecraft-it bazë. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Menaxheri i versionit**\ + Menaxheri i versionit është një lloj launcheri që nevojitet për të drejtuar serverin dhe për të patch-uar skedarët e serverit. + - **Paperclip**\ + Zhvilluar nga ekipi i PaperMC për Paper dhe platformat e tjera të derivuara, shkarkon libraritë dhe aplikon patch-et në server. + - **Bundler**\ + Menaxheri i versionit i Minecraft vanilla. + +
+ +*** + +## 3. Krijimi i skriptit të fillimit + +Për të filluar Plazmën lehtësisht dhe për të ristartuar serverin automatikisht, duhet të krijoni një [skript fillimi](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Mund të shkarkoni skriptin fillimi duke klikuar në butonin e shkarkimit në pjesën e poshtme të majtë.\ +**Verifikoni se skripti i shkarkuar përputhet me sistemin tuaj operativ.** + +*** + +## 4. Rregullimi i skedarëve + +Tani lëvizni skriptin e fillimit të shkarkuar dhe Plazmën në një dosje të re. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Tani ekzekutoni skriptin e fillimit. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Konsentimi + +Pas ekzekutimit të skriptit fillimtar, do të krijohet një `eula.txt` në dosje. + +EULA[^9] është një marrëveshje licensimi që duhet të pranohet duke përdorur shërbimet e [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Për të pranuar EULA-n, ndryshoni `eula=false` në `eula=true` në skedarin `eula.txt` dhe ruani ndryshimet. + +*** + +## 6. Lejimi i hyrjes nga jashtë (Windows) + +Sistemet moderne operative bllokojnë hyrjet e rrezikshme nga jashtë duke përdorur në mënyrë parazgjedhëse **firewall** dhe **ruter**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Nëse ruteri nuk e mbështet UPnP-në, për çdo ruter ka një panel të ndryshëm, kështu që duhet të kërkoni informata vetë. + +Ose mund të përdorni [Ngrok](https://ngrok.com/) për të krijuar një adresë të përkohshme. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Verifikimi i nevojës për forwardim të portit + +Shkruani dhe ekzekutoni si më poshtë në dritaren e ekzekutimit. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Nëse output-i është `True`, atëherë jeni gati, nëse është `False`, duhet të konfiguroni forwardimin e portit. + +### 6.2 Hyrja në server + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Adresa për hyrjen në server mund të kontrollohet [këtu](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Pastaj, ristartoni serverin dhe Plazma do të provojë automatikisht të bëjë forwardimin e portit. + +Suksesin e UPnP vlerësoni sipas mesazhit që shfaqet në konsolë, si `[UPnP] (mesazhi)`. + +| Mesazhi | Kuptimi | +| ------------------------------------ | ------------------------------------------------------- | +| `Porti u hap me sukses (porti)` | Forwardimi i portit është i suksesshëm. | +| `Porti (porti) është i hapur tashmë` | Një shërbim tjetër po përdor këtë port. | +| `Dështoi hapja e portit (porti)` | Forwardimi i portit dështoi. | +| `Shërbimi nuk është në dispozicion` | Ruteri nuk e mbështet UPnP-në. | + +Kur serveri mbyllet, Plazma mbyll automatikisht portin. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Shkarkoni skedarin ZIP `Windows (64-bit)` nga [faqja zyrtare e Ngrok](https://ngrok.com/download). +2. Vendosni skedarin e shkarkuar të Ngrok në dosjen e serverit. +3. Në [panelin e Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) krijoni [tokenin e autorizimit](#user-content-fn-13)[^13]. +4. Ekzekutoni komandën që shfaqet në dritaren e komandës në dosjen e serverit. +5. Shtoni `start /b ngrok tcp --region jp 25565` në pjesën më sipër të skriptit të ekzekutimit, dhe `taskkill /f /t /im ngrok.exe` në fund të tij. +6. Në pjesën më të sipërme të konsolës shfaqet `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, ku `0.tcp.jp.ngrok.io:12345` do të jetë adresa e serverit. +7. Tani mund të lidheni nga jashtë përmes kësaj adrese. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Për shembull, pas ekzekutimit të komandës, nëse shfaqet si më poshtë, + +```log +Konfigurimi i IP në Windows + +Adapteri Ethernet Ethernet: + + Sufiksi DNS i lidhur. . . . : + Adresa IPv4. . . . . . . . . : 192.168.3.7 + Maskë nënrede . . . . . . . : 255.255.255.0 + Gateway-i parazgjedhur . . . . . . : 192.168.3.1 + +``` + +Nëse provoni të lidheni me serverin nga lokal, mund të provoni të lidheni me adresën IPv4 që shfaqet si `192.168.3.7` këtu. + +Nëse serveri dhe loja po ekzekutohen në të njëjtin PC, mund të lidheni me `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Të zhvillohemi + +Pas fillimit të suksesshëm të serverit dhe funksionimit të duhur të tij, tani është koha për të personalizuar serverin. + +Mësoni se si të personalizoni serverin duke lexuar udhëzimet më poshtë. + +{% content-ref url="hapi-hapi.md" %} +[hapi-hapi.md](hapi-hapi.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paperi i bazuar në Plazma është bazuar në Spigot dhe Spigot është platforma zyrtare e serverit. + +[^3]: Tasti Windows + R + +[^4]: Në rastin e Linuxit, në terminal shkruani `java --version` + +[^5]: JRE është një projekt burim i hapur dhe ka shumë lloje si platforma e serverit Minecraft. + +[^6]: Përgjithësisht njihet si **ekzekutor**. + +[^7]: Nëse aktivizoni "Rivendosje automatike", serveri do të ri-startohet automatikisht. Mund të mbyllni duke shtypur `Control + C`. + +[^8]: Nuk rekomandohet të kaloni gjysmën e sistemit. + + Për shembull, kur kapaciteti i përgjithshëm i memorjes së sistemit është 8GB, nuk rekomandohet ta vendosni më shumë se 4GB. + +[^9]: Marrëveshja e Licencës për Përdoruesin e Fundit, marrëveshja e licencës për përdoruesin përfundimtar. Për informacione më të hollësishme, ju lutemi kontrolloni [faqen zyrtare të Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Korporata Microsoft. + +[^11]: Në rastin e Republikës së Koreë, sipas nenit 32, paragrafi 1, nënparagrafi 9 të Ligjit për Promovimin e Industrisë së Lojërave, mund të bëhet denoncim ligjor nga **Korporata Microsoft e Koreas**. + +[^12]: Universal Plug & Play. Purpur i përfshirë në Plazma komunikon automatikisht me ruterin dhe hap portën vetëm kur serveri është në ekzekutim, kështu që nuk ka nevojë për përcjellje portash manualisht. + +[^13]: Nëse nuk keni llogari, regjistrohuni në Ngrok përmes llogarisë Google ose GitHub. diff --git a/sq/origin/plazma/administration/getting-started/customization.md b/sq/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..88803df28 --- /dev/null +++ b/sq/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,125 @@ +--- +description: Mësoni se si të personalizoni serverin. +--- + +# 🎨 Personalizimi i përdoruesit + +Përdorimi i një platforme zyrtare serveri të ofruar nga Mojang Studios dhe jo përdorimi i një platforme serveri të modifikuar si Plazma është për shkak të mundësisë së **personalizimit** të fuqishëm që është më i rëndësishmi. + +Këtu janë disa mënyra për të personalizuar dhe përdorur Plazma-n. + +## Ndryshimi i konfigurimit + +Mënyra më bazike për të personalizuar Plazma-n është duke ndryshuar konfigurimin. + +Plazma ofron konfigurime të fuqishme që përfshijnë mekanizmat e lojës dhe cilësitë e skajeve. + +Përshkrimi i konfigurimit të Plazma-s mund të gjendet në faqen e mëposhtme. + +{% content-ref url="../reference/configurations/" %} +[konfigurimet](../reference/configurations/) +{% endcontent-ref %} + +## Përdorimi i shtojcave + +{% hint style="success" %} + +**Plazma mbështet të gjitha shtojcat bazuar në letër të Hartës.** + +Për shtojcat e Spigot, disa prej tyre mund të mos funksionojnë për shkak të ndryshimeve në hartën e Paper që filluan nga 1.20.5, por +shumica e shtojcave që bazohen në Paper si Paper, Pufferfish dhe Purpur funksionojnë në Plazma, +dhe nëse nuk funksionojnë siç duhet, kjo është faj i Plazma, kështu që ju lutemi [raportoni menjëherë.](../diagnosis/plugins.md) + +{% endhint %} + +Kjo është arsyeja kryesore pse të përdorni Plazma dhe mënyra më e fuqishme për të personalizuar Plazma-n. +Ekosistemi i fuqishëm i shtojcave të Plazma lejon përshtatjen e lehtë të serverit tuaj. + +Ka disa mënyra për të gjetur dhe shkarkuar shtojcat. Disa shtojca +ngarkohen në shërbimet e ruajtjes publike të shtojcave, ndërsa disa të tjera ngarkohen në GitHub ose +faqet e tyre të internetit. + +{% hint style="caution" %} + +**Shtojcat mund të kenë qasje drejtpërdrejt në sistemin tuaj!** + +Përdorni shërbimet si VirusTotal për të verifikuar sigurinë e shtojcave para se t'i aplikoni, +ose shkarkoni shtojcat nga shërbimet e besueshme. + +{% endhint %} + +Ka shumë shërbime për shkarkimin e shtojcave. Në mes tyre, shërbimet si [Forumi i SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) kontrollojnë shtojcat para se të ngarkohen, duke siguruar që vetëm shtojcat e sigurta qarkullojnë. + +### Aplikimi i Shtojcave + +Pas shkarkimit të shtojcave, tani është koha për t'i aplikuar ato. + +1. Shtojcat janë në formatin `.jar` ose `Skedar Ekzekutues Java`. + Disa shtojca janë të kompresuara në një dosje, në rast se + dosja është e kompresuar, hapeni atë dhe nëse emri përmban `bukkit`, `spigot` ose `paper`, + përdorni dosjen që përmban `fat`. +2. Vendosni dosjen e shkarkuar në dosjen `shtojcat` të serverit dhe (ri)nisni serverin. +3. Kur Plazma fillon, do të shihni përmbajtje të re në konsolë. + Kjo tregon se Plazma ka ngarkuar shtojcat me sukses. +4. Edhe pse Plazma ka ngarkuar shtojcat me sukses, ato mund të mos fillojnë siç duhet. + Përdorni komandën `/shtojcat` për të shfaqur shtojcat e ngarkuara aktualisht në server. + Nëse emrat e shtojcave të instaluar nuk janë të + ngjyrë kuqe, + por jeshile, atëherë shtojcat janë ngarkuar me sukses. + +Nëse shtojcat nuk janë ngarkuar me sukses, mund të gjeni zgjidhjet në faqen e mëposhtme. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Përdorimi i Pakove të të Dhënave + +Pakot e të Dhënave janë një mënyrë e Minecraft për të personalizuar lojën, të ngjashme me +[Paketat e Burimeve](#user-content-fn-1)[^1]. + +Me pakot e të dhënave, mund të shtoni grupime të reja të krijesave dhe sfidave në lojë. + +{% hint style="caution" %} + +**Pakot e të dhënave mund të dëmtojnë botën!** + +Disa pakove të dëmshme të të dhënave mund të shkaktojnë dëme të pakthyeshme në botë. + +Prandaj, është e rekomandueshme të bëni një kopje rezervë të botës para se të aplikoni pakot e të dhënave. + +{% endhint %} + +Pakot e të dhënave mund të shkarkohen nga shumë shërbime si [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) etj. + +Pas shkarkimit të pakove të të dhënave, vendosini ato në dosjen `datapacks` të botës së serverit tuaj. +Nëse dosja nuk ekziston, mund ta krijoni atë dhe ta shtoni. + +{% hint style="warning" %} + +**Në raste të caktuara, [pakot e të dhënave](#user-content-fn-2)[^2] mund të mos aplikohen me sukses në fillim.** + +Për këto raste, rekomandohet që serveri të rifillojë **2 herë**. + +{% endhint %} + +Pakot e të dhënave mund të dëmtohen lehtë kur Minecraft-i përditësohet. + +Veçanërisht, nëse pakot e të dhënave janë dëmtuar plotësisht, serveri mund të përplaset, +kështu që është e rëndësishme të kryeni testimet e mjaftueshme para se të përditësoni serverin. + +{% hint style="info" %} + +**Pas komandës së fillimit të serverit, mund të shtypni `safeMode` për të çaktivizuar të gjitha pakot e të dhënave dhe pastaj të rifillonit serverin.** + +[Për më shumë informacion, shihni `Referencat > Argumentet dhe Pronat`.](../reference/arguments.md) + +{% endhint %} + +Pakot e aplikuar mund të verifikohen duke përdorur komandën `/datapack list`. + +*** + +[^1]: Ose edhe Shtojcat e Minecraft: Bedrock Edition. + +[^2]: Shtimi i grupimeve të krijesave etj. diff --git a/sq/origin/plazma/administration/getting-started/next-step.md b/sq/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..23a141540 --- /dev/null +++ b/sq/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Mësoni se si të personalizoni serverin. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Këtu janë disa mënyra për të personalizuar dhe përdorur Plazma-n. + +## Ndryshimi i konfigurimit + +Mënyra më bazike për të personalizuar Plazma-n është duke ndryshuar konfigurimin. + +Plazma ofron konfigurime të fuqishme që përfshijnë mekanizmat e lojës dhe cilësitë e skajeve. + +Përshkrimi i konfigurimit të Plazma-s mund të gjendet në faqen e mëposhtme. + +{% content-ref url="../reference/configurations/" %} +[konfigurimet](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Përdorimi i shtojcave + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Kjo është arsyeja kryesore pse të përdorni Plazma dhe mënyra më e fuqishme për të personalizuar Plazma-n. Ekosistemi i fuqishëm i shtojcave të Plazma lejon përshtatjen e lehtë të serverit tuaj. + +Ka disa mënyra për të gjetur dhe shkarkuar shtojcat. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Ka shumë shërbime për shkarkimin e shtojcave. Në mes tyre, shërbimet si [Forumi i SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) kontrollojnë shtojcat para se të ngarkohen, duke siguruar që vetëm shtojcat e sigurta qarkullojnë. + +### Aplikimi i Shtojcave + +Pas shkarkimit të shtojcave, tani është koha për t'i aplikuar ato. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Vendosni dosjen e shkarkuar në dosjen `shtojcat` të serverit dhe (ri)nisni serverin. +3. Kur Plazma fillon, do të shihni përmbajtje të re në konsolë. Kjo tregon se Plazma ka ngarkuar shtojcat me sukses. +4. Edhe pse Plazma ka ngarkuar shtojcat me sukses, ato mund të mos fillojnë siç duhet. Përdorni komandën `/shtojcat` për të shfaqur shtojcat e ngarkuara aktualisht në server. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Nëse shtojcat nuk janë ngarkuar me sukses, mund të gjeni zgjidhjet në faqen e mëposhtme. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Përdorimi i Pakove të të Dhënave + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Me pakot e të dhënave, mund të shtoni grupime të reja të krijesave dhe sfidave në lojë. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Disa pakove të dëmshme të të dhënave mund të shkaktojnë dëme të pakthyeshme në botë. + +Prandaj, është e rekomandueshme të bëni një kopje rezervë të botës para se të aplikoni pakot e të dhënave. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Pas shkarkimit të pakove të të dhënave, vendosini ato në dosjen `datapacks` të botës së serverit tuaj. Nëse dosja nuk ekziston, mund ta krijoni atë dhe ta shtoni. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Për këto raste, rekomandohet që serveri të rifillojë **2 herë**. +{% endhint %} + +Pakot e të dhënave mund të dëmtohen lehtë kur Minecraft-i përditësohet. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Pakot e aplikuar mund të verifikohen duke përdorur komandën `/datapack list`. + +*** + +## Optimizimi + +Plazma ka shumë rregulla të optimizimit të aplikuar. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proksi + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Për informacion mbi konfigurimin e proksit në mënyrë të sigurt dhe të saktë, shihni faqen më poshtë. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Siguria + +Minecraft ka zhvilluar modifikime që lejojnë lehtësisht hyrjen në linjë të një [motori sulmues vulnerabil](#user-content-fn-3)[^3]. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Konfigurimi i lejeve + +Disa komandat e administratorit të shtojcave kanë vulnerabilitete kur lejet nuk janë konfiguruar si duhet. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Bllokim i X-Ray + +X-Ray është një nga vulnerabilitetet që lehtë mund të përdoret edhe në klientët bazë të optimizuar. + +Plazma ofron një konfigurim që bllokon X-Ray-në në mënyrë parazgjedhur. + +Për më shumë informacion mbi mënyrat dhe përshkrimet e bllokimit të X-Ray, shihni faqen më poshtë. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Lista e bardhë + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Për të parë lojtarët e lejuar, përdorni `/whitelist query`. + +*** + +[^1]: Ose edhe Shtojcat e Minecraft: Bedrock Edition. + +[^2]: Shtimi i grupimeve të krijesave etj. + +[^3]: Përgjithësisht quhet "hile". + +[^4]: Nëse konfigurimi nuk është i optimizuar, ose Plazma është e vjetruar, ose nëse ka vulnerabilitete të reja, atëherë mund të mos jenë të bllokuara. + +[^5]: Kur lojtari hyen në server, bëhet përmes serverit proksi Ngrok dhe adresa e Ngrok që jepet për çdo ri-startim është e ndryshme. diff --git a/sq/origin/plazma/administration/reference/README.md b/sq/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..c12113888 --- /dev/null +++ b/sq/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Mësoni mënyrat e përdorueshmërisë të ofruara nga Plazma. +--- + +# 📜 리퍼런스 + +Plazma ofron disa mënyra të përdorueshmërisë. + +Nga këto, 4 mënyrat e përdorueshmërisë që mund të përdoren menjëherë pa nevojë për veprime shtesë. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Serveri Zyrtar i Discord-it](https://discord.gg/MmfC52K8A8) ose [Diskutimet në GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) për të pyetur komunitetin! +{% endhint %} + +*** + +## 🖥️ Komandat + +> Komandat lejojnë mbledhjen e informacionit në lojë ose përshtatjen e mjedisit të lojës për përdoruesit. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Lejet + +> Lejet përcaktojnë gamën e veprimeve që lojtari mund të kryejë. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argumentet dhe atributet + +> Argumentet dhe atributet kanë një ndikim të gjerë në funksionimin e Plazma. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfigurimi + +> Konfigurimi është mënyra themelore për të përdorur Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/sq/origin/plazma/administration/reference/arguments.md b/sq/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..de02f2ec5 --- /dev/null +++ b/sq/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Mësoni për argumentet fillestare dhe përkatësitë e sistemit. +--- + +# 🎛️ Argumentet dhe përkatësitë + +Fillimi i blerjes dhe atributet e sistemit janë vlera shtesë për ekzekutimin e Plazma-s [komandave të përdorura](#user-content-fn-1)[^1], që kanë një ndikim të gjerë në funksionimin e Plazma-s. + +[Pozicioni i shtimit të komandës](#user-content-fn-2)[^2] ndahet në **argumentin fillestar** dhe **tiparet e sistemit** sipas pozicionit të shtimit të komandës. + +*** + +## Përkatësitë e sistemit + +Përkatësitë e sistemit vendosen para `-jar` përpara se Plazma të inicializohet në JVM. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Mënyra e përdorimit + +Përkatësitë e sistemit vendosen si argumente Java midis `java` dhe `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` tregon se ky argument nuk është i brendshëm në JVM, por është argument i shtuar ekskluzivisht për Plazma-n. + +Nëse nuk jepni asnjë vlerë për tipare, vlera do të mbetet [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Përkatësitë e tërësisë së sistemit + +#### `convertLegacySigns` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Përditëson formatin e shenjave të ndaluar për përdorim. + +#### `debug.entities` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit të informacioneve të entitetit. + +#### `debug.rewriteForIDE` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon revisionin NMS për IDE për të marrë informacionin e brendshëm në mënyrë korrekte dhe për të rimapeuar automatikisht informacionin e versionit të brendshëm. + +#### `disable.watchdog` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon sistemin e sinjalizimit të Watchdog të Spigot-it. + +#### `letMeReload` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon mesazhin e rikonfirmimit të komandës `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Nëse jeni zhvillues shtojcësh dhe duhet të përditësoni shtojcën, përdorni hotswap në vend të `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon shtojcët që përdorin sistemin standard të hyrjeve-daljeve. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Njofton kur zbulohet formatimi i vjetruar në komponentët e bisedës. + +#### `Paper.bypassHostCheck` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon verifikimin e përputhshmërisë së modelit të serverit kur një lojtar lidhet me serverin. + +#### `Paper.debugDynamicMissingKeys` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit për çelësat që mungojnë në objektet NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit për profilet e kokrave të pavlefshme. + +Ky veprim regjistron të gjitha kokrat e pavlefshme në botë me pozicionin e tyre. + +#### `Paper.disableChannelLimit` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon sistemin e prioritetit të klasave shtojcës. + +Është e dobishme në rast se ka probleme me shënjuesit e klasave shtojcës. + +#### `Paper.disableFlushConsolidate` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon sistemin e konsolidimit të shkarkimit të Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Vlera parazgjedhëse**: `750` + +Nëse entiteti është më i madh se vlera e caktuar, ndahet në pako të ndryshme për transmetim. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Vlera parazgjedhëse**: `8192` + +Cakton madhësinë maksimale të pako të pranueshme nga serveri. + +#### `Paper.ignoreJavaVersion` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon verifikimin e versionit të Java-së. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Kjo mund të shkaktojë dëmtim të përhershëm të skedarëve të botës dhe shkatërrimin e mekanikës së lojës. + +Çdo problem që shkaktohet nga kjo është përgjegjësia e përdoruesit dhe Plamza nuk ofron asnjë mbështetje për këtë. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Vlera parazgjedhëse**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Vlera parazgjedhëse**: `80` + +Cakton gjatësinë maksimale të shenjave në një rresht. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Vlera parazgjedhëse**: `(versioni i botës) + 1` + +Cakton versionin e informacionit të përditësimit fillestar për botën që do të inicializohet së pari. + +Është e dobishme kur ka nevojë për të azhurnuar një numër të madh të blloqeve, por nuk përdoret në raste të tjera. + +#### `Paper.parseYamlCommentsByDefault` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `True` + +Aktivizon trajtimin e komenteve YAML-së. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Vlera parazgjedhëse**: `30` + +Kur nuk pranohet asnjë të dhënë nga një lojtar për një periudhë të caktuar (sekonda), lojtari do të dërgohet larg. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Ignoron komentet e pronave të serverit. + +#### `Paper.debug-sync-loads` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit të ngarkesave sinkrone të blloqeve. + +#### `Paper.enable-sync-chunk-writes` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon sistemin e shkrimit të blloqeve të sinkronizuara të Minecraft-it. + +Ky veprim shkruan secilin bllok në një rend të caktuar, duke shkaktuar një ulje të madhe të performancës. + +#### `Paper.explicit-flush` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon shprazjen e qartë të rrjetit të kanaleve. + +#### `Paper.strict-thread-checks` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Regjistron gjithmonë gabimet që ndodhin jashtë thread-it kryesor. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Nëse një detyrë e rezervuar ka një vonesë të tepërt, shfaq një sinjalizim. + +#### `Paperclip.patchOnly` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Kur përdoret ekzekutuesi i ofruar, aplikon vetëm ndryshime pa filluar serverin. + +#### `Plazma.aggressiveOptimize` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` +- **konflikt**: `Plazma.disableConfigOptimization` + +Optimizonin e konfigurimit fillimor në mënyrë më të fortë. + +Aktivizimi bën serverin më të shpejtë dhe më të sigurt, por mund të ketë ndikim të madh në lojë. + +#### `Plazma.disableConfigOptimization` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` +- **konflikt**: `Plazma.aggressiveOptimize` + +Nuk optimizon konfigurimin fillestar. + +Kjo e përdor konfigurimin bazë të Paper. + +#### `Plazma.iDijaCfarePoBej` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` + +Çaktivizon markën Plazma dhe përdor favicon bazë të serverit vanilë. + +#### `Plazma.useVanillaConfiguration` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` +- **konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Kjo mund të ketë ndikim të madh në sigurinë dhe performancën e serverit. + +Çdo problem që shkaktohet duke përdorur këtë atribut është në dore të administratorit të serverit. +{% endhint %} + +Optimizon konfigurimin fillestar me vlerat bazë të ofruara nga Mojang. + +Kjo çaktivizon të gjitha patch-et e realizuara në dobësitë nga Paper. + +Patch-et e dobësive mund të aktivizohen përsëri në konfigurimin e Paper ose Plazma. + +#### `Plazma.vanillaize` + +- **Forma**: `Boolean` +- **Default**: `true` +- **konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Optimizon konfigurimin fillestar në një mënyrë të ngjashme me vanilën. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Atribute i ndaluar në përdorim + +Atributet e sistemit nën janë të ndaluara për përdorim. + +#### `timings.bypassMax` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` +- **Ndalur në përdorim**: Timings pas heqjes së plotë në Plazma + +Vendos nëse mund të kalohet maksimumi i vlerave që mund të dërgohen në API-në e Timings së Aikarit. + +Edhe nëse kjo ndodh, do të aplikohet një kufizim i shpejtësisë nëse nuk është trajtuar në mënyrë të veçantë nga API-ja. + +*** + +## Argumenti fillimor + +Argumenti fillimor vendoset pas `-jar *.jar` dhe inicializon Plazma-në dhe trajtohet së bashku me vlerat e tjera. + +### Mënyra e përdorimit + +Pas `-jar *.jar`, cilësitë e sistemit vendosen si argumente komandë për programin. + +Për shembull, nëse dëshironi të përdorni argumentin fillimor `nogui`,\ +duke e vendosur si më poshtë, Plazma do ta trajtojë argumentin `nogui` gjatë inicializimit. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumenti i plotë fillimor + +#### `bukkit-settings` + +- **Alias**: `b` +- **Vlera parazgjedhur**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Vlera parazgjedhur**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Vlera parazgjedhur**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Fillon serverin në botën demo. + +#### `eraseCache` + +Fshin skedarët e mbetur të kešit pas përmirësimit të botës. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Shfaq argumentet dhe shpjegimin e plotë të fillimit të Plazma-së. + +#### `initSettings` + +Krijon vetëm skedarët e konfigurimit dhe mbyll serverin. + +#### `jfrProfile` + +Aktivizon profilimin JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Çaktivizon panelin e ndërfaqes grafike. + +#### `nojline` + +Çaktivizon JLine dhe përdor konzolën vanilje. + +#### `online-mode` + +- **Alias**: `o` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Zgjedh nëse do të verifikohen lojtarët me serverin e autentifikimit të Mojang-ut. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Vlera parazgjedhur**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Cakton vendndodhjen e [skedarit konfigurues të PaperSpigot-it të ndaluar në përdorim](../reference/configurations/paper/README.md). + +Përdoret për të transferuar konfigurimin ekzistues në një skedar të ri, dhe më pas nuk do të përdoret më. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Vlera parazgjedhur**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Vlera parazgjedhur**: `plugins` + +Cakton vendndodhjen e dosjes së shtojcave. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Vlera parazgjedhur**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Vlera parazgjedhur**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Fillon serverin në një gjendje të plotë vanilje. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Cakton portin e serverit. + +#### `server-name` + +- **Vlera parazgjedhur**: `Një Server Plazma` + +Cakton emrin e serverit. + +#### `spigot-settings` + +- **Alias**: `S` +- **Vlera parazgjedhur**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Shfaq versionin e Plazma-së. + +#### `world-dir` + +- **Alias**: `W`, `universi`, `kontenieri i botës` +- **Vlera parazgjedhur**: `(dosja e serverit)` + +Cakton vendndodhjen ku ruhen skedarët e botës. + +#### `world-name` + +- **Alias**: `w`, `botë` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Cakton emrin e skedarit të botës. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Vendndodhja e argumenteve ndryshon në varësi të vendndodhjes së shtesave. + +[^3]: Për shembull, nëse dëshironi të aktivizoni `Plazma.iKnowWhatIAmDoing` në `true`, mund ta bëni këtë duke vendosur `-DPlazma.iKnowWhatIAmDoing=true` ose vetëm `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: Për shembull, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektori i eventit. + +[^6]: Detektori i eventit. + +[^7]: Klienti. + +[^8]: Sinjali që tregon se serveri është lidhur normalisht si zemërpuls. + +[^9]: Duke përdorur funksionin e largimit të AFK të Purpur, mund të dërgoni larg edhe lojtarët që janë larguar nga vendi. + +[^10]: Sistemi i shkrimit të blloqeve të sinkronizuar, Sync Chunk Write System. + +[^11]: `KUJDES! Plazma mund të shkaktojë probleme të papritura, kështu që sigurohuni të testoni plotësisht para se ta përdorni në një server publik.` + +[^12]: Në lojë, `optimizimi i botës` vepron në këtë mënyrë. + +[^13]: Administratorët me `nivel 2` ose më të lartë janë përjashtuar. + +[^14]: Protokolli i Internetit, IP. diff --git a/sq/origin/plazma/administration/reference/commands.md b/sq/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..4e2ab1f98 --- /dev/null +++ b/sq/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Mësoni për komandat e disponueshme në Plazma. +--- + +# 🖥️ Komandat diff --git a/sq/origin/plazma/administration/reference/configurations/README.md b/sq/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..60ea1960c --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfigurimi është mënyra themelore për të përdorur Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Atributet + +> Atributet janë skedarët bazë që ofron Minecraft. Me përdorimin e atributeve, mund të ndryshoni mekanizmat bazë të lojës. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Konfigurimi i Bukkit + +> Konfigurimi i Bukkit është skedari bazë që ofron Plazma. Me përdorimin e konfigurimit të Bukkit, mund të ndryshoni mekanizmat bazë të serverit Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Konfigurimi i Spigot + +> Konfigurimi i Spigot ju lejon të modifikoni detajet e lojës, trajtimin e lojtarëve, funksionimin e komandave, dhe mesazhet. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Konfigurimi i Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Konfigurimi i Pufferfish + +> Konfigurimi i Pufferfish ju lejon të modifikoni trajtimin e botës dhe entiteteve në Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Konfigurimi i Purpur + +> Atributet e Purpur ju lejojnë të modifikoni të dhënat bazë të lojës. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Konfigurimi i Plazma + +> Konfigurimi i Plazma ju lejon të personalizoni funksionet e Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/sq/origin/plazma/administration/reference/configurations/bukkit.md b/sq/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..a2b899aa1 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/sq/origin/plazma/administration/reference/configurations/paper/README.md b/sq/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..d0fef1939 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni për qëllimin e çdo skedari në dosjen e konfigurimit. +--- + +# 🛩️ Letër diff --git a/sq/origin/plazma/administration/reference/configurations/paper/global.md b/sq/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..09e1a7b11 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/sq/origin/plazma/administration/reference/configurations/paper/world.md b/sq/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..fc8935819 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Bota diff --git a/sq/origin/plazma/administration/reference/configurations/plazma/README.md b/sq/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..987d6ee26 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni për qëllimin e çdo skedari në dosjen e konfigurimit. +--- + +# ✨ Plazma diff --git a/sq/origin/plazma/administration/reference/configurations/plazma/global.md b/sq/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..227b06b35 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/sq/origin/plazma/administration/reference/configurations/plazma/world.md b/sq/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..d1498a203 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/sq/origin/plazma/administration/reference/configurations/plazma/worlds.md b/sq/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..52dfa6fbd --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në plazma-world.yml. +--- + +# ✨ Plazma (kompozimi i botëve) diff --git a/sq/origin/plazma/administration/reference/configurations/property.md b/sq/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..033ae001c --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në server.properties. +--- + +# 🪨 Server.properties diff --git a/sq/origin/plazma/administration/reference/configurations/pufferfish.md b/sq/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..adbd810ab --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/sq/origin/plazma/administration/reference/configurations/purpur/README.md b/sq/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..e063b2699 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në purpur.yml. +--- + +# 🦑 Purpur diff --git a/sq/origin/plazma/administration/reference/configurations/purpur/global.md b/sq/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..4eadb843c --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/sq/origin/plazma/administration/reference/configurations/purpur/world.md b/sq/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..47eb44311 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/sq/origin/plazma/administration/reference/configurations/spigot.md b/sq/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..e2b5d7e60 --- /dev/null +++ b/sq/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në spigot.yml. +--- + +# 🚰 Spigot diff --git a/sq/origin/plazma/administration/reference/permissions.md b/sq/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..e4cbd94ef --- /dev/null +++ b/sq/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Merrni informacion mbi lejet e Plazma-së. +--- + +# 🛡️ Leje + +Lejet është një mjet i thjeshtë i sigurisë që cakton gamën e veprimeve që lojtarët në server mund të bëjnë në mënyrë reciproke. + +Për të përdorur lejet në mënyrë efektive dhe për t'i modifikuar lehtë, duhet të përdorni shtojcën si [LuckPerms](https://luckperms.net). + +*** + +## Kuptimi i sistemit bazë të lejeve + +Në Minecraft, ka grupe themelore të lejeve të menaxhimit të disponueshme. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Lojtar**\ + Një grup i lejeve që jepet në përgjithësi për të gjithë lojtarët. +2. **Arbitër**\ + Mund të injorosh mbrojtjen e lindjes. +3. **Menaxheri i botës**\ + Mund të përdorë të gjitha komandat dhe blloqet e komandave që kanë të bëjnë me menaxhimin e botës.\ + Ky është grupi i bazë i lejeve që aplikohet në paketat e të dhënave dhe blloqet e komandave. +4. **Administrator**\ + Mund të përdorë të gjitha komandat që kanë të bëjnë me menaxhimin e lojtarëve. +5. **Administratori i përgjithshëm**\ + Mund të përdorë të gjitha komandat që kanë të bëjnë me menaxhimin e serverit.\ + Ky është grupi i bazë i lejeve që aplikohet në konzolën dhe administratorët. + +*** + +## Caktimi i lejeve + +*** + +## Leje të plota + +*** + +#### `lejo.rrugë.(Çelësi i Hapesiruar)` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon lojtarët të `uleshin dhe të bashkëveprojnë` me entitetet për të shkuar mbi to. + +Kur ulesh në një entitet, mund të përdorësh tastin e `lëvizjes` për të drejtuar lëvizjen e entitetit dhe tastin e `kthimit` për të bërë një hop ose fluturim. + +Në `(Çelësi i Hapesiruar)` vendoset [ID-ja e Hapesiruar](#user-content-fn-2)[^2] e entitetit. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `lejo.speciale.(Çelësi i Hapesiruar)` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon lojtarët të përdorin aftësitë speciale të entitetit kur janë duke u udhëtuar me të. + +Nuk janë të gjitha aftësitë speciale të disponueshme për të gjitha entitetet. Për një listë të plotë të aftësive speciale të disponueshme, shihni më poshtë. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Publikoni idetë tuaja në [Plazma Discord](https://plazmamc.org/discord) ose [Bisedat e GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Shikoni aftësitë speciale aktualisht të disponueshme + +- **`crepper`**\ + Kur shtyp tastin e `kthimit`, shpërthen.\ + Nëse lojtari ka lejen `crepper i fuqizuar` mund të mbajë shtypur tastin e `kthimit` për të ngarkuar shpërthimin. +- **`delfin`**\ + Kur shtyp tastin e `kthimit`, bën një rrëmbim. +- **`fantazmë`**\ + Kur shtyp tastin e `kthimit`, shpërthen flakë. +- **`me kërcim`**\ + Kur `bashkëvepron`, shpërthen kokën e me kërcim. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.kompas` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/kompas`](commands.md#kompas). + +#### `bukkit.command.kreditet` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/kreditet (Lojtari)`](commands.md#kreditet). + +Nëse shtohet `.tjetër` pas emrit të lejes, lejon përdorimin nga lojtarët e tjerë. + +#### `bukkit.command.demo` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/demo (Lojtari)`](commands.md#demo). + +Nëse shtohet `.tjetër` pas emrit të lejes, lejon përdorimin nga lojtarët e tjerë. + +#### `bukkit.command.ping` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/ping (Lojtari)`](commands.md#ping). + +Nëse shtohet `.tjetër` pas emrit të lejes, lejon përdorimin nga lojtarët e tjerë. + +#### `bukkit.command.ram` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/rambar (Lojtari)`](commands.md#rambar). + +Nëse shtohet `.tjetër` pas emrit të lejes, lejon përdorimin nga lojtarët e tjerë. + +#### `bukkit.command.ristart` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/ristart`](commands.md#ristart). + +#### `bukkit.command.tps` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/tpsbar (Lojtari)`](commands.md#tpsbar). + +Nëse shtohet `.tjetër` pas emrit të lejes, lejon përdorimin nga lojtarët e tjerë. + +#### `bukkit.command.timings` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Për të mësuar më shumë për komandat e ngjashme, shihni [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon përdorimin e komandës `/gamemode (GameMode) (Lojtari)`. + +Nëse shtohet `.tjetër` pas emrit të lejes, lejon përdorimin nga lojtarët e tjerë. + +#### `paper.antixray.bypass` + +- \*\*Ofrohet nga: `Asnjë` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Kjo do të sjellë përfitime në performancë për të dyja palët. + +> Për të mësuar më shumë rreth konfigurimit X-Ray, shihni faqen më poshtë. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- \*\*Ofrohet nga: `Asnjë` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- \*\*Ofrohet nga: `Asnjë` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- \*\*Ofrohet nga: `Asnjë` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon përdorimin e etiketave [MiniMessage](https://docs.advntr.dev/minimessage/format.html) në mocë. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- \*\*Ofrohet nga: `Asnjë` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- \*\*Ofrohet nga: `Asnjë` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- \*\*Ofrohet nga: `Asnjë` + +E përjashton lojtarin nga dëbimi i automatizuar për pasivitet. + +#### `purpur.debug.f3n` + +- \*\*Ofrohet nga: `Menaxheri i botës` + +Lejon lojtarët të ndryshojnë mënyrën e lojës me tastin `F3 + N`. + +Nëse nuk ka leje për këtë mënyrë loje, nuk do të funksionojë. + +#### `purpur.drop.spawners` + +- \*\*Ofrohet nga: `Asnjë` + +Kur minon blloqet e spawnerit me armë me prekje të butë, ato do të bien poshtë si blloqe spawneri. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumërNëNjëri)` + +- \*\*Ofrohet nga: `Asnjë` + +Ndryshon madhësinë e kofshës së endër. + +Në `(NumërNëNjëri)` mund të jepni `një`, `dy`, `tre`, `katër`, `pesë`, `gjashtë`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon funksionimin e totemit të pafajshëm edhe kur është në inventar. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon lojtarin të injorojë kufirin e numrit të hyrës. + +#### `purpur.mending_shift_click` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon lojtarin të riparojë sendin që mban duke `u shtrirë dhe duke ndikuar njëri-tjetrin`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon lojtarin të vendosë spawner-in. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- \*\*Ofrohet nga: `Asnjë` + +Lejon lojtarin të teleportohet menjëherë kur përdor portën e Netherit. + +#### `purpur.sign.color` + +- \*\*Ofrohet nga: `Asnjë` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- \*\*Ofrohet nga: `Asnjë` + +Lejohet përdorimi i kodit të zbehjes `(&o)` në tabelat e sinjalizimit. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- \*\*Ofrohet nga: `Asnjë` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- \*\*Ofrohet nga: `Asnjë` + +Lejohet lojtari të parandalojë shpërthimin e TNT-së duke `bashkëvepruar` me thikën. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Lejet e parashikuara + +#### `plazma.bypass.ncr-require` + +- \*\*Ofrohet nga: `Asnjë` + +Lejohet lojtari të hyjë pa pasur instaluar modulin [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operator. + +[^2]: P.sh.: `ender_dragon` diff --git a/sq/origin/plazma/adminstration/README.md b/sq/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..cba2d4d79 --- /dev/null +++ b/sq/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Krijo serverin tënd duke përdorur Plazmën. +--- + +# ⚒️ Udhëzues për menaxhimin e serverit diff --git a/sq/origin/plazma/adminstration/expert/README.md b/sq/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..5780cc8ff --- /dev/null +++ b/sq/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Mësoni se si të trajtoni Plazma në mënyrë profesionale. +--- + +# 🎓 thellë diff --git a/sq/origin/plazma/adminstration/expert/fix-exploits.md b/sq/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..f8f5e5d40 --- /dev/null +++ b/sq/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Mësoni për të dhënat e dobëta të njohura dhe mënyrën për t'i zgjidhur. +--- + +# ⚠️ Të dhënat e dobëta të njohura dhe mënyra për t'i zgjidhur diff --git a/sq/origin/plazma/adminstration/expert/optimize.md b/sq/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..89c429350 --- /dev/null +++ b/sq/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Mësoni se si të optimizoni Plazma-n. +--- + +# 🧹 Optimizimi maksimal diff --git a/sq/origin/plazma/adminstration/expert/vanillaize.md b/sq/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..d32e0b79b --- /dev/null +++ b/sq/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Mësoni se si të riktheni rregullimin e letër dhe vaniljes. +--- + +# ↩️ Vanilizimi + +{% hint style="warning" %} + +### Letra nuk ofron shumicën e zgjidhjeve për të zgjidhur gabimet e vaniljes. + +Plazma aktualisht po zhvillon mundësinë për të çaktivizuar zgjidhjet e këtyre gabimeve. + +Prandaj, kjo udhëzues është ende në proces shkrimi dhe informacioni mund të ndryshojë në çdo kohë. +{% endhint %} diff --git a/sq/origin/plazma/adminstration/faq.md b/sq/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..e4de25c74 --- /dev/null +++ b/sq/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Merrni informacion mbi pyetjet e shpeshta. +--- + +# ⁉️ Pyetje të shpeshta + +{% hint style="info" %} + +### Nuk mund të gjeni përgjigjen e dëshiruar? + +Pyet komunitetin në [serverin Discord zyrtar](https://discord.gg/MmfC52K8A8) ose në [Problemet e GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Nuk ekzekutohet duke shfaqur një mesazh + +Nëse shfaqet `no main manifest attribute, në plazma-(version).jar`,\ +skedari i shkarkuar është skedar API zhvillimi, duhet të shkarkoni **Reobf Paperweight** nga faqja e GitHub. + +Për të mësuar më shumë, konsultoni faqen në vijim. + +{% content-ref url="getting-started/" %} +[fillimi](getting-started#id-2) +{% endcontent-ref %} + +### Një sinjalizim shfaqet çdo herë që fillon serveri + +Plazma përmban disa patch-e të paqëndrueshme dhe gjithmonë mund të ketë gabime, prandaj shfaq këtë sinjalizim në fillimin e serverit. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Këtë sinjalizim mund ta çaktivizoni duke përdorur atributin e sistemit [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Për të mësuar më shumë, konsultoni faqen në vijim. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Disponueshëm nga versioni 1.20.1 diff --git a/sq/origin/plazma/adminstration/getting-started/README.md b/sq/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..ba185aec1 --- /dev/null +++ b/sq/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,319 @@ +--- +description: Mësoni si të krijoni një server me Plazma. +--- + +# 👟 Filloni + +Për të përdorur Plazma-n në mënyrë stabile, sistemi duhet të plotësojë këto kërkesa: + +| | Minimumi | Rekomanduar | +| :-----------------: | -------: | ----------: | +| Arkitektura | x64 | - | +| RAM | 8GB | 16GB | +| Hapësira e ruajtjes | 1GB | 8GB | +| JRE | 17 | 21 | + +Për të bërë ndryshime të lehta në dosjet e konfigurimit, është gjithashtu e mirë të instaloni një redaktues si [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Instalimi i JRE-së + +Siç mund të kuptohet nga emri, Minecraft: **"Java"** Edition është zhvilluar në Java, kështu që për ta ekzekutuar, ka nevojë për JRE[^1]. + +Pasiguria Plazma bazohet në platformën zyrtare të serverit të Mojang Studios [^2], prandaj për të përdorur Plazma-n, duhet të instalohet JRE. + +### 1.1 Verifikimi i JRE-së + +Për të verifikuar nëse JRE është i instaluar në sistemin tuaj, shkruani dhe ekzekutoni [`cmd /k java --version`](#user-content-fn-4)[^4] në dritaren e ekzekutimit. + +Nëse shfaqet si më poshtë, kaloni në [2 hapat e ardhshëm](setup.md#id-2). + +{% code title="Dalja e saktë" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Nëse nuk shfaqet si më poshtë ose si më poshtë, atëherë JRE nuk ekziston ose është shumë i vjetër, kështu që duhet të vazhdoni me [1.2 hapin](setup.md#id-1.2). + +{% code title="JRE nuk është i instaluar" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE shumë i vjetër" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE instalimi + +Në këtë udhëzues përdorim Azul Zulu si një [nga llojet](#user-content-fn-5)[^5] e JRE. + +Pas instalimit, rishikoni hapin [1.1](setup.md#id-1.1) për të siguruar që instalimi është kryer me sukses. + +{% tabs %} +{% tab title="Windows" %} + +1. Fillimisht, shkarkoni **JDK 21** nga [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) në formatin `.msi`. +2. Ekzekutoni magjistrin e instalimit të shkarkuar dhe klikoni "Vazhdo". +3. Aktivizoni opsionin `Set JAVA_HOME variable` në mes të shiritit të menysë në të majtë dhe klikoni "Vazhdo". +4. Klikoni "Instalo" për të përfunduar instalimin e JRE. + {% endtab %} + +{% tab title="macOS" %} +Shkarkoni dhe ekzekutoni magjistrin e instalimit të JRE nga [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) në formatin `.dmg`. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Fillimisht, shtoni repozitorin Azul Zulu në APT duke ekzekutuar komandën e mëposhtme në terminal. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Pastaj, instaloni JRE duke ekzekutuar komandën e mëposhtme në terminal. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Mund të instaloni JRE duke futur komandën e mëposhtme. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Shkarkimi i Plazmasë + +Plazma ofron një gamë të gjerë skedarësh ekzekutues. + +{% hint style="warning" %} + +### Në shumicën e rasteve, përdorim `Reobf Paperclip`. + +Për ata që janë të interesuar për zhvilluesit ose për veçoritë e çdo lloji, informacioni më poshtë është për ta.\ +Përdoruesit e zakonshëm mund të kalojnë në [hapat 3](setup.md#id-3) pa probleme. +{% endhint %} + +
+ +Më shumë informacion + +Emri i skedarit ekzekutues është `plazma-(menaxheri i versionit)-1.20.4-R0.1-SNAPSHOT-(forma e mapimit).jar`. + +- **Forma e mapimit**\ + Mapimi është një lloj hartimi që lidh kodin real të Minecraft me kodin e zbehur. + - **Reobf**\ + Rizbehja, njihet edhe si mapimi i Spigot dhe përdoret në shumicën e shtojcave NMS.\ + Nga versioni 1.20.5 do të ndalet përdorimi i tij. + - **Mojmap**\ + Mapimi i Mojang, mapimi i Minecraft vanilla. +- **Menaxheri i versionit**\ + Menaxheri i versionit është një lloj launcheri që nevojitet për të drejtuar serverin dhe për të patch-uar skedarët e serverit. + - **Paperclip**\ + Zhvilluar nga ekipi i PaperMC për Paper dhe platformat e tjera të derivuara, shkarkon libraritë dhe aplikon patch-et në server. + - **Bundler**\ + Menaxheri i versionit i Minecraft vanilla. + +
+ +*** + +## 3. Krijimi i skriptit të fillimit + +Për të filluar Plazmën lehtësisht dhe për të ristartuar serverin automatikisht, duhet të krijoni një [skript fillimi](#user-content-fn-6)[^6]. + +Mund të krijoni skriptin fillimi përmes [Flags.sh](https://flags.sh). Nëse jepni vetëm [memorien që do të përdoret](#user-content-fn-8)[^8] në Plazma, komanda do të optimizohet automatikisht. + +Mund të shkarkoni skriptin fillimi duke klikuar në butonin e shkarkimit në pjesën e poshtme të majtë.\ +**Verifikoni se skripti i shkarkuar përputhet me sistemin tuaj operativ.** + +*** + +## 4. Rregullimi i skedarëve + +Tani lëvizni skriptin e fillimit të shkarkuar dhe Plazmën në një dosje të re. + +{% hint style="warning" %} + +### Emri i dosjes duhet të jetë pa hapësira dhe të jetë në anglisht. + +Në kundërt, Plazma ose JRE mund të mos funksionojnë siç duhet. +{% endhint %} + +Tani ekzekutoni skriptin e fillimit. Për Windows, duhet të **lejoni** zgjedhjen e lejuar në dritaren e lejimit të firewall-it. + +*** + +## 5. EULA Konsentimi + +Pas ekzekutimit të skriptit fillimtar, do të krijohet një `eula.txt` në dosje. + +EULA[^9] është një marrëveshje licensimi që duhet të pranohet duke përdorur shërbimet e [Mojang Studios](#user-content-fn-10)[^10]. + +Nëse nuk pranoni EULA-n, nuk mund të filloni serverin dhe nëse shkelni EULA-n, mund të ndëshkoheni me pezullim të llogarisë etj. [sanksione.](#user-content-fn-11)[^11] + +Për të pranuar EULA-n, ndryshoni `eula=false` në `eula=true` në skedarin `eula.txt` dhe ruani ndryshimet. + +*** + +## 6. Lejimi i hyrjes nga jashtë (Windows) + +Sistemet moderne operative bllokojnë hyrjet e rrezikshme nga jashtë duke përdorur në mënyrë parazgjedhëse **firewall** dhe **ruter**. + +Për Windows, pasi që keni lejuar në [hapat 3](setup.md#id-3), duhet të bëni vetëm forwardimin e portit. + +{% hint style="info" %} + +### Ky udhëzues është shkruar në bazë të sistemit operativ Windows dhe [**UPnP**](#user-content-fn-12)[^12] si një ruter që mund të përdorësh. + +Nëse ruteri nuk e mbështet UPnP-në, për çdo ruter ka një panel të ndryshëm, kështu që duhet të kërkoni informata vetë. + +Ose mund të përdorni [Ngrok](https://ngrok.com/) për të krijuar një adresë të përkohshme. +{% endhint %} + +{% hint style="warning" %} + +### Sistemet operative (gjysmë) UNIX si Linux ose macOS kanë metoda të ndryshme për konfigurimin e shërbimeve të firewall-it, kështu që duhet të kërkoni informata vetë. + +{% endhint %} + +### 6.1 Verifikimi i nevojës për forwardim të portit + +Shkruani dhe ekzekutoni si më poshtë në dritaren e ekzekutimit. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Nëse output-i është `True`, atëherë jeni gati, nëse është `False`, duhet të konfiguroni forwardimin e portit. + +### 6.2 Hyrja në server + +{% tabs %} +{% tab title="Hyrja nga jashtë" %} +Nëse nuk ka nevojë për forwardim të portit ose e keni kryer me sukses, tani mund të hyrni në server. + +Adresa për hyrjen në server mund të kontrollohet [këtu](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Përmes UPnP për forwardimin e portit" %} +Në skedarin e serverit, aktivizoni `network.upnp-port-forwarding` në `true` në `purpur.yml`. + +Pastaj, ristartoni serverin dhe Plazma do të provojë automatikisht të bëjë forwardimin e portit. + +Suksesin e UPnP vlerësoni sipas mesazhit që shfaqet në konsolë, si `[UPnP] (mesazhi)`. + +| Mesazhi | Kuptimi | +| ------------------------------------ | --------------------------------------- | +| `Porti u hap me sukses (porti)` | Forwardimi i portit është i suksesshëm. | +| `Porti (porti) është i hapur tashmë` | Një shërbim tjetër po përdor këtë port. | +| `Dështoi hapja e portit (porti)` | Forwardimi i portit dështoi. | +| `Shërbimi nuk është në dispozicion` | Ruteri nuk e mbështet UPnP-në. | + +Kur serveri mbyllet, Plazma mbyll automatikisht portin. +{% endtab %} + +{% tab title="Krijimi i adresës së përkohshme me Ngrok" %} +Përdorimi i Ngrok është i dobishëm për testim të shkurtër, lojë bashkëpunuese ose lojë me miqtë. + +1. Shkarkoni skedarin ZIP `Windows (64-bit)` nga [faqja zyrtare e Ngrok](https://ngrok.com/download). +2. Vendosni skedarin e shkarkuar të Ngrok në dosjen e serverit. +3. Në [panelin e Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) krijoni [tokenin e autorizimit](#user-content-fn-13)[^13]. +4. Ekzekutoni komandën që shfaqet në dritaren e komandës në dosjen e serverit. +5. Shtoni `start /b ngrok tcp --region jp 25565` në pjesën më sipër të skriptit të ekzekutimit, dhe `taskkill /f /t /im ngrok.exe` në fund të tij. +6. Në pjesën më të sipërme të konsolës shfaqet `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`, ku `0.tcp.jp.ngrok.io:12345` do të jetë adresa e serverit. +7. Tani mund të lidheni nga jashtë përmes kësaj adrese. + {% endtab %} + +{% tab title="Lidhu nga lokali" %} +Nëse dëshironi të lidheni me serverin nga kompjuteri lokal, mund të lidheni duke ekzekutuar `cmd /k ipconfig` në dritaren e ekzekutimit dhe duke përdorur `adresën IPv4` që shfaqet. + +Për shembull, pas ekzekutimit të komandës, nëse shfaqet si më poshtë, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Nëse provoni të lidheni me serverin nga lokal, mund të provoni të lidheni me adresën IPv4 që shfaqet si `192.168.3.7` këtu. + +Nëse serveri dhe loja po ekzekutohen në të njëjtin PC, mund të lidheni me `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Faza e zhvillimit + +Pas fillimit të suksesshëm të serverit dhe funksionimit të duhur të tij, tani është koha për të personalizuar serverin. + +Zbuloni se si të personalizoni serverin duke ndjekur udhëzimet më poshtë. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Ambienti i Ekzekutimit të Java-s. + +[^2]: Paperi i bazuar në Plazma është bazuar në Spigot dhe Spigot është platforma zyrtare e serverit. + +[^3]: Tasti Windows + R + +[^4]: Në rastin e Linuxit, në terminal shkruani `java --version` + +[^5]: JRE është një projekt burim i hapur dhe ka shumë lloje si platforma e serverit Minecraft. + +[^6]: Përgjithësisht njihet si **ekzekutor**. + +[^7]: Nëse aktivizoni "Rivendosje automatike", serveri do të ri-startohet automatikisht. Mund të mbyllni duke shtypur `Control + C`. + +[^8]: Nuk rekomandohet të kaloni gjysmën e sistemit. + + Për shembull, kur kapaciteti i përgjithshëm i memorjes së sistemit është 8GB, nuk rekomandohet ta vendosni më shumë se 4GB. + +[^9]: Marrëveshja e Licencës për Përdoruesin e Fundit, marrëveshja e licencës për përdoruesin përfundimtar. Për informacione më të hollësishme, ju lutemi kontrolloni [faqen zyrtare të Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Korporata Microsoft. + +[^11]: Në rastin e Republikës së Koreë, sipas nenit 32, paragrafi 1, nënparagrafi 9 të Ligjit për Promovimin e Industrisë së Lojërave, mund të bëhet denoncim ligjor nga **Korporata Microsoft e Koreas**. + +[^12]: Universal Plug & Play. Purpur i përfshirë në Plazma komunikon automatikisht me ruterin dhe hap portën vetëm kur serveri është në ekzekutim, kështu që nuk ka nevojë për përcjellje portash manualisht. + +[^13]: Nëse nuk keni llogari, regjistrohuni në Ngrok përmes llogarisë Google ose GitHub. diff --git a/sq/origin/plazma/adminstration/getting-started/customization.md b/sq/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..12d7d1578 --- /dev/null +++ b/sq/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Mësoni se si të personalizoni serverin. +--- + +# 🎨 Personalizimi i përdoruesit diff --git a/sq/origin/plazma/adminstration/referenca/README.md b/sq/origin/plazma/adminstration/referenca/README.md new file mode 100644 index 000000000..50287fa41 --- /dev/null +++ b/sq/origin/plazma/adminstration/referenca/README.md @@ -0,0 +1,2 @@ +# 📜 Referenca + diff --git a/sq/origin/plazma/adminstration/referenca/konfigurimi-i-skedareve/README.md b/sq/origin/plazma/adminstration/referenca/konfigurimi-i-skedareve/README.md new file mode 100644 index 000000000..f27a92e5e --- /dev/null +++ b/sq/origin/plazma/adminstration/referenca/konfigurimi-i-skedareve/README.md @@ -0,0 +1,2 @@ +# 🎨 Konfigurimi i Skedarëve + diff --git a/sq/origin/plazma/adminstration/reference/arguments.md b/sq/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..683983bde --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Mësoni për argumentet fillestare dhe përkatësitë e sistemit. +--- + +# 🎛️ Argumentet dhe përkatësitë + +Argumentet fillestare dhe përkatësitë e sistemit janë vlera shtesë që shtohen në [komandën e përdorur për ekzekutimin e Plazma-së](#user-content-fn-1)[^1], duke lejuar ndryshimin e vlerave të pa ndryshueshme pas ekzekutimit të Plazma-së. + +Sipas [vendit të shtimit të komandës](#user-content-fn-2)[^2], ato ndahen në **argumentet fillestare** dhe **përkatësitë e sistemit**. + +*** + +## Përkatësitë e sistemit + +Përkatësitë e sistemit vendosen para `-jar` përpara se Plazma të inicializohet në JVM. + +{% hint style="warning" %} + +### Ndryshimi i përkatësive të sistemit mund të ndikojë në funksionimin e Plazma-së dhe JVM, duke pasur ndikim të madh në lojë! + +Nëse nuk e dini saktësisht se çfarë rolit i shërben çdo përkatësi e sistemit, **mos e përdorni kurrë!** +{% endhint %} + +### Mënyra e përdorimit + +Përkatësitë e sistemit vendosen si argumente Java midis `java` dhe `-jar`. + +Për shembull, nëse dëshironi të aplikoni përkatësinë e sistemit `Plazma.dummyProperty`,\ +duke e vendosur si më poshtë, vlera `37` do të vendoset si përkatësi tjetër dhe Plazma do të inicializohet me këtë vlerë. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` tregon se ky argument nuk është i brendshëm në JVM, por është argument i shtuar ekskluzivisht për Plazma-n. + +Nëse nuk vendosni asnjë vlerë për përkatësi, vlera do të mbetet [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Platforma e serverit të linjës së Paperweight ka përfshirë një pikë në emrin e përkatësive për të ndarë përkatësitë e sistemit për çdo platformë. + +Në disa terminalë si Windows Powershell, mund të mos pranohen këto argumente, kështu që duhet të shtoni `"` në të dyja anët e argumentit.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Përkatësitë e tërësisë së sistemit + +#### `convertLegacySigns` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Përditëson formatin e shenjave të ndaluar për përdorim. + +#### `debug.entities` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit të informacioneve të entitetit. + +#### `debug.rewriteForIDE` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon revisionin NMS për IDE për të marrë informacionin e brendshëm në mënyrë korrekte dhe për të rimapeuar automatikisht informacionin e versionit të brendshëm. + +#### `disable.watchdog` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon sistemin e sinjalizimit të Watchdog të Spigot-it. + +#### `letMeReload` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon mesazhin e rikonfirmimit të komandës `/reload`. + +{% hint style="danger" %} + +### Komanda `/reload` është shumë e paqëndrueshme, kështu që të gjitha problemet e serverit që ndodhin pas përdorimit të komandës `/reload` janë përgjegjësia e përdoruesit. + +Nëse jeni zhvillues shtojcësh dhe duhet të përditësoni shtojcën, përdorni hotswap në vend të `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon shtojcët që përdorin sistemin standard të hyrjeve-daljeve. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Njofton kur zbulohet formatimi i vjetruar në komponentët e bisedës. + +#### `Paper.bypassHostCheck` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon verifikimin e përputhshmërisë së modelit të serverit kur një lojtar lidhet me serverin. + +#### `Paper.debugDynamicMissingKeys` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit për çelësat që mungojnë në objektet NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit për profilet e kokrave të pavlefshme. + +Ky veprim regjistron të gjitha kokrat e pavlefshme në botë me pozicionin e tyre. + +#### `Paper.disableChannelLimit` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon kufirin e numrit të kanaleve të shtojcës për çdo lojtar[^5]. + +#### `Paper.disableClassPrioritization` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon sistemin e prioritetit të klasave shtojcës. + +Është e dobishme në rast se ka probleme me shënjuesit e klasave shtojcës. + +#### `Paper.disableFlushConsolidate` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon sistemin e konsolidimit të shkarkimit të Netty. + +#### `Paper.excessiveTELimit` + +- **Forma**: `Integer` +- **Vlera parazgjedhëse**: `750` + +Nëse entiteti është më i madh se vlera e caktuar, ndahet në pako të ndryshme për transmetim. + +#### `Paper.filterThreshold` + +- **Forma**: `Integer` +- **Vlera parazgjedhëse**: `8192` + +Cakton madhësinë maksimale të pako të pranueshme nga serveri. + +#### `Paper.ignoreJavaVersion` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Çaktivizon verifikimin e versionit të Java-së. + +{% hint style="danger" %} + +### Kjo mundëson JVM të përpiqet të aksesojë kod që nuk ekziston! + +Kjo mund të shkaktojë dëmtim të përhershëm të skedarëve të botës dhe shkatërrimin e mekanikës së lojës. + +Çdo problem që shkaktohet nga kjo është përgjegjësia e përdoruesit dhe Plamza nuk ofron asnjë mbështetje për këtë. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Forma**: `Integer` +- **Vlera parazgjedhëse**: `64` + +Cakton kufirin e emrit të kanalit të shtojcës[^6]. + +#### `Paper.maxSignLength` + +- **Forma**: `Integer` +- **Vlera parazgjedhëse**: `80` + +Cakton gjatësinë maksimale të shenjave në një rresht. + +#### `Paper.minPrecachedDatafixVersion` + +- **Forma**: `Integer` +- **Vlera parazgjedhëse**: `(versioni i botës) + 1` + +Cakton versionin e informacionit të përditësimit fillestar për botën që do të inicializohet së pari. + +Është e dobishme kur ka nevojë për të azhurnuar një numër të madh të blloqeve, por nuk përdoret në raste të tjera. + +#### `Paper.parseYamlCommentsByDefault` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `True` + +Aktivizon trajtimin e komenteve YAML-së. + +#### `Paper.playerConnection.keepAlive` + +- **Forma**: `Integer` +- **Vlera parazgjedhëse**: `30` + +Kur nuk pranohet asnjë të dhënë nga një lojtar për një periudhë të caktuar (sekonda), lojtari do të dërgohet larg. + +Në raste normale, lojëra[^7] vazhdojnë të dërgojnë [sinjalet e zemrës](#user-content-fn-8)[^8] në server, kështu që nuk do të dërgohen larg, por nëse lojëra nuk reagon, serveri do të mendojë se ka ndodhur një konflikt në lojë dhe do të ndalojë trajtimin e lojtarëve. + +#### `Paper.skipServerPropertiesComments` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Ignoron komentet e pronave të serverit. + +#### `Paper.debug-sync-loads` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon regjistrimet e debugimit të ngarkesave sinkrone të blloqeve. + +#### `Paper.enable-sync-chunk-writes` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon sistemin e shkrimit të blloqeve të sinkronizuara të Minecraft-it. + +Ky veprim shkruan secilin bllok në një rend të caktuar, duke shkaktuar një ulje të madhe të performancës. + +#### `Paper.explicit-flush` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Aktivizon shprazjen e qartë të rrjetit të kanaleve. + +#### `Paper.strict-thread-checks` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Regjistron gjithmonë gabimet që ndodhin jashtë thread-it kryesor. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Nëse një detyrë e rezervuar ka një vonesë të tepërt, shfaq një sinjalizim. + +#### `Paperclip.patchOnly` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `False` + +Kur përdoret ekzekutuesi i ofruar, aplikon vetëm ndryshime pa filluar serverin. + +#### `Plazma.aggressiveOptimize` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` + +{% hint style="warning" %} + +### Kjo pronë pritet të zhvendoset si argument fillestar pas 1.20.5. + +{% endhint %} + +Aplikon optimizimin e konfigurimit të fillestarëve në fillim më të ashprë. + +Nëse aktivizohet, serveri bëhet më i shpejtë dhe më i sigurt, por mund të bllokojë disa gabime ose të ketë ndikim të madh në lojë. + +#### `Plazma.iDijaCfarePoBej` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` + +Parandalon shfaqjen e njoftimeve[^11] gjatë inicimit të Plazmës. + +### Atribute i ndaluar në përdorim + +Atributet e sistemit nën janë të ndaluara për përdorim. + +#### `timings.bypassMax` + +- **Forma**: `Boolean` +- **Vlera parazgjedhëse**: `false` +- **Ndalur në përdorim**: Timings pas heqjes së plotë në Plazma + +Vendos nëse mund të kalohet maksimumi i vlerave që mund të dërgohen në API-në e Timings së Aikarit. + +Edhe nëse kjo ndodh, do të aplikohet një kufizim i shpejtësisë nëse nuk është trajtuar në mënyrë të veçantë nga API-ja. + +*** + +## Argumenti fillimor + +Argumenti fillimor vendoset pas `-jar *.jar` dhe inicializon Plazma-në dhe trajtohet së bashku me vlerat e tjera. + +### Mënyra e përdorimit + +Pas `-jar *.jar`, cilësitë e sistemit vendosen si argumente komandë për programin. + +Për shembull, nëse dëshironi të përdorni argumentin fillimor `nogui`,\ +duke e vendosur si më poshtë, Plazma do ta trajtojë argumentin `nogui` gjatë inicializimit. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Argumenti i plotë fillimor + +#### `bukkit-settings` + +- **Alias**: `b` +- **Vlera parazgjedhur**: `bukkit.yml` + +Cakton emrin dhe vendndodhjen e [skedarit konfigurues të Bukkit-it](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Vlera parazgjedhur**: `commands.yml` + +Cakton emrin dhe vendndodhjen e [skedarit konfigurues të komandave të Bukkit-it](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Vlera parazgjedhur**: `server.properties` + +Cakton emrin dhe vendndodhjen e [skedarit të pronave të serverit](../reference/configurations/property.md). + +#### `demo` + +Fillon serverin në botën demo. + +#### `eraseCache` + +Fshin skedarët e mbetur të kešit pas përmirësimit të botës. + +#### `forceUpgrade` + +Forcon një [përmirësim](#user-content-fn-12)[^12] të botës pa marrë parasysh versionin. + +#### `help` + +- **Alias**: `?` + +Shfaq argumentet dhe shpjegimin e plotë të fillimit të Plazma-së. + +#### `initSettings` + +Krijon vetëm skedarët e konfigurimit dhe mbyll serverin. + +#### `jfrProfile` + +Aktivizon profilimin JFR. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Vendos numrin maksimal të [lojtarëve](#user-content-fn-14)[^14] të lejuar. + +#### `nogui` + +Çaktivizon panelin e ndërfaqes grafike. + +#### `nojline` + +Çaktivizon JLine dhe përdor konzolën vanilje. + +#### `online-mode` + +- **Alias**: `o` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Zgjedh nëse do të verifikohen lojtarët me serverin e autentifikimit të Mojang-ut. + +**Nëse nuk përdoret një [EULA](../getting-started/README.md#id-5) për shfrytëzim të proxy-së si Velocity, mund të ndëshkohet për shkelje.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Vlera parazgjedhur**: `paper.yml` + +{% hint style="warning" %} + +### Ky argument është ndaluar në përdorim pas versionit 1.19.4 + +{% endhint %} + +Cakton vendndodhjen e [skedarit konfigurues të PaperSpigot-it të ndaluar në përdorim](../reference/configurations/paper/README.md). + +Përdoret për të transferuar konfigurimin ekzistues në një skedar të ri, dhe më pas nuk do të përdoret më. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Vlera parazgjedhur**: `config` + +Cakton emrin dhe vendndodhjen e dosjes ku gjenden [skedarët konfigurues të Paper-it](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Cakton emrin dhe vendndodhjen e dosjes ku gjenden [skedarët konfigurues të Plazma-së](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Alias**: `p` +- **Vlera parazgjedhur**: `plugins` + +Cakton vendndodhjen e dosjes së shtojcave. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Vlera parazgjedhur**: `pufferfish.yml` + +Cakton emrin dhe vendndodhjen e [skedarit konfigurues të Pufferfish-it](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Vlera parazgjedhur**: `purpur.yml` + +Cakton emrin dhe vendndodhjen e [skedarit konfigurues të Purpur-it](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Fillon serverin në një gjendje të plotë vanilje. + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Cakton emrin e hostit të serverit ose adresën [IP të internetit](#user-content-fn-13)[^13]. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Cakton portin e serverit. + +#### `server-name` + +- **Vlera parazgjedhur**: `Një Server Plazma` + +Cakton emrin e serverit. + +#### `spigot-settings` + +- **Alias**: `S` +- **Vlera parazgjedhur**: `spigot.yml` + +Cakton emrin dhe vendndodhjen e [skedarit konfigurues të Spigot-it](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Shfaq versionin e Plazma-së. + +#### `world-dir` + +- **Alias**: `W`, `universi`, `kontenieri i botës` +- **Vlera parazgjedhur**: `(dosja e serverit)` + +Cakton vendndodhjen ku ruhen skedarët e botës. + +#### `world-name` + +- **Alias**: `w`, `botë` +- **Vlera parazgjedhur**: `(pronat e serverit)` + +Cakton emrin e skedarit të botës. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Vendndodhja e argumenteve ndryshon në varësi të vendndodhjes së shtesave. + +[^3]: Për shembull, nëse dëshironi të aktivizoni `Plazma.iKnowWhatIAmDoing` në `true`, mund ta bëni këtë duke vendosur `-DPlazma.iKnowWhatIAmDoing=true` ose vetëm `-DPlazma.iKnowWhatIAmDoing`. + +[^4]: Për shembull, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Detektori i eventit. + +[^6]: Detektori i eventit. + +[^7]: Klienti. + +[^8]: Sinjali që tregon se serveri është lidhur normalisht si zemërpuls. + +[^9]: Duke përdorur funksionin e largimit të AFK të Purpur, mund të dërgoni larg edhe lojtarët që janë larguar nga vendi. + +[^10]: Sistemi i shkrimit të blloqeve të sinkronizuar, Sync Chunk Write System. + +[^11]: `KUJDES! Plazma mund të shkaktojë probleme të papritura, kështu që sigurohuni të testoni plotësisht para se ta përdorni në një server publik.` + +[^12]: Në lojë, `optimizimi i botës` vepron në këtë mënyrë. + +[^13]: Protokolli i Internetit, IP. + +[^14]: Administratorët me `nivel 2` ose më të lartë janë përjashtuar. diff --git a/sq/origin/plazma/adminstration/reference/commands.md b/sq/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..4e2ab1f98 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Mësoni për komandat e disponueshme në Plazma. +--- + +# 🖥️ Komandat diff --git a/sq/origin/plazma/adminstration/reference/configurations/bukkit.md b/sq/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..a2b899aa1 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/sq/origin/plazma/adminstration/reference/configurations/paper/README.md b/sq/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..d0fef1939 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni për qëllimin e çdo skedari në dosjen e konfigurimit. +--- + +# 🛩️ Letër diff --git a/sq/origin/plazma/adminstration/reference/configurations/paper/global.md b/sq/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..08bc74c6b --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në paper-global.yml. +--- + +# 🛩️ Letër (konfigurimi global) diff --git a/sq/origin/plazma/adminstration/reference/configurations/paper/world.md b/sq/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..c841f6137 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në paper-world.yml. +--- + +# 🛩️ Letër (Ndërtimi i botës) diff --git a/sq/origin/plazma/adminstration/reference/configurations/plazma/README.md b/sq/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..987d6ee26 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni për qëllimin e çdo skedari në dosjen e konfigurimit. +--- + +# ✨ Plazma diff --git a/sq/origin/plazma/adminstration/reference/configurations/plazma/global.md b/sq/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..fdaa4e54b --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në plazma-global.yml. +--- + +# ✨ Plazma (konfigurimi global) diff --git a/sq/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/sq/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..a4d3c922e --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Struktura e botës diff --git a/sq/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/sq/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..52dfa6fbd --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në plazma-world.yml. +--- + +# ✨ Plazma (kompozimi i botëve) diff --git a/sq/origin/plazma/adminstration/reference/configurations/property.md b/sq/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..033ae001c --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në server.properties. +--- + +# 🪨 Server.properties diff --git a/sq/origin/plazma/adminstration/reference/configurations/pufferfish.md b/sq/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..adbd810ab --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në pufferfish.yml. +--- + +# 🐡 Pufferfish diff --git a/sq/origin/plazma/adminstration/reference/configurations/purpur/README.md b/sq/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..e063b2699 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në purpur.yml. +--- + +# 🦑 Purpur diff --git a/sq/origin/plazma/adminstration/reference/configurations/purpur/global.md b/sq/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..441628de0 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në purpur.yml. +--- + +# 🦑 Purpur (struktura globale) diff --git a/sq/origin/plazma/adminstration/reference/configurations/purpur/world.md b/sq/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..ba4608a2b --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë përfaqëson çdo nyje në purpur.yml. +--- + +# 🦑 Purpur (struktura e botës) diff --git a/sq/origin/plazma/adminstration/reference/configurations/spigot.md b/sq/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..e2b5d7e60 --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Zbuloni çfarë do të thotë çdo nyje në spigot.yml. +--- + +# 🚰 Spigot diff --git a/sq/origin/plazma/adminstration/reference/permissions.md b/sq/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..54d9c9abf --- /dev/null +++ b/sq/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Merrni informacion mbi lejet e Plazma-së. +--- + +# 🛡️ Leje diff --git a/sq/origin/plazma/developers.md b/sq/origin/plazma/developers.md new file mode 100644 index 000000000..cf6b69cfe --- /dev/null +++ b/sq/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Zhvillo projekte të treta duke përdorur Plazmën. +--- + +# ⚙️ Guidë e zhvilluesit diff --git a/sq/origin/thunderbolt/README.md b/sq/origin/thunderbolt/README.md new file mode 100644 index 000000000..b83d24cb7 --- /dev/null +++ b/sq/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt është një platformë serveri bazuar në Plazma që ndan patch-et sperimentale në Flavor për të lejuar përdoruesit të provojnë direkt. +--- + +# 🌩️ Udhezuesi i Përdorimit të Thunderbolt diff --git a/sq/origin/volt/README.md b/sq/origin/volt/README.md new file mode 100644 index 000000000..ce5adc51a --- /dev/null +++ b/sq/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt është një shabllon burimor i hapur që ju lejon të zhvilloni platformën tuaj të serverit të vetëm bazuar në Plazma përmbajtjen e tij. +--- + +# ⚡ Udhëzuesi i Zhvillimit të Volts diff --git a/sr/origin/README.md b/sr/origin/README.md new file mode 100644 index 000000000..9230fb38c --- /dev/null +++ b/sr/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Ако имате питања, молимо поставите их преко Discord или GitHub Diskusija. +--- + +# 🏠 Добродошли на Docs Portal + +{% hint style="info" %} + +**Документи Плазме тренутно су преведени машински.** + +[![Статус превода](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) омогућава учешће у превођењу документа како бисте их унапредили. + +{% endhint %} + +### Ако сте искочили проблеми током коришћења Плазме? + +{% content-ref url="plazma/" %} +[плазма](plazma/) +{% endcontent-ref %} + +### Да ли сте заинтересовани за Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[громобран](thunderbolt/) +{% endcontent-ref %} + +### Volt-ом желите ли да направите своју сопствену сервер платформу? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Aко вам је потребно више информација везаних за Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/sr/origin/SUMMARY.md b/sr/origin/SUMMARY.md new file mode 100644 index 000000000..cd334cb11 --- /dev/null +++ b/sr/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Садржај + +- [🏠 Добродошли у Портал за документацију](README.md) + - [⚛️ ГитХаб](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Дискорд](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Плазма + +- [✨ Документација о коришћењу Плазме](plazma/README.md) +- [❓ Шта је Плазма?](plazma/about/README.md) + - [⬇️ Преузми](plazma/about/downloads.md) + - [✅ Статус подршке за верзије](plazma/about/supported-versions.md) +- [⚒️ Упутство за управљање сервером](plazma/administration/README.md) + - [👟 Почетак](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Референца](plazma/administration/reference/README.md) + - [🖥️ Команде](plazma/administration/reference/commands.md) + - [🛡️ Дозволе](plazma/administration/reference/permissions.md) + - [🎛️ Аргументи и својства](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Својства](plazma/administration/reference/configurations/property.md) + - [🪣 Букит](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Спигот](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Пејпер](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Глобална конфигурација](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Светске конфигурације](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Пуферфиш](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Пурпур](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Глобална конфигурација](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Светске конфигурације](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Плазма](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Глобална конфигурација](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Светске конфигурације](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Напредно](plazma/administration/expert/README.md) + - [🧹 Оптимизација](plazma/administration/expert/optimize.md) + - [🔀 Прокси](plazma/administration/expert/proxy.md) + - [↩️ Ванилизација](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray блокада](plazma/administration/expert/xray.md) + - [⚠️ Ранјивости и решења](plazma/administration/expert/fix-exploits.md) + - [⁉️ Често постављана питања](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Упутство за развој](plazma/developers.md) + - [✏️ Допринос](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Јавадоцс](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Упутство за коришћење Thunderbolt-а](thunderbolt/README.md) + +## Volt + +- [⚡ Упутство за развој Volta](volt/README.md) + +## Разно + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Преузми све](plazma/about/downloads-all.md) diff --git a/sr/origin/miscellaneous/README.md b/sr/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/sr/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/sr/origin/plazma/README.md b/sr/origin/plazma/README.md new file mode 100644 index 000000000..5662bf42c --- /dev/null +++ b/sr/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma је отворена сервер платформа за Minecraft: Java Edition која користи експерименталну оптимизацију на основу папира и персонализоване функције играња из различитих игара." +--- + +# ✨ Plazma Упутства за коришћење + +## 👋 Добродошли на Plazma Упутства + +Добродошли на Plazma Упутства за коришћење! + +{% hint style="info" %} + +**Да ли не можете решити проблем преко упутства?** + +[Званични Дискорд сервер](https://discord.gg/MmfC52K8A8) или питајте заједницу преко [GitHub Дискусија](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### О Plazma + +> Сазнајте шта је Plazma сервер платформа. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### За Администраторе + +> Искористите Plazma за креирање свог сопственог сервера. + +{% content-ref url="администрација/" %} +[администрација](администрација/) +{% endcontent-ref %} + +### За Развојне инжењере + +> Искористите Plazma за развој пројеката трећих страна. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/sr/origin/plazma/about/README.md b/sr/origin/plazma/about/README.md new file mode 100644 index 000000000..f494d3672 --- /dev/null +++ b/sr/origin/plazma/about/README.md @@ -0,0 +1,71 @@ +--- +description: Сазнајте шта је Plazma сервер платформа. +--- + +# ❓ Шта је Плазма? + +- **Плазма** је серверска платформа базирана на [Паперу](https://github.com/PaperMC/Paper) која је преузела само предности из [Андромеде](https://github.com/EarendelArchived/Andromeda) и [Фузије](https://github.com/RuinedTechnologyUnify/Fusion). +- Увек се трудимо да пружимо високу стабилност и снажне перформансе, брзе ажурирање и обилне функције. + +## 📋 Циљ Плазме + +- Трудимо се да постанемо серверска платформа са брзим ажурирањем и високом стабилношћу. +- Трудимо се да пружимо обилне функције и снажне перформансе, ништа мање него мод платформа. +- Трудимо се да направимо платформу која је слободна за прилагођавање пачевима ваниле. + +## ⚙️ Кључне карактеристике + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Најбрже ажурирање**\ + [Увек Ажурирано](https://github.com/PlazmaMC/AlwaysUpToDate) омогућава да се сви печови у Плазми увек држе најновијим, пружајући најбрже ажурирање међу серверским платформама базираним на Паперу. +6. **Оптимизоване основне конфигурационе датотеке**\ + Основне конфигурационе датотеке су оптимизоване тако да не морате ручно оптимизовати конфигурацију. +7. **Систематски ради у мулти-нитима**\ + Асинхронизује системске механизме који нису повезани са механизмима игре, смањујући [време касњења](#user-content-fn-4)[^4] за оптимизацију сервера. +8. **Блокирање непотребног коришћења простора**\ + Спајањем података са сличним вредностима у један, смањује се употреба меморије. + +## ✨ Примери употребе + +- **Платформа која правилно обрађује комплексне додатке**\ + Plazma се користи на серверу развијача [IPECTER](https://github.com/IPECTER).\nСа сопственим додацима који раде на NMS и рефлексији, и са великим обимом података,\nуспешно прима преко 100 играча без пада перформанси. +- **Платформа која одржава брзе перформансе на RPG серверу**\ + Стабилно је одржавала 100 играча на једном кластеру без пада TPS,\nи на 4 кластера је омогућила удобно играње за укупно 250 играча. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Многи стримери изабрали платформу**\ + Многи стримери је користе као кашику за учешће гледалаца. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Преузми + +Плазму можете преузети на следећој страници. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Желите детаљне информације о подржаним верзијама? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Бакет, КрафтБакет, Спигот плагини и Папер, Паферфиш, Пурпур плагини. + +[^2]: Поседује Мајкрософт Корпорација. + +[^3]: Ако онемогућите систем за пријаву четова, четови се обрађују само на серверу и може се спречити праћење четова од стране Mojang-а. + +[^4]: Време касњења игре за рад системских механизама. diff --git a/sr/origin/plazma/about/downloads-all.md b/sr/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..4f8317fc5 --- /dev/null +++ b/sr/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Плазма извршна датотека преузми целокупно +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| верзија | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Мојмап Паперклип. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Реобф Паперклип. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Мојмап Паперклип. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/sr/origin/plazma/about/downloads.md b/sr/origin/plazma/about/downloads.md new file mode 100644 index 000000000..6da56cb38 --- /dev/null +++ b/sr/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Одмах преузмите Плазму и пробајте је самостално. +--- + +# ⬇️ Преузми + +#### Желите детаљне информације о подржаним верзијама? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Доле преузимање је извршна датотека за обичне кориснике.** + +Ако сте програмер и треба вам други облик датотеке, погледајте страницу испод. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
верзијапреузимање
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + преузимање +
1.20.1 + Преузимање +
1.19.4 + Преузимање +
+ +*** diff --git a/sr/origin/plazma/about/patches-list.md b/sr/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..9bc3bcac4 --- /dev/null +++ b/sr/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Осврните се на све функције додате у Plazma. +--- + +# 📑 Укључени печови diff --git a/sr/origin/plazma/about/supported-versions.md b/sr/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..19cae39f5 --- /dev/null +++ b/sr/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Да бисте проверили верзију Minecraft: Java Edition коју подржава Plazma." +--- + +# ✅ Статус подршке за верзију + +{% hint style="info" %} + +**Плазма је развијана од верзије 1.19.4 и касније, верзије испод 1.19.4 нису развијане.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Чекање%20на%20издање +[idv]: https://badge.plazmamc.org/1/У_развоју +[atv]: https://badge.plazmamc.org/2/Подржано +[fse]: https://badge.plazmamc.org/6/Подршка_за_функције_прекинута +[eol]: https://badge.plazmamc.org/4/Подршка_завршена +[ukn]: https://badge.plazmamc.org/0/Информације%20нису%20доступне +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Уобичајено +[100]: https://badge.plazmamc.org/percent/100 + +![Чекање\_на\_издање][wtr] ![У\_развоју][idv] ![Подржано][atv] ![Подршка\_за\_функције\_прекинута][fse] ![Подршка\_завршена][eol] + +| верзија | Стабилност и подршка функција | Статус изградње | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Статус\_изградње](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Статус изградње](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Статус изградње](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/sr/origin/plazma/administration/README.md b/sr/origin/plazma/administration/README.md new file mode 100644 index 000000000..739c8b0ff --- /dev/null +++ b/sr/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Искористите Plazma за креирање свог сопственог сервера. +--- + +# ⚒️ Упутство за управљање сервером diff --git a/sr/origin/plazma/administration/diagnosis/README.md b/sr/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..babe6293e --- /dev/null +++ b/sr/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Осмотрите како се суочавати с проблемима када се појаве. +--- + +# 🧾 진단 diff --git a/sr/origin/plazma/administration/diagnosis/plugins.md b/sr/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..b7d23a4f1 --- /dev/null +++ b/sr/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Како решити проблем када додатак не функционише исправно. +--- + +# 📜 플러그인 diff --git a/sr/origin/plazma/administration/expert/README.md b/sr/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..09c647a92 --- /dev/null +++ b/sr/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Осмотрите како професионално поступати са Plazma. +--- + +# 🎓 Дубоко diff --git a/sr/origin/plazma/administration/expert/fix-exploits.md b/sr/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..095f675a9 --- /dev/null +++ b/sr/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Осврните се на познате слабости и начине их решавања. +--- + +# ⚠️ Познате слабости и начин решавања diff --git a/sr/origin/plazma/administration/expert/optimize.md b/sr/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..18142bfa3 --- /dev/null +++ b/sr/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Освежите се како оптимизовати Плазму. +--- + +# 🧹 Оптимизација diff --git a/sr/origin/plazma/administration/expert/proxy.md b/sr/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..37623ae43 --- /dev/null +++ b/sr/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Погледајте како безбедно конфигурисати прокси платформу "Velocity". +--- + +# 🔀 Прокси diff --git a/sr/origin/plazma/administration/expert/vanillaize.md b/sr/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..b9fe63c5f --- /dev/null +++ b/sr/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Осмотрите како вратити поправке за папир и ванила. +--- + +# ↩️ Ванилизовати + +{% hint style="warning" %} + +**Paper не додаје могућности за избор у већини исправки грешака у ванили.** + +Тренутно, Плазма ради на конфигурацији која омогућава онемогућавање таквих поправки за грешке. + +Због тога је овај водич још увек у припреми и информације могу бити промењене у било којем тренутку. + +{% endhint %} diff --git a/sr/origin/plazma/administration/expert/xray.md b/sr/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..22ee4f57c --- /dev/null +++ b/sr/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Осврните се на различите уграђене методе за блокирање X-зрака. +--- + +# 🩻 Блокирање X-зрака diff --git a/sr/origin/plazma/administration/faq.md b/sr/origin/plazma/administration/faq.md new file mode 100644 index 000000000..6db930332 --- /dev/null +++ b/sr/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Сазнајте одговоре на често постављена питања. +--- + +# ⁉️ Често постављена питања + +{% hint style="info" %} + +**Не можете да пронађете жељени одговор?** + +[Званични Дискорд сервер](https://discord.gg/MmfC52K8A8) или питајте заједницу преко [GitHub Дискусија](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Плазма не почиње + +Ако се на конзоли приказује `no main manifest attribute, in plazma-(version).jar`,\ +преузета датотека је датотека API-а за развој, и морате преузети **Reobf Paperweight** са GitHub странице. + +За више информација, погледајте следећу страницу. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### При покретању сервера приказује се упозорење. + +Plazma садржи неке нестабилне исправке и увек постоји могућност неисправног рада, због чега при покретању сервера приказује следећу поруку. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ова порука се може онемогућити коришћењем системског својства [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +За више информација, погледајте следећу страницу. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Доступно од верзије 1.20.1 diff --git a/sr/origin/plazma/administration/getting-started/README.md b/sr/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..387181c61 --- /dev/null +++ b/sr/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Сазнајте како направити сервер са Plazma. +--- + +# 👟 Почетак + +Да бисте успешно користили Plazma, ваш систем мора испунити следеће захтеве: + +| | Минимум | Препоручено | +| :--------------------: | ------- | ----------- | +| Архитектура | x64 | - | +| RAM | 8GB | 16GB | +| Простор за складиштење | 1GB | 8GB | +| JDK | 17 | 21 | + +За лакше уређивање конфигурационих датотека, такође је добро инсталирати уређиваче као што је [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Правилан излаз" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' је(је) унутрашња или спољна команда, извршив програм или +скрипт фајл. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Прво, преузмите **JDK 21** у `.msi` формату са [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Покрените преузети инсталатер и кликните на `Next`. +3. Након тога, активирајте `Set JAVA_HOME variable` у средини левог менија и кликните `Next`. +4. Кликните на `Install` да бисте завршили инсталацију JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Затим извршите следећу команду у терминалу да бисте инсталирали JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Преузимање Plazma + +Plazma нуди различите извршне датотеке. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Сазнајте више + +Име извршне датотеке је `plazma-(верзија управљача)-1.20.4-R0.1-SNAPSHOT-(облик мапирања).jar`. + +- **Облик мапирања**\ + Мапирање је сврста карте која повезује стварни код Minecraft-а са обфусцираним кодом. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Мојмап**\ + Моџанг-мапиран, мапирање за Ванила Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Управљач верзија**\ + Управљач верзија је ланчер сервера који је потребан за покретање сервера и патчовање серверских датотека. + - **Paperclip**\ + Управљачки програм који је развила PaperMC тим за Paper и друге деривате платформе, који преузима библиотеке и примењује патчеве на сервер. + - **Bundler**\ + Управљач верзија ванила Minecraft-a. + +
+ +*** + +## 3. Креирање почетног скрипта + +Да бисте лако покренули Plazmu и аутоматски рестаровали сервер, морате креирати [почетни скрипт](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Преузмите почетни скрипт преко дугмета за преузимање у долјем левом углу.\ +**Проверите да ли је преузети почетни скрипт компатибилан са вашим оперативним системом.** + +*** + +## 4. Сређивање датотека + +Сад преместите преузети почетни скрипт и Plazmu у нови фолдер. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Сада покрените почетни скрипт. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Прихватање EULA + +Након што једном покренете почетни скрипт, у фолдеру ће се појавити `eula.txt` датотека. + +EULA[^9] представља уговор о коришћењу услуга Mojang Studios-a,[^10] који морате прихватити да бисте користили услуге. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Да бисте прихватили EULA, промените `eula=false` у `eula=true` у `eula.txt` датотеци и сачувајте промене. + +*** + +## 6. Дозвола за спољне конекције (Windows) + +Савремени оперативни системи подразумевано блокирају спољне приступе како би спречили потенцијално опасне приступе преко **заштитног зида** и **раутера**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Уколико ваш раутер не подржава UPnP, пошто су панели за раутере различити, мораћете да претражите информације. + +Такође, можете користити [Ngrok](https://ngrok.com/) за генерисање привремене адресе. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Провера потребе за прослеђивањем порта + +Унесите следеће у прозор за извршавање и покрените. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Уколико резултат буде `True`, можете завршити овде, али ако је `False`, морате поставити прослеђивање порта. + +### 6.2 Повезивање са сервером + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Адреса која се користи за повезивање са сервером може се проверити [овде](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Затим, када поново покренете сервер, Plazma ће аутоматски покушати да пренесе порт. + +Доње наведено је да ли је UPnP успео на основу поруке која се приказује на конзоли, а на конзоли ће се приказати `[UPnP] (порука)`. + +| Порука | Значење | +| --------------------------------- | ---------------------------------------------- | +| `Успешно отворен порт (порт)` | Пренос порта је успео. | +| `Порт (порт) је већ отворен` | Друга услуга користи тај порт. | +| `Неуспешно отварање порта (порт)` | Пренос порта није успео. | +| `Сервис није доступан` | Рутер не подржава UPnP. | + +Када се сервер искључи, Plazma аутоматски затвара порт. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Преузмите ZIP фајл `Windows (64-bit)` са [Ngrok веб странице](https://ngrok.com/download). +2. Ставите преузети Ngrok у фолдер сервера. +3. На [Ngrok табли](https://dashboard.ngrok.com/get-started/your-authtoken) генеришите [овлашћење токена](#user-content-fn-13)[^13] из фолдера сервера. +4. Извршите наредбу која се приказује у `Command Line` у фолдеру сервера. +5. Додајте `start /b ngrok tcp --region jp 25565` на врху скрипта за покретање, и `taskkill /f /t /im ngrok.exe` на дну скрипта. +6. Адреса сервера ће бити `0.tcp.jp.ngrok.io:12345` из `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` на врху конзоле. +7. Сада можете приступити серверу изван преко ове адресе. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Нпр., када извршите команду, + +```log +Windows IP конфигурација + +Етернет адаптер Етернет: + + Повезани DNS суфикс. . . . : + IPv4 адреса. . . . . . . . . : 192.168.3.7 + Мрежна маска . . . . . . . : 255.255.255.0 + Подразумевани гејтвеј . . . . . . : 192.168.3.1 + +``` + +Можете се повезати на сервер из локалне мреже користећи `192.168.3.7` који је приказан као IPv4 адреса. + +Ако сервер и игра раде на истом рачунару, можете се повезати користећи `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Напредовати + +Ако је сервер успешно покренут и исправно ради, сада је време за прилагођавање сервера. + +Прочитајте ово упутство како бисте сазнали како прилагодити сервер. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, на којем се базира Plazma, заснован је на Spigot-у, који је заснован на официјалној серверској платформи Spigot. + +[^3]: Притисните Windows тастер + R + +[^4]: За Линукс, у терминал унесите `java --version` + +[^5]: JRE је један од отворених изворних пројеката и постоји више врста као што је Minecraft серверска платформа. + +[^6]: Обично је познат као **покретач**. + +[^7]: Активирањем опције "Аутоматско поновно покретање", сервер ће се аутоматски поново покренути. Можете унети `Control + C` за крај. + +[^8]: Није препоручљиво прелазити половину системске меморије. + + Нпр., ако је укупни капацитет меморије система 8GB, није препоручљиво поставити више од 4GB. + +[^9]: EULA, Уговор о крајњем кориснику. За више информација посетите [Minecraft веб страницу](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорација Мајкрософт. + +[^11]: У складу са чланом 32. став 1. тачка 9. Закона о подршци игрању у Републици Кореји, **Корејска Мајкрософт Корпорација** може бити тужена на суду. + +[^12]: Универзални Прикључак и Пустање. Purpur укључен у Plazma-у комуницира са рутером аутоматски преко ове технологије и отвара порт само када је сервер активан, па није потребно ручно преносити порт. + +[^13]: Ако немате налог, региструјте се на Ngrok преко Google или GitHub налога. diff --git a/sr/origin/plazma/administration/getting-started/customization.md b/sr/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..90bfd74ce --- /dev/null +++ b/sr/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,118 @@ +--- +description: Осмотрите како прилагодити сервер. +--- + +# 🎨 Прилагођавање корисника + +Иако не користе званичну платформу сервера коју нуди Mojang Studios, +разлог за коришћење модификоване серверске платформе као што је Plazma је што је могуће изузетно +**прилагођавање**. + +У наставку су неки начини коришћења и прилагођавања Plazme. + +## Измена конфигурације + +Најосновнији начин прилагођавања Plazme је уређивање конфигурације. + +Plazma пружа могућност напредне конфигурације, укључујући механике игре и особине чудовишта. + +За више информација о конфигурацији Plazme, погледајте доле наведену страницу. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Употреба додатака + +{% hint style="success" %} + +**Plazma подржава све плагинове на бази папира.** + +За Spigot плагине, од верзије 1.20.5, због промена мапира у Paper-у, неки плагини можда неће радити, међутим, већина плагина базираних на Paper-у као што су Paper, Pufferfish и Purpur ће радити на Plazmi и, ако не раде исправно, то је грешка Plazme, па молимо [пријавите то одмах.](../diagnosis/plugins.md) + +{% endhint %} + +Коришћење Plazme је главни разлог и најјачи начин да се персонализује Plazma. +Јака екосистема плагина на Plazmi омогућава лако персонализовање сервера. + +Постоје разни начини за претрагу и преузимање плагина. Неки плагини се каче на јавне репозиторијуме, док се неки каче на GitHub или на сопствени сајт. + +{% hint style="caution" %} + +**Плагини могу директно приступити систему!** + +Увек проверите плагине пре примене користећи услуге као што је VirusTotal или преузимањем плагина са поузданих сервиса. + +{% endhint %} + +Постоје разни сервиси за преузимање плагина. Између осталих, [SpigotMC Форум](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) су сервиси који прегледају плагине пре објављивања, тако да се обезбеђује да су само безбедни плагини у циркулацији. + +### Примена плагина + +Када преузмете плагин, следећи корак је да га примените. + +1. Плагини су у `.jar` или `Java Executable File` формату.\ + Понекад су плагини у облику компримованих фајлова, у том случају + распакујте и користите фајл са 'bukkit', 'spigot' или 'paper' у имену, + а ако постоји фајл са 'fat', користите 'fat' фајл. +2. Сместите преузети фајл у фолдер `plugins` у фолдеру сервера и (поново) покрените сервер. +3. Када се Plazma покрене, на конзоли ћете видети нови садржај. + Ово значи да је Plazma успешно учитала плагине. +4. Иако је Plazma успешно учитала плагине, можда нису сви плагини покренути. + Користећи `/plugins` команду можете видети који плагини су тренутно учитани на серверу. + Ако име учитаног плагина није црвено, већ зелено, то значи да је плагин успешно учитан. + +Ако плагин није успешно учитан, можете наћи решења за проблем на следећој страници. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Коришћење Датапакета + +Датапакети су начин прилагођавања Мајнкрафта и слични су [ресурс пакетима](#user-content-fn-1)[^1]. + +Коришћењем датапакета можете додати нове биће и изазове у игри и модификовати делове игре. + +{% hint style="caution" %} + +**Датапакети могу оштетити свет!** + +Неки датапакети могу оштетити свет и то је непоправљиво. + +Зато се препоручује прављење резервне копије света пре примене датапакета. + +{% endhint %} + +Датапакети се могу преузети са разних сервиса као што су [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) и други. + +Након преузимања датапакета, ставите их у фолдер `datapacks` у свету сервера. +Уколико фолдер не постоји, креирајте га и ставите датапакете у њега. + +{% hint style="warning" %} + +**Неки [датапакети](#user-content-fn-2)[^2] могу имати проблеме при првом примењивању.** + +Због тога се препоручује поновно покретање сервера **2 пута**. + +{% endhint %} + +Датапакети могу лако бити оштећени при ажурирању Мајнкрафта. + +Посебно, ако датапакети буду потпуно оштећени, сервер ће се срушити, па је важно да се изврши довољно тестова пре ажурирања сервера. + +{% hint style="info" %} + +**Након покретања сервера, унесите `safeMode` након команде за покретање сервера да бисте онемогућили све датапакете.** + +[За више информација, погледајте `референце > аргументи и параметри`.](../reference/arguments.md) + +{% endhint %} + +Примењени датапакети се могу проверити коришћењем команде `/datapack list`. + +*** + +[^1]: Или аддони за Minecraft: Bedrock Edition. + +[^2]: Додавање нових бића итд. diff --git a/sr/origin/plazma/administration/getting-started/next-step.md b/sr/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..e0e3be709 --- /dev/null +++ b/sr/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Осмотрите како прилагодити сервер. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +У наставку су неки начини коришћења и прилагођавања Plazme. + +## Измена конфигурације + +Најосновнији начин прилагођавања Plazme је уређивање конфигурације. + +Plazma пружа могућност напредне конфигурације, укључујући механике игре и особине чудовишта. + +За више информација о конфигурацији Plazme, погледајте доле наведену страницу. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Употреба додатака + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Коришћење Plazme је главни разлог и најјачи начин да се персонализује Plazma. Јака екосистема плагина на Plazmi омогућава лако персонализовање сервера. + +Постоје разни начини за претрагу и преузимање плагина. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Постоје разни сервиси за преузимање плагина. Између осталих, [SpigotMC Форум](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) су сервиси који прегледају плагине пре објављивања, тако да се обезбеђује да су само безбедни плагини у циркулацији. + +### Примена плагина + +Када преузмете плагин, следећи корак је да га примените. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Сместите преузети фајл у фолдер `plugins` у фолдеру сервера и (поново) покрените сервер. +3. Када се Plazma покрене, на конзоли ћете видети нови садржај. Ово значи да је Plazma успешно учитала плагине. +4. Иако је Plazma успешно учитала плагине, можда нису сви плагини покренути. Користећи `/plugins` команду можете видети који плагини су тренутно учитани на серверу. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Ако плагин није успешно учитан, можете наћи решења за проблем на следећој страници. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Коришћење Датапакета + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Коришћењем датапакета можете додати нове биће и изазове у игри и модификовати делове игре. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Неки датапакети могу оштетити свет и то је непоправљиво. + +Зато се препоручује прављење резервне копије света пре примене датапакета. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Након преузимања датапакета, ставите их у фолдер `datapacks` у свету сервера. Уколико фолдер не постоји, креирајте га и ставите датапакете у њега. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Због тога се препоручује поновно покретање сервера **2 пута**. +{% endhint %} + +Датапакети могу лако бити оштећени при ажурирању Мајнкрафта. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Примењени датапакети се могу проверити коришћењем команде `/datapack list`. + +*** + +## Оптимизација + +Плазма има многе патчеве за оптимизацију. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Прокси + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +За информације о безбедном и исправном подешавању проксија, погледајте доле наведену страницу. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Безбедност + +Мајнкрафт је развио модове који омогућавају лак приступ [мотору за напад на ранљивости](#user-content-fn-3)[^3] чак и онлајн. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Поставке дозвола + +Неки административни команди одређених плагинова могу имати ранљивости ако дозволе нису исправно подешене. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Блокирање X-Ray-a + +X-Ray је једна од ранљивости која је лако доступна и на основном оптимизационом клијенту. + +Плазма нуди конфигурацију за блокирање X-Ray-a по подразумеваној поставци. + +За информације о начину блокирања X-Ray-a погледајте доле наведену страницу. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Бела листа + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +За преглед играча којим је дозвољен приступ користите `/whitelist query`. + +*** + +[^1]: Или аддони за Minecraft: Bedrock Edition. + +[^2]: Додавање нових бића итд. + +[^3]: Обично се зову "хакери". + +[^4]: Уколико конфигурација није оптимизована, ако је Плазма стара или у случају новооткривених ранљивости, могуће је да нису блокирани. + +[^5]: Играчи се повезују на сервер преко Ngrok прокси сервера, адреса која се додељује са сваким поновним покретањем је различита. diff --git a/sr/origin/plazma/administration/reference/README.md b/sr/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..fcd2c518f --- /dev/null +++ b/sr/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Сазнајте како да прилагодите коришћење у Плазми. +--- + +# 📜 리퍼런스 + +У Плазми постоје различите методе прилагођавања корисника. + +Од тога, четири методе наведене испод могу се одмах користити без додатних радњи. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Званични Дискорд сервер](https://discord.gg/MmfC52K8A8) или питајте заједницу преко [GitHub Дискусија](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ Команде + +> Команде омогућавају сакупљање информација у игри или прилагођавање играчког окружења. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Права + +> Права одређују опсег у коме играч може да интерактује. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Аргументи и својства + +> Аргументи и својства имају општи утицај на рад Плазме. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Подешавања + +> Подешавања су најосновнији начин прилагођавања Плазме. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/sr/origin/plazma/administration/reference/arguments.md b/sr/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..b974099f8 --- /dev/null +++ b/sr/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Упознајте почетне аргументе и системска својства. +--- + +# 🎛️ Аргументи и својства + +Почетни аргументи и системска својства су вредности које се додају на [команде које се користе](#user-content-fn-1)[^1] за покретање Плазме и имају општи утицај на рад Плазме. + +[Позиција која се додаје на команду](#user-content-fn-2)[^2] ће поделити на **почетни аргумент** и **системска својства**. + +*** + +## Системска својства + +Системска својства се уносе испред `-jar` и обрађују се у JVM пре иницијализације Плазме. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Употреба + +Системска својства се уносе као Java командни аргументи између `java` и `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` означава да је тај аргумент додат у Плазму, а не уграђен у JVM, + +Ако не унесете никакве вредности за својства, вредност ће бити постављена на [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Сва системска својства + +#### `convertLegacySigns` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Ажурира формате застарелих табли за информације о ентитетима. + +#### `debug.entities` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава дебаг информације о ентитетима. + +#### `debug.rewriteForIDE` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује NMS ревизију за правилно учитавање дебаг информација у IDE,\ +и аутоматски преправља верзије. + +#### `disable.watchdog` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује систем за упозоравање чувара у Spigot-у. + +#### `letMeReload` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује поруку потврде за `/reload` команду. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Ако сте развијач плагина и морате да ажурирате плагин, користите хотсвап уместо `/reload` команде. +{% endhint %} + +#### `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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује систем приоритета класа плагина. + +Корисно у случају проблема са плагином шејдовања. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује консолидацију пропуста у Netty-у. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Подразумевано**: `750` + +Ако има више ентитета од наведеног броја, проследи их у више пакета. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Подразумевано**: `8192` + +Поставља величину максималног пакета који сервер може примити одједном. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује проверу верзије Java-е. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Може довести до трајног оштећења свих фајлова у свету и уништења механике игре. + +Сви проблеми који настају коришћењем овога су ваша одговорност, и Плазма не пружа подршку за то. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Подразумевано**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Подразумевано**: `80` + +Поставља максималну дужину текста на табли. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Подразумевано**: `(верзија света) + 1` + +Поставља верзију информација о ажурирању света које треба прво иницијализовати. + +Корисно за велике промене у чанковима, али није корисно у другим случајевима. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Boolean` +- **Подразумевано**: `True` + +Омогућава обраду коментара у YAML фајловима. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Подразумевано**: `30` + +Ако играч није примио никакве податке у том временском периоду (у секундама), играч ће бити избачен. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Игнорише коментаре у серверским својствима. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава дебаг информације о синхроном писању чанкова. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава [основни систем писања чанкова](#user-content-fn-10)[^10] у Минекрафту. + +Ово чува сваки чанк по реду, што може значајно успорити рад. + +#### `Paper.explicit-flush` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава експлицитно праћење мрежних канала. + +#### `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` + +Не оптимизује почетну конфигурацију. + +Ово користи основну конфигурацију Папира. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` + +Искључује Plazma брендирање и користи ванила фавикон сервера. + +#### `Plazma.useVanillaConfiguration` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` +- **Сукублуку**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Ово значајно утиче на безбедност и перформансе сервера. + +Сви проблеми који настану уз ову особину су у надлежности администратора сервера. +{% endhint %} + +Исporука почетне конфигурације са подразумеваним вредностима од Mojang-a. + +Ово искључује све поправке ранијих недостатака које је Папир применио. + +Поправке ранијих недостатака могу се поново укључити у Папир или Plazma конфигурацији. + +#### `Plazma.vanillaize` + +- **Тип**: `Boolean` +- **Основна вредност**: `true` +- **Сукублуку**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Конфигурација почетне конфигурације блиска ванили. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Коришћени атрибут + +Следећи системски атрибути су коришћени. + +#### `timings.bypassMax` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` +- **Коришћен је**: Timings је уклоњен из Плазме + +Одлучује да ли је дозвољено прекорачење максималне вредности која се може проследити Aikar-овом Timings API-ју. + +Иако се ово може урадити, ако се не обради у API-ју, примениће се ограничење брзине. + +*** + +## Почетни аргумент + +Почетни аргумент се уноси након `-jar *.jar` и иницијализује Плазму, обрађујући се истовремено. + +### Упутство за коришћење + +Системски атрибут се уноси као аргумент програма након `-jar *.jar`. + +На пример, ако желите да примените почетни аргумент `nogui`,\ +унесите га на следећи начин да би Плазма обрадила `nogui` аргумент током иницијализације. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Цео почетни аргумент + +#### `bukkit-settings` + +- **Надимак**: `b` +- **Подразумевано**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Надимак**: `c` +- **Подразумевано**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Надимак**: `c` +- **Подразумевано**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Покреће сервер у демо режиму. + +#### `eraseCache` + +Брише преостале кеш датотеке након надоградње света. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Надимак**: `?` + +Приказује све почетне аргументе и опис Плазме. + +#### `initSettings` + +Креира само конфигурациону датотеку и зауставља сервер. + +#### `jfrProfile` + +Омогућава JFR профилисање. + +#### `max-players` + +- **Надимак**: `s`, `size` +- **Подразумевано**: `(серверско сопственство)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Искључује графички интерфејс. + +#### `nojline` + +JLine-откључајте и користите ванлајн конзолу. + +#### `онлајн-режим` + +- **Надимак**: `о` +- **Подразумевано**: `(серверско сопственство)` + +Одлучује да ли ће играчи бити проверени на Mojang серверу за проверу. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-podešavanja` + +- **Надимак**: `paper` +- **Подразумевано**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Подешава локацију уклоњеног PaperSpigot конфигурационог фајла. + +Користи се за премештање старе конфигурације у нови фајл, након чега више није потребан. + +#### `paper-podešavanja-direktorijum` + +- **Надимак**: `paper-dir` +- **Подразумевано**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-podešavanja-direktorijum` + +- **Надимак**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `dodaci` + +- **Надимак**: `d` +- **Подразумевано**: `dodaci` + +Подешава локацију фолдера са додацима. + +#### `puferfis-podešavanja` + +- **Надимак**: `puferfis` +- **Подразумевано**: `puferfis.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-podešavanja` + +- **Надимак**: `purpur` +- **Подразумевано**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Покреће сервер у потпуно ванлајн режиму. + +#### `server-ip` + +- **Надимак**: `h`, `host` +- **Подразумевано**: `(серверско сопственство)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Надимак**: `p`, `port` +- **Подразумевано**: `(серверско сопственство)` + +Подешава порт сервера. + +#### `server-name` + +- **Подразумевано**: `А Плазма Сервер` + +Подешава име сервера. + +#### `spigot-podešavanja` + +- **Надимак**: `S` +- **Подразумевано**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `верзија` + +- **Надимак**: `v` + +Исписује верзију Плазме. + +#### `world-dir` + +- **Надимак**: `W`, `универзум`, `контенер-света` +- **Подразумевано**: `(фолдер сервера)` + +Подешава локацију где се чувају светски фајлови. + +#### `world-name` + +- **Надимак**: `w`, `svet` +- **Подразумевано**: `(серверско сопственство)` + +Подешава име светског фајла. + +*** + +[^1]: `јава (...) -jar server.jar (...)` + +[^2]: Позиција додатних аргумената одређује како се обрађују аргументи. + +[^3]: Нпр., ако желите да подесите `Plazma.iKnowWhatIAmDoing` на `true`, уместо `-DPlazma.iKnowWhatIAmDoing=true` можете унети само `-DPlazma.iKnowWhatIAmDoing` и исти резултат ће бити постигнут. + +[^4]: Нпр., `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Детектор догађаја. + +[^6]: Детектор догађаја. + +[^7]: Клијент. + +[^8]: Сигнал који показује да је клијент успешно повезан са сервером као срцеви ударања. + +[^9]: Помоћу Purpur-ове функције избацивања AFK-играча, можете избацити играче који су напустили игру. + +[^10]: Систем за синхронизацију записа чунка, Sync Chunk Write System. + +[^11]: `УПОЗОРЕЊЕ! Plazma може изазвати неочекиване проблеме, па будите сигурни да га детаљно тестирате пре него што га користите на јавном серверу.` + +[^12]: У игри, `оптимизација света` ради на исти начин. + +[^13]: Администратори нивоа `2` и више су искључени. + +[^14]: Интернет протокол, IP. diff --git a/sr/origin/plazma/administration/reference/commands.md b/sr/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..cff797209 --- /dev/null +++ b/sr/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Сазнајте више о командама доступним у Plazmi. +--- + +# 🖥️ Команде diff --git a/sr/origin/plazma/administration/reference/configurations/README.md b/sr/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..a148a76d5 --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Подешавања су најосновнији начин прилагођавања Плазме. +--- + +# 🧾 구성 + +*** + +## 🪨 Својства + +> Својства су најосновнији конфигурациони фајл који нуди Minecraft. Коришћењем својстава можете променити основни механизам игре. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit конфигурација + +> Bukkit конфигурација је најосновнији конфигурациони фајл који нуди Plazma. Коришћењем Bukkit конфигурације можете променити основне механизме Minecraft сервера. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot конфигурација + +> Spigot конфигурација вам омогућава да модификујете детаље механизма игре, обраду играча, рад команди и поруке. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper конфигурација + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish конфигурација вам омогућава да промените обраду света и ентитета у Plazmi. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur конфигурација + +> Purpur својства вам омогућавају да модификујете основне податке игре. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma конфигурација + +> Plazma конфигурација вам омогућава да прилагодите функције Plazme. + +{% content-ref url="plazma/" %} +[плазма](plazma/) +{% endcontent-ref %} + +*** diff --git a/sr/origin/plazma/administration/reference/configurations/bukkit.md b/sr/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0b1a3d13f --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Погледајте шта сваки чвор букит.јмл значи. +--- + +# 🪣 Букит diff --git a/sr/origin/plazma/administration/reference/configurations/paper/README.md b/sr/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9f89a188c --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Одредите за шта служи сваки фајл у фолдеру config. +--- + +# 🛩️ Папир diff --git a/sr/origin/plazma/administration/reference/configurations/paper/global.md b/sr/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..4a120b273 --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта сваки чвор у paper-global.yml значи. +--- + +# 🌏 전역 구성 diff --git a/sr/origin/plazma/administration/reference/configurations/paper/world.md b/sr/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..448b6fcbe --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Погледајте шта сваки чвор у paper-world.yml значи. +--- + +# 🏳️ 세계별 구성 + +Светски diff --git a/sr/origin/plazma/administration/reference/configurations/plazma/README.md b/sr/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e81f2200f --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Одредите за шта служи сваки фајл у фолдеру config. +--- + +# ✨ Плазма diff --git a/sr/origin/plazma/administration/reference/configurations/plazma/global.md b/sr/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..aa365251a --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/sr/origin/plazma/administration/reference/configurations/plazma/world.md b/sr/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..2c08a8ba7 --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/sr/origin/plazma/administration/reference/configurations/plazma/worlds.md b/sr/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..653c526af --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у plazma-world.yml. +--- + +# ✨ Плазма (састав света) diff --git a/sr/origin/plazma/administration/reference/configurations/property.md b/sr/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..a80395ea5 --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Погледајте шта сваки чвор у server.properties значи. +--- + +# 🪨 Server.properties diff --git a/sr/origin/plazma/administration/reference/configurations/pufferfish.md b/sr/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..f35c5522d --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: пронађите шта сваки чвор у pufferfish.yml значи. +--- + +# 🐡 Балиндер diff --git a/sr/origin/plazma/administration/reference/configurations/purpur/README.md b/sr/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..f00bb069e --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у purpur.yml. +--- + +# 🦑 Пурпур diff --git a/sr/origin/plazma/administration/reference/configurations/purpur/global.md b/sr/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..60f428718 --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/sr/origin/plazma/administration/reference/configurations/purpur/world.md b/sr/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..75bb92628 --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/sr/origin/plazma/administration/reference/configurations/spigot.md b/sr/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..f9985b71e --- /dev/null +++ b/sr/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: пронађите шта сваки чвор у spigot.yml значи. +--- + +# 🚰 Спигот diff --git a/sr/origin/plazma/administration/reference/permissions.md b/sr/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..2b5fbbafe --- /dev/null +++ b/sr/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Сазнајте више о овлашћењима Плазме. +--- + +# 🛡️ Овлашћења + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## Разумети основни систем дозвола + +У Minecraft-у постоје основне групе дозвола за управљање. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Играч**\ + Основна група дозвола која се обично додељује свим играчима. +2. **Посредник**\ + Може игнорисати спавање. +3. **Администратор света**\ + Може користити све команде и командне блокове повезане са управљањем светом.\ + Основна група дозвола која се примењује на датапакете и командне блокове. +4. **Администратор**\ + Може користити све команде повезане са управљањем играчима. +5. **Главни администратор**\ + Може користити све команде повезане са управљањем сервером.\ + Основна група дозвола која се примењује на конзолу и администраторе. + +*** + +## Постављање дозвола + +*** + +## Све дозволе + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Подразумевано**: `Ништа` + +Дозвољава играчу да се спусти и упозна са ентитетом. + +Када се на ентитету, може му управљати помоћу `клавише за кретање`, а може скакати или летети помоћу `клавише за скакање`. + +У `(Namespaced Key)` се уноси [Namespaced ID](#user-content-fn-2)[^2] ентитета. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Подразумевано**: `Ништа` + +Дозвољава играчу да користи специјалне способности ентитета када су на њима. + +Сви ентитети немају доступне све специјалне способности. Погледајте које све специјалне способности су доступне испод. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Објавите идеју на [Plazma Discord](https://plazmamc.org/discord) или [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Погледајте тренутно доступне специјалне способности + +- **`crepper`**\ + Када притиснете `клавиш за скакање`, ентитет експлодира.\ + Ако играч има дозволу `allow.powered.creeper`, може држати `клавиш за скакање` за пунење експлозије. +- **`dolphin`**\ + Када притиснете `клавиш за скакање`, ентитет навали напред. +- **`phantom`**\ + Када притиснете `клавиш за скакање`, ентитет пуца пламеном. +- **`wither`**\ + Када се `упусти` у ентитет, испаљује главу витера. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/compass` команде](commands.md#compass). + +#### `bukkit.command.credits` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/credits (Играч)` команде](commands.md#credits). + +Додавање `.other` на крај имена дозволе омогућава њено коришћење од стране других играча. + +#### `bukkit.command.demo` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/demo (Играч)` команде](commands.md#demo). + +Додавање `.other` на крај имена дозволе омогућава њено коришћење од стране других играча. + +#### `bukkit.command.ping` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/ping (Играч)` команде](commands.md#ping). + +Додавање `.other` на крај имена дозволе омогућава њено коришћење од стране других играча. + +#### `bukkit.command.ram` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/ram` команде](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/rambar (Играч)` команде](commands.md#rambar). + +Додавање `.other` на крај имена дозволе омогућава њено коришћење од стране других играча. + +#### `bukkit.command.restart` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/restart` команде](commands.md#restart). + +#### `bukkit.command.tps` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/tps` команде](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/tpsbar (Играч)` команде](commands.md#tpsbar). + +Додавање `.other` на крај имена дозволе омогућава њено коришћење од стране других играча. + +#### `bukkit.command.timings` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/timings` команде](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Погледајте [Spark](https://spark.lucko.me/docs/Command-Usage) за сличне функције. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење [`/uptime` команде](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Подразумевано**: `Администратор света` + +Омогућава коришћење команде `/gamemode (GameMode) (Играч)`. + +Додавање `.other` на крај имена дозволе омогућава њено коришћење од стране других играча. + +#### `paper.antixray.bypass` + +- **Подразумевано**: `Ништа` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Ово омогућава обојицама да искусе побољшање перформанси. + +> За информације о подешавању X-Ray-а, погледајте доле наведену страницу. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Подразумевано**: `Ништа` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Подразумевано**: `Ништа` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Подразумевано**: `Ништа` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Подразумевано**: `Ништа` + +Омогућава коришћење [MiniMessage тагова](https://docs.advntr.dev/minimessage/format.html) на оруђу. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Подразумевано**: `Ништа` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Подразумевано**: `Ништа` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Подразумевано**: `Ништа` + +Искључује играче из избацивања због неактивности. + +#### `purpur.debug.f3n` + +- **Подразумевано**: `Администратор света` + +Омогућава играчима да промене режим игре помоћу тастера `F3 + N`. + +Ова функција не ради ако немате дозволу за тај режим игре. + +#### `purpur.drop.spawners` + +- **Подразумевано**: `Ништа` + +Када копате спавање блокове са предметима по вашем избору, спавање блокови ће пасти. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Подразумевано**: `Ништа` + +Мења величину ендер ковчега. + +У `(NumberString)` можете унети `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Подразумевано**: `Ништа` + +Дозволи да Тотем бесмртности ради у инвентару. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Подразумевано**: `Ништа` + +Дозволи играчу да игнорише ограничење броја прикључених играча. + +#### `purpur.mending_shift_click` + +- **Подразумевано**: `Ништа` + +Дозволи играчу да поправи предмет који држи када `припадне и интеракција`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Подразумевано**: `Ништа` + +Дозволи играчу да постави спавер. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Подразумевано**: `Ништа` + +Дозволи играчу да одмахну према Нетер порталу. + +#### `purpur.sign.color` + +- **Подразумевано**: `Ништа` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Подразумевано**: `Ништа` + +Дозволи коришћење кода за заштиту`(&o)` на табли. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Подразумевано**: `Ништа` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Подразумевано**: `Ништа` + +Дозволи играчу да спречи TNT експлозију `интеракцијом` маказама. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Планирана дозвола + +#### `plazma.bypass.ncr-require` + +- **Подразумевано**: `Ништа` + +Дозволи играчу да се прикључи чак и ако нема инсталиран мод [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Оператор. + +[^2]: На пример: `ender_dragon` diff --git a/sr/origin/plazma/adminstration/README.md b/sr/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..739c8b0ff --- /dev/null +++ b/sr/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Искористите Plazma за креирање свог сопственог сервера. +--- + +# ⚒️ Упутство за управљање сервером diff --git a/sr/origin/plazma/adminstration/expert/README.md b/sr/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..09c647a92 --- /dev/null +++ b/sr/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Осмотрите како професионално поступати са Plazma. +--- + +# 🎓 Дубоко diff --git a/sr/origin/plazma/adminstration/expert/fix-exploits.md b/sr/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..095f675a9 --- /dev/null +++ b/sr/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Осврните се на познате слабости и начине их решавања. +--- + +# ⚠️ Познате слабости и начин решавања diff --git a/sr/origin/plazma/adminstration/expert/optimize.md b/sr/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..18142bfa3 --- /dev/null +++ b/sr/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Освежите се како оптимизовати Плазму. +--- + +# 🧹 Оптимизација diff --git a/sr/origin/plazma/adminstration/expert/vanillaize.md b/sr/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..0b77ecd3e --- /dev/null +++ b/sr/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Осмотрите како вратити поправке за папир и ванила. +--- + +# ↩️ Ванилизовати + +{% hint style="warning" %} + +### Папир не нуди избор у великој већини ванила поправки. + +Тренутно, Плазма ради на конфигурацији која омогућава онемогућавање таквих поправки за грешке. + +Због тога је овај водич још увек у припреми и информације могу бити промењене у било којем тренутку. +{% endhint %} diff --git a/sr/origin/plazma/adminstration/faq.md b/sr/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..ab723dbc4 --- /dev/null +++ b/sr/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Сазнајте одговоре на често постављена питања. +--- + +# ⁉️ Често постављена питања + +{% hint style="info" %} + +### Не можете пронаћи жељени одговор? + +[Званични Discord сервер](https://discord.gg/MmfC52K8A8) или питања за заједницу на [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) погледајте! +{% endhint %} + +### Порука се приказује, али не извршава. + +Ако се на конзоли приказује `no main manifest attribute, in plazma-(version).jar`,\ +преузета датотека је датотека API-а за развој, и морате преузети **Reobf Paperweight** са GitHub странице. + +За више информација, погледајте следећу страницу. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### При покретању сервера приказује се упозорење. + +Plazma садржи неке нестабилне исправке и увек постоји могућност неисправног рада, због чега при покретању сервера приказује следећу поруку. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Ова порука се може онемогућити коришћењем системског својства [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +За више информација, погледајте следећу страницу. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Доступно од верзије 1.20.1 diff --git a/sr/origin/plazma/adminstration/getting-started/README.md b/sr/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..72aa299a3 --- /dev/null +++ b/sr/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Сазнајте како направити сервер са Plazma. +--- + +# 👟 Почетак + +Да бисте успешно користили Plazma, ваш систем мора испунити следеће захтеве: + +| | Минимум | Препоручено | +| :--------------------: | ------: | ----------: | +| Архитектура | x64 | - | +| RAM | 8GB | 16GB | +| Простор за складиштење | 1GB | 8GB | +| JRE | 17 | 21 | + +За лакше уређивање конфигурационих датотека, такође је добро инсталирати уређиваче као што је [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Инсталирање JRE + +Као што само име каже, Minecraft: **"Java"** Edition је развијен у Java програмском језику и за покретање захтева JRE[^1]. + +Пошто је Plazma заснована на званичној серверској платформи Mojang Studios-a,[^2] за коришћење Plazme такође морате инсталирати JRE. + +### 1.1 Провера JRE + +Да бисте проверили да ли је JRE инсталиран на вашем систему, унесите [`cmd /k java --version`](#user-content-fn-4)[^4] у прозор за извршавање и покрените. + +Ако видите следећи резултат, прескочите на [2. корак](setup.md#id-2). + +{% code title="Исправан резултат" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Ако не видите овакав резултат или видите следеће, JRE није инсталиран или је превише стар, па морате извршити [1.2. корак](setup.md#id-1.2). + +{% code title="JRE није инсталиран" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE је превише стар" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Инсталирање JRE + +У овом упутству ћемо користити Azul Zulu као један од [верзија JRE](#user-content-fn-5)[^5]. + +Након што завршите инсталацију, проверите поново [1.1. корак](setup.md#id-1.1) да бисте потврдили успешно завршену инсталацију. + +{% tabs %} +{% tab title="Windows" %} + +1. Прво, преузмите **JDK 21** у `.msi` формату са [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Покрените преузети инсталатер и кликните на `Next`. +3. Након тога, активирајте `Set JAVA_HOME variable` у средини левог менија и кликните `Next`. +4. Кликните на `Install` да бисте завршили инсталацију JRE. + {% endtab %} + +{% tab title="macOS" %} +Са [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) преузмите **JDK 21** у `.dmg` формату и инсталирајте JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Прво, извршите следећу команду у терминалу како бисте додали Azul Zulu репозиторијум у APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Затим извршите следећу команду у терминалу да бисте инсталирали JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Можете инсталирати JRE користећи следећу команду. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Преузимање Plazma + +Plazma нуди различите извршне датотеке. + +{% hint style="warning" %} + +### У већини случајева користите `Reobf Paperclip`. + +Следећи садржај је за оне који су занимљиви за развојне програмере или за оне који су занимљиви за сваку врсту.\ +Ако сте обичан корисник, можете се прескочити на [3. корак](setup.md#id-3) без проблема. +{% endhint %} + +
+ +Сазнајте више + +Име извршне датотеке је `plazma-(верзија управљача)-1.20.4-R0.1-SNAPSHOT-(облик мапирања).jar`. + +- **Облик мапирања**\ + Мапирање је сврста карте која повезује стварни код Minecraft-а са обфусцираним кодом. + - **Reobf**\ + Реобфускација, такође позната као Spigot мапирање, користи се у већини NMS плагина.\ + Од верзије 1.20.5 ће бити укинут. + - **Mojmap**\ + Моџанг мапирање, ванила Minecraft мапирање. +- **Управљач верзија**\ + Управљач верзија је ланчер сервера који је потребан за покретање сервера и патчовање серверских датотека. + - **Paperclip**\ + Управљачки програм који је развила PaperMC тим за Paper и друге деривате платформе, који преузима библиотеке и примењује патчеве на сервер. + - **Bundler**\ + Управљач верзија ванила Minecraft-a. + +
+ +*** + +## 3. Креирање почетног скрипта + +Да бисте лако покренули Plazmu и аутоматски рестаровали сервер, морате креирати [почетни скрипт](#user-content-fn-6)[^6]. + +Можете креирати почетни скрипт путем [Flags.sh](https://flags.sh).\ +Само унесите жељену меморију за Plazmu и команда ће бити аутоматски оптимизована. + +Преузмите почетни скрипт преко дугмета за преузимање у долјем левом углу.\ +**Проверите да ли је преузети почетни скрипт компатибилан са вашим оперативним системом.** + +*** + +## 4. Сређивање датотека + +Сад преместите преузети почетни скрипт и Plazmu у нови фолдер. + +{% hint style="warning" %} + +### Име фолдера мора бити без размака и на енглеском језику. + +У супротном, Plazma или JRE можда неће радити исправно. +{% endhint %} + +Сада покрените почетни скрипт. За Windows, морате одабрати дозволу за пролаз кроз заштитни зид **Одобри** на прозору за одобравање. + +*** + +## 5. Прихватање EULA + +Након што једном покренете почетни скрипт, у фолдеру ће се појавити `eula.txt` датотека. + +EULA[^9] представља уговор о коришћењу услуга Mojang Studios-a,[^10] који морате прихватити да бисте користили услуге. + +Уколико не прихватите EULA, нећете моћи покренути сервер и можете бити кажњени у случају кршења EULA.[^11] + +Да бисте прихватили EULA, промените `eula=false` у `eula=true` у `eula.txt` датотеци и сачувајте промене. + +*** + +## 6. Дозвола за спољне конекције (Windows) + +Савремени оперативни системи подразумевано блокирају спољне приступе како би спречили потенцијално опасне приступе преко **заштитног зида** и **раутера**. + +За Windows, пошто сте већ дозволили у [3. кораку](setup.md#id-3), само треба да направите прослеђивање порта. + +{% hint style="info" %} + +### У овом упутству се претпоставља да користите Windows оперативни систем и [**UPnP**](#user-content-fn-12)[^12] на раутеру. + +Уколико ваш раутер не подржава UPnP, пошто су панели за раутере различити, мораћете да претражите информације. + +Такође, можете користити [Ngrok](https://ngrok.com/) за генерисање привремене адресе. +{% endhint %} + +{% hint style="warning" %} + +### За оперативне системе као што су Linux или macOS (или UNIX слични), пошто су поставке за заштитни зид по сервисима различите, мораћете да претражите информације. + +{% endhint %} + +### 6.1 Провера потребе за прослеђивањем порта + +Унесите следеће у прозор за извршавање и покрените. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Уколико резултат буде `True`, можете завршити овде, али ако је `False`, морате поставити прослеђивање порта. + +### 6.2 Повезивање са сервером + +{% tabs %} +{% tab title="Повезивање изван" %} +Потребно је пренос порта или је већ успешно пренесен порт, сада можете повезати са сервером. + +Адреса која се користи за повезивање са сервером може се проверити [овде](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Покушајте UPnP пренос порта" %} +У `purpur.yml` фајлу сервера, омогућите `network.upnp-port-forwarding` на `true`. + +Затим, када поново покренете сервер, Plazma ће аутоматски покушати да пренесе порт. + +Доње наведено је да ли је UPnP успео на основу поруке која се приказује на конзоли, а на конзоли ће се приказати `[UPnP] (порука)`. + +| Порука | Значење | +| --------------------------------- | ------------------------------ | +| `Успешно отворен порт (порт)` | Пренос порта је успео. | +| `Порт (порт) је већ отворен` | Друга услуга користи тај порт. | +| `Неуспешно отварање порта (порт)` | Пренос порта није успео. | +| `Сервис није доступан` | Рутер не подржава UPnP. | + +Када се сервер искључи, Plazma аутоматски затвара порт. +{% endtab %} + +{% tab title="Креирање привремене адресе помоћу Ngrok" %} +Коришћење Ngrok је корисно за краткорочна тестирања, заједничку игру или игру са пријатељима. + +1. Преузмите ZIP фајл `Windows (64-bit)` са [Ngrok веб странице](https://ngrok.com/download). +2. Ставите преузети Ngrok у фолдер сервера. +3. На [Ngrok табли](https://dashboard.ngrok.com/get-started/your-authtoken) генеришите [овлашћење токена](#user-content-fn-13)[^13] из фолдера сервера. +4. Извршите наредбу која се приказује у `Command Line` у фолдеру сервера. +5. Додајте `start /b ngrok tcp --region jp 25565` на врху скрипта за покретање, и `taskkill /f /t /im ngrok.exe` на дну скрипта. +6. Адреса сервера ће бити `0.tcp.jp.ngrok.io:12345` из `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` на врху конзоле. +7. Сада можете приступити серверу изван преко ове адресе. + {% endtab %} + +{% tab title="Повезивање локално" %} +Ако желите да се повежете на сервер из локалне мреже, покрените `cmd /k ipconfig` у командном прозору. + +Нпр., када извршите команду, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Можете се повезати на сервер из локалне мреже користећи `192.168.3.7` који је приказан као IPv4 адреса. + +Ако сервер и игра раде на истом рачунару, можете се повезати користећи `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Фаза Напредовања + +Ако је сервер успешно покренут и исправно ради, сада је време за прилагођавање сервера. + +Прочитајте упутства испод о томе како прилагодити сервер. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java окружење за покретање, Java Runtime Environment. + +[^2]: Paper, на којем се базира Plazma, заснован је на Spigot-у, који је заснован на официјалној серверској платформи Spigot. + +[^3]: Притисните Windows тастер + R + +[^4]: За Линукс, у терминал унесите `java --version` + +[^5]: JRE је један од отворених изворних пројеката и постоји више врста као што је Minecraft серверска платформа. + +[^6]: Обично је познат као **покретач**. + +[^7]: Активирањем опције "Аутоматско поновно покретање", сервер ће се аутоматски поново покренути. Можете унети `Control + C` за крај. + +[^8]: Није препоручљиво прелазити половину системске меморије. + + Нпр., ако је укупни капацитет меморије система 8GB, није препоручљиво поставити више од 4GB. + +[^9]: EULA, Уговор о крајњем кориснику. За више информација посетите [Minecraft веб страницу](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорација Мајкрософт. + +[^11]: У складу са чланом 32. став 1. тачка 9. Закона о подршци игрању у Републици Кореји, **Корејска Мајкрософт Корпорација** може бити тужена на суду. + +[^12]: Универзални Прикључак и Пустање. Purpur укључен у Plazma-у комуницира са рутером аутоматски преко ове технологије и отвара порт само када је сервер активан, па није потребно ручно преносити порт. + +[^13]: Ако немате налог, региструјте се на Ngrok преко Google или GitHub налога. diff --git a/sr/origin/plazma/adminstration/getting-started/customization.md b/sr/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..f1d1f3e64 --- /dev/null +++ b/sr/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Осмотрите како прилагодити сервер. +--- + +# 🎨 Прилагођавање корисника diff --git a/sr/origin/plazma/adminstration/referenca/README.md b/sr/origin/plazma/adminstration/referenca/README.md new file mode 100644 index 000000000..44a2cae9f --- /dev/null +++ b/sr/origin/plazma/adminstration/referenca/README.md @@ -0,0 +1,2 @@ +# 📜 Референца + diff --git a/sr/origin/plazma/adminstration/referenca/konfiguracioni-fajl/README.md b/sr/origin/plazma/adminstration/referenca/konfiguracioni-fajl/README.md new file mode 100644 index 000000000..2d564ae63 --- /dev/null +++ b/sr/origin/plazma/adminstration/referenca/konfiguracioni-fajl/README.md @@ -0,0 +1,2 @@ +# 🎨 Конфигурациони фајл + diff --git a/sr/origin/plazma/adminstration/reference/arguments.md b/sr/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..11fb4cc83 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Упознајте почетне аргументе и системска својства. +--- + +# 🎛️ Аргументи и својства + +Почетни аргументи и системска својства су вредности које се додају на [команде које се користе](#user-content-fn-1)[^1] за покретање Плазме и омогућавају промену вредности која се не може променити након покретања Плазме. + +Према [месту додавања команде](#user-content-fn-2)[^2], они се деле на **почетне аргументе** и **системска својства**. + +*** + +## Системска својства + +Системска својства се уносе испред `-jar` и обрађују се у JVM пре иницијализације Плазме. + +{% hint style="warning" %} + +### Измена системских својстава може утицати на начин рада Плазме и JVM-а, и може имати велик утицај на игру! + +Ако нисте сигурни како свако системско својство функционише, **никада га не користите!** +{% endhint %} + +### Употреба + +Системска својства се уносе као Java командни аргументи између `java` и `-jar`. + +На пример, ако желите да примените системско својство `Plazma.dummyProperty`,\ +унесите следеће и вредност `37` ће бити унесена у следеће својство при покретању Плазме. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` означава да је тај аргумент додат у Плазму, а не уграђен у JVM, + +ако не унесете ништа за вредност, вредност ће бити [`true`.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Платформа за сервере из Paperweight породице користи `.` у имену својства како би разликовала својства по платформама. + +На неким терминалским програмима као што је Windows Powershell, можда неће бити дозвољени овакви аргументи, па је потребно додати `"` на крајевима аргумената. [^4] +{% endhint %} + +### Сва системска својства + +#### `convertLegacySigns` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Ажурира формате застарелих табли за информације о ентитетима. + +#### `debug.entities` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава дебаг информације о ентитетима. + +#### `debug.rewriteForIDE` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује NMS ревизију за правилно учитавање дебаг информација у IDE,\ +и аутоматски преправља верзије. + +#### `disable.watchdog` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује систем за упозоравање чувара у Spigot-у. + +#### `letMeReload` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује поруку потврде за `/reload` команду. + +{% hint style="danger" %} + +### `/reload` команда је врло нестабилна, па сви проблеми на серверу након њене употребе су на кориснику. + +Ако сте развијач плагина и морате да ажурирате плагин, користите хотсвап уместо `/reload` команде. +{% endhint %} + +#### `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 плагинских канала по играчу[^5]. + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује систем приоритета класа плагина. + +Корисно у случају проблема са плагином шејдовања. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује консолидацију пропуста у Netty-у. + +#### `Paper.excessiveTELimit` + +- **Тип**: `Integer` +- **Подразумевано**: `750` + +Ако има више ентитета од наведеног броја, проследи их у више пакета. + +#### `Paper.filterThreshold` + +- **Тип**: `Integer` +- **Подразумевано**: `8192` + +Поставља величину максималног пакета који сервер може примити одједном. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Искључује проверу верзије Java-е. + +{% hint style="danger" %} + +### Ово омогућава JVM-у да покуша да приступи неисправном коду! + +Може довести до трајног оштећења свих фајлова у свету и уништења механике игре. + +Сви проблеми који настају коришћењем овога су ваша одговорност, и Плазма не пружа подршку за то. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Тип**: `Integer` +- **Подразумевано**: `64` + +Поставља ограничење за имена плагинских канала[^6]. + +#### `Paper.maxSignLength` + +- **Тип**: `Integer` +- **Подразумевано**: `80` + +Поставља максималну дужину текста на табли. + +#### `Paper.minPrecachedDatafixVersion` + +- **Тип**: `Integer` +- **Подразумевано**: `(верзија света) + 1` + +Поставља верзију информација о ажурирању света које треба прво иницијализовати. + +Корисно за велике промене у чанковима, али није корисно у другим случајевима. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Boolean` +- **Подразумевано**: `True` + +Омогућава обраду коментара у YAML фајловима. + +#### `Paper.playerConnection.keepAlive` + +- **Тип**: `Integer` +- **Подразумевано**: `30` + +Ако играч није примио никакве податке у том временском периоду (у секундама), играч ће бити избачен. + +У већини случајева, игра[^7] шаље [сигнал срца](#user-content-fn-8)[^8] серверу, па играч неће бити избачен, али ако игра не одговори, сматра се да је доследило судар и играч се избацује. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Игнорише коментаре у серверским својствима. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава дебаг информације о синхроном писању чанкова. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава [основни систем писања чанкова](#user-content-fn-10)[^10] у Минекрафту. + +Ово чува сваки чанк по реду, што може значајно успорити рад. + +#### `Paper.explicit-flush` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Омогућава експлицитно праћење мрежних канала. + +#### `Paper.strict-thread-checks` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Увек логује грешке које нису настале на главном току. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Исписује упозорење ако резервисани задаци имају превише каснитења. + +#### `Paperclip.patchOnly` + +- **Тип**: `Boolean` +- **Подразумевано**: `False` + +Када користите основни извршни фајл, примењује само печатицу, а не покреће сервер. + +#### `Plazma.aggressiveOptimize` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` + +{% hint style="warning" %} + +### Ово својство ће бити премештено као почетни аргумент после 1.20.5. + +{% endhint %} + +Подесите оптимизације конфигурације које се примењују при почетку на строги + +Активирањем се сервер брже и безбедније, али може блокирати неке играчке механизме или имати велики утицај на игру. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` + +Сузбија упозорење[^11] које се појављује при иницијализацији Plazma. + +### Коришћени атрибут + +Следећи системски атрибути су коришћени. + +#### `timings.bypassMax` + +- **Тип**: `Boolean` +- **Подразумевано**: `false` +- **Коришћен је**: Timings је уклоњен из Плазме + +Одлучује да ли је дозвољено прекорачење максималне вредности која се може проследити Aikar-овом Timings API-ју. + +Иако се ово може урадити, ако се не обради у API-ју, примениће се ограничење брзине. + +*** + +## Почетни аргумент + +Почетни аргумент се уноси након `-jar *.jar` и иницијализује Плазму, обрађујући се истовремено. + +### Упутство за коришћење + +Системски атрибут се уноси као аргумент програма након `-jar *.jar`. + +На пример, ако желите да примените почетни аргумент `nogui`,\ +унесите га на следећи начин да би Плазма обрадила `nogui` аргумент током иницијализације. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Цео почетни аргумент + +#### `bukkit-settings` + +- **Надимак**: `b` +- **Подразумевано**: `bukkit.yml` + +Подешава име и локацију [Bukkit конфигурационе датотеке](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Надимак**: `c` +- **Подразумевано**: `commands.yml` + +Подешава име и локацију [Bukkit конфигурационе датотеке за команде](../reference/configurations/bukkit.md). + +#### `config` + +- **Надимак**: `c` +- **Подразумевано**: `server.properties` + +Подешава име и локацију [серверског сопственства](../reference/configurations/property.md) датотеке. + +#### `demo` + +Покреће сервер у демо режиму. + +#### `eraseCache` + +Брише преостале кеш датотеке након надоградње света. + +#### `forceUpgrade` + +Присилно надограВђује свет игноришући верзију. + +#### `help` + +- **Надимак**: `?` + +Приказује све почетне аргументе и опис Плазме. + +#### `initSettings` + +Креира само конфигурациону датотеку и зауставља сервер. + +#### `jfrProfile` + +Омогућава JFR профилисање. + +#### `max-players` + +- **Надимак**: `s`, `size` +- **Подразумевано**: `(серверско сопственство)` + +Подешава максимални број дозвољених [играча](#user-content-fn-14). + +#### `nogui` + +Искључује графички интерфејс. + +#### `nojline` + +JLine-откључајте и користите ванлајн конзолу. + +#### `онлајн-режим` + +- **Надимак**: `о` +- **Подразумевано**: `(серверско сопственство)` + +Одлучује да ли ће играчи бити проверени на Mojang серверу за проверу. + +**Уколико не користите Velocity или други прокси, може доћи до кажњавања због прекршаја EULA.** + +#### `paper-podešavanja` + +- **Надимак**: `paper` +- **Подразумевано**: `paper.yml` + +{% hint style="warning" %} + +### Овај аргумент је прекинут након верзије 1.19.4 + +{% endhint %} + +Подешава локацију уклоњеног PaperSpigot конфигурационог фајла. + +Користи се за премештање старе конфигурације у нови фајл, након чега више није потребан. + +#### `paper-podešavanja-direktorijum` + +- **Надимак**: `paper-dir` +- **Подразумевано**: `config` + +Подешава име и локацију фолдера у коме се налазе [Paper конфигурациони фајлови](../reference/configurations/paper/README.md). + +#### `plazma-podešavanja-direktorijum` + +- **Надимак**: `plazma-dir` + +Подешава име и локацију фолдера у коме се налазе [Plazma конфигурациони фајлови](../reference/configurations/plazma/README.md). + +#### `dodaci` + +- **Надимак**: `d` +- **Подразумевано**: `dodaci` + +Подешава локацију фолдера са додацима. + +#### `puferfis-podešavanja` + +- **Надимак**: `puferfis` +- **Подразумевано**: `puferfis.yml` + +Подешава име и локацију [Puferfis конфигурационог фајла](../reference/configurations/pufferfish.md). + +#### `purpur-podešavanja` + +- **Надимак**: `purpur` +- **Подразумевано**: `purpur.yml` + +Подешава име и локацију [Purpur конфигурационог фајла](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Покреће сервер у потпуно ванлајн режиму. + +#### `server-ip` + +- **Надимак**: `h`, `host` +- **Подразумевано**: `(серверско сопственство)` + +Подешава име хоста или [IP адресу](#user-content-fn-13)[^13] сервера. + +#### `server-port` + +- **Надимак**: `p`, `port` +- **Подразумевано**: `(серверско сопственство)` + +Подешава порт сервера. + +#### `server-name` + +- **Подразумевано**: `А Плазма Сервер` + +Подешава име сервера. + +#### `spigot-podešavanja` + +- **Надимак**: `S` +- **Подразумевано**: `spigot.yml` + +Подешава име и локацију [Spigot конфигурационог фајла](../reference/configurations/spigot.md). + +#### `верзија` + +- **Надимак**: `v` + +Исписује верзију Плазме. + +#### `world-dir` + +- **Надимак**: `W`, `универзум`, `контенер-света` +- **Подразумевано**: `(фолдер сервера)` + +Подешава локацију где се чувају светски фајлови. + +#### `world-name` + +- **Надимак**: `w`, `svet` +- **Подразумевано**: `(серверско сопственство)` + +Подешава име светског фајла. + +*** + +[^1]: `јава (...) -jar server.jar (...)` + +[^2]: Позиција додатних аргумената одређује како се обрађују аргументи. + +[^3]: Нпр., ако желите да подесите `Plazma.iKnowWhatIAmDoing` на `true`, уместо `-DPlazma.iKnowWhatIAmDoing=true` можете унети само `-DPlazma.iKnowWhatIAmDoing` и исти резултат ће бити постигнут. + +[^4]: Нпр., `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Детектор догађаја. + +[^6]: Детектор догађаја. + +[^7]: Клијент. + +[^8]: Сигнал који показује да је клијент успешно повезан са сервером као срцеви ударања. + +[^9]: Помоћу Purpur-ове функције избацивања AFK-играча, можете избацити играче који су напустили игру. + +[^10]: Систем за синхронизацију записа чунка, Sync Chunk Write System. + +[^11]: `УПОЗОРЕЊЕ! Plazma може изазвати неочекиване проблеме, па будите сигурни да га детаљно тестирате пре него што га користите на јавном серверу.` + +[^12]: У игри, `оптимизација света` ради на исти начин. + +[^13]: Интернет протокол, IP. + +[^14]: Администратори нивоа `2` и више су искључени. diff --git a/sr/origin/plazma/adminstration/reference/commands.md b/sr/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..cff797209 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Сазнајте више о командама доступним у Plazmi. +--- + +# 🖥️ Команде diff --git a/sr/origin/plazma/adminstration/reference/configurations/bukkit.md b/sr/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..0b1a3d13f --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Погледајте шта сваки чвор букит.јмл значи. +--- + +# 🪣 Букит diff --git a/sr/origin/plazma/adminstration/reference/configurations/paper/README.md b/sr/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..9f89a188c --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Одредите за шта служи сваки фајл у фолдеру config. +--- + +# 🛩️ Папир diff --git a/sr/origin/plazma/adminstration/reference/configurations/paper/global.md b/sr/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a428dd8b2 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта сваки чвор у paper-global.yml значи. +--- + +# 🛩️ Папир (глобални конфигурација) diff --git a/sr/origin/plazma/adminstration/reference/configurations/paper/world.md b/sr/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f24a5e7b6 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Погледајте шта сваки чвор у paper-world.yml значи. +--- + +# 🛩️ Пејпер (састав света) diff --git a/sr/origin/plazma/adminstration/reference/configurations/plazma/README.md b/sr/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..e81f2200f --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Одредите за шта служи сваки фајл у фолдеру config. +--- + +# ✨ Плазма diff --git a/sr/origin/plazma/adminstration/reference/configurations/plazma/global.md b/sr/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..17ff8d806 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у plazma-global.yml. +--- + +# ✨ Плазма (глобална конфигурација) diff --git a/sr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/sr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..bf37aae34 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Светска структура diff --git a/sr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/sr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..653c526af --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у plazma-world.yml. +--- + +# ✨ Плазма (састав света) diff --git a/sr/origin/plazma/adminstration/reference/configurations/property.md b/sr/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..a80395ea5 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Погледајте шта сваки чвор у server.properties значи. +--- + +# 🪨 Server.properties diff --git a/sr/origin/plazma/adminstration/reference/configurations/pufferfish.md b/sr/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..f35c5522d --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: пронађите шта сваки чвор у pufferfish.yml значи. +--- + +# 🐡 Балиндер diff --git a/sr/origin/plazma/adminstration/reference/configurations/purpur/README.md b/sr/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..f00bb069e --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у purpur.yml. +--- + +# 🦑 Пурпур diff --git a/sr/origin/plazma/adminstration/reference/configurations/purpur/global.md b/sr/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..8d239a9ec --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у purpur.yml. +--- + +# 🦑 Пурпур (глобална структура) diff --git a/sr/origin/plazma/adminstration/reference/configurations/purpur/world.md b/sr/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..8e96084e8 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Одредите шта представља сваки чвор у purpur.yml. +--- + +# 🦑 Пурпур (састав света) diff --git a/sr/origin/plazma/adminstration/reference/configurations/spigot.md b/sr/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..f9985b71e --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: пронађите шта сваки чвор у spigot.yml значи. +--- + +# 🚰 Спигот diff --git a/sr/origin/plazma/adminstration/reference/permissions.md b/sr/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..97721f7e0 --- /dev/null +++ b/sr/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Сазнајте више о овлашћењима Плазме. +--- + +# 🛡️ Овлашћења diff --git a/sr/origin/plazma/developers.md b/sr/origin/plazma/developers.md new file mode 100644 index 000000000..9000aac1a --- /dev/null +++ b/sr/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Искористите Plazma за развој пројеката трећих страна. +--- + +# ⚙️ Водич за програмере diff --git a/sr/origin/thunderbolt/README.md b/sr/origin/thunderbolt/README.md new file mode 100644 index 000000000..3d08da258 --- /dev/null +++ b/sr/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt је базиран на Plazma платформи која омогућава експерименталне печате да се користе директно као Флавор. +--- + +# 🌩️ Упутство за коришћење Thunderbolt diff --git a/sr/origin/volt/README.md b/sr/origin/volt/README.md new file mode 100644 index 000000000..b9fe0561d --- /dev/null +++ b/sr/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt је отворени изворни шаблон који вам омогућава да развијете свој сопствени серверски платформу на бази Плазме. +--- + +# ⚡ Водич за развој Волта diff --git a/sv-SE/origin/README.md b/sv-SE/origin/README.md new file mode 100644 index 000000000..f3f1b954d --- /dev/null +++ b/sv-SE/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Om du har frågor, vänligen fråga via Discord eller GitHub-diskussioner. +--- + +# 🏠 Välkommen till Docs Portal + +{% hint style="info" %} + +**Plazma:s dokument är för närvarande översatt av maskin.** + +[![Översättningsstatus](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Delta i översättningen av dokument på [https://translate.plazmamc.org/](https://translate.plazmamc.org/) och bidra till förbättringen av dokumentet. + +{% endhint %} + +### Om det uppstår problem med användningen av Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Är du intresserad av Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 din egen serverplattform? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Behöver du mer information om Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/sv-SE/origin/SUMMARY.md b/sv-SE/origin/SUMMARY.md new file mode 100644 index 000000000..798ef66ca --- /dev/null +++ b/sv-SE/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Innehållsförteckning + +- [🏠 Välkommen till Docs Portal](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Användardokumentation](plazma/README.md) +- [❓ Vad är Plazma?](plazma/about/README.md) + - [⬇️ Ladda ner](plazma/about/downloads.md) + - [✅ Versionsstödstatus](plazma/about/supported-versions.md) +- [⚒️ Serverhanteringsguide](plazma/administration/README.md) + - [👟 Komma igång](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referens](plazma/administration/reference/README.md) + - [🖥️ Kommandon](plazma/administration/reference/commands.md) + - [🛡️ Behörigheter](plazma/administration/reference/permissions.md) + - [🎛️ Argument och egenskaper](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Egenskaper](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global konfiguration](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Världsspecifik konfiguration](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global konfiguration](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Världsspecifik konfiguration](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global konfiguration](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Världsspecifik konfiguration](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Avancerad](plazma/administration/expert/README.md) + - [🧹 Optimering](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Gör om till vanilj](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Blockering](plazma/administration/expert/xray.md) + - [⚠️ Sårbarheter och fixar](plazma/administration/expert/fix-exploits.md) + - [⁉️ Vanliga frågor](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Utvecklarguide](plazma/developers.md) + - [✏️ Bidra](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Användarguide](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Utvecklingsguide](volt/README.md) + +## Diverse + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Hämta hela översikten](plazma/about/downloads-all.md) diff --git a/sv-SE/origin/miscellaneous/README.md b/sv-SE/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/sv-SE/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/sv-SE/origin/plazma/README.md b/sv-SE/origin/plazma/README.md new file mode 100644 index 000000000..5ba27cc15 --- /dev/null +++ b/sv-SE/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma är en öppen källkods serverplattform för Minecraft: Java Edition som lägger till experimentell optimering baserad på papper och anpassningsfunktioner för flera spelmekanismer." +--- + +# ✨ Plazma Användningsdokumentation + +## 👋 Välkommen till Plazma Dokumentation + +Välkommen till Plazma användningsdokumentationen! + +{% hint style="info" %} + +**Kan du inte lösa problemet genom handboken?** + +[Officiell Discord-server](https://discord.gg/MmfC52K8A8) eller via [GitHub-diskussioner](https://github.com/PlazmaMC/PlazmaBukkit/discussions) för att ställa frågor till gemenskapen! + +{% endhint %} + +### Om Plazma + +> Lär dig mer om vad Plazma är för serverplattform. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### För Administratörer + +> Skapa din egen server med hjälp av Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### För Utvecklare + +> Utveckla tredjepartsprojekt med hjälp av Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/sv-SE/origin/plazma/about/README.md b/sv-SE/origin/plazma/about/README.md new file mode 100644 index 000000000..b908d03d6 --- /dev/null +++ b/sv-SE/origin/plazma/about/README.md @@ -0,0 +1,72 @@ +--- +description: Lär dig mer om vad Plazma är för serverplattform. +--- + +# ❓ Vad är Plazma? + +- **Plazma** är en serverplattform baserad på [Paper](https://github.com/PaperMC/Paper) som endast tar med fördelarna från [Andromeda](https://github.com/EarendelArchived/Andromeda) och [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Vi strävar alltid efter att erbjuda hög stabilitet, kraftfull prestanda, snabba uppdateringar och omfattande funktioner. + +## 📋 Målet med Plazma + +- Vi strävar efter att bli en serverplattform med snabba uppdateringar och hög stabilitet. +- Vi strävar efter att erbjuda omfattande funktioner och kraftfull prestanda liknande en modplattform. +- Vi strävar efter att skapa en fri plattform där även Vanilla-patches kan anpassas. + +## ⚙️ Huvudfunktioner + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Snabbast uppdateringar**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ser till att Plazmas medföljande patchar alltid är uppdaterade, vilket ger de snabbaste uppdateringarna bland serverplattformar baserade på Paper. +6. **Optimerade standardkonfigurationsfiler**\ + Standardkonfigurationsfilerna är optimerade så att du inte behöver optimera dem manuellt. +7. **Effektivt flertrådat system**\ + Asynkronisering av systemmekanismer som inte påverkar spelets mekanik minskar [latens](#user-content-fn-4)[^4] och optimerar servern. +8. **Blockera användning av onödig plats**\ + Sammanfogar data med liknande värden för att minska minnesanvändningen. + +## ✨ Användningsfall + +- **Plattform som korrekt hanterar komplexa tillägg**\ + Plazma används på servern av utvecklaren [IPECTER](https://github.com/IPECTER).\ + Med egna tillägg som fungerar med NMS och reflektion, samt omfattande datapaket, kan den hantera över 100 spelare utan prestandaförlust. +- **Plattform som bibehåller snabb prestanda även på RPG-servrar**\ + En enda kluster kunde hålla 100 spelare utan TPS-förlust, och med 4 kluster kunde totalt 250 spelare spela smidigt. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Många streamers valda plattform**\ + Många streamers tittar på används som en hink för tittarens deltagande. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Ladda ner + +På följande sida kan du ladda ner Plazma. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Vill du ha mer information om vilka versioner som stöds? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot-plugins och Paper, Pufferfish, Purpur-plugins. + +[^2]: Tillhör Microsoft Corporation. + +[^3]: Genom att inaktivera chattrapporteringssystemet kan chatten endast hanteras på servern och Mojangs chattracking kan förhindras. + +[^4]: Tiden då spelet stannar för att systemmekanismer ska fungera. diff --git a/sv-SE/origin/plazma/about/downloads-all.md b/sv-SE/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..9bb07fdb6 --- /dev/null +++ b/sv-SE/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma körbar fil nedladdning hela visningen +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Version | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/sv-SE/origin/plazma/about/downloads.md b/sv-SE/origin/plazma/about/downloads.md new file mode 100644 index 000000000..711a1a9b7 --- /dev/null +++ b/sv-SE/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Ladda ner Plazma nu och prova det själv. +--- + +# ⬇️ Ladda ner + +#### Vill du ha mer information om vilka versioner som stöds? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Nedladdningen nedan är en körbar fil för vanliga användare.** + +Om du är utvecklare och behöver en annan typ av fil, se sidan nedan. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionHämta
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + Nedladdning +
1.20.1 + Nedladdning +
1.19.4 + Nedladdning +
+ +*** diff --git a/sv-SE/origin/plazma/about/patches-list.md b/sv-SE/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..1a64b62ab --- /dev/null +++ b/sv-SE/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på alla funktioner som har lagts till i Plazma. +--- + +# 📑 Inkluderade patchar diff --git a/sv-SE/origin/plazma/about/supported-versions.md b/sv-SE/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..ebfb5f43e --- /dev/null +++ b/sv-SE/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Ta reda på vilka versioner av Minecraft: Java Edition som stöds av Plazma." +--- + +# ✅ Versionsstöd + +{% hint style="info" %} + +**Plazma är utvecklad sedan 1.19.4 och versioner under 1.19.4 utvecklas inte längre.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: https://badge.plazmamc.org/1/Under_utveckling +[atv]: https://badge.plazmamc.org/2/Understöd +[fse]: https://badge.plazmamc.org/6/Funktionsstöd_avslutat +[eol]: https://badge.plazmamc.org/4/Understöd_avslutat +[ukn]: +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/Normal +[100]: https://badge.plazmamc.org/percent/100 + +![Väntar på release][wtr] ![Under utveckling][idv] ![Understöd][atv] ![Funktionsstöd avslutat][fse] ![Understöd avslutat][eol] + +| Version | Stabilitet och funktionsstöd | Byggstatus | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Byggstatus](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Byggstatus](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Byggstatus](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/sv-SE/origin/plazma/administration/README.md b/sv-SE/origin/plazma/administration/README.md new file mode 100644 index 000000000..c47543d13 --- /dev/null +++ b/sv-SE/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Skapa din egen server med hjälp av Plazma. +--- + +# ⚒️ Serverhanteringsguide diff --git a/sv-SE/origin/plazma/administration/diagnosis/README.md b/sv-SE/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..2a8582fdf --- /dev/null +++ b/sv-SE/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur man hanterar problem när de uppstår. +--- + +# 🧾 진단 diff --git a/sv-SE/origin/plazma/administration/diagnosis/plugins.md b/sv-SE/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..caaa5e63c --- /dev/null +++ b/sv-SE/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur du löser problem när pluginet inte fungerar korrekt. +--- + +# 📜 플러그인 diff --git a/sv-SE/origin/plazma/administration/expert/README.md b/sv-SE/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..a8065867c --- /dev/null +++ b/sv-SE/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur man hanterar Plazma professionellt. +--- + +# 🎓 Avancerad diff --git a/sv-SE/origin/plazma/administration/expert/fix-exploits.md b/sv-SE/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..ff1d91d70 --- /dev/null +++ b/sv-SE/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på kända sårbarheter och hur man löser dem. +--- + +# ⚠️ Kända sårbarheter och lösningar diff --git a/sv-SE/origin/plazma/administration/expert/optimize.md b/sv-SE/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..049da8ce7 --- /dev/null +++ b/sv-SE/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur du optimerar Plazma. +--- + +# 🧹 Optimering diff --git a/sv-SE/origin/plazma/administration/expert/proxy.md b/sv-SE/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..8cc11574e --- /dev/null +++ b/sv-SE/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Lär dig hur du säkert konfigurerar proxysplattformen "Velocity". +--- + +# 🔀 Proxy diff --git a/sv-SE/origin/plazma/administration/expert/vanillaize.md b/sv-SE/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..4c5e113e1 --- /dev/null +++ b/sv-SE/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Ta reda på hur man återställer Paper och vanillapatchen. +--- + +# ↩️ Vanillize + +{% hint style="warning" %} + +**Paper lägger inte till alternativ i de flesta patchar som löser vaniljfel.** + +Plazma håller på att utveckla möjligheten att inaktivera sådana felkorrigeringar i sin konfiguration just nu. + +Därför är denna guide fortfarande under arbete och informationen kan alltid förändras. + +{% endhint %} diff --git a/sv-SE/origin/plazma/administration/expert/xray.md b/sv-SE/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..36b2ccb76 --- /dev/null +++ b/sv-SE/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på olika inbyggda metoder för att blockera X-Ray. +--- + +# 🩻 Blockera X-Ray diff --git a/sv-SE/origin/plazma/administration/faq.md b/sv-SE/origin/plazma/administration/faq.md new file mode 100644 index 000000000..c4d26b1aa --- /dev/null +++ b/sv-SE/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Ta reda på vanliga frågor. +--- + +# ⁉️ Vanliga frågor + +{% hint style="info" %} + +**Hittar du inte det svar du letar efter?** + +[Officiell Discord-server](https://discord.gg/MmfC52K8A8) eller via [GitHub-diskussioner](https://github.com/PlazmaMC/PlazmaBukkit/discussions) för att ställa frågor till gemenskapen! + +{% endhint %} + +### Plazma startar inte + +Om du ser `no main manifest attribute, in plazma-(version).jar` i konsolen,\ +har du laddat ner en utvecklar-API-fil, du bör ladda ner **Reobf Paperweight** från GitHub-sidan. + +För mer information, se följande sida. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### En varning visas varje gång servern startas + +Plazma innehåller vissa instabila patchar och kan därför alltid visa varningar när servern startas. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Denna varning kan inaktiveras med hjälp av systemegenskapen [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +För mer information, se följande sida. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tillgänglig från version 1.20.1 diff --git a/sv-SE/origin/plazma/administration/getting-started/README.md b/sv-SE/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..77c6a5e9f --- /dev/null +++ b/sv-SE/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Lär dig hur man skapar en server med Plazma. +--- + +# 👟 Komma igång + +För att använda Plazma stabilt måste systemet uppfylla följande krav. + +| | Minimum | Rekommenderat | +| :-------------: | ------- | ------------- | +| Arkitektur | x64 | - | +| RAM | 8GB | 16GB | +| Lagringsutrymme | 1GB | 8GB | +| JDK | 17 | 21 | + +För en smidig konfigurationsfilredigering, rekommenderas att installera en redigerare som [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Korrekt utmatning" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' är inte ett internt eller externt kommando, ett körbart program eller +en satsfil. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Ladda först ner **JDK 21** i `.msi`-format från [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Kör den nedladdade installationsguiden och klicka på `Nästa`. +3. Aktivera `Set JAVA_HOME variable` från menyn i mitten till vänster och klicka sedan på `Nästa`. +4. Klicka på `Install` för att slutföra JRE-installationen. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Kör sedan följande kommando i terminalen för att installera JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Ladda ner Plazma + +Plazma erbjuder olika typer av körbara filer. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Läs mer + +Namnet på den körbara filen är `plazma-(versionshanterare)-1.20.4-R0.1-SNAPSHOT-(kartläggningsformat).jar`. + +- **Kartläggningsformat**\ + Kartläggning är en slags karta som kopplar samman Minecrafts faktiska kod med förvanskad kod. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mappad, är en Vanilla Minecraft-mappning. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Versionshanterare**\ + Versionshanteraren är en launcher för servern som behövs för att köra servern och patcha serverfiler. + - **Paperclip**\ + Utvecklad av PaperMC-teamet för Paper och andra derivatplattformar, laddar ner bibliotek och tillämpar patcher på servern. + - **Bundler**\ + Vanilla Minecraft versionshanterare. + +
+ +*** + +## 3. Skapa startskript + +För att enkelt starta Plazma och låta servern starta om automatiskt behöver du skapa ett [startskript](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Ladda ner startskriptet genom att klicka på nedladdningsknappen längst ner till vänster.\ +**Kontrollera att det nedladdade startskriptet matchar ditt operativsystem.** + +*** + +## 4. Rensa filer + +Flytta det nedladdade startskriptet och Plazma till en ny mapp. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Kör startskriptet nu. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA-överenskommelse + +När du har kört startskriptet en gång skapas en `eula.txt`-fil i mappen. + +EULA[^9] är ett användaravtal som måste godkännas för att använda [Mojang Studios](#user-content-fn-10)[^10] tjänster. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +För att godkänna EULA, ändra `eula=false` till `eula=true` i `eula.txt` och spara ändringarna. + +*** + +## 6. Tillåt extern anslutning (Windows) + +Modernt operativsystem blockerar externa åtkomster som en säkerhetsåtgärd med brandväggar och routrar som standard. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Om routern inte stöder UPnP, varje router har olika paneler så du måste söka efter information själv. + +Alternativt kan du använda [Ngrok](https://ngrok.com/) för att skapa en temporär adress. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Kontrollera om portöversättning behövs + +Skriv in följande i Kör-fönstret och kör det. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Om utmatningen är `True` är du klar, om den är `False` behöver du ställa in portöversättning. + +### 6.2 Anslut till servern + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Adressen som används för att ansluta till servern kan hittas [här](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Därefter, om servern startas om, kommer Plazma automatiskt att försöka vidarebefordra porten. + +Nedan visas om UPnP lyckades enligt meddelandet som visas i konsolen, som kommer att vara i formatet `[UPnP] (meddelande)`. + +| Meddelande | Betydelse | +| -------------------------------------- | ------------------------------------------------------------------ | +| `Porten (port)` öppnades framgångsrikt | Port vidarebefordran lyckades. | +| `Porten (port) är redan öppen` | En annan tjänst använder redan den angivna porten. | +| `Misslyckades att öppna porten (port)` | Port vidarebefordran misslyckades. | +| `Tjänsten är inte tillgänglig` | Routern stöder inte UPnP. | + +När servern stängs av kommer Plazma automatiskt att stänga porten. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Ladda ner ZIP-filen `Windows (64-bit)` från [Ngroks hemsida](https://ngrok.com/download). +2. Placera den nedladdade Ngrok-filen i servermappen. +3. Skapa en [autentiserings token](#user-content-fn-13)[^13] från [Ngroks instrumentpanel](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Kör kommandot som visas i `Command Line` i servermappen. +5. Lägg till `start /b ngrok tcp --region jp 25565` längst upp i startskriptet, och `taskkill /f /t /im ngrok.exe` längst ner. +6. Från `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` i toppen av konsolen, är `0.tcp.jp.ngrok.io:12345` serverns adress. +7. Nu kan du ansluta externt via denna adress. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Till exempel, om följande visas efter att kommandot har körts, + +```log +Windows IP-konfiguration + +Ethernet-adapter Ethernet: + + Anslutnings-specifikt DNS-suffix. . . . . . . : + IPv4-adress. . . . . . . . . . . . . . . . . : 192.168.3.7 + Nätmask. . . . . . . . . . . . . . . . . . . : 255.255.255.0 + Standard-gateway. . . . . . . . . . . . . . : 192.168.3.1 + +``` + +Försök att ansluta till servern lokalt med den IPv4-adress som visas som `192.168.3.7`. + +Om servern och spelet körs på samma dator kan du ansluta via `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Utveckla + +Om servern har startats framgångsrikt och fungerar korrekt, är det dags att anpassa servern efter dina behov. + +Ta reda på hur du anpassar servern med hjälp av följande handledning. + +{% content-ref url="nasta-steg.md" %} +[nasta-steg.md](nasta-steg.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, som Plazma är baserat på, är i sin tur baserat på Spigot, som i sin tur är baserat på den officiella serverplattformen. + +[^3]: Windows-tangent + R + +[^4]: För Linux, kör `java --version` i terminalen. + +[^5]: JRE är en öppen källkodsprojekt och finns i olika varianter, liknande Minecraft serverplattformen. + +[^6]: Det är vanligtvis känt som en **launcher**. + +[^7]: Genom att aktivera "Auto-start" kommer servern att starta om automatiskt. Du kan avsluta genom att trycka `Control + C`. + +[^8]: Det rekommenderas inte att använda mer än hälften av systemets minne. + + Till exempel, om systemets totala minneskapacitet är 8GB, är det inte rekommenderat att använda mer än 4GB. + +[^9]: End-User License Agreement, Slutanvändarlicensavtal. Kontrollera [Minecrafts hemsida](https://www.minecraft.net/ko-kr/usage-guidelines) för mer information. + +[^10]: Microsoft Corporation. + +[^11]: Enligt lag om spelindustrins främjande i Republiken Korea artikel 32 punkt 1 punkt 9, kan juridiska åtgärder vidtas av **Koreas Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur som ingår i Plazma kommunicerar automatiskt med routern via denna teknik för att endast öppna porten när servern körs, vilket eliminerar behovet av manuell port vidarebefordran. + +[^13]: Om du inte har ett konto kan du registrera dig på Ngrok med ditt Google- eller GitHub-konto. diff --git a/sv-SE/origin/plazma/administration/getting-started/customization.md b/sv-SE/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..d8cd185c4 --- /dev/null +++ b/sv-SE/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,113 @@ +--- +description: Ta reda på hur du anpassar servern för användare. +--- + +# 🎨 Anpassning för användare + +Anledningen till att man använder en modifierad serverplattform som Plazma istället för den officiella serverplattformen från Mojang Studios är att den ger möjlighet till kraftfull **anpassning**. + +Här är olika sätt att anpassa och använda Plazma. + +## Konfigurationsändring + +Det mest grundläggande sättet att anpassa Plazma är att ändra konfigurationen. + +Plazma erbjuder kraftfulla konfigurationsinställningar från spelets mekanik till monsterattribut. + +Se nedan sida för information om Plazmas konfiguration. + +{% content-ref url="../reference/configurations/" %} +[konfigurationer](../reference/configurations/) +{% endcontent-ref %} + +## Användning av tillägg + +{% hint style="success" %} + +**Plazma stöder alla pluginer baserade på Papper på ett korrekt sätt.** + +För Spigot-pluginer kan vissa inte fungera på grund av kartändringar från Papper från 1.20.5, men de flesta pluginer baserade på Papper, Pufferfish och Purpur fungerar även på Plazma. Om de inte fungerar korrekt är det ett fel med Plazma, så vänligen [rapportera det omedelbart.](../diagnosis/plugins.md) + +{% endhint %} + +Detta är en av de främsta anledningarna till att använda Plazma och den mest kraftfulla metoden för att anpassa Plazma. +Plazmas kraftfulla plugin-ekosystem gör det enkelt att anpassa servern. + +Det finns olika sätt att hitta och ladda ner pluginer. Vissa pluginer laddas upp på offentliga lagringstjänster, medan andra laddas upp på GitHub eller egna webbplatser. + +{% hint style="caution" %} + +**Pluginer kan få direkt åtkomst till systemet!** + +Använd VirusTotal eller liknande tjänster för att alltid kontrollera att en plugin är säker innan du använder den, eller ladda ner pluginen från en betrodd källa. + +{% endhint %} + +Det finns olika tjänster för att ladda ner pluginer. Bland dessa, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) är tjänster där pluginer granskas innan de laddas upp, vilket säkerställer att endast säkra pluginer distribueras. + +### Tillämpa pluginer + +När du har laddat ner en plugin är det dags att tillämpa den. + +1. Pluginer finns som `.jar` eller `Java Executable File`. Vissa kan vara komprimerade, och i så fall ska du extrahera dem och använda filen som innehåller `bukkit`, `spigot` eller `papper` i namnet, samt filen med `fat` om det finns. +2. Placera den nedladdade filen i mappen `plugins` i serverns katalog och starta om servern. +3. När Plazma startar kommer det att finnas nytt innehåll i konsolen. + Detta indikerar att Plazma har laddat pluginen korrekt. +4. Även om Plazma har laddat pluginen korrekt kanske pluginen inte startas. + Använd kommandot `/plugins` för att visa vilka pluginer som är laddade på servern. + Om namnet på en installerad plugin inte är rött utan grönt, har pluginen laddats korrekt. + +Om en plugin inte har laddats korrekt kan du hitta lösningar på problemet på följande sida. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Användning av datapaket + +Datapaket är ett sätt att anpassa Minecraft, liknande resurspaket. + +Med datapaket kan du lägga till nya entiteter och utmaningar i spelet. + +{% hint style="caution" %} + +**Datapaket kan skada världen!** + +Vissa felaktiga datapaket kan skada världen irreparabelt. + +Det rekommenderas att säkerhetskopiera världen innan du tillämpar datapaket. + +{% endhint %} + +Datapaket kan också laddas ner från olika tjänster som [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) och andra. + +När du har laddat ner datapaketet kan du placera det i mappen `datapacks` i serverns världskatalog. +Om mappen inte finns kan du skapa den och lägga till datapaketet där. + +{% hint style="warning" %} + +**Vissa [datapaket](#user-content-fn-2) kan inte tillämpas korrekt vid första försöket.** + +För att hantera detta rekommenderas att starta om servern **två gånger**. + +{% endhint %} + +Datapaket kan lätt skadas varje gång Minecraft uppdateras. + +Särskilt om datapaketet är allvarligt skadat kan det leda till serverkollisioner, så det är viktigt att testa noggrant innan du uppdaterar servern. + +{% hint style="info" %} + +**Efter serverstartkommandot kan du skriva `safeMode` för att inaktivera alla datapaket och sedan starta om servern.** + +[Se `Referens > Argument och parametrar` för mer information.](../reference/arguments.md) + +{% endhint %} + +Du kan kontrollera vilka datapaket som har tillämpats med kommandot `/datapack list`. + +*** + +[^1]: Eller använda add-ons för Minecraft: Bedrock Edition. + +[^2]: Lägg till nya entiteter och mer. diff --git a/sv-SE/origin/plazma/administration/getting-started/next-step.md b/sv-SE/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..d3cdedd1b --- /dev/null +++ b/sv-SE/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Ta reda på hur du anpassar servern för användare. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Här är olika sätt att anpassa och använda Plazma. + +## Konfigurationsändring + +Det mest grundläggande sättet att anpassa Plazma är att ändra konfigurationen. + +Plazma erbjuder kraftfulla konfigurationsinställningar från spelets mekanik till monsterattribut. + +Se nedan sida för information om Plazmas konfiguration. + +{% content-ref url="../reference/configurations/" %} +[konfigurationer](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Användning av tillägg + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Detta är en av de främsta anledningarna till att använda Plazma och den mest kraftfulla metoden för att anpassa Plazma. Plazmas kraftfulla plugin-ekosystem gör det enkelt att anpassa servern. + +Det finns olika sätt att hitta och ladda ner pluginer. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Det finns olika tjänster för att ladda ner pluginer. Bland dessa, [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) är tjänster där pluginer granskas innan de laddas upp, vilket säkerställer att endast säkra pluginer distribueras. + +### Tillämpa pluginer + +När du har laddat ner en plugin är det dags att tillämpa den. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Placera den nedladdade filen i mappen `plugins` i serverns katalog och starta om servern. +3. När Plazma startar kommer det att finnas nytt innehåll i konsolen. Detta indikerar att Plazma har laddat pluginen korrekt. +4. Även om Plazma har laddat pluginen korrekt kanske pluginen inte startas. Använd kommandot `/plugins` för att visa vilka pluginer som är laddade på servern. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Om en plugin inte har laddats korrekt kan du hitta lösningar på problemet på följande sida. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Användning av datapaket + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Med datapaket kan du lägga till nya entiteter och utmaningar i spelet. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Vissa felaktiga datapaket kan skada världen irreparabelt. + +Det rekommenderas att säkerhetskopiera världen innan du tillämpar datapaket. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +När du har laddat ner datapaketet kan du placera det i mappen `datapacks` i serverns världskatalog. Om mappen inte finns kan du skapa den och lägga till datapaketet där. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +För att hantera detta rekommenderas att starta om servern **två gånger**. +{% endhint %} + +Datapaket kan lätt skadas varje gång Minecraft uppdateras. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Du kan kontrollera vilka datapaket som har tillämpats med kommandot `/datapack list`. + +*** + +## Optimering + +Plazma har många optimeringspatchar. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Se nedanstående sida för information om säker och korrekt proxykonfiguration. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Säkerhet + +Med Minecrafts utveckling är det lätt att hitta [sårbarhetsattacksmotorer](#user-content-fn-3)[^3] även online. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Behörighetsinställning + +Vissa administratörskommandon från vissa plugins kan ha sårbarheter om behörigheterna inte är korrekt inställda. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray-blockering + +X-Ray är en av de sårbarheter som är lätt att använda även med grundläggande optimerade klienter. + +Plazma erbjuder en konfiguration för att blockera X-Ray som standard. + +Se nedanstående sida för information om X-Ray-blockering. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Vitlista + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +För att se vilka spelare som är vitlistade använd `/whitelist query`. + +*** + +[^1]: Eller använda add-ons för Minecraft: Bedrock Edition. + +[^2]: Lägg till nya entiteter och mer. + +[^3]: Det kallas vanligtvis "hack". + +[^4]: Om konfigurationen inte är optimerad, om Plazma är föråldrat eller om nya sårbarheter upptäcks kan de eventuellt inte vara blockerade. + +[^5]: När spelare ansluter till servern görs det via en Ngrok-proxyserver och den utfärdade Ngrok-adressen ändras vid varje omstart. diff --git a/sv-SE/origin/plazma/administration/reference/README.md b/sv-SE/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..bd0ee9d97 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Ta reda på de grundläggande sätten att anpassa Plazma som erbjuds. +--- + +# 📜 리퍼런스 + +Plazma erbjuder olika sätt att anpassa sig. + +Av dessa är nedanstående 4 sätt sätt att anpassa sig som kan användas direkt utan extra arbete. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Officiell Discord-server](https://discord.gg/MmfC52K8A8) eller via [GitHub-diskussioner](https://github.com/PlazmaMC/PlazmaBukkit/discussions) för att ställa frågor till gemenskapen! +{% endhint %} + +*** + +## 🖥️ Kommandon + +> Kommandon låter dig samla information i spelet eller anpassa spelupplevelsen. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Behörighet + +> Behörighet bestämmer spelarens interaktionsområde. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argument och egenskaper + +> Argument och egenskaper påverkar Plazmas funktion på ett övergripande sätt. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Konfiguration + +> Konfiguration är det mest grundläggande sättet att anpassa Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/sv-SE/origin/plazma/administration/reference/arguments.md b/sv-SE/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..7760e7b52 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Lär dig om startargument och systemegenskaper. +--- + +# 🎛️ Argument och egenskaper + +Startargument och systemegenskaper är värden som läggs till [kommandon som används](#user-content-fn-1)[^1] för att köra Plazma, vilket i sin tur påverkar Plazmas funktion. + +[Plats för tillägg till kommandon](#user-content-fn-2)[^2] kommer att delas upp i **startargument** och **systemegenskaper** enligt detta. + +*** + +## Systemegenskaper + +Systemegenskaper är värden som behandlas av JVM innan Plazma initialiseras och placeras framför `-jar`. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Användning + +Systemegenskaper anges som Java-kommandon mellan `java` och `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indikerar att det är ett dedikerat argument för Plazma och inte en inbyggd JVM-argument, + +Om inga värden anges för egenskaperna kommer de att vara [`true` som standardvärde](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Alla systemegenskaper + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Uppdaterar avstängda skyltformat. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar debuggloggar för entitetsinformation. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar NMS-revision för att korrekt ladda felsökningsinformation i IDE, och omkartlägger automatiskt intern versionsinformation. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar Spigots Watchdog-varningssystem. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar bekräftelsemeddelandet för `/reload`-kommandot. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Om du är en pluginutvecklare och behöver uppdatera en plugin, använd hotswap istället för `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar pluginer som använder standard in- och utmatning. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Varnar när avbrutet format upptäcks i chattkomponenter. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar verifiering av servermönster när en spelare ansluter till servern. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar felsökningsloggar för saknade nycklar i NBT-objekt. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar felsökningsloggar för felaktiga huvudprofiler. + +Detta loggar alla felaktiga huvuden i världen med deras positioner. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar prioritering av plugin-klasser. + +Användbart vid problem med plugin-skuggning. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar Netty-flushkonsolideringssystemet. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Standardvärde**: `750` + +Dela upp entiteter i flera paket om de är fler än det angivna värdet. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Standardvärde**: `8192` + +Ställer in den maximala storleken på paket som servern kan ta emot åt gången. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar Java-versionkontroll. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Det kan permanent skada världar och filer samt förstöra spelets mekanik. + +Alla problem som uppstår efter detta är användarens ansvar och Plazma ger inget stöd för detta. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Standardvärde**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Standardvärde**: `80` + +Ställer in max längd för text på en skyltlinje. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Standardvärde**: `(world version) + 1` + +Ställer in versionen för uppdateringsinformation som ska initialiseras först. + +Användbart vid massuppdatering av chunkar men annars sällan använt. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Standardvärde**: `True` + +Aktiverar hantering av YAML-filkommentarer som standard. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Standardvärde**: `30` + +Spelaren kastas ut om ingen data har mottagits inom den angivna tiden (i sekunder). + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Ignorerar kommentarer i serveregenskaper. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar debuggloggar för synkroniserad chunkskapande. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar Minecrafts [standard chunkskapande system](#user-content-fn-10)[^10]. + +Detta leder till en betydande prestandaförsämring eftersom varje chunk sparas i tur och ordning. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar explicit flushing för nätverkskanaler. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Loggar alltid fel som uppstår utanför huvudtråden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Ger varning om schemalagda uppgifter har för stor fördröjning. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Om du använder den medföljande körbara filen tillämpas endast patcher utan att starta servern. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +Optimerar den ursprungliga konfigurationen mer kraftfullt. + +Aktivering gör att servern blir snabbare och säkrare, men kan ha stor påverkan på spelupplevelsen. + +#### `Plazma.disableConfigOptimization` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` +- **Konflikt**: `Plazma.aggressiveOptimize` + +Optimerar inte den ursprungliga konfigurationen. + +Detta innebär att använda Pappers grundläggande konfiguration. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` + +Inaktiverar Plazma-varumärket och använder en vanlig serverfavicon. + +#### `Plazma.useVanillaConfiguration` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` +- **Konflikt**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Detta kan i hög grad påverka serverns säkerhet och prestanda. + +Alla problem som uppstår med denna egenskap är serveradministratörens ansvar. +{% endhint %} + +Förser den ursprungliga konfigurationen med standardvärden från Mojang. + +Detta inaktiverar alla patchar för sårbarheter som Paper har implementerat. + +Sårbarhetspatchar kan återaktiveras i Paper-konfigurationen eller Plazma-konfigurationen. + +#### `Plazma.vanillaize` + +- **Typ**: `Boolean` +- **Standardvärde**: `true` +- **Konflikt**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Justerar den ursprungliga konfigurationen för att vara närmare en vanlig konfiguration. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Avbruten egenskap + +Följande systemegenskaper är avbrutna egenskaper. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` +- **Avbruten användning**: Timings har tagits bort från Plazma sedan + +Bestämmer om det är tillåtet att överskrida det maximala värdet som kan skickas till Aikars Timings API. + +Om detta inte hanteras av API:et, kommer en hastighetsbegränsning att tillämpas. + +*** + +## Startargument + +Startargumentet anges efter `-jar *.jar` för att initialisera Plazma och bearbetas tillsammans med det. + +### Användning + +Systemegenskaper anges som programkommandon efter `-jar *.jar`. + +Till exempel, om du vill använda startargumentet `nogui`,\ +ska du ange det på följande sätt så att Plazma kan bearbeta `nogui`-argumentet under initialiseringen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Fullständiga startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standardvärde**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Alias**: `c` +- **Standardvärde**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Alias**: `c` +- **Standardvärde**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Startar servern i demovärlden. + +#### `eraseCache` + +Tar bort eventuella cache-filer som finns kvar efter en världsuppdatering. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Alias**: `?` + +Skriver ut alla startargument och deras beskrivningar för Plazma. + +#### `initSettings` + +Skapar endast konfigurationsfilen och stänger av servern. + +#### `jfrProfile` + +Aktiverar JFR-profileringsläget. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standardvärde**: `(serveregenskaper)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Inaktiverar den grafiska användargränssnittspanelen. + +#### `nojline` + +Inaktiverar JLine och använder en vanlig konsol istället. + +#### `online-mode` + +- **Alias**: `o` +- **Standardvärde**: `(serveregenskaper)` + +Väljer om spelare ska verifieras mot Mojangs autentiseringsservrar. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardvärde**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Ställer in platsen för den avbrutna PaperSpigot-konfigurationsfilen. + +Används för att överföra befintlig konfiguration till en ny fil och används inte längre efter detta. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardvärde**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Alias**: `p` +- **Standardvärde**: `plugins` + +Ställer in platsen för plugin-mappen. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardvärde**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardvärde**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Startar servern i fullständigt vaniljläge (säkert läge). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standardvärde**: `(serveregenskaper)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standardvärde**: `(serveregenskaper)` + +Ställer in serverns port. + +#### `server-name` + +- **Standardvärde**: `A Plazma Server` + +Ställer in serverns namn. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardvärde**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Alias**: `v` + +Skriver ut Plazma-versionen. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardvärde**: `(servermapp)` + +Ställer in platsen där världsfiler sparas. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standardvärde**: `(serveregenskaper)` + +Ställer in namnet på världsfilen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Beroende på den bifogade platsen ändras platsen för att hantera parametrar. + +[^3]: Till exempel, om du vill ställa in `Plazma.iKnowWhatIAmDoing` till `true` (aktivera), fungerar det på samma sätt att bara ange `-DPlazma.iKnowWhatIAmDoing` istället för `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Till exempel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Händelsedetektor. + +[^6]: Händelsedetektor. + +[^7]: Klient. + +[^8]: Ett signal som indikerar att servern är korrekt ansluten, liknande hjärtslag. + +[^9]: Med Purpurs AFK-utkastningsfunktion kan även frånvarande spelare kastas ut. + +[^10]: Sync Chunk Write System, system för synkron skapande av segment. + +[^11]: `VARNING! Plazma kan orsaka oväntade problem, så se till att testa det noggrant innan du använder det på en offentlig server.` + +[^12]: I spelet fungerar även `världsoptimering` enligt samma princip. + +[^13]: Administratörer över `nivå 2` är undantagna. + +[^14]: Internetprotokoll, IP. diff --git a/sv-SE/origin/plazma/administration/reference/commands.md b/sv-SE/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..fd810339c --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vilka kommandon som är tillgängliga i Plazma. +--- + +# 🖥️ Kommandon diff --git a/sv-SE/origin/plazma/administration/reference/configurations/README.md b/sv-SE/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..80deefce1 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Konfiguration är det mest grundläggande sättet att anpassa Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Egenskap + +> Egenskap är den mest grundläggande konfigurationsfilen som erbjuds i Minecraft. Genom att använda egenskaper kan du ändra grundläggande mekanismer i spelet. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit konfiguration + +> Bukkit konfiguration är den mest grundläggande konfigurationsfilen som erbjuds i Plazma. Genom att använda Bukkit konfiguration kan du ändra grundläggande mekanismer i Minecraft-servrar. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot konfiguration + +> Spigot konfiguration gör det möjligt att ändra detaljerade mekanismer, spelarhantering, kommandon och meddelanden i spelet. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper konfiguration + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish-konfiguration gör det möjligt att ändra Plazmas behandling av världar och enheter. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur konfiguration + +> Purpur-egenskaper gör det möjligt att ändra grundläggande speldata i spelet. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma konfiguration + +> Plazma konfiguration möjliggör anpassning av Plazmas funktioner. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/sv-SE/origin/plazma/administration/reference/configurations/bukkit.md b/sv-SE/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..7c36eca88 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i bukkit.yml betyder. +--- + +# 🪣 Bukkit diff --git a/sv-SE/origin/plazma/administration/reference/configurations/paper/README.md b/sv-SE/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..41d231046 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på syftet med varje fil i konfigurationsmappen. +--- + +# 🛩️ Papper diff --git a/sv-SE/origin/plazma/administration/reference/configurations/paper/global.md b/sv-SE/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..4609be66d --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i paper-global.yml betyder. +--- + +# 🌏 전역 구성 diff --git a/sv-SE/origin/plazma/administration/reference/configurations/paper/world.md b/sv-SE/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..4431f9e3e --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Ta reda på vad varje nod i paper-world.yml betyder. +--- + +# 🏳️ 세계별 구성 + +Världsomfattande diff --git a/sv-SE/origin/plazma/administration/reference/configurations/plazma/README.md b/sv-SE/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..218315744 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på syftet med varje fil i konfigurationsmappen. +--- + +# ✨ Plazma diff --git a/sv-SE/origin/plazma/administration/reference/configurations/plazma/global.md b/sv-SE/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a17b7c5ca --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i plazma-global.yml betyder. +--- + +# 🌏 전역 구성 diff --git a/sv-SE/origin/plazma/administration/reference/configurations/plazma/world.md b/sv-SE/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..8d5c63b3e --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i plazma-world.yml betyder. +--- + +# 🏳️ 세계별 구성 diff --git a/sv-SE/origin/plazma/administration/reference/configurations/plazma/worlds.md b/sv-SE/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..fb064ed75 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i plazma-world.yml betyder. +--- + +# ✨ Plazma (världsstruktur) diff --git a/sv-SE/origin/plazma/administration/reference/configurations/property.md b/sv-SE/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..fe81cf240 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i server.properties betyder. +--- + +# 🪨 Server.properties diff --git a/sv-SE/origin/plazma/administration/reference/configurations/pufferfish.md b/sv-SE/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..6eddb9b92 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i pufferfish.yml betyder. +--- + +# 🐡 Blåsfisk diff --git a/sv-SE/origin/plazma/administration/reference/configurations/purpur/README.md b/sv-SE/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..58fc1d4f4 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i purpur.yml betyder. +--- + +# 🦑 Purpur diff --git a/sv-SE/origin/plazma/administration/reference/configurations/purpur/global.md b/sv-SE/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..2c7e69250 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i purpur.yml betyder. +--- + +# 🌏 전역 구성 diff --git a/sv-SE/origin/plazma/administration/reference/configurations/purpur/world.md b/sv-SE/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..74f14c006 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i purpur.yml betyder. +--- + +# 🏳️ 세계별 구성 diff --git a/sv-SE/origin/plazma/administration/reference/configurations/spigot.md b/sv-SE/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..b32f02f2b --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i spigot.yml betyder. +--- + +# 🚰 Spigot diff --git a/sv-SE/origin/plazma/administration/reference/permissions.md b/sv-SE/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..22b78f8f1 --- /dev/null +++ b/sv-SE/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Ta reda på behörigheterna för Plazma. +--- + +# 🛡️ Behörighet + +Behörigheter är en enkel säkerhetsåtgärd som ställer in omfånget där spelare på servern kan interagera med varandra. + +För att använda och enkelt redigera behörigheter bör du använda tillägg som [LuckPerms](https://luckperms.net). + +*** + +## Förstå den grundläggande behörighetsstrukturen + +I Minecraft finns det grundläggande administrativa behörighetsgrupper tillgängliga. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Spelare**\ + En behörighetsgrupp som vanligtvis tilldelas alla spelare. +2. **Medlare**\ + Kan ignorera spawnskydd. +3. **Världsadministratör**\ + Har åtkomst till alla kommandon och kommandoblock som är relaterade till världshantering.\ + Detta är den grundläggande behörighetsgruppen för datapaket och kommandoblock. +4. **Administratör**\ + Har åtkomst till alla kommandon som är relaterade till spelarhantering. +5. **Superadministratör**\ + Har åtkomst till alla kommandon, inklusive serverhantering.\ + Detta är den grundläggande behörighetsgruppen för konsol och operatörer. + +*** + +## Ställa in behörigheter + +*** + +## Fullständiga behörigheter + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Standard**: `Inget` + +Tillåter spelare att krypa och interagera med enheter för att rida dem. + +När man rider enheten kan spelaren använda rörelsetangenterna för att styra enhetens rörelse och hoppa eller flyga med hoppknappen. + +`(Namespaced Key)` är enhetens [Namespaced ID](#user-content-fn-2)[^2]. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Standard**: `Inget` + +Tillåter spelaren att använda enhetens speciella färdigheter medan de rider enheten. + +Inte alla enheter har tillgång till speciella färdigheter. Se nedan för en lista över alla tillgängliga speciella färdigheter. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Vänligen dela dina idéer på [Plazma Discord](https://plazmamc.org/discord) eller [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Se aktuella tillgängliga speciella färdigheter + +- **`crepper`**\ + Exploderar när du trycker på hoppknappen.\ + Om spelaren har behörigheten `allow.powered.creeper` kan de ladda upp explosionen genom att hålla ned hoppknappen. +- **`dolphin`**\ + Rusar fram när du trycker på hoppknappen. +- **`phantom`**\ + Spottar eld när du trycker på hoppknappen. +- **`wither`**\ + Skjuter ut witherhuvuden när du interagerar med enheten. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/compass` kommandot](commands.md#compass). + +#### `bukkit.command.credits` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/credits (Spelare)` kommandot](commands.md#credits). + +Lägg till `.other` efter behörighetsnamnet för att tillåta andra spelare att använda det. + +#### `bukkit.command.demo` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/demo (Spelare)` kommandot](commands.md#demo). + +Lägg till `.other` efter behörighetsnamnet för att tillåta andra spelare att använda det. + +#### `bukkit.command.ping` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/ping (Spelare)` kommandot](commands.md#ping). + +Lägg till `.other` efter behörighetsnamnet för att tillåta andra spelare att använda det. + +#### `bukkit.command.ram` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/ram` kommandot](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/rambar (Spelare)` kommandot](commands.md#rambar). + +Lägg till `.other` efter behörighetsnamnet för att tillåta andra spelare att använda det. + +#### `bukkit.command.restart` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/restart` kommandot](commands.md#restart). + +#### `bukkit.command.tps` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/tps` kommandot](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/tpsbar (Spelare)` kommandot](commands.md#tpsbar). + +Lägg till `.other` efter behörighetsnamnet för att tillåta andra spelare att använda det. + +#### `bukkit.command.timings` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/timings` kommandot](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Kolla in [Spark](https://spark.lucko.me/docs/Command-Usage) för liknande funktioner. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/uptime` kommandot](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Standard**: `Världsadministratör` + +Tillåter användning av [`/gamemode (GameMode) (Spelare)` kommandot](commands.md#gamemode). + +Lägg till `.other` efter behörighetsnamnet för att tillåta andra spelare att använda det. + +#### `paper.antixray.bypass` + +- **Standard**: `Inget` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Detta ger fördelar för båda sidor genom att förbättra prestandan. + +> För information om inställningar för X-Ray, se sidan nedan. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Standard**: `Inget` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Standard**: `Inget` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Standard**: `Inget` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Standard**: `Inget` + +Tillåter användning av [MiniMessage taggar](https://docs.advntr.dev/minimessage/format.html) på städ. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Standard**: `Inget` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Standard**: `Inget` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Standard**: `Inget` + +Undantar spelare från att bli kastade ut på grund av inaktivitet. + +#### `purpur.debug.f3n` + +- **Standard**: `Världsadministratör` + +Tillåter spelare att ändra spelarläget med tangentkombinationen `F3 + N`. + +Funktionen fungerar endast om spelaren har behörigheten för det specifika spelläget. + +#### `purpur.drop.spawners` + +- **Standard**: `Inget` + +Om spelaren bryter en spawnerblock med det konfigurerade verktyget kommer spawnerblocket att släppas. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Standard**: `Inget` + +Ändrar storleken på en enderbröst. + +`(NumberString)` kan vara `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Standard**: `Inget` + +Tillåter att det odödliga totemet fungerar även om det finns i inventariot. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Standard**: `Inget` + +Tillåt spelaren att ignorera begränsningen för antalet anslutningar. + +#### `purpur.mending_shift_click` + +- **Standard**: `Inget` + +Tillåt spelaren att reparera det hållna föremålet genom att `shift-klicka` interagera. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Standard**: `Inget` + +Tillåt spelaren att placera spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Standard**: `Inget` + +Låt spelaren teleportera direkt när de använder Nether Portal. + +#### `purpur.sign.color` + +- **Standard**: `Inget` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Standard**: `Inget` + +Tillåt användning av obfuscation-kod `(&o)` på skyltar. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Standard**: `Inget` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Standard**: `Inget` + +Tillåt spelare att med `interaktion` med sax förhindra TNT-explosioner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Planerad behörighet + +#### `plazma.bypass.ncr-require` + +- **Standard**: `Inget` + +Tillåt spelare att ansluta även om de inte har modet [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) installerat. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operatör. + +[^2]: Exempel: `ender_dragon` diff --git a/sv-SE/origin/plazma/adminstration/README.md b/sv-SE/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..c47543d13 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Skapa din egen server med hjälp av Plazma. +--- + +# ⚒️ Serverhanteringsguide diff --git a/sv-SE/origin/plazma/adminstration/expert/README.md b/sv-SE/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..a8065867c --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur man hanterar Plazma professionellt. +--- + +# 🎓 Avancerad diff --git a/sv-SE/origin/plazma/adminstration/expert/fix-exploits.md b/sv-SE/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..ff1d91d70 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på kända sårbarheter och hur man löser dem. +--- + +# ⚠️ Kända sårbarheter och lösningar diff --git a/sv-SE/origin/plazma/adminstration/expert/optimize.md b/sv-SE/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..049da8ce7 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur du optimerar Plazma. +--- + +# 🧹 Optimering diff --git a/sv-SE/origin/plazma/adminstration/expert/vanillaize.md b/sv-SE/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..d58015e1b --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Ta reda på hur man återställer Paper och vanillapatchen. +--- + +# ↩️ Vanillize + +{% hint style="warning" %} + +### Paper ger inte alternativ till de flesta av vanillas felkorrigeringar. + +Plazma håller på att utveckla möjligheten att inaktivera sådana felkorrigeringar i sin konfiguration just nu. + +Därför är denna guide fortfarande under arbete och informationen kan alltid förändras. +{% endhint %} diff --git a/sv-SE/origin/plazma/adminstration/faq.md b/sv-SE/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..f39259d52 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Ta reda på vanliga frågor. +--- + +# ⁉️ Vanliga frågor + +{% hint style="info" %} + +### Kan du inte hitta det svar du letar efter? + +Fråga gemenskapen via [Officiell Discord-server](https://discord.gg/MmfC52K8A8) eller [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% endhint %} + +### Ett meddelande visas men kör inte + +Om du ser `no main manifest attribute, in plazma-(version).jar` i konsolen,\ +har du laddat ner en utvecklar-API-fil, du bör ladda ner **Reobf Paperweight** från GitHub-sidan. + +För mer information, se följande sida. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### En varning visas varje gång servern startas + +Plazma innehåller vissa instabila patchar och kan därför alltid visa varningar när servern startas. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Denna varning kan inaktiveras med hjälp av systemegenskapen [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +För mer information, se följande sida. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Tillgänglig från version 1.20.1 diff --git a/sv-SE/origin/plazma/adminstration/getting-started/README.md b/sv-SE/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..6d0c1ff03 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Lär dig hur man skapar en server med Plazma. +--- + +# 👟 Komma igång + +För att använda Plazma stabilt måste systemet uppfylla följande krav. + +| | Minimum | Rekommenderat | +| :-------------: | ------: | ------------: | +| Arkitektur | x64 | - | +| RAM | 8GB | 16GB | +| Lagringsutrymme | 1GB | 8GB | +| JRE | 17 | 21 | + +För en smidig konfigurationsfilredigering, rekommenderas att installera en redigerare som [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Installera JRE + +Som namnet antyder är Minecraft: **"Java"** Edition utvecklad med Java och kräver JRE[^1] för att köras. + +Eftersom Plazma är baserad på Mojang Studios officiella serverplattform[^2], måste JRE också installeras för att använda Plazma. + +### 1.1 Kontrollera JRE-installationen + +För att kontrollera om JRE är installerat på systemet, skriv in [`cmd /k java --version`](#user-content-fn-4)[^4] i Kör-fönstret och kör det. + +Om det visas som nedan, hoppa till [steg 2](setup.md#id-2). + +{% code title="Korrekt utmatning" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Om det inte visas som ovan eller visas som nedan, saknas JRE eller är för gammal, och du måste utföra [steg 1.2](setup.md#id-1.2). + +{% code title="JRE är inte installerat" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE är för gammal" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Installera JRE + +I den här guiden använder vi Azul Zulu som en av JRE-alternativen[^5]. + +Efter installationen, kontrollera igen genom att utföra [steg 1.1](setup.md#id-1.1) för att se om installationen har slutförts korrekt. + +{% tabs %} +{% tab title="Windows" %} + +1. Ladda först ner **JDK 21** i `.msi`-format från [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Kör den nedladdade installationsguiden och klicka på `Nästa`. +3. Aktivera `Set JAVA_HOME variable` från menyn i mitten till vänster och klicka sedan på `Nästa`. +4. Klicka på `Install` för att slutföra JRE-installationen. + {% endtab %} + +{% tab title="macOS" %} +Ladda ner **JDK 21** i `.dmg`-format från [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) och kör installationsguiden för att installera JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Kör följande kommando i terminalen för att lägga till Azul Zulu-repositoriet till APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Kör sedan följande kommando i terminalen för att installera JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Använd följande kommando för att installera JRE. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Ladda ner Plazma + +Plazma erbjuder olika typer av körbara filer. + +{% hint style="warning" %} + +### I de flesta fall används `Reobf Paperclip`. + +Följande information är för utvecklare eller de som är intresserade av specifika egenskaper för varje typ.\ +Om du är en vanlig användare kan du hoppa till [steg 3](setup.md#id-3) utan problem. +{% endhint %} + +
+ +Läs mer + +Namnet på den körbara filen är `plazma-(versionshanterare)-1.20.4-R0.1-SNAPSHOT-(kartläggningsformat).jar`. + +- **Kartläggningsformat**\ + Kartläggning är en slags karta som kopplar samman Minecrafts faktiska kod med förvanskad kod. + - **Reobf**\ + Reobfuscation, även kallat Spigot-mappning, används främst i NMS-plugins.\ + Från och med 1.20.5 kommer det att sluta användas. + - **Mojmap**\ + Mojang-mappning, Vanilla Minecraft-mappning. +- **Versionshanterare**\ + Versionshanteraren är en launcher för servern som behövs för att köra servern och patcha serverfiler. + - **Paperclip**\ + Utvecklad av PaperMC-teamet för Paper och andra derivatplattformar, laddar ner bibliotek och tillämpar patcher på servern. + - **Bundler**\ + Vanilla Minecraft versionshanterare. + +
+ +*** + +## 3. Skapa startskript + +För att enkelt starta Plazma och låta servern starta om automatiskt behöver du skapa ett [startskript](#user-content-fn-6)[^6]. + +Du kan skapa startskriptet via [Flags.sh](https://flags.sh).\ +För Plazma, ange endast [minnesanvändning](#user-content-fn-8)[^8] och kommandot optimeras automatiskt. + +Ladda ner startskriptet genom att klicka på nedladdningsknappen längst ner till vänster.\ +**Kontrollera att det nedladdade startskriptet matchar ditt operativsystem.** + +*** + +## 4. Rensa filer + +Flytta det nedladdade startskriptet och Plazma till en ny mapp. + +{% hint style="warning" %} + +### Mappnamnet måste vara utan mellanslag och vara på engelska. + +Annars kan Plazma eller JRE fungera felaktigt. +{% endhint %} + +Kör startskriptet nu. För Windows, vid val av brandväggstillåtelse, välj **Tillåt** i popup-fönstret. + +*** + +## 5. EULA-överenskommelse + +När du har kört startskriptet en gång skapas en `eula.txt`-fil i mappen. + +EULA[^9] är ett användaravtal som måste godkännas för att använda [Mojang Studios](#user-content-fn-10)[^10] tjänster. + +Om du inte godkänner EULA kan du inte starta servern och om du bryter mot EULA kan du bli avstängd eller straffad på andra sätt [se här](#user-content-fn-11)[^11]. + +För att godkänna EULA, ändra `eula=false` till `eula=true` i `eula.txt` och spara ändringarna. + +*** + +## 6. Tillåt extern anslutning (Windows) + +Modernt operativsystem blockerar externa åtkomster som en säkerhetsåtgärd med brandväggar och routrar som standard. + +För Windows, eftersom brandväggen tilläts i [steg 3](setup.md#id-3), behöver du bara vidarebefordra portar. + +{% hint style="info" %} + +### Denna guide antar att du använder Windows-operativsystemet och en router som stöder [**UPnP**](#user-content-fn-12)[^12]. + +Om routern inte stöder UPnP, varje router har olika paneler så du måste söka efter information själv. + +Alternativt kan du använda [Ngrok](https://ngrok.com/) för att skapa en temporär adress. +{% endhint %} + +{% hint style="warning" %} + +### För Linux eller macOS och andra (semi-) UNIX-system, varje brandväggstjänst har olika inställningar så du måste söka efter information själv. + +{% endhint %} + +### 6.1 Kontrollera om portöversättning behövs + +Skriv in följande i Kör-fönstret och kör det. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Om utmatningen är `True` är du klar, om den är `False` behöver du ställa in portöversättning. + +### 6.2 Anslut till servern + +{% tabs %} +{% tab title="Anslut externt" %} +Om port vidarebefordran inte behövs eller om port vidarebefordran redan har lyckats, kan du nu ansluta till servern. + +Adressen som används för att ansluta till servern kan hittas [här](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Försök med UPnP port vidarebefordran" %} +I `purpur.yml` i servermappen, aktivera `network.upnp-port-forwarding` till `true`. + +Därefter, om servern startas om, kommer Plazma automatiskt att försöka vidarebefordra porten. + +Nedan visas om UPnP lyckades enligt meddelandet som visas i konsolen, som kommer att vara i formatet `[UPnP] (meddelande)`. + +| Meddelande | Betydelse | +| -------------------------------------- | -------------------------------------------------- | +| `Porten (port)` öppnades framgångsrikt | Port vidarebefordran lyckades. | +| `Porten (port) är redan öppen` | En annan tjänst använder redan den angivna porten. | +| `Misslyckades att öppna porten (port)` | Port vidarebefordran misslyckades. | +| `Tjänsten är inte tillgänglig` | Routern stöder inte UPnP. | + +När servern stängs av kommer Plazma automatiskt att stänga porten. +{% endtab %} + +{% tab title="Skapa temporär adress med Ngrok" %} +Metoden med Ngrok är användbar för tillfälliga tester, samarbete eller att spela med vänner. + +1. Ladda ner ZIP-filen `Windows (64-bit)` från [Ngroks hemsida](https://ngrok.com/download). +2. Placera den nedladdade Ngrok-filen i servermappen. +3. Skapa en [autentiserings token](#user-content-fn-13)[^13] från [Ngroks instrumentpanel](https://dashboard.ngrok.com/get-started/your-authtoken). +4. Kör kommandot som visas i `Command Line` i servermappen. +5. Lägg till `start /b ngrok tcp --region jp 25565` längst upp i startskriptet, och `taskkill /f /t /im ngrok.exe` längst ner. +6. Från `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` i toppen av konsolen, är `0.tcp.jp.ngrok.io:12345` serverns adress. +7. Nu kan du ansluta externt via denna adress. + {% endtab %} + +{% tab title="Anslut lokalt" %} +Om du försöker ansluta till servern lokalt, kan du använda den IPv4-adress som visas genom att köra `cmd /k ipconfig` i körningen. + +Till exempel, om följande visas efter att kommandot har körts, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Försök att ansluta till servern lokalt med den IPv4-adress som visas som `192.168.3.7`. + +Om servern och spelet körs på samma dator kan du ansluta via `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Utvecklingsfas + +Om servern har startats framgångsrikt och fungerar korrekt, är det dags att anpassa servern efter dina behov. + +Lär dig hur du anpassar servern genom följande guide. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java körningsmiljö. + +[^2]: Paper, som Plazma är baserat på, är i sin tur baserat på Spigot, som i sin tur är baserat på den officiella serverplattformen. + +[^3]: Windows-tangent + R + +[^4]: För Linux, kör `java --version` i terminalen. + +[^5]: JRE är en öppen källkodsprojekt och finns i olika varianter, liknande Minecraft serverplattformen. + +[^6]: Det är vanligtvis känt som en **launcher**. + +[^7]: Genom att aktivera "Auto-start" kommer servern att starta om automatiskt. Du kan avsluta genom att trycka `Control + C`. + +[^8]: Det rekommenderas inte att använda mer än hälften av systemets minne. + + Till exempel, om systemets totala minneskapacitet är 8GB, är det inte rekommenderat att använda mer än 4GB. + +[^9]: End-User License Agreement, Slutanvändarlicensavtal. Kontrollera [Minecrafts hemsida](https://www.minecraft.net/ko-kr/usage-guidelines) för mer information. + +[^10]: Microsoft Corporation. + +[^11]: Enligt lag om spelindustrins främjande i Republiken Korea artikel 32 punkt 1 punkt 9, kan juridiska åtgärder vidtas av **Koreas Microsoft Corporation**. + +[^12]: Universal Plug & Play. Purpur som ingår i Plazma kommunicerar automatiskt med routern via denna teknik för att endast öppna porten när servern körs, vilket eliminerar behovet av manuell port vidarebefordran. + +[^13]: Om du inte har ett konto kan du registrera dig på Ngrok med ditt Google- eller GitHub-konto. diff --git a/sv-SE/origin/plazma/adminstration/getting-started/customization.md b/sv-SE/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..70b67baa8 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på hur du anpassar servern för användare. +--- + +# 🎨 Anpassning för användare diff --git a/sv-SE/origin/plazma/adminstration/reference/arguments.md b/sv-SE/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..72f96942e --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,524 @@ +--- +description: Lär dig om startargument och systemegenskaper. +--- + +# 🎛️ Argument och egenskaper + +Startvariabler och systemegenskaper är värden som läggs till [kommandon som används](#user-content-fn-1)[^1] för att ändra värden som inte kan ändras efter att Plazma har startats. + +Beroende på [var kommandot läggs till](#user-content-fn-2)[^2] delas det upp i **startargument** och **systemegenskaper**. + +*** + +## Systemegenskaper + +Systemegenskaper är värden som behandlas av JVM innan Plazma initialiseras och placeras framför `-jar`. + +{% hint style="warning" %} + +### Ändringar i systemegenskaper kan påverka Plazmas och JVM:s funktionssätt och ha stor inverkan på spelet! + +Om du inte är säker på vad varje systemegenskap gör, **använd dem inte!** +{% endhint %} + +### Användning + +Systemegenskaper anges som Java-kommandon mellan `java` och `-jar`. + +Om du till exempel vill använda systemegenskapen `Plazma.dummyProperty`, +då initieras Plazma med värdet `37` efter att du har angett det som följande. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` indikerar att det är ett dedikerat argument för Plazma och inte en inbyggd JVM-argument, + +Om ingen värde anges kommer det att vara [`true` som standard.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight-relaterade serverplattformar inkluderar en `.` i egenskapsnamnet för att skilja systemegenskaper åt per plattform. + +Vissa terminaler som Windows Powershell kanske inte tillåter dessa argument, så du måste lägga till `"` i början och slutet av argumentet. +{% endhint %} + +### Alla systemegenskaper + +#### `convertLegacySigns` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Uppdaterar avstängda skyltformat. + +#### `debug.entities` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar debuggloggar för entitetsinformation. + +#### `debug.rewriteForIDE` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar NMS-revision för att korrekt ladda felsökningsinformation i IDE, och omkartlägger automatiskt intern versionsinformation. + +#### `disable.watchdog` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar Spigots Watchdog-varningssystem. + +#### `letMeReload` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar bekräftelsemeddelandet för `/reload`-kommandot. + +{% hint style="danger" %} + +### Eftersom `/reload`-kommandot är mycket instabilt är alla problem som uppstår efter användning av detta kommando användarens eget ansvar. + +Om du är en pluginutvecklare och behöver uppdatera en plugin, använd hotswap istället för `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar pluginer som använder standard in- och utmatning. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Varnar när avbrutet format upptäcks i chattkomponenter. + +#### `Paper.bypassHostCheck` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar verifiering av servermönster när en spelare ansluter till servern. + +#### `Paper.debugDynamicMissingKeys` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar felsökningsloggar för saknade nycklar i NBT-objekt. + +#### `Paper.debugInvalidSkullProfiles` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar felsökningsloggar för felaktiga huvudprofiler. + +Detta loggar alla felaktiga huvuden i världen med deras positioner. + +#### `Paper.disableChannelLimit` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar begränsningen av 128 pluginkanaler per spelare. + +#### `Paper.disableClassPrioritization` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar prioritering av plugin-klasser. + +Användbart vid problem med plugin-skuggning. + +#### `Paper.disableFlushConsolidate` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar Netty-flushkonsolideringssystemet. + +#### `Paper.excessiveTELimit` + +- **Typ**: `Integer` +- **Standardvärde**: `750` + +Dela upp entiteter i flera paket om de är fler än det angivna värdet. + +#### `Paper.filterThreshold` + +- **Typ**: `Integer` +- **Standardvärde**: `8192` + +Ställer in den maximala storleken på paket som servern kan ta emot åt gången. + +#### `Paper.ignoreJavaVersion` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Inaktiverar Java-versionkontroll. + +{% hint style="danger" %} + +### Detta kan leda till att JVM försöker komma åt kod som inte längre existerar! + +Det kan permanent skada världar och filer samt förstöra spelets mekanik. + +Alla problem som uppstår efter detta är användarens ansvar och Plazma ger inget stöd för detta. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Typ**: `Integer` +- **Standardvärde**: `64` + +Ställer in begränsningen för kanalnamn för pluginer. + +#### `Paper.maxSignLength` + +- **Typ**: `Integer` +- **Standardvärde**: `80` + +Ställer in max längd för text på en skyltlinje. + +#### `Paper.minPrecachedDatafixVersion` + +- **Typ**: `Integer` +- **Standardvärde**: `(world version) + 1` + +Ställer in versionen för uppdateringsinformation som ska initialiseras först. + +Användbart vid massuppdatering av chunkar men annars sällan använt. + +#### `Paper.parseYamlCommentsByDefault` + +- **Typ**: `Boolean` +- **Standardvärde**: `True` + +Aktiverar hantering av YAML-filkommentarer som standard. + +#### `Paper.playerConnection.keepAlive` + +- **Typ**: `Integer` +- **Standardvärde**: `30` + +Spelaren kastas ut om ingen data har mottagits inom den angivna tiden (i sekunder). + +Vanligtvis skickar spelet[^7] kontinuerligt [hjärtslagssignaler](#user-content-fn-8)[^8] till servern, så spelaren kastas inte ut. Om spelet inte svarar anses det ha kraschat och spelaren kastas ut. + +#### `Paper.skipServerPropertiesComments` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Ignorerar kommentarer i serveregenskaper. + +#### `Paper.debug-sync-loads` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar debuggloggar för synkroniserad chunkskapande. + +#### `Paper.enable-sync-chunk-writes` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar Minecrafts [standard chunkskapande system](#user-content-fn-10)[^10]. + +Detta leder till en betydande prestandaförsämring eftersom varje chunk sparas i tur och ordning. + +#### `Paper.explicit-flush` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Aktiverar explicit flushing för nätverkskanaler. + +#### `Paper.strict-thread-checks` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Loggar alltid fel som uppstår utanför huvudtråden. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Ger varning om schemalagda uppgifter har för stor fördröjning. + +#### `Paperclip.patchOnly` + +- **Typ**: `Boolean` +- **Standardvärde**: `False` + +Om du använder den medföljande körbara filen tillämpas endast patcher utan att starta servern. + +#### `Plazma.aggressiveOptimize` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` + +{% hint style="warning" %} + +### Denna egenskap kommer att flyttas till startargument efter 1.20.5. + +{% endhint %} + +Ökar konfigurationsoptimeringarna som tillämpas vid första starten. + +När du aktiverar det blir servern snabbare och säkrare, men det kan blockera vissa funktioner eller påverka spelupplevelsen negativt. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` + +Undertrycker varningsmeddelandet[^11] som visas när Plazma initialiseras. + +### Avbruten egenskap + +Följande systemegenskaper är avbrutna egenskaper. + +#### `timings.bypassMax` + +- **Typ**: `Boolean` +- **Standardvärde**: `false` +- **Avbruten användning**: Timings har tagits bort från Plazma sedan + +Bestämmer om det är tillåtet att överskrida det maximala värdet som kan skickas till Aikars Timings API. + +Om detta inte hanteras av API:et, kommer en hastighetsbegränsning att tillämpas. + +*** + +## Startargument + +Startargumentet anges efter `-jar *.jar` för att initialisera Plazma och bearbetas tillsammans med det. + +### Användning + +Systemegenskaper anges som programkommandon efter `-jar *.jar`. + +Till exempel, om du vill använda startargumentet `nogui`,\ +ska du ange det på följande sätt så att Plazma kan bearbeta `nogui`-argumentet under initialiseringen. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Fullständiga startargument + +#### `bukkit-settings` + +- **Alias**: `b` +- **Standardvärde**: `bukkit.yml` + +Ange namn och plats för [Bukkit-konfigurationsfilen](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Alias**: `c` +- **Standardvärde**: `commands.yml` + +Ange namn och plats för [Bukkit-kommandokonfigurationsfilen](../reference/configurations/bukkit.md). + +#### `config` + +- **Alias**: `c` +- **Standardvärde**: `server.properties` + +Ange namn och plats för [serveregenskapsfilen](../reference/configurations/property.md). + +#### `demo` + +Startar servern i demovärlden. + +#### `eraseCache` + +Tar bort eventuella cache-filer som finns kvar efter en världsuppdatering. + +#### `forceUpgrade` + +Tvingar uppgradering av världen utan att ta hänsyn till versionen ([^12]). + +#### `help` + +- **Alias**: `?` + +Skriver ut alla startargument och deras beskrivningar för Plazma. + +#### `initSettings` + +Skapar endast konfigurationsfilen och stänger av servern. + +#### `jfrProfile` + +Aktiverar JFR-profileringsläget. + +#### `max-players` + +- **Alias**: `s`, `size` +- **Standardvärde**: `(serveregenskaper)` + +Ställer in det maximala antalet tillåtna [spelare](#user-content-fn-14). + +#### `nogui` + +Inaktiverar den grafiska användargränssnittspanelen. + +#### `nojline` + +Inaktiverar JLine och använder en vanlig konsol istället. + +#### `online-mode` + +- **Alias**: `o` +- **Standardvärde**: `(serveregenskaper)` + +Väljer om spelare ska verifieras mot Mojangs autentiseringsservrar. + +**Om du inte använder Velocity eller en proxy kan du bli straffad för att bryta mot [EULA](../getting-started/README.md#id-5).** + +#### `paper-settings` + +- **Alias**: `paper` +- **Standardvärde**: `paper.yml` + +{% hint style="warning" %} + +### Denna parameter har slutat användas efter 1.19.4. + +{% endhint %} + +Ställer in platsen för den avbrutna PaperSpigot-konfigurationsfilen. + +Används för att överföra befintlig konfiguration till en ny fil och används inte längre efter detta. + +#### `paper-settings-directory` + +- **Alias**: `paper-dir` +- **Standardvärde**: `config` + +Ställer in namn och plats för mappen där [Paper-konfigurationsfilen](../reference/configurations/paper/README.md) finns. + +#### `plazma-settings-directory` + +- **Alias**: `plazma-dir` + +Ställer in namn och plats för mappen där [Plazma-konfigurationsfilen](../reference/configurations/plazma/README.md) finns. + +#### `plugins` + +- **Alias**: `p` +- **Standardvärde**: `plugins` + +Ställer in platsen för plugin-mappen. + +#### `pufferfish-settings` + +- **Alias**: `pufferfish` +- **Standardvärde**: `pufferfish.yml` + +Ställer in namn och plats för [Pufferfish-konfigurationsfilen](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Alias**: `purpur` +- **Standardvärde**: `purpur.yml` + +Ställer in namn och plats för [Purpur-konfigurationsfilen](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Startar servern i fullständigt vaniljläge (säkert läge). + +#### `server-ip` + +- **Alias**: `h`, `host` +- **Standardvärde**: `(serveregenskaper)` + +Ställer in serverns värdnamn eller [IP-adress](#user-content-fn-13). + +#### `server-port` + +- **Alias**: `p`, `port` +- **Standardvärde**: `(serveregenskaper)` + +Ställer in serverns port. + +#### `server-name` + +- **Standardvärde**: `A Plazma Server` + +Ställer in serverns namn. + +#### `spigot-settings` + +- **Alias**: `S` +- **Standardvärde**: `spigot.yml` + +Ställer in namn och plats för [Spigot-konfigurationsfilen](../reference/configurations/spigot.md). + +#### `version` + +- **Alias**: `v` + +Skriver ut Plazma-versionen. + +#### `world-dir` + +- **Alias**: `W`, `universe`, `world-container` +- **Standardvärde**: `(servermapp)` + +Ställer in platsen där världsfiler sparas. + +#### `world-name` + +- **Alias**: `w`, `world` +- **Standardvärde**: `(serveregenskaper)` + +Ställer in namnet på världsfilen. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Beroende på den bifogade platsen ändras platsen för att hantera parametrar. + +[^3]: Till exempel, om du vill ställa in `Plazma.iKnowWhatIAmDoing` till `true` (aktivera), fungerar det på samma sätt att bara ange `-DPlazma.iKnowWhatIAmDoing` istället för `-DPlazma.iKnowWhatIAmDoing=true`. + +[^4]: Till exempel, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Händelsedetektor. + +[^6]: Händelsedetektor. + +[^7]: Klient. + +[^8]: Ett signal som indikerar att servern är korrekt ansluten, liknande hjärtslag. + +[^9]: Med Purpurs AFK-utkastningsfunktion kan även frånvarande spelare kastas ut. + +[^10]: Sync Chunk Write System, system för synkron skapande av segment. + +[^11]: `VARNING! Plazma kan orsaka oväntade problem, så se till att testa det noggrant innan du använder det på en offentlig server.` + +[^12]: I spelet fungerar även `världsoptimering` enligt samma princip. + +[^13]: Internetprotokoll, IP. + +[^14]: Administratörer över `nivå 2` är undantagna. diff --git a/sv-SE/origin/plazma/adminstration/reference/commands.md b/sv-SE/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..fd810339c --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vilka kommandon som är tillgängliga i Plazma. +--- + +# 🖥️ Kommandon diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/bukkit.md b/sv-SE/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..7c36eca88 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i bukkit.yml betyder. +--- + +# 🪣 Bukkit diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/paper/README.md b/sv-SE/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..41d231046 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på syftet med varje fil i konfigurationsmappen. +--- + +# 🛩️ Papper diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/paper/global.md b/sv-SE/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..8dc0fb505 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i paper-global.yml betyder. +--- + +# 🛩️ Papper (global konfiguration) diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/paper/world.md b/sv-SE/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..94026c6eb --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i paper-world.yml betyder. +--- + +# 🛩️ Papper (världsuppsättning) diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/README.md b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..218315744 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på syftet med varje fil i konfigurationsmappen. +--- + +# ✨ Plazma diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/global.md b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..b79d03e22 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i plazma-global.yml betyder. +--- + +# ✨ Plazma (Global Configuration) diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..851536646 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Världsomfattande konfiguration diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..fb064ed75 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i plazma-world.yml betyder. +--- + +# ✨ Plazma (världsstruktur) diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/property.md b/sv-SE/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..fe81cf240 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i server.properties betyder. +--- + +# 🪨 Server.properties diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/pufferfish.md b/sv-SE/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..6eddb9b92 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i pufferfish.yml betyder. +--- + +# 🐡 Blåsfisk diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/README.md b/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..58fc1d4f4 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i purpur.yml betyder. +--- + +# 🦑 Purpur diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/global.md b/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..1e2cc84d7 --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i purpur.yml betyder. +--- + +# 🦑 Purpur (global komposition) diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/world.md b/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..4dc430e5a --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i purpur.yml betyder. +--- + +# 🦑 Purpur (världskomposition) diff --git a/sv-SE/origin/plazma/adminstration/reference/configurations/spigot.md b/sv-SE/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..b32f02f2b --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på vad varje nod i spigot.yml betyder. +--- + +# 🚰 Spigot diff --git a/sv-SE/origin/plazma/adminstration/reference/permissions.md b/sv-SE/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..9eeeb552c --- /dev/null +++ b/sv-SE/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Ta reda på behörigheterna för Plazma. +--- + +# 🛡️ Behörighet diff --git a/sv-SE/origin/plazma/developers.md b/sv-SE/origin/plazma/developers.md new file mode 100644 index 000000000..981ca156a --- /dev/null +++ b/sv-SE/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Utveckla tredjepartsprojekt med hjälp av Plazma. +--- + +# ⚙️ Utvecklarguide diff --git a/sv-SE/origin/thunderbolt/README.md b/sv-SE/origin/thunderbolt/README.md new file mode 100644 index 000000000..2ca5fdecb --- /dev/null +++ b/sv-SE/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt är en Plazma-baserad serverplattform som möjliggör användning av experimentella patchar genom att dela in dem i olika smaker för direkt användning. +--- + +# 🌩️ Thunderbolt Användarhandbok diff --git a/sv-SE/origin/volt/README.md b/sv-SE/origin/volt/README.md new file mode 100644 index 000000000..4c0b96683 --- /dev/null +++ b/sv-SE/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt är en öppen källkodsmodell som gör det möjligt att utveckla sin egen Paperweight-serverplattform baserad på Plazma. +--- + +# ⚡ Volt Utvecklingsguide diff --git a/th/origin/README.md b/th/origin/README.md new file mode 100644 index 000000000..9b863aa77 --- /dev/null +++ b/th/origin/README.md @@ -0,0 +1,41 @@ +--- +description: หากมีคำถามโปรดถามผ่านทาง Discord หรือ GitHub Discussions +--- + +# 🏠 ยินดีต้อนรับสู่พอร์ทัลเอกสาร + +{% hint style="info" %} + +**เอกสารของ Plazma ถูกแปลด้วยเครื่องในปัจจุบัน** + +[![สถานะการแปล](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) ร่วมสมทบในการแปลเอกสารที่ [https://translate.plazmamc.org/](https://translate.plazmamc.org/) เพื่อปรับปรุงเอกสาร + +{% endhint %} + +### ถ้าพบปัญหาในการใช้ Plazma ควรทำอย่างไร? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderbolt에 대해 관심이 있다면? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` ต้องการข้อมูลเพิ่มเติมเกี่ยวกับ Minecraft หรือไม่? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/th/origin/SUMMARY.md b/th/origin/SUMMARY.md new file mode 100644 index 000000000..fad8d73e9 --- /dev/null +++ b/th/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# สารบัญ + +- [🏠 ยินดีต้อนรับสู่พอร์ทัลเอกสาร](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ เอกสารการใช้งาน Plazma](plazma/README.md) +- [❓ คือ Plazma หรือไม่?](plazma/about/README.md) + - [⬇️ ดาวน์โหลด](plazma/about/downloads.md) + - [✅ สถานะการสนับสนุนเวอร์ชัน](plazma/about/supported-versions.md) +- [⚒️ คู่มือการจัดการเซิร์ฟเวอร์](plazma/administration/README.md) + - [👟 เริ่มต้นใช้งาน](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 อ้างอิง](plazma/administration/reference/README.md) + - [🖥️ คำสั่ง](plazma/administration/reference/commands.md) + - [🛡️ สิทธิ](plazma/administration/reference/permissions.md) + - [🎛️ อาร์กิวเมนต์และคุณสมบัติ](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 คุณลักษณะ](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 การกำหนดค่าระดับโลก](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ การกำหนดโครงสร้างตามโลก](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 การกำหนดค่าระดับโลก](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ การกำหนดโครงสร้างตามโลก](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 การกำหนดค่าระดับโลก](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ การกำหนดโครงสร้างตามโลก](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 ขั้นสูง](plazma/administration/expert/README.md) + - [🧹 การปรับปรุง](plazma/administration/expert/optimize.md) + - [🔀 พร็อกซี่](plazma/administration/expert/proxy.md) + - [↩️ ทำให้เป็นวานิลล่า](plazma/administration/expert/vanillaize.md) + - [🩻 การบล็อก X-Ray](plazma/administration/expert/xray.md) + - [⚠️ จุดอ่อนและวิธีแก้ไข](plazma/administration/expert/fix-exploits.md) + - [⁉️ คำถามที่ถามบ่อย](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ คู่มือนักพัฒนา](plazma/developers.md) + - [✏️ สนับสนุน](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ คู่มือการใช้งาน Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ คู่มือการพัฒนา Volt](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ ดาวน์โหลดทั้งหมด](plazma/about/downloads-all.md) diff --git a/th/origin/miscellaneous/README.md b/th/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/th/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/th/origin/plazma/README.md b/th/origin/plazma/README.md new file mode 100644 index 000000000..d22d46c26 --- /dev/null +++ b/th/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma เป็นแพลตฟอร์มเซิร์ฟเวอร์โอเพนซอร์สสำหรับ Minecraft: Java Edition ที่เพิ่มฟีเจอร์การปรับแต่งการใช้งานด้วยการทดลองแบบกระดานและกลไกเกมหลายอย่าง" +--- + +# ✨ เอกสารการใช้ Plazma + +## 👋 ยินดีต้อนรับสู่เอกสาร Plazma + +ยินดีต้อนรับสู่เอกสารการใช้ Plazma! + +{% hint style="info" %} + +**ไม่สามารถแก้ไขปัญหาผ่านคู่มือได้หรือไม่?** + +[เข้าร่วมเซิร์ฟเวอร์ Discord อย่างเป็นทางการ](https://discord.gg/MmfC52K8A8) หรือถามคำถามในชุมชนผ่าน [การสนทนาบน GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### เกี่ยวกับ Plazma + +> เรียนรู้เกี่ยวกับแพลตฟอร์มเซิร์ฟเวอร์ Plazma ได้ที่ไหน + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### สำหรับผู้ดูแลระบบ + +> ลองใช้ Plazma สร้างเซิร์ฟเวอร์ของคุณเอง + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### สำหรับนักพัฒนา + +> ลองพัฒนาโปรเจกต์ของบุคคลที่สามด้วย Plazma + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/th/origin/plazma/about/README.md b/th/origin/plazma/about/README.md new file mode 100644 index 000000000..d735496dc --- /dev/null +++ b/th/origin/plazma/about/README.md @@ -0,0 +1,71 @@ +--- +description: เรียนรู้เกี่ยวกับแพลตฟอร์มเซิร์ฟเวอร์ Plazma ได้ที่ไหน +--- + +# ❓ Plazmaคืออะไร? + +- **Plazma**เป็นแพลตฟอร์มเซิร์ฟเวอร์ที่ดัดแปลงจาก [Andromeda](https://github.com/EarendelArchived/Andromeda) และ [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) เพื่อเอาเฉพาะจุดเด่นมาจาก [Paper](https://github.com/PaperMC/Paper) +- เราพยายามทำให้มีความเสถียรสูง ประสิทธิภาพที่แข็งแรง การอัพเดทอย่างรวดเร็ว และมีคุณสมบัติมากมาย + +## 📋 วัตถุประสงค์ของ Plazma + +- พยายามทำให้เป็นแพลตฟอร์มเซิร์ฟเวอร์ที่มีการอัพเดทรวดเร็วและเสถียร +- พยายามทำให้มีคุณสมบัติและประสิทธิภาพที่มากกว่าแพลตฟอร์มของโมด +- พยายามสร้างแพลตฟอร์มที่สามารถปรับแต่งแบบวานิลล่า + +## ⚙️ คุณสมบัติหลัก + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **อัพเดทเร็วที่สุด**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) ทำให้แพทช์ของ Plazma อยู่ในสภาพที่สมบูรณ์เสมอ จึงมีการอัพเดทเร็วที่สุดในแพลตฟอร์มเซิร์ฟเวอร์ที่ใช้งานบน Paper +6. **การปรับแต่งไฟล์การกำหนดค่าหลัก**\ + ไฟล์การกำหนดค่าที่ใช้เป็นค่าเริ่มต้นถูกปรับแต่งให้เหมาะสมอยู่แล้ว ไม่จำเป็นต้องปรับแต่งไฟล์การกำหนดค่าเอง +7. **การทำงานแบบหลายเทรดที่เชื่อถือได้**\ + การทำงานที่ไม่เกี่ยวข้องกับกลไกของเกมถูกทำแบบไม่ซึ่งกันเพื่อลดเวลาหน่วงเพื่อทำให้เซิร์ฟเวอร์มีประสิทธิภาพสูงสุด +8. **ป้องกันการใช้พื้นที่ที่ไม่จำเป็น**\ + รวมข้อมูลที่มีค่าเท่ากันเข้าด้วยกันเพื่อลดการใช้พื้นที่หน่วยความจำ + +## ✨ การใช้งาน + +- **แพลตฟอร์มที่สามารถจัดการปลัักอินที่ซับซ้อนอย่างถูกต้อง**\ + Plazma ใช้งานบนเซิร์ฟเวอร์ของ [IPECTER](https://github.com/IPECTER) โดยมีปลัักอินที่ทำงานด้วย NMS และการสะท้อนแสงเอง มีการใช้งานข้อมูลแพ็คขนาดใหญ่และซับซ้อนมากมาย แต่ก็สามารถรองรับผู้เล่นที่มีจำนวนมากกว่า 100 คนโดยไม่มีการลดประสิทธิภาพ +- **แพลตฟอร์มที่รักษาประสิทธิภาพสูงในเซิร์ฟเวอร์ RPG**\ + รักษาผู้เล่น 100 คนในคลัสเตอร์เดียวโดยไม่มีการลด TPS และสามารถให้ผู้เล่น 250 คนในคลัสเตอร์ 4 คลัสเตอร์เล่นได้อย่างราบรื่น +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **แพลตฟอร์มที่ถูกเลือกโดยผู้สตรีมมิ่งมากมาย**\ + ได้รับการเลือกใช้เป็นกระถางสำหรับผู้ชมของผู้สตรีมมิ่งมากมาย + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ ดาวน์โหลด + +คุณสามารถดาวน์โหลด Plazma ได้ที่หน้าเว็บด้านล่าง + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### ต้องการข้อมูลเพิ่มเติมเกี่ยวกับการรองรับเวอร์ชัน? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot เครื่องเสริม และ Paper, Pufferfish, Purpur เครื่องเสริม + +[^2]: โดย Microsoft Corporation + +[^3]: การปิดใช้งานระบบรายงานแชทจะทำให้การแชทถูกประมวลผลเฉพาะในเซิร์ฟเวอร์เท่านั้นและป้องกันการติดตามแชทของ Mojang + +[^4]: เวลาที่ต้องรอสักครู่เพื่อให้เกิดการทำงานของกลไกของระบบ diff --git a/th/origin/plazma/about/downloads-all.md b/th/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..9e30a09fd --- /dev/null +++ b/th/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: ดาวน์โหลดไฟล์ Plazma ดูทั้งหมด +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| เวอร์ชัน | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/th/origin/plazma/about/downloads.md b/th/origin/plazma/about/downloads.md new file mode 100644 index 000000000..55dc55bc4 --- /dev/null +++ b/th/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: ดาวน์โหลด Plazma ทันทีเพื่อลองใช้งานเอง +--- + +# ⬇️ ดาวน์โหลด + +#### ต้องการข้อมูลเพิ่มเติมเกี่ยวกับการรองรับเวอร์ชัน? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**ดาวน์โหลดด้านล่างเป็นไฟล์ exe สำหรับผู้ใช้ทั่วไป** + +ถ้าคุณเป็นนักพัฒนาและต้องการไฟล์รูปแบบอื่น ๆ กรุณาดูที่หน้าด้านล่าง + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
เวอร์ชันดาวน์โหลด
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + ดาวน์โหลด +
1.20.1 + ดาวน์โหลด +
1.19.4 + ดาวน์โหลด +
+ +*** diff --git a/th/origin/plazma/about/patches-list.md b/th/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..cb8951f4d --- /dev/null +++ b/th/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้เกี่ยวกับฟีเจอร์ทั้งหมดที่เพิ่มใน Plazma +--- + +# 📑 แพทช์ที่รวมอยู่ diff --git a/th/origin/plazma/about/supported-versions.md b/th/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..b22bcc9c3 --- /dev/null +++ b/th/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "ดูรายละเอียดเวอร์ชัน Minecraft: Java Edition ที่ Plazma รองรับ" +--- + +# ✅ สถานะการรองรับเวอร์ชัน + +{% hint style="info" %} + +**Plazma พัฒนาตั้งแต่เวอร์ชัน 1.19.4 ขึ้นไป และไม่ได้พัฒนาเวอร์ชันที่ต่ำกว่า 1.19.4** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/รอการปล่อย +[idv]: https://badge.plazmamc.org/1/กำลังพัฒนา +[atv]: https://badge.plazmamc.org/2/รองรับ +[fse]: https://badge.plazmamc.org/6/หยุดการสนับสนุนฟีเจอร์ +[eol]: https://badge.plazmamc.org/4/สิ้นสุดการสนับสนุน +[ukn]: https://badge.plazmamc.org/0/ไม่มีข้อมูล +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/ปกติ +[100]: https://badge.plazmamc.org/percent/100 + +![รอลิสต์รอ][wtr] ![กำลังพัฒนา][idv] ![รองรับ][atv] ![หยุดการสนับสนุนฟีเจอร์][fse] ![สิ้นสุดการสนับสนุน][eol] + +| เวอร์ชัน | ความเสถียรภาพและการสนับสนุนฟังก์ชัน | สถานะการสร้าง | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![สถานะการสร้าง](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![สถานะการสร้าง](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![สถานะการสร้าง](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/th/origin/plazma/administration/README.md b/th/origin/plazma/administration/README.md new file mode 100644 index 000000000..e765add85 --- /dev/null +++ b/th/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: ลองใช้ Plazma สร้างเซิร์ฟเวอร์ของคุณเอง +--- + +# ⚒️ คู่มือการบริหารเซิร์ฟเวอร์ diff --git a/th/origin/plazma/administration/diagnosis/README.md b/th/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..ceefde3ba --- /dev/null +++ b/th/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีการจัดการเมื่อเกิดปัญหา +--- + +# 🧾 진단 diff --git a/th/origin/plazma/administration/diagnosis/plugins.md b/th/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..683cd5387 --- /dev/null +++ b/th/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีแก้ปัญหาเมื่อปลั๊กอินไม่ทำงานอย่างปกติ +--- + +# 📜 플러그인 diff --git a/th/origin/plazma/administration/expert/README.md b/th/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..f2ca5518d --- /dev/null +++ b/th/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีการจัดการ Plazma อย่างมืออาชีพ +--- + +# 🎓 ลึกซึ้ง diff --git a/th/origin/plazma/administration/expert/fix-exploits.md b/th/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..348b18786 --- /dev/null +++ b/th/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้เกี่ยวกับช่องโหว่ที่รู้จักและวิธีการแก้ไข +--- + +# ⚠️ ช่องโหว่ที่รู้จักและวิธีการแก้ไข diff --git a/th/origin/plazma/administration/expert/optimize.md b/th/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..d2507811f --- /dev/null +++ b/th/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีปรับ Plazma ให้เหมาะสม +--- + +# 🧹 การปรับแต่งให้เหมาะสม diff --git a/th/origin/plazma/administration/expert/proxy.md b/th/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..ca595409e --- /dev/null +++ b/th/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีกำหนดค่าแพลตฟอร์มโปรกซี "Velocity" อย่างปลอดภัย +--- + +# 🔀 โปรกซี diff --git a/th/origin/plazma/administration/expert/vanillaize.md b/th/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..69de55078 --- /dev/null +++ b/th/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: เรียนรู้วิธีที่จะกู้คืนการแปลง Paper และ Vanilla +--- + +# ↩️ การทำให้เป็นรสวานิลล่า + +{% hint style="warning" %} + +**Paper ไม่มีตัวเลือกที่เพิ่มเข้ามาในส่วนใหญ่ของการแก้ไขข้อผิดพลาดของ vanilla** + +Plazma กำลังพัฒนาให้สามารถปิดการแก้ไขข้อผิดพลาดดังกล่าวได้ในการกำหนดปัจจัย + +ดังนั้นคู่มือนี้ยังไม่สมบูรณ์และข้อมูลอาจมีการเปลี่ยนแปลงได้เสมอ + +{% endhint %} diff --git a/th/origin/plazma/administration/expert/xray.md b/th/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..003babbcd --- /dev/null +++ b/th/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีการบล็อกแสง X-Ray ที่ซ่อนอยู่ในตัว +--- + +# 🩻 การบล็อกแสง X-Ray diff --git a/th/origin/plazma/administration/faq.md b/th/origin/plazma/administration/faq.md new file mode 100644 index 000000000..1aa68eb11 --- /dev/null +++ b/th/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: เรียนรู้เกี่ยวกับคำถามที่ถามบ่อย +--- + +# ⁉️ คำถามที่ถามบ่อย + +{% hint style="info" %} + +**คุณไม่พบคำตอบที่คุณต้องการหรือไม่?** + +[เข้าร่วมเซิร์ฟเวอร์ Discord อย่างเป็นทางการ](https://discord.gg/MmfC52K8A8) หรือถามคำถามในชุมชนผ่าน [การสนทนาบน GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! + +{% endhint %} + +### Plazma ไม่สามารถเริ่มต้นได้ + +หากมีข้อความ `no main manifest attribute, in plazma-(version).jar` ปรากฏในคอนโซล\ +ไฟล์ที่ดาวน์โหลดเป็นไฟล์ API สำหรับการพัฒนา คุณต้องดาวน์โหลด **Reobf Paperweight** จากหน้า GitHub + +ดูข้อมูลเพิ่มเติมได้ที่หน้าต่อไป + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### คำเตือนปรากฏทุกครั้งที่เซิร์ฟเวอร์เริ่มทำงาน + +Plazma มีการแก้ไขบางส่วนที่ไม่เสถียรและมีโอกาสในการทำงานผิดพลาดเสมอ ดังนั้น ข้อความคำเตือนต่อไปนี้จะปรากฏเมื่อเซิร์ฟเวอร์เริ่มทำงาน + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +คำเตือนนี้สามารถปิดการใช้งานได้ด้วยคุณสมบัติระบบ [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] + +ดูข้อมูลเพิ่มเติมได้ที่หน้าต่อไป + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: สามารถใช้งานตั้งแต่เวอร์ชัน 1.20.1 diff --git a/th/origin/plazma/administration/getting-started/README.md b/th/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..8bc86fbee --- /dev/null +++ b/th/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: ดูวิธีการสร้างเซิร์ฟเวอร์ด้วย Plazma +--- + +# 👟 เริ่มต้น + +เพื่อใช้ Plazma อย่างเสถียร, ระบบจำเป็นต้องทำตามความต้องการต่อไปนี้ + +| | ต่ำสุด | แนะนำ | +| :------------: | ------ | ----- | +| โครงสร้าง | x64 | - | +| RAM | 8GB | 16GB | +| พื้นที่จัดเก็บ | 1GB | 8GB | +| JDK | 17 | 21 | + +เพื่อแก้ไขไฟล์การกำหนดค่าได้อย่างราบรื่น, คุณสามารถติดตั้งโปรแกรมแก้ไขเช่น [Visual Studio Code](https://code.visualstudio.com/download) + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="การแสดงผลที่ถูกต้อง" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, เป็นแมพพิ้งก์ของ Minecraft รุ่นพื้นฐาน 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | ------------------------------------ | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP การกำหนดค่า + +อะแดปเตอร์อีเธอร์เน็ต: + + DNS suffix ที่เชื่อมต่อ. . . . . . . . : + ที่อยู่ IPv4. . . . . . . . . : 192.168.3.7 + มาสก์ซับเน็ต . . . . . . . : 255.255.255.0 + เกตเวย์เริ่มต้น . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. เติบโต + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +ศึกษาวิธีการปรับแต่งเซิร์ฟเวอร์ผ่านคู่มือด้านล่าง + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. โปรดดูข้อมูลเพิ่มเติมที่ [เว็บไซต์ Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) + +[^10]: บริษัท Microsoft Corporation. + +[^11]: ตาม พระราชกฤษฎีกาว่าด้วยกฎหมายที่เกี่ยวข้องกับการส่งเสริมอุตสาหกรรมเกมในประเทศ มาตรา 32 ข้อ 1 ข้อ 9 ที่ **บริษัท ไมโครซอฟท์ ประเทศเกาหลี** สามารถดำเนินคดีตามกฎหมายได้ + +[^12]: Universal Plug & Play. เนื่องจาก Purpur ที่รวมอยู่ใน Plazma สามารถสื่อสารกับเราเตอร์โดยอัตโนมัติผ่านเทคโนโลยีนี้เพียงเมื่อเซิร์ฟเวอร์กำลังทำงานอยู่เท่านั้น ดังนั้นไม่จำเป็นต้องทำการกำหนดพอร์ตโดยตรง + +[^13]: หากไม่มีบัญชี คุณสามารถลงทะเบียนใน Ngrok ผ่านบัญชี Google หรือ GitHub diff --git a/th/origin/plazma/administration/getting-started/customization.md b/th/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..c4b5dfd90 --- /dev/null +++ b/th/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,122 @@ +--- +description: เรียนรู้วิธีปรับแต่งเซิร์ฟเวอร์ +--- + +# 🎨 การปรับแต่งผู้ใช้ + +เหตุผลที่ใช้แพลตฟอร์มเซิร์ฟเวอร์ที่ถูกปรับแก้เช่น Plazma โดยไม่ใช้แพลตฟอร์มเซิร์ฟเวอร์ทางการจาก Mojang Studios คือความสามารถในการทำ **การปรับแต่ง** อย่างมากที่สุด + +ด้านล่างนี้คือวิธีการปรับแต่งและใช้ Plazma หลายวิธี + +## การปรับแก้ + +วิธีการที่เริ่มต้นที่สุดในการปรับแต่ง Plazma คือการแก้ไขการกำหนดค่า + +Plazma มีการกำหนดค่าที่มีประสิทธิภาพตั้งแต่กลไกของเกม ไปจนถึงลักษณะของมอนสเตอร์ + +สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าของ Plazma โปรดดูที่หน้าด้านล่าง + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## การใช้งานปลั๊กอิน + +{% hint style="success" %} + +**Plazma สนับสนุนปลัักอินทุกประเภทที่ใช้งานบนกระดาษอย่างเต็มรูปแบบ** + +สำหรับปลัักอินของ Spigot บางส่วนอาจไม่ทำงานเนื่องจากการเปลี่ยนแปลงในการแมพของ Paper ตั้งแต่เวอร์ชัน 1.20.5 แต่ปลัักอินส่วนใหญ่ที่ใช้งานบน Paper เช่น Paper, Pufferfish และ Purpur จะทำงานได้บน Plazma และหากไม่ทำงานอย่างถูกต้องจะเป็นเพราะข้อผิดพลาดของ Plazma กรุณา [รายงานให้เราทราบทันที](../diagnosis/plugins.md) + +{% endhint %} + +เหตุผลสำคัญในการใช้ Plazma และวิธีที่มีประสิทธิภาพที่สุดในการปรับแต่ง Plazma +ระบบปลัักอินที่มีอยู่บน Plazma ช่วยให้การปรับแต่งเซิร์ฟเวอร์ง่ายมาก + +มีหลายวิธีในการค้นหาและดาวน์โหลดปลัักอิน บางปลัักอิน +อัปโหลดไปยังบริการเก็บรักษาข้อมูลสาธารณะ และบางปลัักอิน +อัปโหลดไปยัง GitHub หรือเว็บไซต์ของตนเอง + +{% hint style="caution" %} + +**ปลัักอินสามารถเข้าถึงระบบโดยตรงได้!** + +ใช้บริการเช็คความปลอดภัยของ VirusTotal หรือบริการที่เชื่อถือได้เสมอก่อนการใช้งานปลัักอินหรือ +ดาวน์โหลดปลัักอินจากบริการที่เชื่อถือได้ + +{% endhint %} + +มีหลายบริการที่ใช้ในการดาวน์โหลดปลัักอิน ระหว่างนั้น, [บอร์ด SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) และบริการอื่นๆ ตรวจสอบปลัักอินก่อนที่จะอัปโหลด เพื่อให้แน่ใจว่าปลัักอินที่ปล่อยออกมาเป็นปลัักอินที่ปลอดภัยเท่านั้น + +### การใช้งานปลัักอิน + +หลังจากดาวน์โหลดปลัักอินแล้ว, ตอนนี้เรามาลองใช้งานปลัักอิน + +1. ปลัักอินมีรูปแบบเป็น `.jar` หรือ `Java Executable File`\ + บางปลัักอินถูกบีบอัดเป็นไฟล์ซึ่งในกรณีนั้น + คุณสามารถแตกไฟล์และเช็คชื่อว่ามี `bukkit`, `spigot` หรือ `paper` อยู่ในชื่อ และ + หากมีไฟล์ที่มีคำว่า `fat` คุณสามารถใช้ไฟล์ `fat` +2. นำไฟล์ที่ดาวน์โหลดมาใส่ในโฟลเดอร์ `plugins` ในโซนเซิร์ฟเวอร์และเริ่ม (รี)เริ่มเซิร์ฟเวอร์ +3. เมื่อ Plazma เริ่มทำงาน, ข้อความใหม่จะปรากฏบนคอนโซล + สิ่งนี้หมายความว่า Plazma ได้โหลดปลัักอินอย่างถูกต้อง +4. แม้ Plazma จะโหลดปลัักอินอย่างถูกต้อง อาจจะไม่สามารถเริ่มทำงานปลัักอินได้ + การใช้คำสั่ง `/plugins` จะช่วยในการโหลดปลัักอินที่กำลังใช้งานบนเซิร์ฟเวอร์ + ถ้าชื่อของปลัักอินที่ติดตั้งไม่ได้เป็นสี แดง + แต่เป็นสี เขียว + นั่นหมายความว่าปลัักอินได้โหลดอย่างถูกต้อง + +หากปลัักอินไม่ได้โหลดอย่างถูกต้อง คุณสามารถหาวิธีแก้ไขในหน้าต่อไป + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## การใช้งานแพ็คข้อมูล + +แพ็คข้อมูลคือวิธีการปรับแต่งที่ Minecraft มีให้และคล้ายกับ[แพ็คเสริม](#user-content-fn-1)[^1] + +การใช้แพ็คข้อมูลช่วยในการเพิ่มสรรพสิ่งและอุปสรรคใหม่ในเกม เป็นต้น + +{% hint style="caution" %} + +**การใช้แพ็คข้อมูลอาจทำให้โลกเกมเสีย** + +บางแพ็คข้อมูลที่เสียอาจทำให้โลกเกมเสียไปและไม่สามารถกู้คืนได้ + +ดังนั้น, ควรสำรองข้อมูลโลกก่อนการใช้แพ็คข้อมูล + +{% endhint %} + +แพ็คข้อมูลสามารถดาวน์โหลดจากหลายบริการ เช่น [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) และบริการอื่นๆ + +หลังจากดาวน์โหลดแพ็คข้อมูล ใส่ในโฟลเดอร์ `datapacks` ในโซนโลกของเซิร์ฟเวอร์ +หากไม่มีโฟลเดอร์สามารถสร้างขึ้นและใส่ไฟล์เข้าไปได้ + +{% hint style="warning" %} + +**บาง [แพ็คข้อมูล](#user-content-fn-2)[^2] อาจไม่ทำงานถูกต้องครั้งแรก** + +เพื่อป้องกันการทำงานไม่ถูกต้องควรรีสตาร์ทเซิร์ฟเวอร์ **2 ครั้ง** + +{% endhint %} + +แพ็คข้อมูลอาจเสียง่ายเมื่อ Minecraft อัปเดตเวอร์ชัน + +โดยเฉพาะ, หากแพ็คข้อมูลเสียอย่างสมบูรณ์ เซิร์ฟเวอร์อาจล้มเหลว ดังนั้น, +การทดสอบเพียงพอก่อนอัปเดตเซิร์ฟเวอร์เป็นสิ่งสำคัญ + +{% hint style="info" %} + +**หลังจากคำสั่งเริ่มเซิร์ฟเวอร์ ใส่ `safeMode` ทำให้แพ็คข้อมูลทั้งหมดไม่ทำงาน และเริ่มเซิร์ฟเวอร์** + +[ดูข้อมูลเพิ่มเติมที่ `รีเฟอเรนซ์ > อาร์กิวเมนท์และพรอพเพอร์ตี้`](../reference/arguments.md) + +{% endhint %} + +แพ็คข้อมูลที่ใช้งานสามารถตรวจสอบได้ด้วยคำสั่ง `/datapack list` + +*** + +[^1]: หรือ Minecraft: Bedrock Edition's แอดออน. + +[^2]: เพิ่มสรรพสิ่งและอุปสรรคใหม่ เป็นต้น diff --git a/th/origin/plazma/administration/getting-started/next-step.md b/th/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..d78972af5 --- /dev/null +++ b/th/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: เรียนรู้วิธีปรับแต่งเซิร์ฟเวอร์ +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +ด้านล่างนี้คือวิธีการปรับแต่งและใช้ Plazma หลายวิธี + +## การปรับแก้ + +วิธีการที่เริ่มต้นที่สุดในการปรับแต่ง Plazma คือการแก้ไขการกำหนดค่า + +Plazma มีการกำหนดค่าที่มีประสิทธิภาพตั้งแต่กลไกของเกม ไปจนถึงลักษณะของมอนสเตอร์ + +สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าของ Plazma โปรดดูที่หน้าด้านล่าง + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## การใช้งานปลั๊กอิน + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +เหตุผลสำคัญในการใช้ Plazma และวิธีที่มีประสิทธิภาพที่สุดในการปรับแต่ง Plazma ระบบปลัักอินที่มีอยู่บน Plazma ช่วยให้การปรับแต่งเซิร์ฟเวอร์ง่ายมาก + +มีหลายวิธีในการค้นหาและดาวน์โหลดปลัักอิน 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +มีหลายบริการที่ใช้ในการดาวน์โหลดปลัักอิน ระหว่างนั้น, [บอร์ด SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) และบริการอื่นๆ ตรวจสอบปลัักอินก่อนที่จะอัปโหลด เพื่อให้แน่ใจว่าปลัักอินที่ปล่อยออกมาเป็นปลัักอินที่ปลอดภัยเท่านั้น + +### การใช้งานปลัักอิน + +หลังจากดาวน์โหลดปลัักอินแล้ว, ตอนนี้เรามาลองใช้งานปลัักอิน + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. นำไฟล์ที่ดาวน์โหลดมาใส่ในโฟลเดอร์ `plugins` ในโซนเซิร์ฟเวอร์และเริ่ม (รี)เริ่มเซิร์ฟเวอร์ +3. เมื่อ Plazma เริ่มทำงาน, ข้อความใหม่จะปรากฏบนคอนโซล สิ่งนี้หมายความว่า Plazma ได้โหลดปลัักอินอย่างถูกต้อง +4. แม้ Plazma จะโหลดปลัักอินอย่างถูกต้อง อาจจะไม่สามารถเริ่มทำงานปลัักอินได้ การใช้คำสั่ง `/plugins` จะช่วยในการโหลดปลัักอินที่กำลังใช้งานบนเซิร์ฟเวอร์ 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +หากปลัักอินไม่ได้โหลดอย่างถูกต้อง คุณสามารถหาวิธีแก้ไขในหน้าต่อไป + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## การใช้งานแพ็คข้อมูล + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +การใช้แพ็คข้อมูลช่วยในการเพิ่มสรรพสิ่งและอุปสรรคใหม่ในเกม เป็นต้น + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +บางแพ็คข้อมูลที่เสียอาจทำให้โลกเกมเสียไปและไม่สามารถกู้คืนได้ + +ดังนั้น, ควรสำรองข้อมูลโลกก่อนการใช้แพ็คข้อมูล +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +หลังจากดาวน์โหลดแพ็คข้อมูล ใส่ในโฟลเดอร์ `datapacks` ในโซนโลกของเซิร์ฟเวอร์ หากไม่มีโฟลเดอร์สามารถสร้างขึ้นและใส่ไฟล์เข้าไปได้ + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +เพื่อป้องกันการทำงานไม่ถูกต้องควรรีสตาร์ทเซิร์ฟเวอร์ **2 ครั้ง** +{% endhint %} + +แพ็คข้อมูลอาจเสียง่ายเมื่อ Minecraft อัปเดตเวอร์ชัน + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +แพ็คข้อมูลที่ใช้งานสามารถตรวจสอบได้ด้วยคำสั่ง `/datapack list` + +*** + +## การปรับแต่ง + +Plazma มีการปรับแต่งมากมายที่ถูกใช้ 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## พร็อกซี + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +ข้อมูลการตั้งค่าพร็อกซีที่ปลอดภัยและถูกต้อง โปรดดูที่หน้านี้ + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## ความปลอดภัย + +Minecraft ได้รับการพัฒนาโดยมอดหลายตัวทำให้สามารถ[หาเอนจินโจมตีช่องโหว่](#user-content-fn-3)[^3]ได้ง่ายๆบนอินเตอร์เน็ต + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### การตั้งค่าสิทธิ + +บางคำสั่งผู้ดูแลของปลั๊กอินบางตัวอาจมีช่องโหว่เนื่องจากสิทธิไม่ถูกต้อง + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### บล็อก X-Ray + +X-Ray เป็นหนึ่งในช่องโหว่ที่สามารถใช้งานได้ง่ายๆ จากไคลเอ็นต์การปรับแต่งพื้นฐาน + +Plazma มีการตั้งค่าที่สามารถบล็อก X-Ray อย่างพื้นฐาน + +โปรดดูวิธีการบล็อก X-Ray และคำอธิบายในหน้านี้ + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### วิทลิสต์ + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +ใช้ `/whitelist query` เพื่อดูผู้เล่นที่ได้รับอนุญาตให้เข้าถึง + +*** + +[^1]: หรือ Minecraft: Bedrock Edition's แอดออน. + +[^2]: เพิ่มสรรพสิ่งและอุปสรรคใหม่ เป็นต้น + +[^3]: ทั่วไปจะเรียกว่า "hack" + +[^4]: การตั้งค่าไม่ได้รับการปรับแต่ง หรือ Plazma เก่า หรือ การค้นพบช่องโหว่ใหม่ อาจไม่ถูกบล็อก + +[^5]: ผู้เล่นเข้าถึงเซิร์ฟเวอร์ผ่านเซิร์ฟเวอร์พร็อกซี Ngrok และที่อยู่ Ngrok ที่ออกใหม่ทุกครั้ง จะแตกต่างกัน diff --git a/th/origin/plazma/administration/reference/README.md b/th/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..02140c039 --- /dev/null +++ b/th/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: เรียนรู้วิธีการปรับแต่งที่ Plazma ให้ +--- + +# 📜 리퍼런스 + +ที่ Plazma มีวิธีการปรับแต่งหลายวิธีที่ให้บริการ + +ในนั้น มีวิธีการปรับแต่ง 4 วิธีที่สามารถใช้ได้ทันทีโดยไม่ต้องมีการดำเนินการเพิ่มเติม + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[เข้าร่วมเซิร์ฟเวอร์ Discord อย่างเป็นทางการ](https://discord.gg/MmfC52K8A8) หรือถามคำถามในชุมชนผ่าน [การสนทนาบน GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +*** + +## 🖥️ คำสั่ง + +> คำสั่งช่วยให้คุณสามารถเก็บข้อมูลในเกมหรือปรับแต่งสภาพแวดล้อมการเล่นของคุณได้ + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ สิทธิ์ + +> สิทธิ์กำหนดขอบเขตที่ผู้เล่นสามารถโต้ตอบกันได้ + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ อาร์กิวเมนต์และคุณสมบัติ + +> อาร์กิวเมนต์และคุณสมบัติมีผลต่อการทำงานของ Plazma โดยรวม + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 การกำหนดค่า + +> การกำหนดค่าเป็นวิธีการปรับแต่ง Plazma ที่เริ่มต้นที่สุด + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/th/origin/plazma/administration/reference/arguments.md b/th/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..1e86c4690 --- /dev/null +++ b/th/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +เริ่มต้นของการเก็บซื้อและคุณสมบัติของระบบเป็นค่าที่เพิ่มเติมที่ถูกเชื่อมต่อกับคำสั่งที่ใช้ในการดำเนินการ Plazma มีผลต่อการทำงานของ Plazma โดยรวม + +[ตามตำแหน่งที่เพิ่มเติมในคำสั่ง](#user-content-fn-2)[^2] จะแบ่งเป็น **พารามิเตอร์เริ่มต้น** และ **คุณสมบัติของระบบ** + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +หากไม่มีการป้อนค่าใดๆ ในคุณสมบัติ ค่าจะถูกตั้งค่าเป็น [`true`](#user-content-fn-3)[^3] + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **รูปแบบ**: `บูลีน` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` +- **การชน**: `Plazma.disableConfigOptimization` + +ทำให้การกำหนดค่าเริ่มต้นมีประสิทธิภาพมากขึ้น + +เมื่อเปิดใช้งานแล้วเซิร์ฟเวอร์จะให้บริการได้อย่างรวดเร็วและปลอดภัยมากขึ้น แต่อาจส่งผลกระทบต่อการเล่นเกม + +#### `Plazma.disableConfigOptimization` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` +- **การชน**: `Plazma.aggressiveOptimize` + +ไม่ทำการปรับแต่งค่าเริ่มต้นอย่างละเอียด + +นี้ทำให้ใช้การกำหนดค่าเริ่มต้นของ Paper + +#### `Plazma.iKnowWhatIAmDoing` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +ปิดการใช้งานการเข้ารหัส Plazma และใช้ไอคอนเซิร์ฟเวอร์เบื้องต้นแทน + +#### `Plazma.useVanillaConfiguration` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` +- **การชน**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +อาจส่งผลต่อความปลอดภัยและประสิทธิภาพของเซิร์ฟเวอร์อย่างมาก + +ปัญหาทั้งหมดที่เกิดจากคุณสมบัตินี้เป็นความรับผิดของผู้ดูแลเซิร์ฟเวอร์ +{% endhint %} + +ให้การกำหนดค่าเริ่มต้นเป็นค่าการตั้งค่าเริ่มต้นที่ Mojang มีการจัดหา + +นี้ยกเลิกการแปลงเรียกรอยช่องโหว่ทั้งหมดที่ Paper ได้ทำ + +คุณสามารถเปิดใช้งานการแปลงเรียกรอยช่องโหว่ทั้งหมดที่ Paper หรือ Plazma ได้ใหม่ + +#### `Plazma.vanillaize` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `true` +- **การชน**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +เปลี่ยนการกำหนดค่าเริ่มต้นให้ใกล้เคียงกับ Vanilla + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` +- **หยุดใช้**: ตั้งแต่ลบ Timings ออกจาก Plazma + +ตัดสินใจว่าสามารถเกินค่าสูงสุดของข้อมูลที่ส่งไปยัง API Timings ของ Aikar หรือไม่ + +หากไม่มีการจัดการข้อยกเว้นใน API จะมีการใช้จำกัดการใช้งาน + +*** + +## อาร์กิวเมนต์เริ่มต้น + +อาร์กิวเมนต์เริ่มต้นถูกใส่หลัง `-jar *.jar` เพื่อเริ่มต้น Plazma และประมวลผลร่วมด้วย + +### วิธีการใช้ + +คุณสมบัติระบบถูกใส่หลัง `-jar *.jar` เป็นอาร์กิวเมนต์คำสั่งของโปรแกรม + +ตัวอย่างเช่น หากคุณต้องการใช้อาร์กิวเมนต์เริ่มต้น `nogui`\ +คุณสามารถป้อนดังนี้เพื่อให้ Plazma ประมวลผลอาร์กิวเมนต์ `nogui` ในระหว่างขั้นตอนเริ่มต้น + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### อาร์กิวเมนต์เริ่มต้นทั้งหมด + +#### `bukkit-settings` + +- **ชื่อเล่น**: `b` +- **ค่าเริ่มต้น**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **ชื่อเล่น**: `c` +- **ค่าเริ่มต้น**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **ชื่อเล่น**: `c` +- **ค่าเริ่มต้น**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +เริ่มเซิร์ฟเวอร์ในโลกสาธารณะ + +#### `eraseCache` + +ลบไฟล์แคชที่เหลือหลังจากอัพเกรดโลก + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **ชื่อเล่น**: `?` + +แสดงอาร์กิวเมนต์เริ่มต้นและคำอธิบายของ Plazma + +#### `initSettings` + +สร้างไฟล์กำหนดค่าเท่านั้นและปิดเซิร์ฟเวอร์ + +#### `jfrProfile` + +เปิดใช้งานการโปรไฟล์ JFR + +#### `max-players` + +- **ชื่อเล่น**: `s`, `size` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +ปิดการใช้งานพาเนลอินเตอร์เฟซ + +#### `nojline` + +ปิดใช้งาน JLine และใช้คอนโซลแบบวานิลล่า + +#### `online-mode` + +- **ชื่อเล่น**: `o` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +เลือกว่าจะตรวจสอบผู้เล่นกับเซิร์ฟเวอร์การยืนยันของ Mojang + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **ชื่อเล่น**: `paper` +- **ค่าเริ่มต้น**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +กำหนดตำแหน่งของไฟล์กำหนดค่า PaperSpigot ที่หยุดใช้ + +ใช้สำหรับย้ายการตั้งค่าเดิมไปยังไฟล์ตั้งค่าใหม่ และจะไม่ใช้ต่อจากนั้น + +#### `paper-settings-directory` + +- **ชื่อเล่น**: `paper-dir` +- **ค่าเริ่มต้น**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **ชื่อเล่น**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **ชื่อเล่น**: `p` +- **ค่าเริ่มต้น**: `plugins` + +กำหนดตำแหน่งของโฟลเดอร์ปลั๊กอิน + +#### `pufferfish-settings` + +- **ชื่อเล่น**: `pufferfish` +- **ค่าเริ่มต้น**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **ชื่อเล่น**: `purpur` +- **ค่าเริ่มต้น**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +เริ่มเซิร์ฟเวอร์ในโหมดปลอดภัยแบบวานิลล่า + +#### `server-ip` + +- **ชื่อเล่น**: `h`, `host` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **ชื่อเล่น**: `p`, `port` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +กำหนดพอร์ตของเซิร์ฟเวอร์ + +#### `server-name` + +- **ค่าเริ่มต้น**: `A Plazma Server` + +กำหนดชื่อของเซิร์ฟเวอร์ + +#### `spigot-settings` + +- **ชื่อเล่น**: `S` +- **ค่าเริ่มต้น**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **ชื่อเล่น**: `v` + +แสดงเวอร์ชัน Plazma + +#### `world-dir` + +- **ชื่อเล่น**: `W`, `universe`, `world-container` +- **ค่าเริ่มต้น**: `(โฟลเดอร์เซิร์ฟเวอร์)` + +กำหนดตำแหน่งที่เก็บไฟล์โลก + +#### `world-name` + +- **ชื่อเล่น**: `w`, `world` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +กำหนดชื่อไฟล์โลก + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: ตำแหน่งการประมวลผลอาร์กิวเมนต์จะเปลี่ยนตามตำแหน่งที่เพิ่มเข้ามา + +[^3]: ตัวอย่างเช่น หากคุณต้องการเปิดการใช้งาน `Plazma.iKnowWhatIAmDoing` เป็น `true` คุณสามารถใช้ `-DPlazma.iKnowWhatIAmDoing` แทน `-DPlazma.iKnowWhatIAmDoing=true` และจะทำงานเหมือนกัน + +[^4]: ตัวอย่างเช่น `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: เซ็นเซอร์ตรวจจับเหตุการณ์ + +[^6]: เซ็นเซอร์ตรวจจับเหตุการณ์ + +[^7]: client + +[^8]: สัญญาณที่บ่งบอกว่าเชื่อมต่อกับเซิร์ฟเวอร์อย่างถูกต้องเช่นเดียวกับการเต้นของหัวใจ + +[^9]: การใช้งานฟีเจอร์ AFK Kick ของ Purpur จะช่วยให้คุณสามารถเตะผู้เล่นที่ไม่อยู่ในที่ + +[^10]: ระบบการเขียนชัดเจนแบบเชิงพร้อมกัน, Sync Chunk Write System + +[^11]: `WARNING! Plazma อาจทำให้เกิดปัญหาที่ไม่คาดคิด ดังนั้นตรวจสอบให้ดีก่อนใช้บนเซิร์ฟเวอร์สาธารณะ` + +[^12]: ในเกม `การปรับปรุงโลก` ทำงานตามหลักการเดียวกันกับนี้ + +[^13]: ผู้ดูแลระดับ 2 ขึ้นไป ยกเว้น + +[^14]: โปรโตคอลอินเทอร์เน็ต, IP. diff --git a/th/origin/plazma/administration/reference/commands.md b/th/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..32055e571 --- /dev/null +++ b/th/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้เกี่ยวกับคำสั่งที่สามารถใช้ใน Plazma +--- + +# 🖥️ คำสั่ง diff --git a/th/origin/plazma/administration/reference/configurations/README.md b/th/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..f605f2163 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: การกำหนดค่าเป็นวิธีการปรับแต่ง Plazma ที่เริ่มต้นที่สุด +--- + +# 🧾 구성 + +*** + +## 🪨 คุณสมบัติ + +> คุณสมบัติคือไฟล์การกำหนดค่าพื้นฐานที่ Minecraft ให้ การใช้คุณสมบัติจะช่วยเปลี่ยนแปลงกลไกพื้นฐานของเกม + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 การกำหนด Bukkit + +> การกำหนด Bukkit คือไฟล์การกำหนดค่าพื้นฐานที่ Plazma ให้ การใช้การกำหนด Bukkit จะช่วยเปลี่ยนแปลงกลไกพื้นฐานของเซิร์ฟเวอร์ Minecraft + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 การกำหนด Spigot + +> การกำหนด Spigot ช่วยให้คุณสามารถแก้ไขการทำงานของเกมเช่นกลไกที่ละเอียด การประมวลผลผู้เล่น คำสั่ง และข้อความ + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ การกำหนด Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 การกำหนด Pufferfish + +> การกำหนด Pufferfish ช่วยให้คุณสามารถเปลี่ยนแปลงการประมวลผลของโลกและสิ่งมีชีวิตใน Plazma + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 การกำหนด Purpur + +> คุณสมบัติ Purpur ช่วยให้คุณสามารถแก้ไขข้อมูลพื้นฐานของเกม + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ การกำหนด Plazma + +> การกำหนด Plazma ช่วยให้คุณสามารถปรับแต่งฟังก์ชันของ Plazma + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/th/origin/plazma/administration/reference/configurations/bukkit.md b/th/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..90f1243d6 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้ความหมายของแต่ละโหนดใน bukkit.yml +--- + +# 🪣 Bukkit diff --git a/th/origin/plazma/administration/reference/configurations/paper/README.md b/th/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..0b2a9c44c --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าไฟล์ในโฟลเดอร์ config มีวัตถุประสงค์อะไรบ้าง +--- + +# 🛩️ กระดาษ diff --git a/th/origin/plazma/administration/reference/configurations/paper/global.md b/th/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..5dacd4110 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน paper-global.yml หมายถึงอะไร +--- + +# 🌏 전역 구성 diff --git a/th/origin/plazma/administration/reference/configurations/paper/world.md b/th/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..de882c527 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: ดูว่าแต่ละโหนดใน paper-world.yml หมายถึงอะไร +--- + +# 🏳️ 세계별 구성 + +โลกแต่ละ diff --git a/th/origin/plazma/administration/reference/configurations/plazma/README.md b/th/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..552025b79 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าไฟล์ในโฟลเดอร์ config มีวัตถุประสงค์อะไรบ้าง +--- + +# ✨ พลาซม่า diff --git a/th/origin/plazma/administration/reference/configurations/plazma/global.md b/th/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..b5f619fd5 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน plazma-global.yml หมายถึงอะไร +--- + +# 🌏 전역 구성 diff --git a/th/origin/plazma/administration/reference/configurations/plazma/world.md b/th/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..a2f67f734 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน plazma-world.yml หมายถึงอะไร +--- + +# 🏳️ 세계별 구성 diff --git a/th/origin/plazma/administration/reference/configurations/plazma/worlds.md b/th/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..cf657f3c4 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน plazma-world.yml หมายถึงอะไร +--- + +# ✨ Plazma (โครงสร้างตามโลก) diff --git a/th/origin/plazma/administration/reference/configurations/property.md b/th/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..90d1b0bb0 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้ความหมายของแต่ละโหนดใน server.properties +--- + +# 🪨 Server.properties diff --git a/th/origin/plazma/administration/reference/configurations/pufferfish.md b/th/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..241cf60ff --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: ดำเนินการตรวจสอบความหมายของแต่ละโหนดใน pufferfish.yml +--- + +# 🐡 ปลาปัญจเป็น diff --git a/th/origin/plazma/administration/reference/configurations/purpur/README.md b/th/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..58bfcd6ed --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน purpur.yml หมายถึงอะไร +--- + +# 🦑 Purpur diff --git a/th/origin/plazma/administration/reference/configurations/purpur/global.md b/th/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..8b1ca0277 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน purpur.yml หมายถึงอะไร +--- + +# 🌏 전역 구성 diff --git a/th/origin/plazma/administration/reference/configurations/purpur/world.md b/th/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..8484e6955 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน purpur.yml หมายถึงอะไร +--- + +# 🏳️ 세계별 구성 diff --git a/th/origin/plazma/administration/reference/configurations/spigot.md b/th/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..fbc29c734 --- /dev/null +++ b/th/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้ความหมายของแต่ละโหนดใน spigot.yml +--- + +# 🚰 Spigot diff --git a/th/origin/plazma/administration/reference/permissions.md b/th/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..d1b7e88bc --- /dev/null +++ b/th/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: เรียนรู้เกี่ยวกับสิทธิของ Plazma +--- + +# 🛡️ สิทธิ + +권한은 서버 내 플레이어가 상호 작용 할 수 있는 범위를 설정하는 간단한 보안 도구입니다. + +권한을 제대로 활용하고 쉽게 수정하려면 [LuckPerms](https://luckperms.net) 등의 플러그인을 사용해야 합니다. + +*** + +## 기본 권한 체계 이해하기 + +Minecraft에서는 기본적인 관리 권한 그룹을 제공하고 있습니다. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **플레이어**\ + 일반적으로 모든 플레이어어게 주어지는 권한 그룹입니다. +2. **중재자**\ + 스폰 보호를 무시할 수 있습니다. +3. **세계 관리자**\ + 세계 관리와 관련된 모든 명령어와 명령 블록을 사용할 수 있습니다.\ + 데이터팩 및 명령 블록에 기본 적용되는 권한 그룹입니다. +4. **관리자**\ + 플레이어 관리와 관련된 모든 명령어를 사용할 수 있습니다. +5. **총관리자**\ + 서버 관리를 포함한 모든 명령어를 사용할 수 있습니다.\ + 콘솔 및 운영자에게 기본 적용되는 권한 그룹입니다. + +*** + +## 권한 설정하기 + +*** + +## 전체 권한 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **기본 제공**: `없음` + +플레이어가 엔티티에 `웅크리고 상호 작용`하여 엔티티를 탑승할 수 있도록 허용합니다. + +엔티티를 탑승하면 `이동 키`로 엔티티의 이동을 조작할 수 있으며, `점프 키`로 점프하거나 날 수 있습니다. + +`(Namespaced Key)`에는 엔티티의 [Namespaced ID](#user-content-fn-2)[^2]가 입력됩니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **기본 제공**: `ไม่มี` + +플레이어가 엔티티를 탑승하고 있을 때, 엔티티의 특수 기술을 사용할 수 있도록 허용합니다. + +모든 엔티티의 특수 기능이 사용 가능한 것은 아닙니다. 사용 가능한 전체 특수 기술은 아래를 참고하세요. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) 또는 [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)에 아이디어를 게시해 주세요! +{% endhint %} + +
+ +현재 사용 가능한 특수 기술 보기 + +- **`crepper`**\ + `점프 키`를 누르면 폭발합니다.\ + 플레이어가 `allow.powered.creeper` 권한을 가지고 있으면, `점프 키`를 꾹 눌러 충전할 수 있습니다. +- **`dolphin`**\ + `점프 키`를 누르면 돌진합니다. +- **`phantom`**\ + `점프 키`를 누르면 화염을 발사합니다. +- **`wither`**\ + `상호 작용`하면 위더 머리를 발사합니다. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **기본 제공**: `세계 관리자` + +[`/compass` 명령어](commands.md#compass) 사용을 허용합니다. + +#### `bukkit.command.credits` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/credits (Player)` 명령어](commands.md#credits) 사용을 허용합니다. + +เมื่อป้อน `.other` หลังชื่อสิทธิ์จะทำให้สามารถใช้ได้กับผู้เล่นคนอื่น + +#### `bukkit.command.demo` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/demo (Player)` 명령어](commands.md#demo) 사용을 허용합니다. + +เมื่อป้อน `.other` หลังชื่อสิทธิ์จะทำให้สามารถใช้ได้กับผู้เล่นคนอื่น + +#### `bukkit.command.ping` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/ping (Player)` 명령어](commands.md#ping) 사용을 허용합니다. + +권한명 뒤에 `.other` 를 입력하면 다른 플레이어에게 사용할 수 있도록 허용합니다. + +#### `bukkit.command.ram` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/ram` 명령어](commands.md#ram) 사용을 허용합니다. + +#### `bukkit.command.rambar` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/rambar (Player)` 명령어](commands.md#rambar) 사용을 허용합니다. + +เมื่อป้อน `.other` หลังชื่อสิทธิ์จะทำให้สามารถใช้ได้กับผู้เล่นคนอื่น + +#### `bukkit.command.restart` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/restart` 명령어](commands.md#restart) 사용을 허용합니다. + +#### `bukkit.command.tps` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/tps` 명령어](commands.md#tps) 사용을 허용합니다. + +#### `bukkit.command.tpsbar` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/tpsbar (Player)` 명령어](commands.md#tpsbar) 사용을 허용합니다. + +เมื่อป้อน `.other` หลังชื่อสิทธิ์จะทำให้สามารถใช้ได้กับผู้เล่นคนอื่น + +#### `bukkit.command.timings` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/timings` 명령어](commands.md#timings) 사용을 허용합니다. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +비슷한 기능을 가지는 명령어에 대해 알아보려면 [Spark](https://spark.lucko.me/docs/Command-Usage)를 확인하세요. +{% endhint %} + +#### `bukkit.command.uptime` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +[`/uptime` 명령어](commands.md#uptime) 사용을 허용합니다. + +#### `minecraft.command.gamemode.(GameMode)` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +`/gamemode (GameMode) (Player)` 명령어 사용을 허용합니다. + +เมื่อป้อน `.other` หลังชื่อสิทธิ์จะทำให้สามารถใช้ได้กับผู้เล่นคนอื่น + +#### `paper.antixray.bypass` + +- **기본 제공**: `ไม่มี` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +이렇게 하면 양 측 모두 성능 향상을 경험할 수 있습니다. + +> X-Ray 설정 방법에 대해 알아보려면 아래 페이지를 참고하세요. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **기본 제공**: `없음` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **기본 제공**: `ไม่มี` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **기본 제공**: `ไม่มี` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **기본 제공**: `ไม่มี` + +모루에 [MiniMessage 태그](https://docs.advntr.dev/minimessage/format.html)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **기본 제공**: `ไม่มี` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **기본 제공**: `ไม่มี` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **기본 제공**: `없음` + +플레이어를 유휴 상태 추방 대상에서 제외합니다. + +#### `purpur.debug.f3n` + +- **기본 제공**: `ผู้ดูแลระบบโลก` + +플레이어가 `F3 + N` 키로 게임 모드를 변경할 수 있도록 허용합니다. + +해당 게임모드에 대한 권한이 없으면 작동하지 않습니다. + +#### `purpur.drop.spawners` + +- **기본 제공**: `ไม่มี` + +구성에서 설정한 아이템으로 스포너 블록을 채굴하면 스포너 블록을 떨어뜨립니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **기본 제공**: `ไม่มี` + +엔더 상자의 크기를 변경합니다. + +`(NumberString)`에는 `one`, `two`, `three`, `four`, `five`, `six`를 입력할 수 있습니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ทีโอเท็มของความไมตายทำงานได้แม้ว่าจะอยู่ในกระเป๋าสะพาน + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ผู้เล่นละเว้น จำกัดจำนวนผู้เล่นที่เข้ามา + +#### `purpur.mending_shift_click` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ผู้เล่นสามารถซ่อมแซมไอเทมที่ถืออยู่เมื่อพวกเขากด `เอียงและทำงานร่วมกัน` + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ผู้เล่นติดตั้งเจ้าสปอนเนอร์ + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **기본 제공**: `ไม่มี` + +ทำให้ผู้เล่นเดินทางทันทีเมื่อใช้ประตูเชิงรูปของเนเธอร์ + +#### `purpur.sign.color` + +- **기본 제공**: `ไม่มี` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ใช้รหัสทำให้ลำบาก `(&o)` ในป้าย + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **기본 제공**: `ไม่มี` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ผู้เล่นใช้กรรไกรเพื่อ `การทำงานร่วมกัน` เพื่อป้องกันการระเบิดของ TNT + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### การให้สิทธิที่จะให้ + +#### `plazma.bypass.ncr-require` + +- **기본 제공**: `ไม่มี` + +อนุญาตให้ผู้เล่นเข้าถึงโดยไม่ต้องติดตั้งโหมด [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: ผู้ดำเนินการ + +[^2]: ตัวอย่าง: `ender_dragon` diff --git a/th/origin/plazma/adminstration/README.md b/th/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..e765add85 --- /dev/null +++ b/th/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: ลองใช้ Plazma สร้างเซิร์ฟเวอร์ของคุณเอง +--- + +# ⚒️ คู่มือการบริหารเซิร์ฟเวอร์ diff --git a/th/origin/plazma/adminstration/expert/README.md b/th/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..f2ca5518d --- /dev/null +++ b/th/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีการจัดการ Plazma อย่างมืออาชีพ +--- + +# 🎓 ลึกซึ้ง diff --git a/th/origin/plazma/adminstration/expert/fix-exploits.md b/th/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..348b18786 --- /dev/null +++ b/th/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้เกี่ยวกับช่องโหว่ที่รู้จักและวิธีการแก้ไข +--- + +# ⚠️ ช่องโหว่ที่รู้จักและวิธีการแก้ไข diff --git a/th/origin/plazma/adminstration/expert/optimize.md b/th/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..d2507811f --- /dev/null +++ b/th/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีปรับ Plazma ให้เหมาะสม +--- + +# 🧹 การปรับแต่งให้เหมาะสม diff --git a/th/origin/plazma/adminstration/expert/vanillaize.md b/th/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..9b684586c --- /dev/null +++ b/th/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: เรียนรู้วิธีที่จะกู้คืนการแปลง Paper และ Vanilla +--- + +# ↩️ การทำให้เป็นรสวานิลล่า + +{% hint style="warning" %} + +### Paper ไม่ได้เสนอตัวเลือกสำหรับการแก้ไขข้อผิดพลาดของ Vanilla ในส่วนมาก + +Plazma กำลังพัฒนาให้สามารถปิดการแก้ไขข้อผิดพลาดดังกล่าวได้ในการกำหนดปัจจัย + +ดังนั้นคู่มือนี้ยังไม่สมบูรณ์และข้อมูลอาจมีการเปลี่ยนแปลงได้เสมอ +{% endhint %} diff --git a/th/origin/plazma/adminstration/faq.md b/th/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..9cf5886d0 --- /dev/null +++ b/th/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: เรียนรู้เกี่ยวกับคำถามที่ถามบ่อย +--- + +# ⁉️ คำถามที่ถามบ่อย + +{% hint style="info" %} + +### ไม่พบคำตอบที่คุณต้องการหรือไม่ + +สอบถามคำถามในชุมชนผ่าน [เซิร์ฟเวอร์ Discord อย่างเป็นทางการ](https://discord.gg/MmfC52K8A8) หรือ [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) นะคะ! +{% endhint %} + +### ไม่สามารถดำเนินการได้พร้อมข้อความที่ปรากฏ + +หากมีข้อความ `no main manifest attribute, in plazma-(version).jar` ปรากฏในคอนโซล\ +ไฟล์ที่ดาวน์โหลดเป็นไฟล์ API สำหรับการพัฒนา คุณต้องดาวน์โหลด **Reobf Paperweight** จากหน้า GitHub + +ดูข้อมูลเพิ่มเติมได้ที่หน้าต่อไป + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### คำเตือนปรากฏทุกครั้งที่เซิร์ฟเวอร์เริ่มทำงาน + +Plazma มีการแก้ไขบางส่วนที่ไม่เสถียรและมีโอกาสในการทำงานผิดพลาดเสมอ ดังนั้น ข้อความคำเตือนต่อไปนี้จะปรากฏเมื่อเซิร์ฟเวอร์เริ่มทำงาน + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +คำเตือนนี้สามารถปิดการใช้งานได้ด้วยคุณสมบัติระบบ [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] + +ดูข้อมูลเพิ่มเติมได้ที่หน้าต่อไป + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: สามารถใช้งานตั้งแต่เวอร์ชัน 1.20.1 diff --git a/th/origin/plazma/adminstration/getting-started/README.md b/th/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..f191621de --- /dev/null +++ b/th/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: ดูวิธีการสร้างเซิร์ฟเวอร์ด้วย Plazma +--- + +# 👟 เริ่มต้น + +เพื่อใช้ Plazma อย่างเสถียร, ระบบจำเป็นต้องทำตามความต้องการต่อไปนี้ + +| | ต่ำสุด | แนะนำ | +| :------------: | -----: | ----: | +| โครงสร้าง | x64 | - | +| RAM | 8GB | 16GB | +| พื้นที่จัดเก็บ | 1GB | 8GB | +| JRE | 17 | 21 | + +เพื่อแก้ไขไฟล์การกำหนดค่าได้อย่างราบรื่น, คุณสามารถติดตั้งโปรแกรมแก้ไขเช่น [Visual Studio Code](https://code.visualstudio.com/download) + +*** + +## 1. การติดตั้ง JRE + +ตามชื่อ, Minecraft: **"Java"** Edition ถูกพัฒนาด้วย Java ดังนั้นต้องมี JRE[^1] เพื่อให้ทำงานได้ + +Plazma ยังต้องการ JRE เพื่อใช้งานเนื่องจากเป็นแพลตฟอร์มเซิร์ฟเวอร์อย่างเป็นทางการของ Mojang Studios [เช่นกัน](#user-content-fn-2)[^2] + +### 1.1 การตรวจสอบ JRE + +หากต้องการตรวจสอบว่า JRE ถูกติดตั้งในระบบหรือไม่ ให้เปิดหน้าต่างคำสั่ง [ที่นี่](#user-content-fn-3)[^3] แล้วพิมพ์ [`cmd /k java --version`](#user-content-fn-4)[^4] แล้วกด Enter + +หากมีการแสดงผลดังต่อไปนี้ ให้ข้ามไปที่ [ขั้นตอนที่ 2](setup.md#id-2) + +{% code title="ผลลัพธ์ที่ถูกต้อง" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +หากไม่แสดงผลดังนี้ หรือแสดงผลดังต่อไปนี้ แสดงว่า JRE ไม่ได้ติดตั้งหรือเป็นเวอร์ชันเก่า ให้ดำเนินการตาม [ขั้นตอน 1.2](setup.md#id-1.2) + +{% code title="JRE ไม่ได้ติดตั้ง" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE가 너무 오래됨" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE 설치 + +본 가이드에서는 JRE의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](setup.md#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 먼저, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.msi` 형태로 다운로드 합니다. +2. 다운로드된 설치 마법사를 실행하고, `다음`을 클릭합니다. +3. **창 좌측 중앙에 표시되는 메뉴에서 `Set JAVA_HOME variable`을 활성화 한 후,** `다음`을 클릭합니다. +4. `설치`를 눌러 JRE 설치를 `완료`합니다. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JRE를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma 다운로드 + +Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다. + +{% hint style="warning" %} + +### 대부분의 경우에는 `Reobf Paperclip`을 사용합니다. + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](setup.md#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +자세히 알아보기 + +실행 파일의 이름은 `plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar` 로 정해집니다. + +- **매핑 형태**\ + 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다. + - **Reobf**\ + Reobfuscation, Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.5부터 사용이 종료될 예정입니다. + - **Mojmap**\ + Mojang 매핑, 바닐라 Minecraft 매핑입니다. +- **버전 관리자**\ + 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다. + - **Paperclip**\ + PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다. + - **Bundler**\ + 바닐라 Minecraft 버전 관리자입니다. + +
+ +*** + +## 3. 시작 스크립트 생성 + +Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, [시작 스크립트](#user-content-fn-6)[^6]를 만들어야 합니다. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 [생성할 수 있습니다.](#user-content-fn-7)[^7]\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다.\ +**다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.** + +*** + +## 4. 파일 정리 + +이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다. + +{% hint style="warning" %} + +### 폴더 명칭은 반드시 띄어 쓰기가 없고, 영어로 설정되어야 합니다. + +그렇지 않으면 Plazma 또는 JRE가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA 동의 + +시작 스크립트를 한 번 실행하면, 폴더에 `eula.txt` 가 생성됩니다. + +EULA[^9]는 [Mojang Studios](#user-content-fn-10)[^10]의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다. + +EULA에 동의하지 않는 경우 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 [제재를 받을 수 있습니다.](#user-content-fn-11)[^11] + +EULA에 동의하려면 `eula.txt` 파일의 `eula=false`를 `eula=true`로 수정하고 저장합니다. + +*** + +## 6. 외부 접속 허용 (Windows) + +현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 **방화벽**과 **라우터**가 외부 접속을 차단하고 있습니다. + +Windows의 경우, 방화벽은 [3 단계](setup.md#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} + +### 해당 가이드에서는 Windows 운영 체제 및 [**UPnP**](#user-content-fn-12)[^12]를 사용할 수 있는 라우터임을 가정하고 작성되었습니다. + +라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다. + +또는 [Ngrok](https://ngrok.com/)을 통해 임시 주소를 생성할 수도 있습니다. +{% endhint %} + +{% hint style="warning" %} + +### Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다. + +{% endhint %} + +### 6.1 포트 포워딩 필요 유무 확인 + +실행 창에 다음과 같이 입력하고 실행합니다. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +만약 출력이 `True`라면, 여기서 마쳐도 되지만, `False`라면 포트 포워딩을 설정해야 합니다. + +### 6.2 서버에 접속 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +서버에 접속할 때 사용되는 주소는 [여기에서](https://ip.pe.kr/) 확인할 수 있습니다. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다. + +아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 `[UPnP] (메세지)` 와 같이 출력됩니다. + +| 메세지 | 의미 | +| ------------------------------- | -------------------- | +| `Successfully opened port (포트)` | 포트포워딩 성공. | +| `Port (포트) is already open` | 다른 서비스가 해당 포트를 사용중임. | +| `Failed to open port (포트)` | 포트포워딩 실패. | +| `Service is unavailable` | 라우터가 UPnP를 지원하지 않음. | + +서버가 종료되면 Plazma가 자동으로 포트를 닫습니다. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok 홈페이지](https://ngrok.com/download)에서 `Windows (64-bit)` ZIP 파일을 다운로드 합니다. +2. 다운로드한 Ngrok을 서버 폴더에 넣습니다. +3. [Ngrok 대시보드](https://dashboard.ngrok.com/get-started/your-authtoken) 에서 [인증 토큰을 생성](#user-content-fn-13)[^13]합니다. +4. 서버 폴더에서 아래 `Command Line`에 표시되는 명령어를 실행합니다. +5. 실행 스크립트 가장 상단에 `start /b ngrok tcp --region jp 25565`, 최하단에 `taskkill /f /t /im ngrok.exe`를 추가합니다. +6. 콘솔 최상단에 표시된 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 에서, `0.tcp.jp.ngrok.io:12345`가 서버의 주소가 됩니다. +7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +여기에서 IPv4 주소에 표시된 `192.168.3.7`로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다. + +서버와 게임이 같은 PC에서 실행되는 경우, `localhost`로 접속할 수 있습니다. +{% endtab %} +{% endtabs %} + +## 7. 발전 단계 + +서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다. + +아래 가이드를 통해 서버를 사용자화 하는 방법에 대해 알아보세요. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Java 실행 환경. + +[^2]: Plazma의 기반 Paper는 Spigot을 기반으로 하며, Spigot이 공식 서버 플랫폼을 기반으로 합니다. + +[^3]: Windows 키 + R + +[^4]: Linux의 경우 터미널 에서 `java --version` + +[^5]: JRE는 오픈 소스 프로젝트중 하나로, Minecraft 서버 플랫폼 처럼 여러 종류가 있습니다. + +[^6]: 일반적으로 **구동기**라고 알려져 있습니다. + +[^7]: "Auto-restart"를 활성화 하면 서버가 자동으로 재시작 됩니다. `Control + C`를 입력해 종료할 수 있습니다. + +[^8]: 시스템의 절반 이상을 넘기는것은 권장하지 않습니다. + + 예를 들어, 시스템 전체 메모리 용량이 8GB라고 했을 때, 4GB 이상으로 설정하는것은 권장되지 않습니다. + +[^9]: End-User License Agreement, 최종 사용자 사용권 계약. โปรดดูข้อมูลเพิ่มเติมที่ [เว็บไซต์ Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines) + +[^10]: บริษัท Microsoft Corporation. + +[^11]: ตาม พระราชกฤษฎีกาว่าด้วยกฎหมายที่เกี่ยวข้องกับการส่งเสริมอุตสาหกรรมเกมในประเทศ มาตรา 32 ข้อ 1 ข้อ 9 ที่ **บริษัท ไมโครซอฟท์ ประเทศเกาหลี** สามารถดำเนินคดีตามกฎหมายได้ + +[^12]: Universal Plug & Play. เนื่องจาก Purpur ที่รวมอยู่ใน Plazma สามารถสื่อสารกับเราเตอร์โดยอัตโนมัติผ่านเทคโนโลยีนี้เพียงเมื่อเซิร์ฟเวอร์กำลังทำงานอยู่เท่านั้น ดังนั้นไม่จำเป็นต้องทำการกำหนดพอร์ตโดยตรง + +[^13]: หากไม่มีบัญชี คุณสามารถลงทะเบียนใน Ngrok ผ่านบัญชี Google หรือ GitHub diff --git a/th/origin/plazma/adminstration/getting-started/customization.md b/th/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..4f03865e6 --- /dev/null +++ b/th/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้วิธีปรับแต่งเซิร์ฟเวอร์ +--- + +# 🎨 การปรับแต่งผู้ใช้ diff --git a/th/origin/plazma/adminstration/reference/arguments.md b/th/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..d0c8a6bd1 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: 시작 인수와 시스템 속성에 대해 알아보세요. +--- + +# 🎛️ 인수와 속성 + +시작 변수와 시스템 속성은 Plazma 실행에 [사용되는 명령어](#user-content-fn-1)[^1]에 덧붙이는 값으로,\ +Plazma가 실행된 이후 변경할 수 없는 값을 변경할 수 있게 해줍니다. + +[명령어에 덧붙이는 위치에](#user-content-fn-2)[^2] 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 시스템 속성 + +시스템 속성은 `-jar` 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다. + +{% hint style="warning" %} + +### 시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다! + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 사용 방법 + +시스템 속성은 `java` 와 `-jar` 사이에 Java 명령 인수로써 입력됩니다. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우,\ +다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정됩니다.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다. + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 [추가해야 합니다.](#user-content-fn-4)[^4] +{% endhint %} + +### 전체 시스템 속성 + +#### `convertLegacySigns` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +사용 중지된 표지판 포맷을 업데이트 합니다. + +#### `debug.entities` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +엔티티 정보 관련 디버그 로그를 활성화 합니다. + +#### `debug.rewriteForIDE` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고,\ +내부 버전 정보를 자동으로 리맵합니다. + +#### `disable.watchdog` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Spigot의 Watchdog 경고 시스템을 비활성화 합니다. + +#### `letMeReload` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +`/reload` 명령어의 재확인 메세지를 비활성화 합니다. + +{% hint style="อันตราย" %} + +### `/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다. + +플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, `/reload` 대신 핫스왑을 사용하세요. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다. + +#### `Paper.bypassHostCheck` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다. + +#### `Paper.debugDynamicMissingKeys` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다. + +#### `Paper.debugInvalidSkullProfiles` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다. + +이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다. + +#### `Paper.disableChannelLimit` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +플러그인 클래스 우선 순위 체계를 비활성화 합니다. + +플러그인 셰이드에서 문제가 발생한 경우 유용합니다. + +#### `Paper.disableFlushConsolidate` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Netty flush consolidation 체계를 비활성화 합니다. + +#### `Paper.excessiveTELimit` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `750` + +엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다. + +#### `Paper.filterThreshold` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `8192` + +서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다. + +#### `Paper.ignoreJavaVersion` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Java 버전 확인을 비활성화 합니다. + +{% hint style="อันตราย" %} + +### 이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다! + +월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다. + +이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `80` + +표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다. + +#### `Paper.minPrecachedDatafixVersion` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `(월드 버전) + 1` + +먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다. + +대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다. + +#### `Paper.parseYamlCommentsByDefault` + +- **รูปแบบ**: `บูลีน` +- **기본값**: `True` + +YAML 파일의 주석의 처리를 활성화 합니다. + +#### `Paper.playerConnection.keepAlive` + +- **รูปแบบ**: `จำนวนเต็ม` +- **기본값**: `30` + +플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +서버 속성의 주석을 무시합니다. + +#### `Paper.debug-sync-loads` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +동기 청크 작성의 디버그 로그를 활성화 합니다. + +#### `Paper.enable-sync-chunk-writes` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Minecraft의 [기본 청크 작성 체계](#user-content-fn-10)[^10]을 활성화 합니다. + +이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다. + +#### `Paper.explicit-flush` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +네트워크 채널의 Explicit Flushing을 활성화 합니다. + +#### `Paper.strict-thread-checks` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +메인 스레드에서 발생하지 않은 오류를 항상 로그합니다. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다. + +#### `Paperclip.patchOnly` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다. + +#### `Plazma.aggressiveOptimize` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +{% hint style="warning" %} + +### 해당 속성은 1.20.5 이후 시작 인수로 이동 될 예정입니다. + +{% endhint %} + +처음 시작시 적용되는 구성 최적화를 더 엄격하게 적용합니다. + +활성화 하면 서버가 더욱 빨라지고 안전해지지만, 일부 기믹을 차단하거나 게임 플레이에 큰 영향을 줄 수 있습니다. + +#### `Plazma.iKnowWhatIAmDoing` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +### 사용 중단된 속성 + +아래 시스템 속성은 사용이 중단된 속성입니다. + +#### `timings.bypassMax` + +- **รูปแบบ**: `บูลีน` +- **ค่าเริ่มต้น**: `เท็จ` +- **หยุดใช้**: ตั้งแต่ลบ Timings ออกจาก Plazma + +ตัดสินใจว่าสามารถเกินค่าสูงสุดของข้อมูลที่ส่งไปยัง API Timings ของ Aikar หรือไม่ + +หากไม่มีการจัดการข้อยกเว้นใน API จะมีการใช้จำกัดการใช้งาน + +*** + +## อาร์กิวเมนต์เริ่มต้น + +อาร์กิวเมนต์เริ่มต้นถูกใส่หลัง `-jar *.jar` เพื่อเริ่มต้น Plazma และประมวลผลร่วมด้วย + +### วิธีการใช้ + +คุณสมบัติระบบถูกใส่หลัง `-jar *.jar` เป็นอาร์กิวเมนต์คำสั่งของโปรแกรม + +ตัวอย่างเช่น หากคุณต้องการใช้อาร์กิวเมนต์เริ่มต้น `nogui`\ +คุณสามารถป้อนดังนี้เพื่อให้ Plazma ประมวลผลอาร์กิวเมนต์ `nogui` ในระหว่างขั้นตอนเริ่มต้น + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### อาร์กิวเมนต์เริ่มต้นทั้งหมด + +#### `bukkit-settings` + +- **ชื่อเล่น**: `b` +- **ค่าเริ่มต้น**: `bukkit.yml` + +กำหนดชื่อและตำแหน่งของ [ไฟล์การกำหนดค่า Bukkit](../reference/configurations/bukkit.md) + +#### `command-settings` + +- **ชื่อเล่น**: `c` +- **ค่าเริ่มต้น**: `commands.yml` + +กำหนดชื่อและตำแหน่งของ [ไฟล์การกำหนดค่าคำสั่ง Bukkit](../reference/configurations/bukkit.md) + +#### `config` + +- **ชื่อเล่น**: `c` +- **ค่าเริ่มต้น**: `server.properties` + +กำหนดชื่อและตำแหน่งของไฟล์ [คุณสมบัติเซิร์ฟเวอร์](../reference/configurations/property.md) + +#### `demo` + +เริ่มเซิร์ฟเวอร์ในโลกสาธารณะ + +#### `eraseCache` + +ลบไฟล์แคชที่เหลือหลังจากอัพเกรดโลก + +#### `forceUpgrade` + +อัพเกรดโลกโดยไม่สนใจเวอร์ชันโดยบังคับ + +#### `help` + +- **ชื่อเล่น**: `?` + +แสดงอาร์กิวเมนต์เริ่มต้นและคำอธิบายของ Plazma + +#### `initSettings` + +สร้างไฟล์กำหนดค่าเท่านั้นและปิดเซิร์ฟเวอร์ + +#### `jfrProfile` + +เปิดใช้งานการโปรไฟล์ JFR + +#### `max-players` + +- **ชื่อเล่น**: `s`, `size` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +กำหนดจำนวน [ผู้เล่นสูงสุด](#user-content-fn-14) + +#### `nogui` + +ปิดการใช้งานพาเนลอินเตอร์เฟซ + +#### `nojline` + +ปิดใช้งาน JLine และใช้คอนโซลแบบวานิลล่า + +#### `online-mode` + +- **ชื่อเล่น**: `o` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +เลือกว่าจะตรวจสอบผู้เล่นกับเซิร์ฟเวอร์การยืนยันของ Mojang + +**หมายเหตุ: หากไม่ได้ใช้ Velocity หรือโปรกซี่ อาจถูกลงโทษเนื่องจากการละเมิด [EULA](../getting-started/README.md#id-5)** + +#### `paper-settings` + +- **ชื่อเล่น**: `paper` +- **ค่าเริ่มต้น**: `paper.yml` + +{% hint style="warning" %} + +### อาร์กิวเมนต์นี้ถูกหยุดใช้ตั้งแต่ 1.19.4 + +{% endhint %} + +กำหนดตำแหน่งของไฟล์กำหนดค่า PaperSpigot ที่หยุดใช้ + +ใช้สำหรับย้ายการตั้งค่าเดิมไปยังไฟล์ตั้งค่าใหม่ และจะไม่ใช้ต่อจากนั้น + +#### `paper-settings-directory` + +- **ชื่อเล่น**: `paper-dir` +- **ค่าเริ่มต้น**: `config` + +กำหนดชื่อและตำแหน่งของโฟลเดอร์ที่บรรจุ [ไฟล์กำหนดค่า Paper](../reference/configurations/paper/README.md) + +#### `plazma-settings-directory` + +- **ชื่อเล่น**: `plazma-dir` + +กำหนดชื่อและตำแหน่งของโฟลเดอร์ที่บรรจุ [ไฟล์กำหนดค่า Plazma](../reference/configurations/plazma/README.md) + +#### `plugins` + +- **ชื่อเล่น**: `p` +- **ค่าเริ่มต้น**: `plugins` + +กำหนดตำแหน่งของโฟลเดอร์ปลั๊กอิน + +#### `pufferfish-settings` + +- **ชื่อเล่น**: `pufferfish` +- **ค่าเริ่มต้น**: `pufferfish.yml` + +กำหนดชื่อและตำแหน่งของ [ไฟล์กำหนดค่า Pufferfish](../reference/configurations/pufferfish.md) + +#### `purpur-settings` + +- **ชื่อเล่น**: `purpur` +- **ค่าเริ่มต้น**: `purpur.yml` + +กำหนดชื่อและตำแหน่งของ [ไฟล์กำหนดค่า Purpur](../reference/configurations/purpur/README.md) + +#### `safeMode` + +เริ่มเซิร์ฟเวอร์ในโหมดปลอดภัยแบบวานิลล่า + +#### `server-ip` + +- **ชื่อเล่น**: `h`, `host` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +กำหนดชื่อโฮสต์ของเซิร์ฟเวอร์หรือที่อยู่ IP ของ [โพรโทคอลอินเตอร์เน็ต](#user-content-fn-13) + +#### `server-port` + +- **ชื่อเล่น**: `p`, `port` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +กำหนดพอร์ตของเซิร์ฟเวอร์ + +#### `server-name` + +- **ค่าเริ่มต้น**: `A Plazma Server` + +กำหนดชื่อของเซิร์ฟเวอร์ + +#### `spigot-settings` + +- **ชื่อเล่น**: `S` +- **ค่าเริ่มต้น**: `spigot.yml` + +กำหนดชื่อและตำแหน่งของ [ไฟล์กำหนดค่า Spigot](../reference/configurations/spigot.md) + +#### `version` + +- **ชื่อเล่น**: `v` + +แสดงเวอร์ชัน Plazma + +#### `world-dir` + +- **ชื่อเล่น**: `W`, `universe`, `world-container` +- **ค่าเริ่มต้น**: `(โฟลเดอร์เซิร์ฟเวอร์)` + +กำหนดตำแหน่งที่เก็บไฟล์โลก + +#### `world-name` + +- **ชื่อเล่น**: `w`, `world` +- **ค่าเริ่มต้น**: `(คุณสมบัติเซิร์ฟเวอร์)` + +กำหนดชื่อไฟล์โลก + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: ตำแหน่งการประมวลผลอาร์กิวเมนต์จะเปลี่ยนตามตำแหน่งที่เพิ่มเข้ามา + +[^3]: ตัวอย่างเช่น หากคุณต้องการเปิดการใช้งาน `Plazma.iKnowWhatIAmDoing` เป็น `true` คุณสามารถใช้ `-DPlazma.iKnowWhatIAmDoing` แทน `-DPlazma.iKnowWhatIAmDoing=true` และจะทำงานเหมือนกัน + +[^4]: ตัวอย่างเช่น `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: เซ็นเซอร์ตรวจจับเหตุการณ์ + +[^6]: เซ็นเซอร์ตรวจจับเหตุการณ์ + +[^7]: client + +[^8]: สัญญาณที่บ่งบอกว่าเชื่อมต่อกับเซิร์ฟเวอร์อย่างถูกต้องเช่นเดียวกับการเต้นของหัวใจ + +[^9]: การใช้งานฟีเจอร์ AFK Kick ของ Purpur จะช่วยให้คุณสามารถเตะผู้เล่นที่ไม่อยู่ในที่ + +[^10]: ระบบการเขียนชัดเจนแบบเชิงพร้อมกัน, Sync Chunk Write System + +[^11]: `WARNING! Plazma อาจทำให้เกิดปัญหาที่ไม่คาดคิด ดังนั้นตรวจสอบให้ดีก่อนใช้บนเซิร์ฟเวอร์สาธารณะ` + +[^12]: ในเกม `การปรับปรุงโลก` ทำงานตามหลักการเดียวกันกับนี้ + +[^13]: โปรโตคอลอินเทอร์เน็ต, IP. + +[^14]: ผู้ดูแลระดับ 2 ขึ้นไป ยกเว้น diff --git a/th/origin/plazma/adminstration/reference/commands.md b/th/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..32055e571 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้เกี่ยวกับคำสั่งที่สามารถใช้ใน Plazma +--- + +# 🖥️ คำสั่ง diff --git a/th/origin/plazma/adminstration/reference/configurations/bukkit.md b/th/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..90f1243d6 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้ความหมายของแต่ละโหนดใน bukkit.yml +--- + +# 🪣 Bukkit diff --git a/th/origin/plazma/adminstration/reference/configurations/paper/README.md b/th/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..0b2a9c44c --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าไฟล์ในโฟลเดอร์ config มีวัตถุประสงค์อะไรบ้าง +--- + +# 🛩️ กระดาษ diff --git a/th/origin/plazma/adminstration/reference/configurations/paper/global.md b/th/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..97b340e4d --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน paper-global.yml หมายถึงอะไร +--- + +# 🛩️ กระดาษ (การกำหนดโครงสร้างทั่วโลก) diff --git a/th/origin/plazma/adminstration/reference/configurations/paper/world.md b/th/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..0ff31c836 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน paper-world.yml หมายถึงอะไร +--- + +# 🛩️ กระดาษ (โครงสร้างโลก) diff --git a/th/origin/plazma/adminstration/reference/configurations/plazma/README.md b/th/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..552025b79 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าไฟล์ในโฟลเดอร์ config มีวัตถุประสงค์อะไรบ้าง +--- + +# ✨ พลาซม่า diff --git a/th/origin/plazma/adminstration/reference/configurations/plazma/global.md b/th/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..bfd8d3729 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน plazma-global.yml หมายถึงอะไร +--- + +# ✨ Plazma (การกำหนดที่ global) diff --git a/th/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/th/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..12e79b521 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ โลกตามภูมิภาค diff --git a/th/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/th/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..cf657f3c4 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน plazma-world.yml หมายถึงอะไร +--- + +# ✨ Plazma (โครงสร้างตามโลก) diff --git a/th/origin/plazma/adminstration/reference/configurations/property.md b/th/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..90d1b0bb0 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้ความหมายของแต่ละโหนดใน server.properties +--- + +# 🪨 Server.properties diff --git a/th/origin/plazma/adminstration/reference/configurations/pufferfish.md b/th/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..241cf60ff --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: ดำเนินการตรวจสอบความหมายของแต่ละโหนดใน pufferfish.yml +--- + +# 🐡 ปลาปัญจเป็น diff --git a/th/origin/plazma/adminstration/reference/configurations/purpur/README.md b/th/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..58bfcd6ed --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน purpur.yml หมายถึงอะไร +--- + +# 🦑 Purpur diff --git a/th/origin/plazma/adminstration/reference/configurations/purpur/global.md b/th/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..aab088995 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน purpur.yml หมายถึงอะไร +--- + +# 🦑 Purpur (โครงสร้างโลก) diff --git a/th/origin/plazma/adminstration/reference/configurations/purpur/world.md b/th/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..1de3feae5 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: ดูว่าแต่ละโหนดใน purpur.yml หมายถึงอะไร +--- + +# 🦑 Purpur (สรรพสารของโลก) diff --git a/th/origin/plazma/adminstration/reference/configurations/spigot.md b/th/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..fbc29c734 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้ความหมายของแต่ละโหนดใน spigot.yml +--- + +# 🚰 Spigot diff --git a/th/origin/plazma/adminstration/reference/permissions.md b/th/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..f021add26 --- /dev/null +++ b/th/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: เรียนรู้เกี่ยวกับสิทธิของ Plazma +--- + +# 🛡️ สิทธิ diff --git a/th/origin/plazma/adminstration/undefined/README.md b/th/origin/plazma/adminstration/undefined/README.md new file mode 100644 index 000000000..bdaded5cf --- /dev/null +++ b/th/origin/plazma/adminstration/undefined/README.md @@ -0,0 +1,2 @@ +# 📜 ข้อมูลอ้างอิง + diff --git a/th/origin/plazma/adminstration/undefined/undefined/README.md b/th/origin/plazma/adminstration/undefined/undefined/README.md new file mode 100644 index 000000000..2522bafee --- /dev/null +++ b/th/origin/plazma/adminstration/undefined/undefined/README.md @@ -0,0 +1,2 @@ +# 🎨 ไฟล์กำหนดค่า + diff --git a/th/origin/plazma/developers.md b/th/origin/plazma/developers.md new file mode 100644 index 000000000..683216391 --- /dev/null +++ b/th/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: ลองพัฒนาโปรเจกต์ของบุคคลที่สามด้วย Plazma +--- + +# ⚙️ คู่มือนักพัฒนา diff --git a/th/origin/thunderbolt/README.md b/th/origin/thunderbolt/README.md new file mode 100644 index 000000000..d6490b4f1 --- /dev/null +++ b/th/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt는 실험적인 แพทช์ทดลอง ซึ่งแยก Flavor เพื่อให้สามารถใช้งานโดยตรงได้บนแพลตฟอร์มเซิร์ฟเวอร์ที่ใช้ Plazma เป็นพื้นฐาน +--- + +# 🌩️ คู่มือการใช้งาน Thunderbolt diff --git a/th/origin/volt/README.md b/th/origin/volt/README.md new file mode 100644 index 000000000..13217fbe7 --- /dev/null +++ b/th/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt는 Plazma를 기반으로 자신만의 Paperweight 서버 플랫폼을 개발할 수 있는 오픈 소스 템플릿입니다. +--- + +# ⚡ คู่มือการพัฒนา Volt diff --git a/tr/origin/README.md b/tr/origin/README.md new file mode 100644 index 000000000..228f3b412 --- /dev/null +++ b/tr/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Sorularınız varsa, lütfen Discord veya GitHub Tartışmaları üzerinden sorun. +--- + +# 🏠 Docs Portal'a Hoş Geldiniz + +{% hint style="info" %} + +**Plazma belgesi şu anda makine çevirisi durumundadır.** + +[![Çeviri Durumu](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) adresinde belge çevirilerine katılarak belgeleri geliştirin. + +{% endhint %} + +### Plazma kullanımı sırasında bir sorunla karşılaşırsanız? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Thunderbolt hakkında ilginiz var mı? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt ile kendi sunucu platformunuzu oluşturmak ister misiniz? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Daha fazla Minecraft ile ilgili bilgiye mi ihtiyacınız var? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/tr/origin/SUMMARY.md b/tr/origin/SUMMARY.md new file mode 100644 index 000000000..51e9fd4d0 --- /dev/null +++ b/tr/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# İçindekiler + +- [🏠 Docs Portal'a Hoş Geldiniz](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma Kullanım Belgeleri](plazma/README.md) +- [❓ Plazma Nedir?](plazma/about/README.md) + - [⬇️ İndir](plazma/about/downloads.md) + - [✅ Desteklenen Sürümler](plazma/about/supported-versions.md) +- [⚒️ Sunucu Yönetimi Kılavuzu](plazma/administration/README.md) + - [👟 Başlangıç](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Referans](plazma/administration/reference/README.md) + - [🖥️ Komutlar](plazma/administration/reference/commands.md) + - [🛡️ İzinler](plazma/administration/reference/permissions.md) + - [🎛️ Argümanlar](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Özellik](plazma/yönetim/başvuru/ayarlar/özellik.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Global Yapılandırma](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Dünya Bazlı Yapılandırma](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Global Yapılandırma](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Dünya Bazlı Yapılandırma](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Global Yapılandırma](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Dünya Bazlı Yapılandırma](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Uzmanlaşma](plazma/administration/expert/README.md) + - [🧹 Optimizasyon](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Vanilla Hâline Getirme](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray Engelleme](plazma/administration/expert/xray.md) + - [⚠️ Zafiyetler ve Çözümleri](plazma/administration/expert/fix-exploits.md) + - [⁉️ Sıkça Sorulan Sorular](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Geliştirici Kılavuzu](plazma/developers.md) + - [✏️ Katkıda Bulun](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Thunderbolt Kullanım Kılavuzu](thunderbolt/README.md) + +## Volt + +- [⚡ Volt Geliştirme Kılavuzu](volt/README.md) + +## Çeşitli + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Tümünü İndir](plazma/about/downloads-all.md) diff --git a/tr/origin/miscellaneous/README.md b/tr/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/tr/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/tr/origin/plazma/README.md b/tr/origin/plazma/README.md new file mode 100644 index 000000000..e3dbc3c3f --- /dev/null +++ b/tr/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma, Minecraft: Java Edition için açık kaynaklı bir sunucu platformudur, Paper tabanlı deneysel optimizasyon ve çeşitli oyun mekanizmaları kullanıcı özelleştirmesi eklenmiştir." +--- + +# ✨ Plazma Kullanım Belgeleri + +## 👋 Plazma Belgelerine Hoş Geldiniz + +Plazma Kullanım Belgelerine hoş geldiniz! + +{% hint style="info" %} + +**Kılavuzla sorunu çözemiyor musunuz?** + +Topluluğa sorular sormak için [Resmi Discord Sunucusu](https://discord.gg/MmfC52K8A8) veya [GitHub Tartışmaları](https://github.com/PlazmaMC/PlazmaBukkit/discussions) üzerinden iletişime geçin! + +{% endhint %} + +### Plazma Hakkında + +> Plazma'nın hangi tür bir sunucu platformu olduğunu öğrenin. + +{% content-ref url="hakkimizda/" %} +[hakkimizda](hakkimizda/) +{% endcontent-ref %} + +### Yöneticiler İçin + +> Kendi sunucunuzu oluşturmak için Plazma'yı kullanın. + +{% content-ref url="administration/" %} +[yönetim](administration/) +{% endcontent-ref %} + +### Geliştiriciler İçin + +> Üçüncü taraf projeler geliştirmek için Plazma'yı kullanın. + +{% content-ref url="gelistiriciler.md" %} +[gelistiriciler.md](gelistiriciler.md) +{% endcontent-ref %} + +*** diff --git a/tr/origin/plazma/about/README.md b/tr/origin/plazma/about/README.md new file mode 100644 index 000000000..cb49dc731 --- /dev/null +++ b/tr/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Plazma'nın hangi tür bir sunucu platformu olduğunu öğrenin. +--- + +# ❓ Plazma nedir? + +- **Plazma**, [Andromeda](https://github.com/EarendelArchived/Andromeda) ve [Fusion](https://github.com/RuinedTechnologyUnify/Fusion) projelerinden sadece olumlu yönleri alarak [Paper](https://github.com/PaperMC/Paper) tabanlı bir sunucu platformudur. +- Her zaman yüksek kararlılık ve güçlü performans, hızlı güncellemeler ve geniş özellik seti sunmak için çaba sarf etmektedir. + +## 📋 Plazma'nın hedefleri + +- Hızlı güncellemeler ve yüksek kararlılığa sahip bir sunucu platformu olmak için çaba sarf etmektedir. +- Mod platformlarına eşdeğer geniş özellikler ve güçlü performans sunmak için çaba sarf etmektedir. +- Vanilya yamalarını da özelleştirebileceğiniz özgür bir platform oluşturmak için çaba sarf etmektedir. + +## ⚙️ Ana özellikler + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **En hızlı güncellemeler**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate), Plazma'nın dahil ettiği yamaların her zaman en güncel kalmasını sağlayarak, Paper tabanlı sunucu platformları arasında en hızlı güncellemeleri sunmaktadır. +6. **Varsayılan yapılandırma dosyaları optimize edilmiş**\ + Doğrudan yapılandırma dosyalarını optimize etmenize gerek kalmadan varsayılan olarak optimize edilmiştir. +7. **Sistemli çoklu iş parçacıklı çalışma**\ + Oyun mekanizmalarıyla ilgisi olmayan sistem mekanizmalarını asenkron hale getirerek, [gecikmeyi](#user-content-fn-4)[^4] azaltarak sunucuyu optimize etmektedir. +8. **Gereksiz alan kullanımını engelleme**\ + Benzer değerlere sahip verileri birleştirerek bellek kullanımını azaltır. + +## ✨ Kullanım Örnekleri + +- **Karmaşık eklentileri doğru şekilde işleyen platform**\ + Geliştirici [IPECTER](https://github.com/IPECTER)'ın sunucusunda Plazma kullanılmaktadır.\ + NMS ve yansıma ile çalışan yerleşik eklentiler, karmaşık ve büyük veri paketleriyle yoğun bir şekilde uygulanmış olmasına rağmen, + 100'den fazla oyuncuyu performans düşüşü olmadan kabul etmektedir. +- **RPG sunucularında hızlı performans sağlayan platform**\ + Tek bir kümede 100 oyuncuyu TPS düşüşü olmadan istikrarlı bir şekilde korumuş ve, + 4 kümede toplamda 250 oyuncunun rahatça oynayabileceği sağlanmıştır. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Çok sayıda yayıncının tercih ettiği platform**\ + Birçok yayıncının izleyici katılımı için tercih ettiği platform olarak kullanılmaktadır. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ İndir + +Plazma'yı indirebileceğiniz sayfaya aşağıdan erişebilirsiniz. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Sürüm desteği hakkında daha fazla bilgi mi almak istiyorsunuz? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot eklentileri ve Paper, Pufferfish, Purpur eklentileri. + +[^2]: Microsoft Corporation tarafından. + +[^3]: Sohbet raporlama sistemi devre dışı bırakıldığında sohbet tamamen sunucu tarafından işlendiği için Mojang'ın sohbet izleme işlemini engelleyebilirsiniz. + +[^4]: Sistem mekanizmasının çalışması için oyunun kısa süreliğine duraklaması gereken süre. diff --git a/tr/origin/plazma/about/downloads-all.md b/tr/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..a9c94da3d --- /dev/null +++ b/tr/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma çalıştırılabilir dosyasını indir Tamamını Görüntüle +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Sürüm | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/tr/origin/plazma/about/downloads.md b/tr/origin/plazma/about/downloads.md new file mode 100644 index 000000000..91ee483ca --- /dev/null +++ b/tr/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Hemen indirerek Plazma'yı şimdi deneyin. +--- + +# ⬇️ İndir + +#### Sürüm desteği hakkında daha fazla bilgi mi almak istiyorsunuz? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Aşağıdaki indirme, genel kullanıcılar için yürütülebilir dosyadır.** + +Geliştiricisiniz ve farklı bir dosya türüne ihtiyacınız varsa, lütfen aşağıdaki sayfaya bakın. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Sürümİndir
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + İndir +
1.20.1 + İndir +
1.19.4 + İndir +
+ +*** diff --git a/tr/origin/plazma/about/patches-list.md b/tr/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..37b51333b --- /dev/null +++ b/tr/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Plazma'ya eklenen tüm özellikleri keşfedin. +--- + +# 📑 Dahil Edilen Yamalar diff --git a/tr/origin/plazma/about/supported-versions.md b/tr/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..c10d80550 --- /dev/null +++ b/tr/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Plazma'da desteklenen Minecraft: Java Edition sürümlerini keşfedin." +--- + +# ✅ Sürüm Destek Durumu + +{% hint style="info" %} + +**Plazma, 1.19.4'ten sonra geliştirilmekte olup, 1.19.4'ten düşük sürümler geliştirilmemektedir.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/Bekleme%20Sürümü +[idv]: https://badge.plazmamc.org/1/development +[atv]: https://badge.plazmamc.org/2/support +[fse]: https://badge.plazmamc.org/6/feature-support-discontinued +[eol]: https://badge.plazmamc.org/4/support-ended +[ukn]: https://badge.plazmamc.org/0/Bilgi%20yok +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/normal +[100]: https://badge.plazmamc.org/percent/100 + +![Waiting for release][wtr] ![Development][idv] ![Support][atv] ![Feature support discontinued][fse] ![Support ended][eol] + +| Sürüm | Stabilite ve işlev desteği | Derleme Durumu | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![Build status](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Derleme Durumu](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Derleme Durumu](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/tr/origin/plazma/administration/README.md b/tr/origin/plazma/administration/README.md new file mode 100644 index 000000000..2d0fd93ec --- /dev/null +++ b/tr/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Kendi sunucunuzu oluşturmak için Plazma'yı kullanın. +--- + +# ⚒️ Sunucu Yönetim Kılavuzu diff --git a/tr/origin/plazma/administration/diagnosis/README.md b/tr/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..fb05217ea --- /dev/null +++ b/tr/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Sorunlar ortaya çıktığında nasıl başa çıkılacağını öğrenin. +--- + +# 🧾 진단 diff --git a/tr/origin/plazma/administration/diagnosis/plugins.md b/tr/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..32bed3f3b --- /dev/null +++ b/tr/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Eklentinin düzgün çalışmadığı durumlarda nasıl çözüleceğini öğrenin. +--- + +# 📜 플러그인 diff --git a/tr/origin/plazma/administration/expert/README.md b/tr/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..2e01135f1 --- /dev/null +++ b/tr/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma'yı profesyonel olarak ele alma yöntemlerini öğrenin. +--- + +# 🎓 Derinlemesine diff --git a/tr/origin/plazma/administration/expert/fix-exploits.md b/tr/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..ef8fd2dd7 --- /dev/null +++ b/tr/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Bilinen zayıflıkları ve bunları nasıl çözeceğinizi öğrenin. +--- + +# ⚠️ Bilinen zayıflıklar ve çözüm yolları diff --git a/tr/origin/plazma/administration/expert/optimize.md b/tr/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..5a26dc251 --- /dev/null +++ b/tr/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma'yı optimize etme yöntemlerini öğrenin. +--- + +# 🧹 Optimize diff --git a/tr/origin/plazma/administration/expert/proxy.md b/tr/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..5e3bb6b2f --- /dev/null +++ b/tr/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: '"Velocity" adlı proxy platformunu güvenli bir şekilde yapılandırmanın yöntemlerini öğrenin.' +--- + +# 🔀 Proxy diff --git a/tr/origin/plazma/administration/expert/vanillaize.md b/tr/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..4651f712d --- /dev/null +++ b/tr/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Paper ve vanilyanın düzeltme yamasını nasıl geri yükleyeceğinizi öğrenin. +--- + +# ↩️ Vanilyalaştırma + +{% hint style="warning" %} + +**Paper, vanilyanın hatalarını çözen çoğu yamada seçenek sunmamaktadır.** + +Şu anda Plazma, bu tür hata çözümlerini devre dışı bırakma seçeneği eklemektedir. + +Bu nedenle bu kılavuz henüz tamamlanmamıştır ve her zaman bilgiler değişebilir. + +{% endhint %} diff --git a/tr/origin/plazma/administration/expert/xray.md b/tr/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..aa2b61b1a --- /dev/null +++ b/tr/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: X-Ray'ı engelleyen çeşitli yerleşik yöntemleri öğrenin. +--- + +# 🩻 X-Ray Engelleme diff --git a/tr/origin/plazma/administration/faq.md b/tr/origin/plazma/administration/faq.md new file mode 100644 index 000000000..55eb92409 --- /dev/null +++ b/tr/origin/plazma/administration/faq.md @@ -0,0 +1,43 @@ +--- +description: Sıkça Sorulan Soruları İnceleyin. +--- + +# ⁉️ Sıkça Sorulan Sorular + +{% hint style="info" %} + +**Aradığınız cevabı bulamadınız mı?** + +Topluluğa sorular sormak için [Resmi Discord Sunucusu](https://discord.gg/MmfC52K8A8) veya [GitHub Tartışmaları](https://github.com/PlazmaMC/PlazmaBukkit/discussions) üzerinden iletişime geçin! + +{% endhint %} + +### Plazma başlatılamıyor + +Eğer konsolda `no main manifest attribute, in plazma-(version).jar` şeklinde bir çıktı alıyorsanız, indirdiğiniz dosya geliştirme amaçlı bir API dosyasıdır, GitHub sayfasından **Reobf Paperweight**'i indirmeniz gerekmektedir. + +Daha fazla bilgi için aşağıdaki sayfaya bakın. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Her sunucu başlatıldığında uyarılar görüntülenir + +Plazma bazı kararsız yamalar içerir ve her zaman yanlış çalışma olasılığı bulunduğu için sunucu başlatıldığında aşağıdaki uyarıları görüntüler. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Bu uyarılar [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] sistem özelliği kullanılarak devre dışı bırakılabilir. + +Daha fazla bilgi için aşağıdaki sayfaya bakın. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1'den itibaren kullanılabilir diff --git a/tr/origin/plazma/administration/getting-started/README.md b/tr/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..142b4305e --- /dev/null +++ b/tr/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Plazma ile sunucu oluşturma yöntemini öğrenin. +--- + +# 👟 Başlangıç + +Plazma'yı stabil bir şekilde kullanabilmek için, sistem aşağıdaki gereksinimleri karşılamalıdır. + +| | Minimum | Tavsiye Edilen | +| :------: | ------- | -------------- | +| Mimari | x64 | - | +| RAM | 8GB | 16GB | +| Depolama | 1GB | 8GB | +| JDK | 17 | 21 | + +Düzenli yapılandırma dosyası düzenlemesi için, [Visual Studio Code](https://code.visualstudio.com/download) gibi bir düzenleyici kurmanız da iyi olacaktır. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Doğru çıktı" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' iç veya dış komut, yürütülebilir program veya +yürütme dosyası değil. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. İlk olarak, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) sitesinden **JDK 21**'i `.msi` formatında indirin. +2. İndirilen kurulum sihirbazını çalıştırın ve `Next`e tıklayın. +3. **Pencerenin sol ortasında görünen menüden `Set JAVA_HOME variable`'ı etkinleştirin ve ardından** `Next`e tıklayın. +4. JRE kurulumunu `Complete` seçeneğiyle tamamlayın. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Sonrasında, terminalde aşağıdaki komutu çalıştırarak JRE'yi kurun. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma İndirme + +Plazma, çeşitli şekillerdeki yürütülebilir dosyaları sunmaktadır. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Daha Fazla Bilgi + +Yürütülebilir dosyanın adı `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping şekli).jar` olarak belirlenmiştir. + +- **Mapping Şekli**\ + Mapping, Minecraft'ın gerçek kodunu ve karışık kodunu birleştiren bir tür haritadır. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang tarafından eşlenmiş, Vanilla Minecraft eşlemesidir. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Sürüm Yöneticisi**\ + Sürüm yöneticisi, sunucu işletimi için gerekli kütüphaneleri sağlayan ve sunucu dosyalarını yamalayan sunucunun başlatıcısı olarak düşünülebilir. + - **Paperclip**\ + PaperMC ekibi tarafından Paper ve diğer türetilmiş platformlar için geliştirilen bir yönetici, kütüphaneleri indirir ve sunucuya yama uygular. + - **Bundler**\ + Vanilla Minecraft sürüm yöneticisidir. + +
+ +*** + +## 3. Başlangıç Komut Dosyası Oluşturma + +Plazma'yı hızlıca başlatmak ve sunucuyu otomatik olarak yeniden başlatmak için, [Başlangıç Komut Dosyası](#user-content-fn-6)[^6] oluşturmanız gerekmektedir. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Sol alt köşedeki indirme düğmesi ile başlangıç komut dosyasını indirebilirsiniz.\ +**İndirdiğiniz başlangıç komut dosyasının işletim sisteminizle uyumlu olduğundan emin olun.** + +*** + +## 4. Dosya Düzenleme + +Şimdi indirdiğiniz başlangıç komut dosyasını ve Plazma'yı yeni bir klasöre taşıyın. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Şimdi başlangıç komut dosyasını çalıştırın. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA Onayı + +Başlangıç komut dosyasını bir kez çalıştırdıktan sonra, klasöre `eula.txt` dosyası oluşturulacaktır. + +EULA[^9], [Mojang Studios](#user-content-fn-10)[^10]'un hizmetlerini kullanmak için kabul etmeniz gereken bir lisans sözleşmesidir. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +EULA'yı kabul etmek için `eula.txt` dosyasındaki `eula=false`'ı `eula=true` olarak değiştirin ve kaydedin. + +*** + +## 6. Dış Erişime İzin Verme (Windows) + +Modern işletim sistemleri, dışarıdan gelen tehlikeli erişimleri engellemek için varsayılan olarak **güvenlik duvarı** ve **yönlendirici** ile dış erişimi engeller. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Eğer yönlendiriciniz UPnP'yi desteklemiyorsa, yönlendiriciler farklı panel yapısına sahip olduğundan doğrudan araştırma yapmanız gerekmektedir. + +Ayrıca [Ngrok](https://ngrok.com/) aracılığıyla geçici bir adres oluşturabilirsiniz. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Port Yönlendirme Gerekliliğini Kontrol Etme + +Aşağıdaki gibi girin ve çalıştırın. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Çıktı `True` ise burada durabilirsiniz, ancak `False` ise port yönlendirme yapmanız gerekmektedir. + +### 6.2 Sunucuya Bağlanma + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Sunucuya bağlanmak için kullanılan adresi [buradan](https://ip.pe.kr/) kontrol edebilirsiniz. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Sonrasında sunucuyu yeniden başlattığınızda, Plazma otomatik olarak port yönlendirmesi deneyecektir. + +Aşağıdaki mesaj, konsola yazdırılan UPnP başarısını gösterir ve konsolda `[UPnP] (mesaj)` şeklinde görüntülenir. + +| Mesaj | Anlam | +| ----------------------------------------- | ------------------------------------------------------------- | +| `Başarılı bir şekilde port açıldı (port)` | Port yönlendirme başarılı. | +| `Port (port) zaten açık` | Başka bir hizmet belirtilen portu kullanıyor. | +| `Port açılamadı (port)` | Port yönlendirme başarısız. | +| `Hizmet kullanılamıyor` | Router UPnP'yi desteklemiyor. | + +Sunucu kapanırsa, Plazma otomatik olarak bağlantı noktalarını kapatır. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. [Ngrok websitesi](https://ngrok.com/download) üzerinden `Windows (64-bit)` ZIP dosyasını indirin. +2. İndirdiğiniz Ngrok'ü sunucu klasörüne yerleştirin. +3. [Ngrok kontrol paneli](https://dashboard.ngrok.com/get-started/your-authtoken) üzerinden [kimlik doğrulama belirteci oluşturun](#user-content-fn-13)[^13]. +4. Sunucu klasöründe gösterilen komutu çalıştırın. +5. Çalıştırma betiğinin en üstüne `start /b ngrok tcp --region jp 25565`, en altına `taskkill /f /t /im ngrok.exe` ekleyin. +6. Konsolda gösterilen `Yönlendirme tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` adresinde, `0.tcp.jp.ngrok.io:12345` sunucunun adresidir. +7. Şimdi dışarıdan bu adres aracılığıyla bağlanabilirsiniz. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Örneğin, komutu çalıştırdıktan sonra aşağıdaki gibi bir çıktı alırsanız, + +```log +Windows IP Yapılandırması + +Ethernet Adaptörü Ethernet: + + Bağlı DNS Soneği. . . . : + IPv4 Adresi. . . . . . . . . : 192.168.3.7 + Alt Ağ Maskesi . . . . . . . : 255.255.255.0 + Varsayılan Ağ Geçidi . . . . . . : 192.168.3.1 + +``` + +Burada belirtilen IPv4 adresine `192.168.3.7` ile bağlanmaya çalışırsanız sunucuya yerel ağdan erişebilirsiniz. + +Sunucu ve oyun aynı PC'de çalışıyorsa, `localhost` ile bağlanabilirsiniz. +{% endtab %} +{% endtabs %} + +## 7. Gelişmek + +Sunucuyu başarıyla başlattıysanız ve sunucunun düzgün çalıştığından eminseniz, şimdi sunucuyu özelleştirme zamanı. + +Sunucuyu nasıl özelleştireceğinizi öğrenmek için aşağıdaki kılavuzu inceleyin. + +{% content-ref url="sonraki-adim.md" %} +[sonraki-adım.md](sonraki-adım.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma'nın temeli olan Paper, Spigot'a dayanmaktadır ve Spigot resmi sunucu platformuna dayanmaktadır. + +[^3]: Windows tuşu + R + +[^4]: Linux'ta `java --version` komutunu terminalden çalıştırın. + +[^5]: JRE, Minecraft sunucu platformu gibi çeşitli türlerde olduğu gibi, açık kaynaklı bir projedir. + +[^6]: Genellikle **launcher** olarak bilinir. + +[^7]: "Oto-yeniden başlatma" etkinleştirildiğinde sunucu otomatik olarak yeniden başlatılır. `Control + C` tuşlarına basarak kapatılabilir. + +[^8]: Sistemin yarısından fazlasını aşırı yüklemek önerilmez. + + Örneğin, sistem toplam bellek kapasitesi 8GB ise, 4GB'den fazlasını ayarlamak önerilmez. + +[^9]: Son Kullanıcı Lisans Anlaşması, EULA. Daha fazla bilgi için [Minecraft websitesi](https://www.minecraft.net/ko-kr/usage-guidelines)'ni kontrol edin. + +[^10]: Microsoft Corporation. + +[^11]: Güney Kore'nin oyun endüstrisini teşvik etme yasası Madde 32(1)(9) uyarınca **Kore Microsoft Corporation** yasal olarak dava açabilir. + +[^12]: Universal Plug & Play. Purpur, Plazma'da bulunan bu teknoloji sayesinde sunucu çalışırken otomatik olarak yönlendiriciyle iletişim kurar ve sadece sunucu çalışırken bağlantı noktalarını açar, bu nedenle doğrudan port yönlendirmesi yapmanıza gerek yoktur. + +[^13]: Hesabınız yoksa, Google veya GitHub hesabınızı kullanarak Ngrok'a kaydolun. diff --git a/tr/origin/plazma/administration/getting-started/customization.md b/tr/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..30acadbe3 --- /dev/null +++ b/tr/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,123 @@ +--- +description: Sunucuyu özelleştirmenin yollarını öğrenin. +--- + +# 🎨 Kullanıcı özelleştirmesi + +Mojang Studios tarafından sağlanan resmi sunucu platformunu kullanmadan +Plazma ve benzeri özelleştirilmiş sunucu platformunu kullanmanın nedeni, güçlü +**özelleştirme** imkanı sunmasıdır. + +Aşağıda Plazma'yı özelleştirmek ve kullanmak için çeşitli yöntemler bulunmaktadır. + +## Yapılandırma Değişikliği + +Plazma'yı özelleştirmenin en temel yolu, yapılandırmayı değiştirmektir. + +Plazma, oyun mekaniği ve yaratıkların özellikleri gibi güçlü yapılandırma ayarlarını sunmaktadır. + +Plazma'nın yapılandırması hakkında daha fazla bilgi için aşağıdaki sayfaya bakınız. + +{% content-ref url="../reference/configurations/" %} +[yapılandırmalar](../reference/configurations/) +{% endcontent-ref %} + +## Eklenti Kullanımı + +{% hint style="success" %} + +**Plazma, Tüm Kağıt Tabanlı Eklentileri Destekler.** + +Spigot eklentileri 1.20.5 sürümünden itibaren Paper'ın eşleme değişiklikleri nedeniyle bazıları düzgün çalışmayabilir, ancak Paper, Pufferfish ve Purpur gibi Paper'a dayalı çoğu eklenti Plazma'da da sorunsuz çalışır ve düzgün çalışmıyorsa bu Plazma'nın hatası olduğundan lütfen [bildiriniz.](../diagnosis/plugins.md) + +{% endhint %} + +Plazma'yı kullanmanın ve kişiselleştirmenin en güçlü yolu. +Plazma'nın güçlü eklenti ekosistemi sunucuyu kolayca kişiselleştirmenizi sağlar. + +Eklenti bulma ve indirme işlemi için çeşitli yöntemler bulunmaktadır. Bazı eklentiler +genel depolama hizmetlerine eklentileri yüklerken, bazıları GitHub veya kendi +sitelerine yüklerler. + +{% hint style="caution" %} + +**Eklentiler sistemle doğrudan etkileşebilir!** + +VirusTotal gibi hizmetler kullanarak eklentileri uygulamadan önce her zaman güvenli olup olmadığını kontrol edin veya +güvenilir bir hizmetten eklentiyi indirin. + +{% endhint %} + +Eklenti indirmek için kullanılan hizmetlerin çeşitli olduğunu unutmayın. Bu hizmetler arasında [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) gibi hizmetler bulunmaktadır ve eklentiler güvenli olup olmadıkları kontrol edilerek dağıtılmaktadır. + +### Eklenti Uygulama + +Eklentiyi indirdikten sonra, şimdi eklentiyi uygulama zamanı. + +1. Eklentiler `.jar` veya `Java Yürütülebilir Dosya` şeklinde olacaktır.\ + Bazı eklentiler sıkıştırılmış dosya olarak gelebilir, bu durumda + sıkıştırılmış dosyayı açın ve içinde `bukkit`, `spigot` veya `paper` içeren + bir dosya varsa ve `fat` içeren bir dosya varsa, `fat` dosyasını kullanın. +2. İndirdiğiniz dosyayı sunucu klasöründeki `plugins` klasörüne koyun ve sunucuyu (yeniden) başlatın. +3. Plazma başladığında, konsola yeni içerikler yazdırılacaktır. + Bu, Plazma'nın eklentiyi başarıyla yüklediği anlamına gelir. +4. Plazma eklentiyi başarıyla yüklemiş olsa bile, eklentiyi başlatamayabilir. + `/plugins` komutunu kullanarak mevcut sunucuda yüklenen eklentileri listeleyebilirsiniz. + Yüklediğiniz eklentinin adı kırmızı değilse yeşil ise eklenti başarıyla yüklendi demektir. + +Eğer eklenti başarıyla yüklenmediyse, sorunun çözümünü aşağıdaki sayfadan bulabilirsiniz. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Veri Paketi Kullanımı + +Veri paketi, Minecraft'ın varsayılan olarak sunduğu kişiselleştirme yöntemidir ve +[Kaynak Paketi](#user-content-fn-1)[^1] ile benzerdir. + +Veri paketi kullanarak yeni yaratıklar ve meydan okumalar ekleyerek oyunun içinde bazı değişiklikler yapabilirsiniz. + +{% hint style="caution" %} + +**Veri paketi dünyayı bozabilir!** + +Bazı bozuk veri paketleri dünyayı bozabilir ve bu geri alınamaz. + +Bu nedenle, veri paketini uygulamadan önce dünyayı yedeklemeniz önerilir. + +{% endhint %} + +Veri paketleri de birçok hizmetten indirilebilir, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) gibi birçok hizmette bulunabilir. + +Veri paketini indirdikten sonra, sunucunun dünya klasörüne `datapacks` klasörüne koyarak uygulayabilirsiniz. +Klasör yoksa oluşturarak ekleyebilirsiniz. + +{% hint style="warning" %} + +**Bazı [veri paketleri](#user-content-fn-2)[^2] ilk uygulandığında düzgün çalışmayabilir.** + +Bu duruma karşı sunucuyu **2 kez** yeniden başlatmanız önerilir. + +{% endhint %} + +Veri paketleri Minecraft'ın sürümü güncellendiğinde kolayca bozulabilir. + +Özellikle, veri paketi tamamen bozulduğunda, sunucu çökeceği için, +sunucuyu güncellemeden önce yeterli test yapmak önemlidir. + +{% hint style="info" %} + +**Sunucu başlatma komutunun arkasına `safeMode` yazarak tüm veri paketlerini devre dışı bırakabilir ve sunucuyu başlatabilirsiniz.** + +[Daha fazla bilgi için `Referans > Argümanlar ve Özellikler` bölümüne bakınız.](../reference/arguments.md) + +{% endhint %} + +Uygulanan veri paketlerini `/datapack list` komutuyla kontrol edebilirsiniz. + +*** + +[^1]: Ya da Minecraft: Bedrock Sürümü'nün eklentileri. + +[^2]: Yaratıkların eklenmesi vb. diff --git a/tr/origin/plazma/administration/getting-started/next-step.md b/tr/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..fe199073b --- /dev/null +++ b/tr/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Sunucuyu özelleştirmenin yollarını öğrenin. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Aşağıda Plazma'yı özelleştirmek ve kullanmak için çeşitli yöntemler bulunmaktadır. + +## Yapılandırma Değişikliği + +Plazma'yı özelleştirmenin en temel yolu, yapılandırmayı değiştirmektir. + +Plazma, oyun mekaniği ve yaratıkların özellikleri gibi güçlü yapılandırma ayarlarını sunmaktadır. + +Plazma'nın yapılandırması hakkında daha fazla bilgi için aşağıdaki sayfaya bakınız. + +{% content-ref url="../reference/configurations/" %} +[yapılandırmalar](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Eklenti Kullanımı + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Plazma'yı kullanmanın ve kişiselleştirmenin en güçlü yolu. Plazma'nın güçlü eklenti ekosistemi sunucuyu kolayca kişiselleştirmenizi sağlar. + +Eklenti bulma ve indirme işlemi için çeşitli yöntemler bulunmaktadır. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Eklenti indirmek için kullanılan hizmetlerin çeşitli olduğunu unutmayın. Bu hizmetler arasında [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) gibi hizmetler bulunmaktadır ve eklentiler güvenli olup olmadıkları kontrol edilerek dağıtılmaktadır. + +### Eklenti Uygulama + +Eklentiyi indirdikten sonra, şimdi eklentiyi uygulama zamanı. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. İndirdiğiniz dosyayı sunucu klasöründeki `plugins` klasörüne koyun ve sunucuyu (yeniden) başlatın. +3. Plazma başladığında, konsola yeni içerikler yazdırılacaktır. Bu, Plazma'nın eklentiyi başarıyla yüklediği anlamına gelir. +4. Plazma eklentiyi başarıyla yüklemiş olsa bile, eklentiyi başlatamayabilir. `/plugins` komutunu kullanarak mevcut sunucuda yüklenen eklentileri listeleyebilirsiniz. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Eğer eklenti başarıyla yüklenmediyse, sorunun çözümünü aşağıdaki sayfadan bulabilirsiniz. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Veri Paketi Kullanımı + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Veri paketi kullanarak yeni yaratıklar ve meydan okumalar ekleyerek oyunun içinde bazı değişiklikler yapabilirsiniz. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Bazı bozuk veri paketleri dünyayı bozabilir ve bu geri alınamaz. + +Bu nedenle, veri paketini uygulamadan önce dünyayı yedeklemeniz önerilir. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Veri paketini indirdikten sonra, sunucunun dünya klasörüne `datapacks` klasörüne koyarak uygulayabilirsiniz. Klasör yoksa oluşturarak ekleyebilirsiniz. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Bu duruma karşı sunucuyu **2 kez** yeniden başlatmanız önerilir. +{% endhint %} + +Veri paketleri Minecraft'ın sürümü güncellendiğinde kolayca bozulabilir. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Uygulanan veri paketlerini `/datapack list` komutuyla kontrol edebilirsiniz. + +*** + +## Optimizasyon + +Plazma'ya birçok optimizasyon yaması uygulanmıştır. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Vekil + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Güvenli ve doğru vekil yapılandırması hakkında bilgi için aşağıdaki sayfaya bakınız. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Güvenlik + +Minecraft, çevrimiçi ortamda da kolayca [Zararlı Yazılım Saldırı Motoru](#user-content-fn-3)[^3]'nü bulabileceğiniz modlara sahiptir. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### İzin Ayarları + +Bazı eklentilerin yönetici komutlarında uygun izinlerin ayarlanmamış zayıf noktaları olabilir. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X-Ray Engelleme + +X-Ray, temel optimizasyon istemcilerinde kolayca kullanılabilen zayıf noktalardan biridir. + +Plazma, X-Ray'i varsayılan olarak engelleyebileceğiniz bir yapılandırma sunmaktadır. + +X-Ray engelleme yöntemi ve açıklamaları için aşağıdaki sayfaya bakınız. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Beyaz Liste + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Erişime izin verilen oyuncuları görmek için `/whitelist query` komutunu kullanın. + +*** + +[^1]: Ya da Minecraft: Bedrock Sürümü'nün eklentileri. + +[^2]: Yaratıkların eklenmesi vb. + +[^3]: Genellikle "hack" olarak adlandırılır. + +[^4]: Yapılandırma optimize edilmemişse, Plazma eskiyse veya yeni keşfedilen zayıf noktalar varsa engellenmemiş olabilir. + +[^5]: Oyuncular sunucuya Ngrok proxy sunucusu aracılığıyla bağlandığında, her yeniden başlatmada farklı bir Ngrok adresi verilir. diff --git a/tr/origin/plazma/administration/reference/README.md b/tr/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..fb77f7107 --- /dev/null +++ b/tr/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Plazma'da sağlanan varsayılan kullanıcı özelleştirme yöntemlerini öğrenin. +--- + +# 📜 리퍼런스 + +Plazma, çeşitli kullanıcı özelleştirme yöntemleri sunmaktadır. + +Bu yöntemler arasında, ek bir işlem olmadan hemen kullanılabilecek 4 farklı özelleştirme yöntemi bulunmaktadır. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +Topluluğa sorular sormak için [Resmi Discord Sunucusu](https://discord.gg/MmfC52K8A8) veya [GitHub Tartışmaları](https://github.com/PlazmaMC/PlazmaBukkit/discussions) üzerinden iletişime geçin! +{% endhint %} + +*** + +## 🖥️ Komutlar + +> Komutlar, oyun içinde bilgi toplamak veya oynanış ortamını özelleştirmenize olanak tanır. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ İzinler + +> İzinler, oyuncuların etkileşimde bulunabileceği alanları belirler. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Argümanlar ve Özellikler + +> Argümanlar ve özellikler, Plazma'nın işleyişine genel olarak etki eder. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Yapılandırma + +> Yapılandırma, Plazma'yı özelleştirmenin en temel yoludur. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/tr/origin/plazma/administration/reference/arguments.md b/tr/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..5b88c8684 --- /dev/null +++ b/tr/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Başlangıç argümanları ve sistem özelliklerini öğrenin. +--- + +# 🎛️ Argümanlar ve Özellikler + +Başlangıç ​​parametreleri ve sistem özellikleri, Plazma'nın çalışmasına eklenen bir değer olarak [kullanılan komutlar](#user-content-fn-1)[^1] ile ilgilidir ve Plazma'nın genel işleyişine etki eder. + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]e göre **başlangıç argümanı** ve **sistem özellikleri** olarak ayrılır. + +*** + +## Sistem özelliği + +Sistem özellikleri, `-jar`'ın önüne yerleştirilir ve Plazma'nın başlatılması öncesinde JVM tarafından işlenen değerlerdir. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Kullanım şekli + +Sistem özellikleri, `java` ve `-jar` arasına Java komut argümanı olarak eklenir. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`, bu argümanın JVM'e yerleşik olmadığını ve Plazma'ya eklenen özel bir argüman olduğunu belirtir ve + +Özelliklere herhangi bir değer girilmezse değer [`true` olarak sabitlenir](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Tüm sistem özellikleri + +#### `convertLegacySigns` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Kullanımdan kaldırılan işaret formatlarını günceller. + +#### `debug.entities` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Varlık bilgileri ile ilgili hata ayıklama günlüklerini etkinleştirir. + +#### `debug.rewriteForIDE` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +IDE'de hata ayıklama bilgilerini doğru şekilde yükleyebilmek için NMS revizyonunu devre dışı bırakır ve,\ +iç versiyon bilgisini otomatik olarak yeniden haritalandırır. + +#### `disable.watchdog` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Spigot'un Watchdog uyarı sistemi devre dışı bırakılır. + +#### `letMeReload` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +`/reload` komutunun yeniden doğrulama iletişim kutusunu devre dışı bırakır. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Eğer bir eklenti geliştiricisiyseniz ve eklentiyi güncellemeniz gerekiyorsa, `/reload` yerine hotswap kullanın. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Standart giriş/çıkış sistemini kullanan eklentileri devre dışı bırakır. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Mesajlaşma bileşenlerinde kullanımdan kaldırılan biçim algılandığında uyarır. + +#### `Paper.bypassHostCheck` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Oyuncunun sunucuya bağlandığında sunucunun model eşleşme doğrulamasını devre dışı bırakır. + +#### `Paper.debugDynamicMissingKeys` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +NBT nesnelerinde eksik anahtarlar için hata ayıklama günlüklerini etkinleştirir. + +#### `Paper.debugInvalidSkullProfiles` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Hatalı kafatası profilleri hakkında hata ayıklama günlüklerini etkinleştirir. + +Bu, tüm hatalı kafatası bloklarını konumlarıyla birlikte günlüğe kaydeder. + +#### `Paper.disableChannelLimit` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Eklenti sınıf öncelik sistemini devre dışı bırakır. + +Eklenti gölgelendirmede sorun yaşandığında faydalıdır. + +#### `Paper.disableFlushConsolidate` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Netty flush konsolidasyon sistemini devre dışı bırakır. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Varsayılan Değer**: `750` + +Varlık sayısı belirtilen değerden fazla ise çoklu paketlere bölerek iletilir. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Varsayılan Değer**: `8192` + +Sunucunun alabileceği maksimum paket boyutunu ayarlar. + +#### `Paper.ignoreJavaVersion` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Java sürüm kontrolünü devre dışı bırakır. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Dünya ve diğer tüm dosyalar kalıcı olarak zarar görebilir ve oyunun genel mekanikleri bozulabilir. + +Bu nedenle yaşanan tüm sorunlar sizin sorumluluğunuzdadır ve Plamza bunun için herhangi bir destek sağlamaz. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Varsayılan Değer**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Varsayılan Değer**: `80` + +Tabelanın bir satırına girilebilecek maksimum karakter sayısını ayarlar. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Varsayılan Değer**: `(Dünya Sürümü) + 1` + +Önce başlanacak dünya güncelleme bilgisinin sürümünü ayarlar. + +Çok sayıda bloğun güncellenmesi gereken durumlarda faydalı olabilir, ancak diğer durumlarda kullanılmaz. + +#### `Paper.parseYamlCommentsByDefault` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `True` + +YAML dosyalarındaki yorumların işlenmesini etkinleştirir. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Varsayılan Değer**: `30` + +Oyuncudan belirli bir süre (saniye cinsinden) hiçbir veri alınmazsa, oyuncuyu atar. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Sunucu özelliklerinin yorumlarını görmezden gelir. + +#### `Paper.debug-sync-loads` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Senkron yükleme hata ayıklama günlüklerini etkinleştirir. + +#### `Paper.enable-sync-chunk-writes` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Minecraft'un [varsayılan yükleme sistemi](#user-content-fn-10)[^10]'ni etkinleştirir. + +Bu, her bir bloğu sırayla kaydetmeyi gerektirdiği için büyük performans düşüşüne neden olur. + +#### `Paper.explicit-flush` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Ağ kanalının Açıkça Boşaltılmasını etkinleştirir. + +#### `Paper.strict-thread-checks` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Ana iş parçacığında meydana gelen hataları her zaman kaydeder. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Zamanlamalı görevlerin aşırı gecikmeye sahip olması durumunda uyarı verir. + +#### `Paperclip.patchOnly` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Varsayılan yürütülebilir dosyayı kullandığınızda, sunucuyu başlatmadan yalnızca yama uygular. + +#### `Plazma.aggressiveOptimize` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` +- **Çarpışma**: `Plazma.disableConfigOptimization` + +İlk yapılandırmayı daha güçlü bir şekilde optimize eder. + +Aktive edildiğinde sunucu daha hızlı ve güvenli hale gelir, ancak oyun oynama üzerinde büyük etkileri olabilir. + +#### `Plazma.disableConfigOptimization` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` +- **Çarpışma**: `Plazma.aggressiveOptimize` + +İlk yapılandırmayı optimize etmeyecek. + +Bu, Paper'ın varsayılan yapılandırmasını kullanır. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` + +Plazma markasını devre dışı bırakır ve vanilya temel sunucu favicon'unu kullanacak şekilde yapılandırır. + +#### `Plazma.useVanillaConfiguration` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` +- **Çarpışma**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Bu, sunucu güvenliği ve performansı üzerinde büyük etkilere sahip olabilir. + +Bu özellikten kaynaklanan herhangi bir sorumluluk sunucu yöneticisine aittir. +{% endhint %} + +İlk yapılandırmayı Mojang tarafından sağlanan varsayılan değerlerle sunar. + +Bu, Paper'da uygulanan tüm güvenlik açıkları yamalarını devre dışı bırakır. + +Güvenlik açıkları yamaları, Paper yapılandırmasında veya Plazma yapılandırmasında yeniden etkinleştirilebilir. + +#### `Plazma.vanillaize` + +- **Biçimi**: `Boolean` +- **Varsayılan**: `true` +- **Çarpışma**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +İlk yapılandırmayı vanilyaya yakın olarak ayarlar. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Kullanımdan kaldırılan özellik + +Aşağıdaki sistem özellikleri kullanımdan kaldırılmış özelliklerdir. + +#### `timings.bypassMax` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` +- **Kullanım dışı**: Timings, Plazma'dan tamamen kaldırıldıktan sonra + +Aikar'ın Timings API'sine iletilen değerin maksimumunun aşıp aşamayacağını belirler. + +Buna rağmen, API'de istisna olmazsa hız sınırlaması uygulanır. + +*** + +## Başlangıç argümanı + +Başlangıç argümanı, `-jar *.jar`'ın arkasına girilir ve Plazma başlatıldığında işlenen bir değerdir. + +### Kullanım şekli + +Sistem özellikleri, `-jar *.jar`'ın arkasına programın komut argümanı olarak girilir. + +Örneğin, `nogui` başlangıç argümanını uygulamak istediğinizde,\ +şu şekilde girerek Plazma, başlatma sırasında `nogui` argümanını işler. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Tüm başlangıç argümanı + +#### `bukkit-settings` + +- **Takma ad**: `b` +- **Varsayılan**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Takma ad**: `c` +- **Varsayılan**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Takma ad**: `c` +- **Varsayılan**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Sunucuyu demo dünyasıyla başlatır. + +#### `eraseCache` + +Dünya yükseltme sonrası kalan önbellek dosyalarını siler. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Takma ad**: `?` + +Plazma'nın tüm başlangıç argümanlarını ve açıklamalarını görüntüler. + +#### `initSettings` + +Yapılandırma dosyasını oluşturur ve sunucuyu kapatır. + +#### `jfrProfile` + +JFR profil oluşturmayı etkinleştirir. + +#### `max-players` + +- **Takma ad**: `s`, `size` +- **Varsayılan**: `(sunucu özellikleri)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Grafik arayüz panelini devre dışı bırakır. + +#### `nojline` + +JLine'ı devre dışı bırakır ve saf konsolu kullanır. + +#### `online-mode` + +- **Takma ad**: `o` +- **Varsayılan**: `(sunucu özellikleri)` + +Oyuncuları Mojang kimlik doğrulama sunucusuyla doğrulamak için seçim yapar. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Takma ad**: `paper` +- **Varsayılan**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Kullanımdan kaldırılan PaperSpigot yapılandırma dosyasının konumunu ayarlar. + +Bu, mevcut yapıyı yeni bir yapılandırma dosyasına taşımak için kullanılır ve daha sonra kullanılmaz. + +#### `paper-settings-directory` + +- **Takma ad**: `paper-dir` +- **Varsayılan**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Takma ad**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Takma ad**: `p` +- **Varsayılan**: `plugins` + +Eklenti klasörünün konumunu ayarlar. + +#### `pufferfish-settings` + +- **Takma ad**: `pufferfish` +- **Varsayılan**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Takma ad**: `purpur` +- **Varsayılan**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(Güvenli Mod) Sunucuyu tamamen saf bir şekilde başlatır. + +#### `server-ip` + +- **Takma ad**: `h`, `host` +- **Varsayılan**: `(sunucu özellikleri)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Takma ad**: `p`, `port` +- **Varsayılan**: `(sunucu özellikleri)` + +Sunucunun bağlantı noktasını ayarlar. + +#### `server-name` + +- **Varsayılan**: `A Plazma Sunucusu` + +Sunucunun adını ayarlar. + +#### `spigot-settings` + +- **Takma ad**: `S` +- **Varsayılan**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Takma ad**: `v` + +Plazma sürümünü görüntüler. + +#### `world-dir` + +- **Takma ad**: `W`, `evren`, `dünya-konteyneri` +- **Varsayılan**: `(sunucu klasörü)` + +Dünya dosyalarının kaydedildiği konumu ayarlar. + +#### `world-name` + +- **Takma ad**: `w`, `dünya` +- **Varsayılan**: `(sunucu özellikleri)` + +Dünya dosyasının adını ayarlar. + +*** + +[^1]: `java (...) -jar sunucu.jar (...)` + +[^2]: Eklenen konuma bağlı olarak argüman işleme konumu değişir. + +[^3]: Örneğin, `Plazma.iKnowWhatIAmDoing` değerini `true` olarak ayarlamak (etkinleştirmek) istediğinizde, `-DPlazma.iKnowWhatIAmDoing=true` yerine `-DPlazma.iKnowWhatIAmDoing` yazmak yeterlidir ve aynı şekilde çalışır. + +[^4]: Örneğin, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Olay algılayıcı. + +[^6]: Olay algılayıcı. + +[^7]: İstemci. + +[^8]: Kalp atışı gibi sunucu ile düzgün bağlantı kurulduğunu belirten sinyal. + +[^9]: Purpur'un AFK atma özelliği, oyundan ayrılan oyuncuları da atmanıza olanak tanır. + +[^10]: Senkron Chunk Yazma Sistemi, Sync Chunk Write System. + +[^11]: `UYARI! Plazma beklenmedik sorunlara neden olabilir, bu nedenle halka açık bir sunucuda kullanmadan önce detaylı bir şekilde test ettiğinizden emin olun.` + +[^12]: Oyundaki `dünya optimizasyonu` da aynı prensiple çalışır. + +[^13]: `Seviye 2` ve üzeri yöneticiler hariç tutulur. + +[^14]: Internet Protokolü, IP. diff --git a/tr/origin/plazma/administration/reference/commands.md b/tr/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..de3cae12a --- /dev/null +++ b/tr/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma'da kullanılabilen komutları öğrenin. +--- + +# 🖥️ Komutlar diff --git a/tr/origin/plazma/administration/reference/configurations/README.md b/tr/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..70a07581f --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Yapılandırma, Plazma'yı özelleştirmenin en temel yoludur. +--- + +# 🧾 구성 + +*** + +## 🪨 Özellik + +> Özellik, Minecraft tarafından sağlanan en temel yapı dosyasıdır. Özellikleri kullanarak oyunun temel mekanizmalarını değiştirebilirsiniz. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit Yapı + +> Bukkit Yapı, Plazma tarafından sağlanan en temel yapı dosyasıdır. Bukkit Yapısını kullanarak Minecraft sunucusunun temel mekanizmalarını değiştirebilirsiniz. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot Yapı + +> Spigot Yapı, oyunun detaylı mekanizmalarını, oyuncu işlemlerini, komutları ve mesajları değiştirmenize olanak tanır. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper Yapı + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish Yapı, Plazma'nın dünya ve varlıkların işlenişini değiştirmenize olanak tanır. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur Yapı + +> Purpur özellikleri, oyunun genel verilerini değiştirmenize olanak tanır. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma Yapı + +> Plazma Yapı, Plazma'nın özelliklerini özelleştirmenize olanak tanır. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/tr/origin/plazma/administration/reference/configurations/bukkit.md b/tr/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..fb4a952b3 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🪣 Bukkit diff --git a/tr/origin/plazma/administration/reference/configurations/paper/README.md b/tr/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..31670d983 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config klasöründeki her dosyanın amacını öğrenin. +--- + +# 🛩️ Kağıt diff --git a/tr/origin/plazma/administration/reference/configurations/paper/global.md b/tr/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..9550abac1 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🌏 전역 구성 diff --git a/tr/origin/plazma/administration/reference/configurations/paper/world.md b/tr/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..e8810146b --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: paper-world.yml'nin her düğümün ne anlama geldiğini öğrenin. +--- + +# 🏳️ 세계별 구성 + +Dünya çapında diff --git a/tr/origin/plazma/administration/reference/configurations/plazma/README.md b/tr/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..87f6e9542 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config klasöründeki her dosyanın amacını öğrenin. +--- + +# ✨ Plazma diff --git a/tr/origin/plazma/administration/reference/configurations/plazma/global.md b/tr/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..e36dde97a --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🌏 전역 구성 diff --git a/tr/origin/plazma/administration/reference/configurations/plazma/world.md b/tr/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..d968eb334 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🏳️ 세계별 구성 diff --git a/tr/origin/plazma/administration/reference/configurations/plazma/worlds.md b/tr/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a0c49a7a3 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# ✨ Plazma (Dünya Yapısı) diff --git a/tr/origin/plazma/administration/reference/configurations/property.md b/tr/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..f863f2f3b --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties'in her bir düğümünün ne anlama geldiğini öğrenin. +--- + +# 🪨 Server.properties diff --git a/tr/origin/plazma/administration/reference/configurations/pufferfish.md b/tr/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04799e581 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🐡 Balon Balığı diff --git a/tr/origin/plazma/administration/reference/configurations/purpur/README.md b/tr/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..d544bd8a5 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml dosyasındaki her düğümün ne anlama geldiğini öğrenin. +--- + +# 🦑 Purpur diff --git a/tr/origin/plazma/administration/reference/configurations/purpur/global.md b/tr/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..baf9ddd96 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml dosyasındaki her düğümün ne anlama geldiğini öğrenin. +--- + +# 🌏 전역 구성 diff --git a/tr/origin/plazma/administration/reference/configurations/purpur/world.md b/tr/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..917d9c911 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml dosyasındaki her düğümün ne anlama geldiğini öğrenin. +--- + +# 🏳️ 세계별 구성 diff --git a/tr/origin/plazma/administration/reference/configurations/spigot.md b/tr/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..4f35051c6 --- /dev/null +++ b/tr/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🚰 Spigot diff --git a/tr/origin/plazma/administration/reference/permissions.md b/tr/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..d12c49087 --- /dev/null +++ b/tr/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Plazma'nın izinleri hakkında bilgi edinin. +--- + +# 🛡️ İzin + +İzinler, sunucu içinde oyuncuların etkileşimde bulunabileceği kapsamı belirleyen basit bir güvenlik aracıdır. + +İzinleri doğru şekilde kullanmak ve kolayca değiştirmek için [LuckPerms](https://luckperms.net) gibi eklentiler kullanılmalıdır. + +*** + +## Temel izin sistemi anlayışı + +Minecraft'ta temel yönetici izin grupları sağlanmaktadır. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Oyuncu**\ + Genellikle tüm oyunculara verilen bir izin grubudur. +2. **Aracı**\ + Doğma korumasını yok sayabilir. +3. **Dünya Yöneticisi**\ + Tüm dünya yönetimiyle ilgili komutları ve komut bloklarını kullanabilir.\ + Veri paketlerine ve komut bloklarına varsayılan olarak uygulanan bir izin grubudur. +4. **Yönetici**\ + Oyuncu yönetimiyle ilgili tüm komutları kullanabilir. +5. **Baş Yönetici**\ + Sunucu yönetimi de dahil olmak üzere tüm komutları kullanabilir.\ + Konsol ve operatörlere varsayılan olarak uygulanan bir izin grubudur. + +*** + +## İzinleri Ayarlama + +*** + +## Tüm İzinler + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Varsayılan**: `None` + +Oyuncuların varlıkla `eğilip etkileşime geçerek` varlığa binmelerine izin verir. + +Varlığa bindiğinizde, varlığın hareketini `hareket tuşlarıyla` kontrol edebilir ve `zıplama tuşuyla` zıplayabilir veya uçabilirsiniz. + +`(Namespaced Key)` varlığın [Namespaced ID](#user-content-fn-2)[^2] girilir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Varsayılan**: `None` + +Oyuncu bir varlığa binerken, varlığın özel yeteneklerini kullanmasına izin verir. + +Tüm varlıkların özel yetenekleri kullanılamayabilir. Kullanılabilir tüm özel yetenekler için aşağıya bakınız. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +[Plazma Discord](https://plazmamc.org/discord) veya [GitHub Tartışmaları](https://github.com/PlazmaMC/PlazmaBukkit/discussions) üzerinde fikirlerinizi paylaşın! +{% endhint %} + +
+ +Şu anda kullanılabilir özel yetenekleri görüntüle + +- **`crepper`**\ + `Zıplama tuşuna` basarak patlar.\ + Oyuncu, `allow.powered.creeper` iznine sahipse, patlatmak için `zıplama tuşunu` basılı tutabilir. +- **`dolphin`**\ + `Zıplama tuşuna` basarak hızla yüzer. +- **`phantom`**\ + `Zıplama tuşuna` basarak alev atar. +- **`wither`**\ + `Etkileşime` girerse wither başını fırlatır. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/compass` komutu](commands.md#compass) kullanımına izin verir. + +#### `bukkit.command.credits` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/credits (Oyuncu)` komutu](commands.md#credits) kullanımına izin verir. + +İzin adının arkasına `.other` yazarsanız başka oyuncuların kullanmasına izin verir. + +#### `bukkit.command.demo` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/demo (Oyuncu)` komutu](commands.md#demo) kullanımına izin verir. + +İzin adının arkasına `.other` yazarsanız başka oyuncuların kullanmasına izin verir. + +#### `bukkit.command.ping` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/ping (Oyuncu)` komutu](commands.md#ping) kullanımına izin verir. + +İzin adının arkasına `.other` yazarsanız başka oyuncuların kullanmasına izin verir. + +#### `bukkit.command.ram` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/ram` komutu](commands.md#ram) kullanımına izin verir. + +#### `bukkit.command.rambar` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/rambar (Oyuncu)` komutu](commands.md#rambar) kullanımına izin verir. + +İzin adının arkasına `.other` yazarsanız başka oyuncuların kullanmasına izin verir. + +#### `bukkit.command.restart` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/restart` komutu](commands.md#restart) kullanımına izin verir. + +#### `bukkit.command.tps` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/tps` komutu](commands.md#tps) kullanımına izin verir. + +#### `bukkit.command.tpsbar` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/tpsbar (Oyuncu)` komutu](commands.md#tpsbar) kullanımına izin verir. + +İzin adının arkasına `.other` yazarsanız başka oyuncuların kullanmasına izin verir. + +#### `bukkit.command.timings` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/timings` komutu](commands.md#timings) kullanımına izin verir. + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Benzer işlevlere sahip komutları görmek için [Spark](https://spark.lucko.me/docs/Command-Usage)'e bakın. +{% endhint %} + +#### `bukkit.command.uptime` + +- **Varsayılan**: `Dünya Yöneticisi` + +[`/uptime` komutu](commands.md#uptime) kullanımına izin verir. + +#### `minecraft.command.gamemode.(GameMode)` + +- **Varsayılan**: `Dünya Yöneticisi` + +`/gamemode (GameMode) (Oyuncu)` komutu kullanımına izin verir. + +İzin adının arkasına `.other` yazarsanız başka oyuncuların kullanmasına izin verir. + +#### `paper.antixray.bypass` + +- **Varsayılan**: `None` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Bu, her iki tarafın da performansını artırır. + +> X-Ray ayarları hakkında bilgi edinmek için aşağıdaki sayfaya bakın. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Varsayılan**: `None` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Varsayılan**: `None` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Varsayılan**: `None` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Varsayılan**: `None` + +Örsün [MiniMessage Etiketleri](https://docs.advntr.dev/minimessage/format.html) kullanılmasına izin verir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Varsayılan**: `None` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Varsayılan**: `None` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Varsayılan**: `None` + +Oyuncuyu boşta atma kuralı dışında tutar. + +#### `purpur.debug.f3n` + +- **Varsayılan**: `Dünya Yöneticisi` + +Oyuncunun `F3 + N` tuşuyla oyun modunu değiştirmesine izin verir. + +Bu oyun modu için izni yoksa çalışmaz. + +#### `purpur.drop.spawners` + +- **Varsayılan**: `None` + +Yapılandırmada belirlenen öğelerle spawner bloklarını kırarsanız spawner blokları düşer. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Varsayılan**: `None` + +Ender sandığının boyutunu değiştirir. + +`(NumberString)` içine `one`, `two`, `three`, `four`, `five`, `six` girebilirsiniz. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Varsayılan**: `None` + +Ölümsüzlük totemi envanterdeyken çalışmasına izin verir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Varsayılan**: `None` + +Oyuncunun bağlantı sınırını yoksaymasına izin verir. + +#### `purpur.mending_shift_click` + +- **Varsayılan**: `None` + +Oyuncunun `eğilip etkileşime geçtiğinde` tuttuğu öğeyi tamir etmesine izin verir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Varsayılan**: `None` + +Oyuncunun yaratıcıları yerleştirmesine izin verir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Varsayılan**: `None` + +Oyuncunun Nether portalını kullandığında hemen teleport olmasını sağlar. + +#### `purpur.sign.color` + +- **Varsayılan**: `None` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Varsayılan**: `None` + +Levha üzerinde okunabilirlik kodu`(&o)` kullanılmasına izin verir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.levha.stili` + +- **Varsayılan**: `None` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.söndür` + +- **Varsayılan**: `None` + +Oyuncuların TNT patlamasını `etkileşim` ile engellemesine izin verir. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Verilen izinler + +#### `plazma.bypass.ncr-gereksinimi` + +- **Varsayılan**: `None` + +Oyuncuların [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) modu yüklü olmasa bile giriş yapmasına izin verir. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Operatör. + +[^2]: Örnek: `ender_dragon` diff --git a/tr/origin/plazma/adminstration/README.md b/tr/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..2d0fd93ec --- /dev/null +++ b/tr/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Kendi sunucunuzu oluşturmak için Plazma'yı kullanın. +--- + +# ⚒️ Sunucu Yönetim Kılavuzu diff --git a/tr/origin/plazma/adminstration/expert/README.md b/tr/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..2e01135f1 --- /dev/null +++ b/tr/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Plazma'yı profesyonel olarak ele alma yöntemlerini öğrenin. +--- + +# 🎓 Derinlemesine diff --git a/tr/origin/plazma/adminstration/expert/fix-exploits.md b/tr/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..ef8fd2dd7 --- /dev/null +++ b/tr/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Bilinen zayıflıkları ve bunları nasıl çözeceğinizi öğrenin. +--- + +# ⚠️ Bilinen zayıflıklar ve çözüm yolları diff --git a/tr/origin/plazma/adminstration/expert/optimize.md b/tr/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..5a26dc251 --- /dev/null +++ b/tr/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Plazma'yı optimize etme yöntemlerini öğrenin. +--- + +# 🧹 Optimize diff --git a/tr/origin/plazma/adminstration/expert/vanillaize.md b/tr/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..01e3bf8a7 --- /dev/null +++ b/tr/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Paper ve vanilyanın düzeltme yamasını nasıl geri yükleyeceğinizi öğrenin. +--- + +# ↩️ Vanilyalaştırma + +{% hint style="warning" %} + +### Paper, vanilyanın hatalarını çözen çoğu yamada seçenek sunmamaktadır. + +Şu anda Plazma, bu tür hata çözümlerini devre dışı bırakma seçeneği eklemektedir. + +Bu nedenle bu kılavuz henüz tamamlanmamıştır ve her zaman bilgiler değişebilir. +{% endhint %} diff --git a/tr/origin/plazma/adminstration/faq.md b/tr/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..7a4408bb9 --- /dev/null +++ b/tr/origin/plazma/adminstration/faq.md @@ -0,0 +1,42 @@ +--- +description: Sıkça Sorulan Soruları İnceleyin. +--- + +# ⁉️ Sıkça Sorulan Sorular + +{% hint style="info" %} + +### İstediğiniz cevabı bulamadınız mı? + +[Resmi Discord Sunucusu](https://discord.gg/MmfC52K8A8) veya [GitHub Sorunları](https://github.com/PlazmaMC/PlazmaBukkit/issues) üzerinden topluluktan yardım alın! +{% endhint %} + +### Mesaj görüntülenirken çalışmıyor + +Eğer konsolda `no main manifest attribute, in plazma-(version).jar` şeklinde bir çıktı alıyorsanız, indirdiğiniz dosya geliştirme amaçlı bir API dosyasıdır, GitHub sayfasından **Reobf Paperweight**'i indirmeniz gerekmektedir. + +Daha fazla bilgi için aşağıdaki sayfaya bakın. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Her sunucu başlatıldığında uyarılar görüntülenir + +Plazma bazı kararsız yamalar içerir ve her zaman yanlış çalışma olasılığı bulunduğu için sunucu başlatıldığında aşağıdaki uyarıları görüntüler. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Bu uyarılar [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] sistem özelliği kullanılarak devre dışı bırakılabilir. + +Daha fazla bilgi için aşağıdaki sayfaya bakın. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 1.20.1'den itibaren kullanılabilir diff --git a/tr/origin/plazma/adminstration/getting-started/README.md b/tr/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..cd8862f46 --- /dev/null +++ b/tr/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Plazma ile sunucu oluşturma yöntemini öğrenin. +--- + +# 👟 Başlangıç + +Plazma'yı stabil bir şekilde kullanabilmek için, sistem aşağıdaki gereksinimleri karşılamalıdır. + +| | Minimum | Tavsiye Edilen | +| :------: | ------: | -------------: | +| Mimari | x64 | - | +| RAM | 8GB | 16GB | +| Depolama | 1GB | 8GB | +| JRE | 17 | 21 | + +Düzenli yapılandırma dosyası düzenlemesi için, [Visual Studio Code](https://code.visualstudio.com/download) gibi bir düzenleyici kurmanız da iyi olacaktır. + +*** + +## 1. JRE Kurulumu + +Adından da anlaşılacağı gibi, Minecraft: **"Java"** Sürümü Java ile geliştirildiği için, çalıştırmak için JRE[^1] gereklidir. + +Plazma, Mojang Studios'un resmi sunucu platformuna [dayandığı için](#user-content-fn-2)[^2], Plazma'yı kullanmak için de JRE kurmanız gerekmektedir. + +### 1.1 JRE Varlığını Kontrol Etme + +Sistemde JRE'nin kurulu olup olmadığını kontrol etmek için, [Çalıştır](#user-content-fn-3)[^3] penceresine [`cmd /k java --version`](#user-content-fn-4)[^4] yazıp çalıştırın. + +Aşağıdaki gibi bir çıktı alıyorsanız, [2. adıma](setup.md#id-2) geçebilirsiniz. + +{% code title="Doğru Çıktı" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Yukarıdaki gibi bir çıktı alamazsanız veya aşağıdaki gibi bir çıktı alırsanız, JRE yüklü değil demektir veya çok eski olduğu için [1.2 adımı](setup.md#id-1.2) tamamlamanız gerekmektedir. + +{% code title="JRE Yüklü Değil" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE Çok Eski" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JRE Kurulumu + +Bu kılavuzda JRE'nin [türlerinden biri](#user-content-fn-5)[^5] olan Azul Zulu'yu kullanacağız. + +Kurulumu tamamladıktan sonra, kurulumun doğru bir şekilde yapıldığını kontrol etmek için [1.1 adımını](setup.md#id-1.1) tekrarlayın. + +{% tabs %} +{% tab title="Windows" %} + +1. İlk olarak, [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) sitesinden **JDK 21**'i `.msi` formatında indirin. +2. İndirilen kurulum sihirbazını çalıştırın ve `Next`e tıklayın. +3. **Pencerenin sol ortasında görünen menüden `Set JAVA_HOME variable`'ı etkinleştirin ve ardından** `Next`e tıklayın. +4. JRE kurulumunu `Complete` seçeneğiyle tamamlayın. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) sitesinden **JDK 21**'i `.dmg` formatında indirin ve çalıştırarak JRE'yi kurun. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Öncelikle, terminalde aşağıdaki komutu çalıştırarak Azul Zulu deposunu APT'ye ekleyin. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Sonrasında, terminalde aşağıdaki komutu çalıştırarak JRE'yi kurun. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +JRE'yi kurmak için aşağıdaki komutu girin. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Plazma İndirme + +Plazma, çeşitli şekillerdeki yürütülebilir dosyaları sunmaktadır. + +{% hint style="warning" %} + +### Genellikle `Reobf Paperclip` kullanılır. + +Geliştiriciler veya farklı şekiller hakkında meraklı olanlar için aşağıdaki bilgiler vardır.\ +Normal kullanıcılar için [3. adımı](setup.md#id-3) atlayabilirsiniz. +{% endhint %} + +
+ +Daha Fazla Bilgi + +Yürütülebilir dosyanın adı `plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping şekli).jar` olarak belirlenmiştir. + +- **Mapping Şekli**\ + Mapping, Minecraft'ın gerçek kodunu ve karışık kodunu birleştiren bir tür haritadır. + - **Reobf**\ + Yeniden karıştırma, Spigot eşleşmesi olarak da bilinir ve çoğu NMS eklentisinde kullanılır.\ + 1.20.5'ten itibaren kullanımı sona erecektir. + - **Mojmap**\ + Mojang eşleşmesi, vanilla Minecraft eşlemesidir. +- **Sürüm Yöneticisi**\ + Sürüm yöneticisi, sunucu işletimi için gerekli kütüphaneleri sağlayan ve sunucu dosyalarını yamalayan sunucunun başlatıcısı olarak düşünülebilir. + - **Paperclip**\ + PaperMC ekibi tarafından Paper ve diğer türetilmiş platformlar için geliştirilen bir yönetici, kütüphaneleri indirir ve sunucuya yama uygular. + - **Bundler**\ + Vanilla Minecraft sürüm yöneticisidir. + +
+ +*** + +## 3. Başlangıç Komut Dosyası Oluşturma + +Plazma'yı hızlıca başlatmak ve sunucuyu otomatik olarak yeniden başlatmak için, [Başlangıç Komut Dosyası](#user-content-fn-6)[^6] oluşturmanız gerekmektedir. + +[Flags.sh](https://flags.sh) üzerinden başlangıç komut dosyasını [oluşturabilirsiniz.](#user-content-fn-7)[^7]\ +Plazma için [kullanılacak belleği](#user-content-fn-8)[^8] girdikten sonra komut otomatik olarak optimize edilir. + +Sol alt köşedeki indirme düğmesi ile başlangıç komut dosyasını indirebilirsiniz.\ +**İndirdiğiniz başlangıç komut dosyasının işletim sisteminizle uyumlu olduğundan emin olun.** + +*** + +## 4. Dosya Düzenleme + +Şimdi indirdiğiniz başlangıç komut dosyasını ve Plazma'yı yeni bir klasöre taşıyın. + +{% hint style="warning" %} + +### Klasör adı aralıksız olmalı ve İngilizce olmalıdır. + +Aksi takdirde Plazma veya JRE'nin düzgün çalışmayabileceğini unutmayın. +{% endhint %} + +Şimdi başlangıç komut dosyasını çalıştırın. Windows için, Güvenlik Duvarı İzin Seçme Penceresinde, mutlaka **İzin Ver**'i seçmelisiniz. + +*** + +## 5. EULA Onayı + +Başlangıç komut dosyasını bir kez çalıştırdıktan sonra, klasöre `eula.txt` dosyası oluşturulacaktır. + +EULA[^9], [Mojang Studios](#user-content-fn-10)[^10]'un hizmetlerini kullanmak için kabul etmeniz gereken bir lisans sözleşmesidir. + +EULA'yı kabul etmezseniz sunucuyu başlatamaz ve EULA'yı ihlal ederseniz hesabınız askıya alınabilir veya [cezalandırılabilirsiniz.](#user-content-fn-11)[^11] + +EULA'yı kabul etmek için `eula.txt` dosyasındaki `eula=false`'ı `eula=true` olarak değiştirin ve kaydedin. + +*** + +## 6. Dış Erişime İzin Verme (Windows) + +Modern işletim sistemleri, dışarıdan gelen tehlikeli erişimleri engellemek için varsayılan olarak **güvenlik duvarı** ve **yönlendirici** ile dış erişimi engeller. + +Windows için, güvenlik duvarını [3. adımda](setup.md#id-3) onayladığınızdan, sadece port yönlendirmesi yapmanız gerekmektedir. + +{% hint style="info" %} + +### Bu kılavuz, Windows işletim sistemi ve [**UPnP**](#user-content-fn-12)[^12]'yi destekleyen bir yönlendirici varsayılarak yazılmıştır. + +Eğer yönlendiriciniz UPnP'yi desteklemiyorsa, yönlendiriciler farklı panel yapısına sahip olduğundan doğrudan araştırma yapmanız gerekmektedir. + +Ayrıca [Ngrok](https://ngrok.com/) aracılığıyla geçici bir adres oluşturabilirsiniz. +{% endhint %} + +{% hint style="warning" %} + +### Linux veya macOS gibi (yarı) UNIX tabanlı işletim sistemlerinde, farklı güvenlik duvarı hizmetleri için farklı şekilde yapılandırma gerektiğinden doğrudan araştırma yapmanız gerekmektedir. + +{% endhint %} + +### 6.1 Port Yönlendirme Gerekliliğini Kontrol Etme + +Aşağıdaki gibi girin ve çalıştırın. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Çıktı `True` ise burada durabilirsiniz, ancak `False` ise port yönlendirme yapmanız gerekmektedir. + +### 6.2 Sunucuya Bağlanma + +{% tabs %} +{% tab title="Dışarıdan Bağlanma" %} +Port yönlendirme gerekmiyorsa veya zaten başarılı bir şekilde port yönlendirme yaptıysanız, şimdi sunucuya bağlanabilirsiniz. + +Sunucuya bağlanmak için kullanılan adresi [buradan](https://ip.pe.kr/) kontrol edebilirsiniz. +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +Sunucu klasöründeki `purpur.yml` dosyasında, `network.upnp-port-forwarding` özelliğini `true` olarak etkinleştirin. + +Sonrasında sunucuyu yeniden başlattığınızda, Plazma otomatik olarak port yönlendirmesi deneyecektir. + +Aşağıdaki mesaj, konsola yazdırılan UPnP başarısını gösterir ve konsolda `[UPnP] (mesaj)` şeklinde görüntülenir. + +| Mesaj | Anlam | +| ----------------------------------------- | --------------------------------------------- | +| `Başarılı bir şekilde port açıldı (port)` | Port yönlendirme başarılı. | +| `Port (port) zaten açık` | Başka bir hizmet belirtilen portu kullanıyor. | +| `Port açılamadı (port)` | Port yönlendirme başarısız. | +| `Hizmet kullanılamıyor` | Router UPnP'yi desteklemiyor. | + +Sunucu kapanırsa, Plazma otomatik olarak bağlantı noktalarını kapatır. +{% endtab %} + +{% tab title="Ngrok ile Geçici Adres Oluşturma" %} +Ngrok'ü kullanarak kısa süreli testler, toplantılar veya arkadaşlarla oynamak için kullanışlıdır. + +1. [Ngrok websitesi](https://ngrok.com/download) üzerinden `Windows (64-bit)` ZIP dosyasını indirin. +2. İndirdiğiniz Ngrok'ü sunucu klasörüne yerleştirin. +3. [Ngrok kontrol paneli](https://dashboard.ngrok.com/get-started/your-authtoken) üzerinden [kimlik doğrulama belirteci oluşturun](#user-content-fn-13)[^13]. +4. Sunucu klasöründe gösterilen komutu çalıştırın. +5. Çalıştırma betiğinin en üstüne `start /b ngrok tcp --region jp 25565`, en altına `taskkill /f /t /im ngrok.exe` ekleyin. +6. Konsolda gösterilen `Yönlendirme tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` adresinde, `0.tcp.jp.ngrok.io:12345` sunucunun adresidir. +7. Şimdi dışarıdan bu adres aracılığıyla bağlanabilirsiniz. + {% endtab %} + +{% tab title="Yerel Bağlantıdan Erişim" %} +Sunucuya yerel ağdan erişmeye çalışıyorsanız, çalıştır penceresinde `cmd /k ipconfig` komutunu çalıştırarak elde edilen `IPv4 adresi` ile bağlanabilirsiniz. + +Örneğin, komutu çalıştırdıktan sonra aşağıdaki gibi bir çıktı alırsanız, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Burada belirtilen IPv4 adresine `192.168.3.7` ile bağlanmaya çalışırsanız sunucuya yerel ağdan erişebilirsiniz. + +Sunucu ve oyun aynı PC'de çalışıyorsa, `localhost` ile bağlanabilirsiniz. +{% endtab %} +{% endtabs %} + +## 7. Gelişim Aşaması + +Sunucuyu başarıyla başlattıysanız ve sunucunun düzgün çalıştığından eminseniz, şimdi sunucuyu özelleştirme zamanı. + +Sunucuyu nasıl özelleştireceğinizi öğrenmek için aşağıdaki kılavuza göz atın. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Çalışma Ortamı, Java Runtime Environment. + +[^2]: Plazma'nın temeli olan Paper, Spigot'a dayanmaktadır ve Spigot resmi sunucu platformuna dayanmaktadır. + +[^3]: Windows tuşu + R + +[^4]: Linux'ta `java --version` komutunu terminalden çalıştırın. + +[^5]: JRE, Minecraft sunucu platformu gibi çeşitli türlerde olduğu gibi, açık kaynaklı bir projedir. + +[^6]: Genellikle **launcher** olarak bilinir. + +[^7]: "Oto-yeniden başlatma" etkinleştirildiğinde sunucu otomatik olarak yeniden başlatılır. `Control + C` tuşlarına basarak kapatılabilir. + +[^8]: Sistemin yarısından fazlasını aşırı yüklemek önerilmez. + + Örneğin, sistem toplam bellek kapasitesi 8GB ise, 4GB'den fazlasını ayarlamak önerilmez. + +[^9]: Son Kullanıcı Lisans Anlaşması, EULA. Daha fazla bilgi için [Minecraft websitesi](https://www.minecraft.net/ko-kr/usage-guidelines)'ni kontrol edin. + +[^10]: Microsoft Corporation. + +[^11]: Güney Kore'nin oyun endüstrisini teşvik etme yasası Madde 32(1)(9) uyarınca **Kore Microsoft Corporation** yasal olarak dava açabilir. + +[^12]: Universal Plug & Play. Purpur, Plazma'da bulunan bu teknoloji sayesinde sunucu çalışırken otomatik olarak yönlendiriciyle iletişim kurar ve sadece sunucu çalışırken bağlantı noktalarını açar, bu nedenle doğrudan port yönlendirmesi yapmanıza gerek yoktur. + +[^13]: Hesabınız yoksa, Google veya GitHub hesabınızı kullanarak Ngrok'a kaydolun. diff --git a/tr/origin/plazma/adminstration/getting-started/customization.md b/tr/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..f2116f629 --- /dev/null +++ b/tr/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Sunucuyu özelleştirmenin yollarını öğrenin. +--- + +# 🎨 Kullanıcı özelleştirmesi diff --git a/tr/origin/plazma/adminstration/reference/arguments.md b/tr/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..b69253049 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,526 @@ +--- +description: Başlangıç argümanları ve sistem özelliklerini öğrenin. +--- + +# 🎛️ Argümanlar ve Özellikler + +Başlangıç değişkenleri ve sistem özellikleri, Plazma çalıştırması için [kullanılan komutlara](#user-content-fn-1)[^1] eklenen değerlerdir ve\ +Plazma başlatıldıktan sonra değiştirilemeyen değerleri değiştirmenize olanak tanır. + +[Komuta eklenen konuma](#user-content-fn-2)[^2] bağlı olarak **başlangıç argümanları** ve **sistem özellikleri** olarak ayrılır. + +*** + +## Sistem özelliği + +Sistem özellikleri, `-jar`'ın önüne yerleştirilir ve Plazma'nın başlatılması öncesinde JVM tarafından işlenen değerlerdir. + +{% hint style="warning" %} + +### Sistem özelliklerini değiştirmek, Plazma ve JVM'in çalışma şeklini değiştirebilir ve oyun üzerinde büyük etkilere neden olabilir! + +Her sistem özelliğinin ne işe yaradığını kesin olarak bilmiyorsanız, **kesinlikle kullanmayın!** +{% endhint %} + +### Kullanım şekli + +Sistem özellikleri, `java` ve `-jar` arasına Java komut argümanı olarak eklenir. + +Örneğin, `Plazma.dummyProperty` sistem özelliğini uygulamak istediğinizde,\ +şu şekilde girdiğinizde sonraki özelliğe `37` değeri eklenir ve Plazma başlatılır. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`, bu argümanın JVM'e yerleşik olmadığını ve Plazma'ya eklenen özel bir argüman olduğunu belirtir ve + +değer girilmediğinde değer [`true` olarak sabitlenir.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight serisi sunucu platformları, her platformu ayırt etmek için özellik adlarında `.` işaretini içerir. + +Windows Powershell gibi bazı terminalde bu tür argümanlara izin verilmeyebilir, bu nedenle argümanların her iki ucuna da `"` eklenmelidir.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Tüm sistem özellikleri + +#### `convertLegacySigns` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Kullanımdan kaldırılan işaret formatlarını günceller. + +#### `debug.entities` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Varlık bilgileri ile ilgili hata ayıklama günlüklerini etkinleştirir. + +#### `debug.rewriteForIDE` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +IDE'de hata ayıklama bilgilerini doğru şekilde yükleyebilmek için NMS revizyonunu devre dışı bırakır ve,\ +iç versiyon bilgisini otomatik olarak yeniden haritalandırır. + +#### `disable.watchdog` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Spigot'un Watchdog uyarı sistemi devre dışı bırakılır. + +#### `letMeReload` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +`/reload` komutunun yeniden doğrulama iletişim kutusunu devre dışı bırakır. + +{% hint style="danger" %} + +### `/reload` komutu son derece kararsız olduğundan, `/reload` kullanımından sonra oluşan tüm sunucu sorunları kullanıcıya aittir. + +Eğer bir eklenti geliştiricisiyseniz ve eklentiyi güncellemeniz gerekiyorsa, `/reload` yerine hotswap kullanın. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Standart giriş/çıkış sistemini kullanan eklentileri devre dışı bırakır. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Mesajlaşma bileşenlerinde kullanımdan kaldırılan biçim algılandığında uyarır. + +#### `Paper.bypassHostCheck` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Oyuncunun sunucuya bağlandığında sunucunun model eşleşme doğrulamasını devre dışı bırakır. + +#### `Paper.debugDynamicMissingKeys` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +NBT nesnelerinde eksik anahtarlar için hata ayıklama günlüklerini etkinleştirir. + +#### `Paper.debugInvalidSkullProfiles` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Hatalı kafatası profilleri hakkında hata ayıklama günlüklerini etkinleştirir. + +Bu, tüm hatalı kafatası bloklarını konumlarıyla birlikte günlüğe kaydeder. + +#### `Paper.disableChannelLimit` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Oyuncu başına uygulanan 128 adet eklenti kanalının sınırını devre dışı bırakır. + +#### `Paper.disableClassPrioritization` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Eklenti sınıf öncelik sistemini devre dışı bırakır. + +Eklenti gölgelendirmede sorun yaşandığında faydalıdır. + +#### `Paper.disableFlushConsolidate` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Netty flush konsolidasyon sistemini devre dışı bırakır. + +#### `Paper.excessiveTELimit` + +- **Biçimi**: `Integer` +- **Varsayılan Değer**: `750` + +Varlık sayısı belirtilen değerden fazla ise çoklu paketlere bölerek iletilir. + +#### `Paper.filterThreshold` + +- **Biçimi**: `Integer` +- **Varsayılan Değer**: `8192` + +Sunucunun alabileceği maksimum paket boyutunu ayarlar. + +#### `Paper.ignoreJavaVersion` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Java sürüm kontrolünü devre dışı bırakır. + +{% hint style="danger" %} + +### Bu, JVM'in mevcut olmayan kodlara erişmeye çalışmasına neden olabilir! + +Dünya ve diğer tüm dosyalar kalıcı olarak zarar görebilir ve oyunun genel mekanikleri bozulabilir. + +Bu nedenle yaşanan tüm sorunlar sizin sorumluluğunuzdadır ve Plamza bunun için herhangi bir destek sağlamaz. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Biçimi**: `Integer` +- **Varsayılan Değer**: `64` + +Eklenti kanalı adının sınırını belirler. + +#### `Paper.maxSignLength` + +- **Biçimi**: `Integer` +- **Varsayılan Değer**: `80` + +Tabelanın bir satırına girilebilecek maksimum karakter sayısını ayarlar. + +#### `Paper.minPrecachedDatafixVersion` + +- **Biçimi**: `Integer` +- **Varsayılan Değer**: `(Dünya Sürümü) + 1` + +Önce başlanacak dünya güncelleme bilgisinin sürümünü ayarlar. + +Çok sayıda bloğun güncellenmesi gereken durumlarda faydalı olabilir, ancak diğer durumlarda kullanılmaz. + +#### `Paper.parseYamlCommentsByDefault` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `True` + +YAML dosyalarındaki yorumların işlenmesini etkinleştirir. + +#### `Paper.playerConnection.keepAlive` + +- **Biçimi**: `Integer` +- **Varsayılan Değer**: `30` + +Oyuncudan belirli bir süre (saniye cinsinden) hiçbir veri alınmazsa, oyuncuyu atar. + +Genellikle, oyun[^7] sürekli olarak sunucuya [kalp atış sinyali](#user-content-fn-8)[^8] gönderdiğinden, [atılmazlar ancak,](#user-content-fn-9)[^9] oyun yanıt vermezse çakışma olduğunu düşünür ve artık sunucuda oyuncuyu işlemez ve atar. + +#### `Paper.skipServerPropertiesComments` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Sunucu özelliklerinin yorumlarını görmezden gelir. + +#### `Paper.debug-sync-loads` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Senkron yükleme hata ayıklama günlüklerini etkinleştirir. + +#### `Paper.enable-sync-chunk-writes` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Minecraft'un [varsayılan yükleme sistemi](#user-content-fn-10)[^10]'ni etkinleştirir. + +Bu, her bir bloğu sırayla kaydetmeyi gerektirdiği için büyük performans düşüşüne neden olur. + +#### `Paper.explicit-flush` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Ağ kanalının Açıkça Boşaltılmasını etkinleştirir. + +#### `Paper.strict-thread-checks` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Ana iş parçacığında meydana gelen hataları her zaman kaydeder. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Zamanlamalı görevlerin aşırı gecikmeye sahip olması durumunda uyarı verir. + +#### `Paperclip.patchOnly` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `False` + +Varsayılan yürütülebilir dosyayı kullandığınızda, sunucuyu başlatmadan yalnızca yama uygular. + +#### `Plazma.aggressiveOptimize` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` + +{% hint style="warning" %} + +### Bu özellik, 1.20.5'ten sonra başlangıç argümanına taşınacaktır. + +{% endhint %} + +Başlangıçta uygulanan yapılandırma optimizasyonunu daha katı bir şekilde uygular. + +Aktifleştirildiğinde sunucu daha hızlı ve güvenli hale gelir, ancak bazı hataları engelleyebilir veya oyun oynamayı büyük ölçüde etkileyebilir. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` + +Plazma'nın başlatılması sırasında görüntülenen uyarıyı bastırır. + +### Kullanımdan kaldırılan özellik + +Aşağıdaki sistem özellikleri kullanımdan kaldırılmış özelliklerdir. + +#### `timings.bypassMax` + +- **Biçimi**: `Boolean` +- **Varsayılan Değer**: `false` +- **Kullanım dışı**: Timings, Plazma'dan tamamen kaldırıldıktan sonra + +Aikar'ın Timings API'sine iletilen değerin maksimumunun aşıp aşamayacağını belirler. + +Buna rağmen, API'de istisna olmazsa hız sınırlaması uygulanır. + +*** + +## Başlangıç argümanı + +Başlangıç argümanı, `-jar *.jar`'ın arkasına girilir ve Plazma başlatıldığında işlenen bir değerdir. + +### Kullanım şekli + +Sistem özellikleri, `-jar *.jar`'ın arkasına programın komut argümanı olarak girilir. + +Örneğin, `nogui` başlangıç argümanını uygulamak istediğinizde,\ +şu şekilde girerek Plazma, başlatma sırasında `nogui` argümanını işler. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Tüm başlangıç argümanı + +#### `bukkit-settings` + +- **Takma ad**: `b` +- **Varsayılan**: `bukkit.yml` + +[Bukkit yapılandırma dosyası](../reference/configurations/bukkit.md)'nın adını ve konumunu ayarlar. + +#### `command-settings` + +- **Takma ad**: `c` +- **Varsayılan**: `commands.yml` + +[Bukkit komut yapılandırma dosyası](../reference/configurations/bukkit.md)'nın adını ve konumunu ayarlar. + +#### `config` + +- **Takma ad**: `c` +- **Varsayılan**: `server.properties` + +[Sunucu özellikleri](../reference/configurations/property.md) dosyasının adını ve konumunu ayarlar. + +#### `demo` + +Sunucuyu demo dünyasıyla başlatır. + +#### `eraseCache` + +Dünya yükseltme sonrası kalan önbellek dosyalarını siler. + +#### `forceUpgrade` + +Sürümü dikkate almadan dünyayı zorla [yükseltir](#user-content-fn-12)[^12]. + +#### `help` + +- **Takma ad**: `?` + +Plazma'nın tüm başlangıç argümanlarını ve açıklamalarını görüntüler. + +#### `initSettings` + +Yapılandırma dosyasını oluşturur ve sunucuyu kapatır. + +#### `jfrProfile` + +JFR profil oluşturmayı etkinleştirir. + +#### `max-players` + +- **Takma ad**: `s`, `size` +- **Varsayılan**: `(sunucu özellikleri)` + +Kabul edilen maksimum [oyuncu](#user-content-fn-14)[^14] sayısını ayarlar. + +#### `nogui` + +Grafik arayüz panelini devre dışı bırakır. + +#### `nojline` + +JLine'ı devre dışı bırakır ve saf konsolu kullanır. + +#### `online-mode` + +- **Takma ad**: `o` +- **Varsayılan**: `(sunucu özellikleri)` + +Oyuncuları Mojang kimlik doğrulama sunucusuyla doğrulamak için seçim yapar. + +**Velocity ve benzeri proxy'ler kullanılmadığı takdirde [EULA](../getting-started/README.md#id-5) ihlali nedeniyle cezalandırılabilirsiniz.** + +#### `paper-settings` + +- **Takma ad**: `paper` +- **Varsayılan**: `paper.yml` + +{% hint style="warning" %} + +### Bu argüman 1.19.4'ten sonra kullanımdan kaldırılmıştır + +{% endhint %} + +Kullanımdan kaldırılan PaperSpigot yapılandırma dosyasının konumunu ayarlar. + +Bu, mevcut yapıyı yeni bir yapılandırma dosyasına taşımak için kullanılır ve daha sonra kullanılmaz. + +#### `paper-settings-directory` + +- **Takma ad**: `paper-dir` +- **Varsayılan**: `config` + +[Paper yapılandırma dosyası](../reference/configurations/paper/README.md)'nın bulunduğu klasörün adını ve konumunu ayarlar. + +#### `plazma-settings-directory` + +- **Takma ad**: `plazma-dir` + +[Plazma yapılandırma dosyası](../reference/configurations/plazma/README.md)'nın bulunduğu klasörün adını ve konumunu ayarlar. + +#### `plugins` + +- **Takma ad**: `p` +- **Varsayılan**: `plugins` + +Eklenti klasörünün konumunu ayarlar. + +#### `pufferfish-settings` + +- **Takma ad**: `pufferfish` +- **Varsayılan**: `pufferfish.yml` + +[Pufferfish yapılandırma dosyası](../reference/configurations/pufferfish.md)'nın adını ve konumunu ayarlar. + +#### `purpur-settings` + +- **Takma ad**: `purpur` +- **Varsayılan**: `purpur.yml` + +[Purpur yapılandırma dosyası](../reference/configurations/purpur/README.md)'nın adını ve konumunu ayarlar. + +#### `safeMode` + +(Güvenli Mod) Sunucuyu tamamen saf bir şekilde başlatır. + +#### `server-ip` + +- **Takma ad**: `h`, `host` +- **Varsayılan**: `(sunucu özellikleri)` + +Sunucunun ana bilgisayar adını veya [internet protokolü](#user-content-fn-13)[^13] adresini ayarlar. + +#### `server-port` + +- **Takma ad**: `p`, `port` +- **Varsayılan**: `(sunucu özellikleri)` + +Sunucunun bağlantı noktasını ayarlar. + +#### `server-name` + +- **Varsayılan**: `A Plazma Sunucusu` + +Sunucunun adını ayarlar. + +#### `spigot-settings` + +- **Takma ad**: `S` +- **Varsayılan**: `spigot.yml` + +[Spigot yapılandırma dosyası](../reference/configurations/spigot.md)'nın adını ve konumunu ayarlar. + +#### `version` + +- **Takma ad**: `v` + +Plazma sürümünü görüntüler. + +#### `world-dir` + +- **Takma ad**: `W`, `evren`, `dünya-konteyneri` +- **Varsayılan**: `(sunucu klasörü)` + +Dünya dosyalarının kaydedildiği konumu ayarlar. + +#### `world-name` + +- **Takma ad**: `w`, `dünya` +- **Varsayılan**: `(sunucu özellikleri)` + +Dünya dosyasının adını ayarlar. + +*** + +[^1]: `java (...) -jar sunucu.jar (...)` + +[^2]: Eklenen konuma bağlı olarak argüman işleme konumu değişir. + +[^3]: Örneğin, `Plazma.iKnowWhatIAmDoing` değerini `true` olarak ayarlamak (etkinleştirmek) istediğinizde, `-DPlazma.iKnowWhatIAmDoing=true` yerine `-DPlazma.iKnowWhatIAmDoing` yazmak yeterlidir ve aynı şekilde çalışır. + +[^4]: Örneğin, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Olay algılayıcı. + +[^6]: Olay algılayıcı. + +[^7]: İstemci. + +[^8]: Kalp atışı gibi sunucu ile düzgün bağlantı kurulduğunu belirten sinyal. + +[^9]: Purpur'un AFK atma özelliği, oyundan ayrılan oyuncuları da atmanıza olanak tanır. + +[^10]: Senkron Chunk Yazma Sistemi, Sync Chunk Write System. + +[^11]: `UYARI! Plazma beklenmedik sorunlara neden olabilir, bu nedenle halka açık bir sunucuda kullanmadan önce detaylı bir şekilde test ettiğinizden emin olun.` + +[^12]: Oyundaki `dünya optimizasyonu` da aynı prensiple çalışır. + +[^13]: Internet Protokolü, IP. + +[^14]: `Seviye 2` ve üzeri yöneticiler hariç tutulur. diff --git a/tr/origin/plazma/adminstration/reference/commands.md b/tr/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..de3cae12a --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Plazma'da kullanılabilen komutları öğrenin. +--- + +# 🖥️ Komutlar diff --git a/tr/origin/plazma/adminstration/reference/configurations/bukkit.md b/tr/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..fb4a952b3 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: bukkit.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🪣 Bukkit diff --git a/tr/origin/plazma/adminstration/reference/configurations/paper/README.md b/tr/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..31670d983 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: config klasöründeki her dosyanın amacını öğrenin. +--- + +# 🛩️ Kağıt diff --git a/tr/origin/plazma/adminstration/reference/configurations/paper/global.md b/tr/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..232b883f7 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: paper-global.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🛩️ Kağıt (Global Yapı) diff --git a/tr/origin/plazma/adminstration/reference/configurations/paper/world.md b/tr/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..c6243e363 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: paper-world.yml'nin her düğümün ne anlama geldiğini öğrenin. +--- + +# 🛩️ Kağıt (Dünya Bazlı Yapı) diff --git a/tr/origin/plazma/adminstration/reference/configurations/plazma/README.md b/tr/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..87f6e9542 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: config klasöründeki her dosyanın amacını öğrenin. +--- + +# ✨ Plazma diff --git a/tr/origin/plazma/adminstration/reference/configurations/plazma/global.md b/tr/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..5c9e9ffb8 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: plazma-global.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# ✨ Plazma (global configuration) diff --git a/tr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/tr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..911a066d1 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Dünya Çapında Yapılandırma diff --git a/tr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/tr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..a0c49a7a3 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: plazma-world.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# ✨ Plazma (Dünya Yapısı) diff --git a/tr/origin/plazma/adminstration/reference/configurations/property.md b/tr/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..f863f2f3b --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: server.properties'in her bir düğümünün ne anlama geldiğini öğrenin. +--- + +# 🪨 Server.properties diff --git a/tr/origin/plazma/adminstration/reference/configurations/pufferfish.md b/tr/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..04799e581 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🐡 Balon Balığı diff --git a/tr/origin/plazma/adminstration/reference/configurations/purpur/README.md b/tr/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..d544bd8a5 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml dosyasındaki her düğümün ne anlama geldiğini öğrenin. +--- + +# 🦑 Purpur diff --git a/tr/origin/plazma/adminstration/reference/configurations/purpur/global.md b/tr/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..5046c6e9a --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml dosyasındaki her düğümün ne anlama geldiğini öğrenin. +--- + +# 🦑 Mor (global yapı) diff --git a/tr/origin/plazma/adminstration/reference/configurations/purpur/world.md b/tr/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..2a668dd5a --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: purpur.yml dosyasındaki her düğümün ne anlama geldiğini öğrenin. +--- + +# 🦑 Morina (Dünya düzeni) diff --git a/tr/origin/plazma/adminstration/reference/configurations/spigot.md b/tr/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..4f35051c6 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: spigot.yml'nin her düğümünün ne anlama geldiğini öğrenin. +--- + +# 🚰 Spigot diff --git a/tr/origin/plazma/adminstration/reference/permissions.md b/tr/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..90ce9c1d5 --- /dev/null +++ b/tr/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Plazma'nın izinleri hakkında bilgi edinin. +--- + +# 🛡️ İzin diff --git a/tr/origin/plazma/developers.md b/tr/origin/plazma/developers.md new file mode 100644 index 000000000..a0a8ea2b8 --- /dev/null +++ b/tr/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Üçüncü taraf projeler geliştirmek için Plazma'yı kullanın. +--- + +# ⚙️ Geliştirici Kılavuzu diff --git a/tr/origin/thunderbolt/README.md b/tr/origin/thunderbolt/README.md new file mode 100644 index 000000000..d47ad058c --- /dev/null +++ b/tr/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt, Plazma tabanlı bir sunucu platformudur ve Thunderbolt, deneysel yamaları Flavor olarak ayırarak doğrudan kullanmanıza olanak tanır. +--- + +# 🌩️ Thunderbolt Kullanım Kılavuzu diff --git a/tr/origin/volt/README.md b/tr/origin/volt/README.md new file mode 100644 index 000000000..9cdd96c85 --- /dev/null +++ b/tr/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt, kendi Paperweight sunucu platformunu geliştirmek için Plazma tabanlı açık kaynaklı bir şablon olan Volt'u kullanabilirsiniz. +--- + +# ⚡ Volt Geliştirme Rehberi diff --git a/uk/origin/README.md b/uk/origin/README.md new file mode 100644 index 000000000..f2de9dea3 --- /dev/null +++ b/uk/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Якщо у вас є питання, будь ласка, задайте їх через Discord або обговорення на GitHub. +--- + +# 🏠 Ласкаво просимо до порталу документів + +{% нагадування стилю="інформація" %} + +**Документація Plazma наразі перебуває в стані машинного перекладу.** + +[![Статус перекладу](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +[https://translate.plazmamc.org/](https://translate.plazmamc.org/) зацікавлених у вдосконаленні документації можуть приєднатися до перекладу на [https://translate.plazmamc.org/](https://translate.plazmamc.org/) і покращити документацію. + +{% кінець нагадування %} + +### Якщо виникли проблеми з використанням Plazma? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Якщо вас цікавить Thunderbolt, зверніть увагу? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt для створення власної платформи сервера? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` Потрібна більш докладна інформація щодо Minecraft? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/uk/origin/SUMMARY.md b/uk/origin/SUMMARY.md new file mode 100644 index 000000000..3fccf21fb --- /dev/null +++ b/uk/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Зміст + +- [🏠 Ласкаво просимо до порталу документів](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Документація з використання Plazma](plazma/README.md) +- [❓ Що таке Plazma?](plazma/about/README.md) + - [⬇️ Завантаження](plazma/about/downloads.md) + - [✅ Статус підтримки версій](plazma/about/supported-versions.md) +- [⚒️ Керування сервером Посібник](plazma/administration/README.md) + - [👟 Початок роботи](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Посилання](plazma/administration/reference/README.md) + - [🖥️ Команди](plazma/administration/reference/commands.md) + - [🛡️ Дозволи](plazma/administration/reference/permissions.md) + - [🎛️ Аргументи та властивості](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Властивість](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Глобальна конфігурація](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Світові конфігурації](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Глобальна конфігурація](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Світові конфігурації](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Глобальна конфігурація](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Світові конфігурації](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Експертне вивчення](plazma/administration/expert/README.md) + - [🧹 Оптимізація](plazma/administration/expert/optimize.md) + - [🔀 Проксі](plazma/administration/expert/proxy.md) + - [↩️ Ванілізація](plazma/administration/expert/vanillaize.md) + - [🩻 Блокування X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Уразливості та їх виправлення](plazma/administration/expert/fix-exploits.md) + - [⁉️ Часті запитання](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Посібник для розробників](plazma/developers.md) + - [✏️ Співпрацювати](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Посібник з використання Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Посібник з розробки Volt](volt/README.md) + +## Різне + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Завантажити повний перегляд](plazma/about/downloads-all.md) diff --git a/uk/origin/miscellaneous/README.md b/uk/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/uk/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/uk/origin/plazma/README.md b/uk/origin/plazma/README.md new file mode 100644 index 000000000..08c555706 --- /dev/null +++ b/uk/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma - це відкрите серверне програмне забезпечення для Minecraft: Java Edition з експериментальною оптимізацією на основі паперу та різними індивідуалізованими геймплейними механізмами." +--- + +# ✨ Документація з використання Plazma + +## 👋 Ласкаво просимо до документації Plazma + +Ласкаво просимо до документації Plazma! + +{% нагадування стилю="інформація" %} + +**Чи не вдається вирішити проблему за допомогою посібника?** + +[Офіційний сервер Discord](https://discord.gg/MmfC52K8A8) або [Обговорення на GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - задавайте питання спільноті! + +{% кінець нагадування %} + +### Про Plazma + +> Дізнайтеся, що таке Plazma серверна платформа. + +{% зміст-посилання url="про/" %} +[про](про/) +{% кінець-змісту %} + +### Для адміністраторів + +> Створіть свій власний сервер за допомогою Plazma. + +{% content-ref url="administration/" %} +[адміністрування](administration/) +{% endcontent-ref %} + +### Для розробників + +> Розробляйте сторонні проекти за допомогою Plazma. + +{% зміст-посилання url="розробники.md" %} +[розробники.md](розробники.md) +{% кінець-змісту %} + +*** diff --git a/uk/origin/plazma/about/README.md b/uk/origin/plazma/about/README.md new file mode 100644 index 000000000..3449ad938 --- /dev/null +++ b/uk/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: Дізнайтеся, що таке Plazma серверна платформа. +--- + +# ❓ Що таке Plazma? + +- **Plazma** - це серверна платформа, яка базується на [Paper](https://github.com/PaperMC/Paper) та бере лише переваги з [Andromeda](https://github.com/EarendelArchived/Andromeda) та [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Ми постійно прагнемо забезпечувати високу стабільність, потужну продуктивність, швидкі оновлення та широкий функціонал. + +## 📋 Мета Plazma + +- Ми прагнемо стати серверною платформою зі швидкими оновленнями та високою стабільністю. +- Ми прагнемо забезпечити широкий функціонал та потужну продуктивність, недоступні для платформ модів. +- Ми прагнемо створити вільну платформу, на якій можна налаштовувати навіть патчі ваніли. + +## ⚙️ Основні функції + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Найшвидші оновлення**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) забезпечує, що патчі Plazma завжди залишаються актуальними, надаючи найшвидші оновлення серед серверних платформ на базі Paper. +6. **Оптимізація базових конфігураційних файлів**\ + Базові конфігураційні файли вже оптимізовані, тому вам не потрібно самостійно оптимізувати їх. +7. **Систематична робота багатопотокових процесів**\ + Асинхронізація системних механізмів, не пов'язаних з механікою гри, допомагає зменшити затримки та оптимізувати сервер. +8. **Блокування непотрібного використання простору**\ + Об'єднання даних зі схожими значеннями дозволяє зменшити використання пам'яті. + +## ✨ Використання + +- **Платформа, яка правильно обробляє складні плагіни**\ + Plazma використовується на сервері розробника [IPECTER](https://github.com/IPECTER).\ + Незважаючи на власні плагіни, що працюють з NMS та рефлексією, і велику кількість обсягових пакетів даних,\ + вона приймає понад 100 гравців без падіння продуктивності. +- **Платформа зі стабільною продуктивністю на сервері RPG**\ + Склали 100 гравців на одному кластері без падіння TPS і 250 гравців на 4 кластерах могли грати комфортно. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Багато стрімерів обирають платформу**\ + Багато стрімерів використовують цей відеоблог як відро для участі глядачів. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Завантажити + +На цій сторінці ви можете завантажити Plazma. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Бажаєте дізнатися більше про підтримувані версії? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Плагіни для Bukkit, CraftBukkit, Spigot та Paper, Pufferfish, Purpur. + +[^2]: Нижче Microsoft Corporation. + +[^3]: Вимкнувши систему скарг на чат, ви можете обробляти чат лише на сервері та уникнути відстеження чату Mojang. + +[^4]: Час, коли гра зупиняється для роботи системного механізму. diff --git a/uk/origin/plazma/about/downloads-all.md b/uk/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..80293efbd --- /dev/null +++ b/uk/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Завантажити весь вміст файлу Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% кінець нагадування %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Версія | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/uk/origin/plazma/about/downloads.md b/uk/origin/plazma/about/downloads.md new file mode 100644 index 000000000..f46bd9521 --- /dev/null +++ b/uk/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Завантажте Plazma прямо зараз та випробуйте його особисто. +--- + +# ⬇️ Завантажити + +#### Бажаєте дізнатися більше про підтримувані версії? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% нагадування стилю="інформація" %} + +**Нижче наведено виконувальний файл для звичайного користувача.** + +Якщо ви є розробником і вам потрібен інший тип файлу, будь ласка, перегляньте нижченаведену сторінку. + +{% кінець нагадування %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВерсіяЗавантажити
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + завантажити +
1.20.1 + Завантажити +
1.19.4 + Завантажити +
+ +*** diff --git a/uk/origin/plazma/about/patches-list.md b/uk/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..943365302 --- /dev/null +++ b/uk/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про всі функції, що були додані до Plazma. +--- + +# 📑 Включені патчі diff --git a/uk/origin/plazma/about/supported-versions.md b/uk/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..df967ec37 --- /dev/null +++ b/uk/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Дізнайтеся, які версії підтримує Minecraft: Java Edition в Plazma." +--- + +# ✅ Статус підтримки версії + +{% нагадування стилю="інформація" %} + +**Plazma розробляється з версії 1.19.4 і вище, версії нижче 1.19.4 не розробляються.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% кінець нагадування %} + +[wtr]: +[idv]: +[atv]: https://badge.plazmamc.org/2/підтримується +[fse]: +[eol]: +[ukn]: https://badge.plazmamc.org/0/немає%20інформації +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/звичайний +[100]: https://badge.plazmamc.org/percent/100 + +![очікується випуск][wtr] ![в розробці][idv] ![підтримується][atv] ![припинення підтримки функції][fse] ![підтримка завершена][eol] + +| Версія | Стабільність та підтримка функцій | Стан збірки | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![стан збірки](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![стан збирання](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![стан збирання](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/uk/origin/plazma/administration/README.md b/uk/origin/plazma/administration/README.md new file mode 100644 index 000000000..a39f47288 --- /dev/null +++ b/uk/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Створіть свій власний сервер за допомогою Plazma. +--- + +# ⚒️ Керівництво з управління сервером diff --git a/uk/origin/plazma/administration/diagnosis/README.md b/uk/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..1038a4547 --- /dev/null +++ b/uk/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, як вирішувати проблеми, коли вони виникають. +--- + +# 🧾 진단 diff --git a/uk/origin/plazma/administration/diagnosis/plugins.md b/uk/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..5d9c01383 --- /dev/null +++ b/uk/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, як вирішити проблеми з нормальною роботою плагіна. +--- + +# 📜 플러그인 diff --git a/uk/origin/plazma/administration/expert/README.md b/uk/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..84fa43e96 --- /dev/null +++ b/uk/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про професійний спосіб роботи з Plazma. +--- + +# 🎓 Поглиблене diff --git a/uk/origin/plazma/administration/expert/fix-exploits.md b/uk/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..38a966ef3 --- /dev/null +++ b/uk/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про відомі уразливості та способи їх вирішення. +--- + +# ⚠️ Відомі уразливості та методи вирішення diff --git a/uk/origin/plazma/administration/expert/optimize.md b/uk/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..0339a732f --- /dev/null +++ b/uk/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, як оптимізувати Plazma. +--- + +# 🧹 Оптимізація diff --git a/uk/origin/plazma/administration/expert/proxy.md b/uk/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..3f36f696c --- /dev/null +++ b/uk/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, як безпечно налаштувати платформу проксі "Velocity". +--- + +# 🔀 Проксі diff --git a/uk/origin/plazma/administration/expert/vanillaize.md b/uk/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..a7afeec7a --- /dev/null +++ b/uk/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Дізнайтеся, як відновити патч Paper та ваніль. +--- + +# ↩️ Ванілізація + +{% hint style="warning" %} + +**Paper не містить вибору для більшості патчів, які вирішують помилки Vanilla.** + +Наразі Plazma розробляє можливість вимкнути такі виправлення помилок. + +Тому цей посібник все ще у процесі розробки і інформація може змінюватися. + +{% кінець нагадування %} diff --git a/uk/origin/plazma/administration/expert/xray.md b/uk/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..e322e4740 --- /dev/null +++ b/uk/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про різні вбудовані методи блокування рентгенів. +--- + +# 🩻 Блокування рентгенів diff --git a/uk/origin/plazma/administration/faq.md b/uk/origin/plazma/administration/faq.md new file mode 100644 index 000000000..9094ab232 --- /dev/null +++ b/uk/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Дізнайтеся більше про часто задавані питання. +--- + +# ⁉️ Часті питання + +{% нагадування стилю="інформація" %} + +**Не можна знайти бажану відповідь?** + +[Офіційний сервер Discord](https://discord.gg/MmfC52K8A8) або [Обговорення на GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - задавайте питання спільноті! + +{% кінець нагадування %} + +### Plazma не запускається + +Якщо у консолі виводиться `no main manifest attribute, in plazma-(version).jar`,\ +завантажений файл є файлом API для розробників, вам потрібно завантажити **Reobf Paperweight** зі сторінки GitHub. + +Для отримання докладної інформації див. наступну сторінку. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Під час запуску сервера відображається попередження + +Plazma містить деякі нестабільні патчі і завжди може працювати некоректно, тому виводить попередження під час запуску сервера. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Це попередження можна вимкнути за допомогою системного властивості [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Для отримання докладної інформації див. наступну сторінку. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Доступно з версії 1.20.1 diff --git a/uk/origin/plazma/administration/getting-started/README.md b/uk/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..2a3f6a184 --- /dev/null +++ b/uk/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Дізнайтеся, як створити сервер за допомогою Plazma. +--- + +# 👟 Початок + +Для стабільного використання Plazma система повинна відповідати наступним вимогам. + +| | Мінімальні | Рекомендовані | +| :----------------: | ---------- | ------------- | +| Архітектура | x64 | - | +| ОЗП | 8 ГБ | 16 ГБ | +| Простір зберігання | 1 ГБ | 8 ГБ | +| JDK | 17 | 21 | + +Для зручного редагування файлів налаштувань, рекомендується встановити редактор, такий як [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Правильний вивід" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java' не є внутрішньою або зовнішньою командою, виконуваним програмою або +пакетним файлом. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Спочатку завантажте **JDK 21** у форматі `.msi` з [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu). +2. Запустіть завантажений майстер встановлення та натисніть `Next`. +3. Після цього активуйте `Set JAVA_HOME variable` в центрі лівої частини вікна та натисніть `Next`. +4. Натисніть `Install`, щоб завершити встановлення JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Потім виконайте наступну команду в терміналі для встановлення JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Завантаження Plazma + +Plazma надає різноманітні виконавчі файли. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% кінець нагадування %} + +
+ +Дізнатися більше + +Назва виконавчого файлу визначається як `plazma-(менеджер-версій)-1.20.4-R0.1-SNAPSHOT-(форма-картування).jar`. + +- **Форма картування**\ + Карта мапує реальний код Minecraft і змішаний код, подібно до карти. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-маппинг, це маппинг для ванільного Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Менеджер версій**\ + Менеджер версій - це лаунчер сервера, який необхідний для запуску сервера та патчення файлів сервера. + - **Paperclip**\ + Розроблений командою PaperMC для Paper та інших похідних платформ, завантажує бібліотеки та застосовує патчі на сервері. + - **Bundler**\ + Менеджер версій Vanilla Minecraft. + +
+ +*** + +## 3. Створення початкового скрипта + +Для простого запуску Plazma та автоматичного перезапуску сервера потрібно створити [початковий скрипт](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Можна завантажити початковий скрипт, натиснувши кнопку завантаження у лівому нижньому кутку.\ +**Переконайтеся, що завантажений початковий скрипт відповідає вашій операційній системі.** + +*** + +## 4. Очищення файлів + +Тепер перемістіть завантажений початковий скрипт та Plazma в нову теку. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% кінець нагадування %} + +Тепер запустіть початковий скрипт. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Погодження з EULA + +Після запуску початкового скрипта у теку буде створено `eula.txt`. + +EULA[^9] - це ліцензійна угода, яку потрібно погодитися з Mojang Studios[^10], щоб користуватися їхніми послугами. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% кінець нагадування %} + +Для погодження з EULA змініть `eula=false` на `eula=true` у файлі `eula.txt` та збережіть зміни. + +*** + +## 6. Дозвіл на зовнішні підключення (Windows) + +Сучасні операційні системи за замовчуванням блокують зовнішні доступи за допомогою **брандмауера** та **маршрутизатора**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Якщо ваш маршрутизатор не підтримує UPnP, вам потрібно дослідити, які панелі керування має ваш маршрутизатор. + +Також можна створити тимчасову адресу через [Ngrok](https://ngrok.com/). +{% кінець нагадування %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Перевірка необхідності перенаправлення портів + +Введіть наступне у вікні виклику команд та запустіть. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Якщо вивід `True`, то все в порядку, якщо `False`, потрібно налаштувати перенаправлення портів. + +### 6.2 Підключення до сервера + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Адреса для підключення до сервера може бути знайдена [тут](https://ip.pe.kr/) +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Після цього, після перезапуску сервера, Plazma автоматично спробує налаштувати перенаправлення портів. + +Нижче наведено варіанти повідомлень, які виводяться в консолі в залежності від успішності UPnP, вони виглядають як `[UPnP] (повідомлення)`. + +| Повідомлення | Значення | +| --------------------------------- | ------------------------------------------------------- | +| `Успішно відкритий порт (порт)` | Успішне перенаправлення порту. | +| `Порт (порт) вже відкритий` | Інший сервіс вже використовує цей порт. | +| `Не вдалося відкрити порт (порт)` | Невдале перенаправлення порту. | +| `Сервіс недоступний` | Маршрутизатор не підтримує UPnP. | + +Після завершення роботи сервера, Plazma автоматично закриє порт. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Завантажте ZIP-файл `Windows (64-bit)` з [веб-сайту Ngrok](https://ngrok.com/download). +2. Розпакуйте завантажений Ngrok у папці сервера. +3. Створіть [токен автентифікації](https://dashboard.ngrok.com/get-started/your-authtoken) на панелі керування Ngrok. +4. Виконайте команду, яка відображається у вікні командного рядка папки сервера. +5. Додайте `start /b ngrok tcp --region jp 25565` у верхню частину сценарію запуску та `taskkill /f /t /im ngrok.exe` в нижню частину. +6. Адреса сервера буде `0.tcp.jp.ngrok.io:12345`, яка відображається у верхній частині консолі як `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`. +7. Тепер ви можете підключитися до сервера за допомогою цієї адреси зовнішнього доступу. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Наприклад, якщо ви побачите такий результат після виконання команди, + +```log +Windows IP Configuration + +Ethernet adapter Ethernet: + + Приєднаний суфікс DNS. . . . . . . : + IPv4-адреса. . . . . . . . . . : 192.168.3.7 + Маска підмережі. . . . . . . . : 255.255.255.0 + Основний шлюз. . . . . . . . : 192.168.3.1 + +``` + +Ви можете підключитися до сервера з локальної мережі, використовуючи `192.168.3.7`, який відображається як IPv4-адреса. + +Якщо сервер і гра запускаються на одному ПК, ви можете підключитися за допомогою `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Розвиватися + +Якщо сервер успішно запущено і працює належним чином, тепер час налаштувати його відповідно до вашого бажання. + +Дізнайтеся, як налаштувати сервер за допомогою наведеного нижче посібника. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma, що базується на Paper, використовує Spigot, який, у свою чергу, базується на офіційній серверній платформі. + +[^3]: Комбінація клавіш Windows + R + +[^4]: У Linux виконайте `java --version` у терміналі + +[^5]: JRE є одним з відкритих проектів існує кілька видів, так само як і для серверів Minecraft. + +[^6]: Зазвичай відомий як **запускач**. + +[^7]: Активувавши "Автоматичний перезапуск", сервер буде перезапущений автоматично. Для завершення роботи введіть `Control + C`. + +[^8]: Не рекомендується встановлювати більше половини від загальної кількості системної пам'яті. + + Наприклад, якщо загальний обсяг пам'яті системи становить 8 ГБ, то не рекомендується встановлювати більше 4 ГБ. + +[^9]: EULA, Ліцензійна угода з кінцевим користувачем. Докладніше на [веб-сайті Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорація Microsoft. + +[^11]: Згідно зі статтею 32 пунктом 1 пунктом 9 Закону Кореї про просування галузі гральної промисловості, **Корейська компанія Microsoft** може подати судову скаргу. + +[^12]: Universal Plug & Play. Purpur в Plazma використовує цю технологію для автоматичного спілкування з маршрутизатором лише тоді, коли сервер працює, тому не потрібно налаштовувати перенаправлення портів вручну. + +[^13]: Якщо у вас немає облікового запису, ви можете зареєструватися в Ngrok за допомогою облікового запису Google або GitHub. diff --git a/uk/origin/plazma/administration/getting-started/customization.md b/uk/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..c6772454b --- /dev/null +++ b/uk/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,123 @@ +--- +description: Дізнайтеся, як налаштувати сервер. +--- + +# 🎨 Налаштування користувача + +Причина використання модифікованої платформи сервера, такої як Plazma, замість офіційної серверної платформи, яку надає Mojang Studios, полягає в тому, що це надає можливість потужного **налаштування**. + +Нижче наведено кілька способів налаштування та використання Plazma. + +## Зміна конфігурації + +Одним із найбільш базових способів налаштування Plazma є зміна конфігурації. + +Plazma надає потужні налаштування, починаючи від механіки гри до властивостей мобів. + +Для отримання докладної інформації про конфігурацію Plazma, перегляньте сторінку нижче. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Використання плагінів + +{% hint style="success" %} + +**Plazma підтримує всі плагіни на основі Paper.** + +У випадку Spigot плагінів, з 1.20.5 через зміни в мапінгу Paper, деякі можуть не працювати, +але більшість плагінів на основі Paper, Pufferfish та Purpur працюють на Plazma, +і якщо вони не працюють належним чином, то це помилка Plazma, тому негайно [повідомте про це.](../diagnosis/plugins.md) + +{% кінець нагадування %} + +Це головна причина використання Plazma та найпотужніший спосіб користування Plazma. +Міцна екосистема плагінів Plazma дозволяє легко налаштувати сервер. + +Існує кілька способів пошуку та завантаження плагінів. Деякі плагіни +завантажуються на публічні сервіси сховищ та деякі на GitHub або власний +сайт. + +{% hint style="caution" %} + +**Плагіни можуть мати прямий доступ до системи!** + +Перед застосуванням плагіну завжди перевіряйте його на безпеку за допомогою сервісів, таких як VirusTotal, +або завантажуйте плагіни з надійних сервісів. + +{% кінець нагадування %} + +Існує кілька сервісів для завантаження плагінів. Зокрема, [Форум SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) та інші сервіси перевіряють плагіни перед завантаженням, щоб лише безпечні плагіни були поширені. + +### Застосування плагінів + +Якщо ви вже завантажили плагін, тепер час його застосувати. + +1. Плагіни мають формат `.jar` або `Java Executable File`.\ + Деякі плагіни можуть бути у вигляді архіву, у такому випадку + розпакуйте архів, якщо в назві є `bukkit`, `spigot` або `paper`, + то використовуйте файл, в якому присутній `fat`. +2. Помістіть завантажений файл у папку `plugins` у папці сервера та перезапустіть сервер. +3. Після запуску Plazma з'явиться новий вміст у консолі. + Це означає, що Plazma успішно завантажив плагіни. +4. Навіть якщо Plazma успішно завантажив плагіни, вони можуть не почати працювати. + Використовуючи команду `/plugins`, ви можете переглянути завантажені на сервер плагіни. + Якщо назва встановленого плагіна не червона, + а зелена, це означає, що плагін успішно завантажено. + +Якщо плагін не завантажується належним чином, ви можете знайти рішення на цій сторінці. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Використання датапаків + +Датапаки - це спосіб користування Minecraft, подібний до [ресурс-паків](#user-content-fn-1)[^1]. + +З допомогою датапаків ви можете змінювати частини гри, додаючи нові монстри та виклики. + +{% hint style="caution" %} + +**Датапаки можуть пошкодити світ!** + +Деякі несправні датапаки можуть пошкодити світ без можливості відновлення. + +Тому перед застосуванням датапаку рекомендується зробити резервну копію світу. + +{% кінець нагадування %} + +Датапаки також можна завантажити з різних сервісів, таких як [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) та інші. + +Після завантаження датапаку його можна застосувати, помістивши його у папку `datapacks` у папці світу сервера. +Якщо папки немає, створіть її та додайте датапак. + +{% hint style="warning" %} + +**Деякі [датапаки](#user-content-fn-2)[^2] можуть не застосовуватися належним чином при першому застосуванні.** + +У такому випадку рекомендується **2 рази** перезапустити сервер. + +{% кінець нагадування %} + +Датапаки можуть легко пошкодитися при оновленні версії Minecraft. + +Особливо, якщо датапак повністю пошкоджений, це може спричинити збій сервера, тому +перед оновленням сервера важливо провести достатні тести. + +{% нагадування стилю="інформація" %} + +**Після команди запуску сервера введіть `safeMode`, щоб деактивувати всі датапаки та запустити сервер.** + +[Для отримання додаткової інформації дивіться `Референції > Аргументи та властивості`.](../reference/arguments.md) + +{% кінець нагадування %} + +Застосовані датапаки можна переглянути за допомогою команди `/datapack list`. + +*** + +[^1]: Або додаток Minecraft: Bedrock Edition. + +[^2]: Додавання нових монстрів тощо. diff --git a/uk/origin/plazma/administration/getting-started/next-step.md b/uk/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..c9241d721 --- /dev/null +++ b/uk/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: Дізнайтеся, як налаштувати сервер. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Нижче наведено кілька способів налаштування та використання Plazma. + +## Зміна конфігурації + +Одним із найбільш базових способів налаштування Plazma є зміна конфігурації. + +Plazma надає потужні налаштування, починаючи від механіки гри до властивостей мобів. + +Для отримання докладної інформації про конфігурацію Plazma, перегляньте сторінку нижче. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Використання плагінів + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Це головна причина використання Plazma та найпотужніший спосіб користування Plazma. Міцна екосистема плагінів Plazma дозволяє легко налаштувати сервер. + +Існує кілька способів пошуку та завантаження плагінів. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% кінець нагадування %} + +Існує кілька сервісів для завантаження плагінів. Зокрема, [Форум SpigotMC](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) та інші сервіси перевіряють плагіни перед завантаженням, щоб лише безпечні плагіни були поширені. + +### Застосування плагінів + +Якщо ви вже завантажили плагін, тепер час його застосувати. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Помістіть завантажений файл у папку `plugins` у папці сервера та перезапустіть сервер. +3. Після запуску Plazma з'явиться новий вміст у консолі. Це означає, що Plazma успішно завантажив плагіни. +4. Навіть якщо Plazma успішно завантажив плагіни, вони можуть не почати працювати. Використовуючи команду `/plugins`, ви можете переглянути завантажені на сервер плагіни. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Якщо плагін не завантажується належним чином, ви можете знайти рішення на цій сторінці. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Використання датапаків + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +З допомогою датапаків ви можете змінювати частини гри, додаючи нові монстри та виклики. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Деякі несправні датапаки можуть пошкодити світ без можливості відновлення. + +Тому перед застосуванням датапаку рекомендується зробити резервну копію світу. +{% кінець нагадування %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Після завантаження датапаку його можна застосувати, помістивши його у папку `datapacks` у папці світу сервера. Якщо папки немає, створіть її та додайте датапак. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +У такому випадку рекомендується **2 рази** перезапустити сервер. +{% кінець нагадування %} + +Датапаки можуть легко пошкодитися при оновленні версії Minecraft. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Застосовані датапаки можна переглянути за допомогою команди `/datapack list`. + +*** + +## Оптимізація + +У Plazma застосовано багато патчів для оптимізації. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Проксі + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Для отримання інформації про безпечні та правильні налаштування проксі дивіться нижченаведену сторінку. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## Безпека + +У Minecraft розвинулися моди, які дозволяють легко отримати [движок для атак на вразливості](#user-content-fn-3)[^3] навіть онлайн. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Налаштування дозволів + +Деякі адміністративні команди плагінів можуть містити вразливості через неправильні налаштування дозволів. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Блокування X-Ray + +X-Ray - одна з вразливостей, яку легко використовувати навіть з базовим оптимізованим клієнтом. + +Plazma надає конфігурацію для автоматичного блокування X-Ray. + +Для отримання інструкцій щодо блокування X-Ray дивіться нижченаведену сторінку. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Біла листа + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Щоб переглянути список гравців, які мають дозвіл на підключення, використовуйте команду `/whitelist query`. + +*** + +[^1]: Або додаток Minecraft: Bedrock Edition. + +[^2]: Додавання нових монстрів тощо. + +[^3]: Зазвичай їх називають "хакерами". + +[^4]: Якщо конфігурація не оптимізована, Plazma застаріла або є нові вразливості, то деякі вразливості можуть бути не заблоковані. + +[^5]: Підключення гравців до сервера здійснюється через проксі-сервер Ngrok, і кожного разу при перезапуску видається нова адреса Ngrok. diff --git a/uk/origin/plazma/administration/reference/README.md b/uk/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..07d9c03c2 --- /dev/null +++ b/uk/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Дізнайтеся про способи користування, які надає Plazma за замовчуванням. +--- + +# 📜 리퍼런스 + +У Plazma надається кілька способів користування. + +Серед них чотири способи користування, які можна використовувати без додаткових дій. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Офіційний сервер Discord](https://discord.gg/MmfC52K8A8) або [Обговорення на GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) - задавайте питання спільноті! +{% кінець нагадування %} + +*** + +## 🖥️ Команди + +> Команди дозволяють збирати інформацію в грі або налаштовувати геймплей. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Права + +> Права визначають обсяг взаємодії гравця. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Аргументи та властивості + +> Аргументи та властивості впливають на роботу Plazma в цілому. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Налаштування + +> Налаштування - це найпростіший спосіб користування Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/uk/origin/plazma/administration/reference/arguments.md b/uk/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..c2c10939a --- /dev/null +++ b/uk/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: Дізнайтеся про початкові аргументи та властивості системи. +--- + +# 🎛️ Аргументи та властивості + +Початкові аргументи та властивості системи - це значення, які додаються до [команди, яка використовується](#user-content-fn-1)[^1] для запуску Plazma, і вони загалом впливають на роботу Plazma. + +[Місце, додане до команди](#user-content-fn-2)[^2] розділяється на **початковий аргумент** та **властивості системи**. + +*** + +## Властивості системи + +Властивості системи вводяться перед `-jar` і оброблюються JVM перед ініціалізацією Plazma. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Спосіб використання + +Властивості системи вводяться як аргументи Java між `java` та `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` позначає, що цей аргумент не вбудований у JVM, але є додатковим аргументом для Plazma, + +Якщо не вказано жодного значення для властивостей, вони за замовчуванням встановлюються ​​на [`true`](#user-content-fn-3)[^3]. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% кінець нагадування %} + +### Повні властивості системи + +#### `convertLegacySigns` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Оновлює використані формати плакатів. + +#### `debug.entities` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Активує журнализацію для інформації про сутності. + +#### `debug.rewriteForIDE` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує NMS ревізію для коректного завантаження відлагоджувальної інформації в IDE,\ +та автоматично ремапує внутрішню версію. + +#### `disable.watchdog` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує систему попередження Watchdog у Spigot. + +#### `letMeReload` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує повідомлення підтвердження команди `/reload`. + +{% hint style="danger" %} +**`/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개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує систему пріоритетів класів плагінів. + +Корисно у випадку проблем у плагінах Shade. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує систему консолідації Netty flush. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **За замовчуванням**: `750` + +Якщо сутність перевищує вказане значення, вона розділиться на кілька пакетів для передачі. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **За замовчуванням**: `8192` + +Встановлює максимальний розмір пакета, який сервер може прийняти за раз. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує перевірку версії Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Це може призвести до пошкодження файлів усього світу та зламу всієї механіки гри. + +Всі проблеми, що виникли через це, є вашою відповідальністю, і Plamza не надає жодної підтримки в цьому випадку. +{% кінець нагадування %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **За замовчуванням**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **За замовчуванням**: `80` + +Встановлює максимальну довжину тексту на одному рядку плаката. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **За замовчуванням**: `(версія світу) + 1` + +Встановлює версію інформації про оновлення світу, яку потрібно ініціювати спочатку. + +Корисно при необхідності оновлення великої кількості чанків, але в інших випадках не використовується. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Boolean` +- **За замовчуванням**: `True` + +Активує обробку коментарів у YAML файлах. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Значення за замовчуванням**: `30` + +Якщо гравець не отримує жодних даних протягом введеного гравцем значення (у секундах), він буде вилучений. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Ігнорувати коментарі властивостей сервера. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Увімкнути відлагодження синхронного створення чанків. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Увімкнути [стандартну систему створення чанків](#user-content-fn-10)[^10] у Minecraft. + +Це призводить до значного погіршення продуктивності, оскільки кожен чанк зберігається послідовно. + +#### `Paper.explicit-flush` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Увімкнути явне очищення мережевого каналу. + +#### `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가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `false` + +Деактивує брендування Plazma і використовує базовий серверний фавікон ванільного типу. + +#### `Plazma.useVanillaConfiguration` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `false` +- **конфлікт**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +Це може серйозно вплинути на безпеку та продуктивність сервера. + +Всі проблеми, що виникають при використанні цього параметра, покласти на адміністратора сервера. +{% кінець нагадування %} + +Надає початкове значення Mojang за замовчуванням. + +Це скасовує усі патчі на вразливості, що були застосовані в Paper. + +Патчі на вразливості можна активувати знову в Paper або Plazma конфігурації. + +#### `Plazma.vanillaize` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `true` +- **конфлікт**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +Налаштовує початкову конфігурацію наближено до ванільного. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Вибрана властивість + +Нижче наведені системні властивості, які були відмічені як застарілі. + +#### `timings.bypassMax` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `false` +- **Застаріло**: Після повного видалення Timings з Plazma + +Визначає, чи можна перевищувати максимально допустиме значення, яке можна передавати в API Timings Aikar. + +У разі відсутності обробки в API встановлюється обмеження швидкості. + +*** + +## Параметр запуску + +Параметри запуску вводяться після `-jar *.jar` для ініціалізації Plazma та обробки разом з ними. + +### Спосіб використання + +Системні властивості вводяться як аргументи командного рядка після `-jar *.jar`. + +Наприклад, якщо ви хочете застосувати параметр запуску `nogui`,\ +ви маєте ввести наступне, щоб Plazma обробив параметр `nogui` під час ініціалізації. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Повний список параметрів запуску + +#### `bukkit-settings` + +- **Псевдонім**: `b` +- **Значення за замовчуванням**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Псевдонім**: `c` +- **Значення за замовчуванням**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Псевдонім**: `c` +- **Значення за замовчуванням**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Запускає сервер у демонстраційному режимі. + +#### `eraseCache` + +Видаляє залишкові файли кешу після оновлення світу. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Псевдонім**: `?` + +Виводить повний список параметрів запуску та їх опис у Plazma. + +#### `initSettings` + +Створює лише конфігураційний файл та завершує роботу сервера. + +#### `jfrProfile` + +Увімкнути профілювання JFR. + +#### `max-players` + +- **Псевдоніми**: `s`, `size` +- **Значення за замовчуванням**: `(властивість сервера)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Вимикає графічну панель інтерфейсу. + +#### `nojline` + +Деактивуйте JLine та використовуйте консоль ванільної версії. + +#### `online-mode` + +- **Псевдонім**: `o` +- **Значення за замовчуванням**: `(властивість сервера)` + +Вибір перевірки гравців на Mojang-сервері. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **Псевдонім**: `paper` +- **За замовчуванням**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +Встановлює місце розташування вимкненої конфігураційної файлу PaperSpigot. + +Це використовується для перенесення існуючої конфігурації в новий файл конфігурації та потім більше не використовується. + +#### `paper-settings-directory` + +- **Псевдонім**: `paper-dir` +- **За замовчуванням**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **Псевдонім**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **Псевдонім**: `p` +- **За замовчуванням**: `plugins` + +Встановлює розташування папки з плагінами. + +#### `pufferfish-settings` + +- **Псевдонім**: `pufferfish` +- **За замовчуванням**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **Псевдонім**: `purpur` +- **За замовчуванням**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +Запускає сервер у повністю ванільному стані. + +#### `server-ip` + +- **Псевдонім**: `h`, `host` +- **Значення за замовчуванням**: `(властивість сервера)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **Псевдонім**: `p`, `port` +- **Значення за замовчуванням**: `(властивість сервера)` + +Встановлює порт сервера. + +#### `server-name` + +- **За замовчуванням**: `A Plazma Server` + +Встановлює назву сервера. + +#### `spigot-settings` + +- **Псевдонім**: `S` +- **За замовчуванням**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **Псевдонім**: `v` + +Виводить версію Plazma. + +#### `world-dir` + +- **Псевдонім**: `W`, `universe`, `world-container` +- **За замовчуванням**: `(папка сервера)` + +Встановлює місце збереження файлів світу. + +#### `world-name` + +- **Псевдонім**: `w`, `world` +- **Значення за замовчуванням**: `(властивість сервера)` + +Встановлює назву файлу світу. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Порядок обробки аргументів змінюється в залежності від місця додавання. + +[^3]: Наприклад, якщо ви хочете встановити `Plazma.iKnowWhatIAmDoing` в `true` (активувати), ви можете ввести лише `-DPlazma.iKnowWhatIAmDoing`, а не `-DPlazma.iKnowWhatIAmDoing=true`, і вони будуть працювати однаково. + +[^4]: Наприклад, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Детектор подій. + +[^6]: Детектор подій. + +[^7]: Клієнт. + +[^8]: Сигнал, що показує, що клієнт успішно підключений до сервера, подібно до серцевого ритму. + +[^9]: За допомогою функції вигнання AFK в Purpur можна вигнати гравця, який залишився без дії. + +[^10]: Система синхронного запису чанків, Sync Chunk Write System. + +[^11]: `WARNING! Plazma може викликати неочікувані проблеми, тому обов'язково протестуйте його перед використанням на публічному сервері.` + +[^12]: В грі `оптимізація світу` також працює за таким же принципом. + +[^13]: Менеджери рівня 2 та вище виключаються. + +[^14]: Протокол Інтернету, IP. diff --git a/uk/origin/plazma/administration/reference/commands.md b/uk/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..382afcbdd --- /dev/null +++ b/uk/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про доступні команди у Plazma. +--- + +# 🖥️ Команди diff --git a/uk/origin/plazma/administration/reference/configurations/README.md b/uk/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..722fe6ae7 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Налаштування - це найпростіший спосіб користування Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Властивість + +> Властивість - це найбільш базовий конфігураційний файл, який надається в Minecraft. Використання властивостей дозволяє змінювати основні механізми гри. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Конфігурація Bukkit + +> Конфігурація Bukkit - це найбільш базовий конфігураційний файл, який надається в Plazma. Використання конфігурації Bukkit дозволяє змінювати основні механізми Minecraft сервера. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Конфігурація Spigot + +> Конфігурація Spigot дозволяє змінювати роботу деталей гри, обробку гравців, функціонування команд тощо. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Конфігурація Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Конфігурація Pufferfish + +> Конфігурація Pufferfish дозволяє змінювати обробку світу та сутностей в Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Конфігурація Purpur + +> Властивості Purpur дозволяють змінювати загальні дані гри. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Конфігурація Plazma + +> Конфігурація Plazma дозволяє налаштовувати функції Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/uk/origin/plazma/administration/reference/configurations/bukkit.md b/uk/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e1ef6faad --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/uk/origin/plazma/administration/reference/configurations/paper/README.md b/uk/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..f163b4232 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, для чого призначений кожний файл у папці config. +--- + +# 🛩️ Папір diff --git a/uk/origin/plazma/administration/reference/configurations/paper/global.md b/uk/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..0dd0c6b3c --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/uk/origin/plazma/administration/reference/configurations/paper/world.md b/uk/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..193ca227b --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Дізнайтеся, що означає кожен вузол у paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Світовий diff --git a/uk/origin/plazma/administration/reference/configurations/plazma/README.md b/uk/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..d2de310b5 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, для чого призначений кожний файл у папці config. +--- + +# ✨ Плазма diff --git a/uk/origin/plazma/administration/reference/configurations/plazma/global.md b/uk/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..0b66cfa0c --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/uk/origin/plazma/administration/reference/configurations/plazma/world.md b/uk/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..4b56d9c59 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/uk/origin/plazma/administration/reference/configurations/plazma/worlds.md b/uk/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..07982555d --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у plazma-world.yml. +--- + +# ✨ Plazma (склад за світами) diff --git a/uk/origin/plazma/administration/reference/configurations/property.md b/uk/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..6cdb46e06 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у server.properties. +--- + +# 🪨 Server.properties diff --git a/uk/origin/plazma/administration/reference/configurations/pufferfish.md b/uk/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..fd43de5f3 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у pufferfish.yml. +--- + +# 🐡 Риба-балон diff --git a/uk/origin/plazma/administration/reference/configurations/purpur/README.md b/uk/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..5e0330a5a --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у purpur.yml. +--- + +# 🦑 Purpur diff --git a/uk/origin/plazma/administration/reference/configurations/purpur/global.md b/uk/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..e87d2d446 --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/uk/origin/plazma/administration/reference/configurations/purpur/world.md b/uk/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..b2d88c92c --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/uk/origin/plazma/administration/reference/configurations/spigot.md b/uk/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..fdd20642d --- /dev/null +++ b/uk/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у spigot.yml. +--- + +# 🚰 Spigot diff --git a/uk/origin/plazma/administration/reference/permissions.md b/uk/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..10b8b88d3 --- /dev/null +++ b/uk/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Дізнайтеся про дозволи Plazma. +--- + +# 🛡️ Дозволи + +Права - це простий інструмент безпеки, який визначає область взаємодії гравців на сервері. + +Для належного використання та легкої зміни прав вам потрібно використовувати плагіни, такі як [LuckPerms](https://luckperms.net). + +*** + +## Розуміння базової системи прав + +У Minecraft є базові групи прав для управління. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Гравець**\ + Це стандартна група прав, яку отримує кожен гравець. +2. **Посередник**\ + Може ігнорувати захист від спавну. +3. **Адміністратор світу**\ + Має доступ до всіх команд та командних блоків, що стосуються управління світом.\ + Це базова група прав для даних пакетів та командних блоків. +4. **Адміністратор**\ + Має доступ до всіх команд, пов'язаних з управлінням гравцями. +5. **Головний адміністратор**\ + Має доступ до всіх команд, включаючи управління сервером.\ + Це базова група прав для консолі та адміністраторів. + +*** + +## Налаштування прав + +*** + +## Повні права + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Стандартно**: `Немає` + +Дозволяє гравцеві кататися на істоті, взаємодіючи з нею, коли він вгамується. + +Після того як гравець сідає на істоту, він може керувати її рухами за допомогою клавіш переміщення та стрибати або літати за допомогою клавіші стрибка. + +У `(Namespaced Key)` вказується [Namespaced ID](#user-content-fn-2)[^2] істоти. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Стандартно**: `Немає` + +Дозволяє гравцю використовувати особливі вміння істоти, на якій він сидить. + +Не всі істоти мають доступ до особливих вмінь. Дивіться список доступних особливих вмінь нижче. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Поділіться своїми ідеями на [Plazma Discord](https://plazmamc.org/discord) або [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions) ! +{% кінець нагадування %} + +
+ +Переглянути доступні особливі вміння + +- **`crepper`**\ + При натисканні клавіші стрибка вибухає.\ + Якщо у гравця є право `allow.powered.creeper`, він може заряджати вибух, утримуючи клавішу стрибка. +- **`dolphin`**\ + При натисканні клавіші стрибка дельфін робить стрибок. +- **`phantom`**\ + При натисканні клавіші стрибка фантом випускає полум'я. +- **`wither`**\ + При взаємодії викидає голову відьмака. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/credits (Player)`](commands.md#credits). + +Після назви права додайте `.other`, щоб надати можливість використовувати іншим гравцям. + +#### `bukkit.command.demo` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/demo (Player)`](commands.md#demo). + +Після назви права додайте `.other`, щоб надати можливість використовувати іншим гравцям. + +#### `bukkit.command.ping` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/ping (Player)`](commands.md#ping). + +Після назви права додайте `.other`, щоб надати можливість використовувати іншим гравцям. + +#### `bukkit.command.ram` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/rambar (Player)`](commands.md#rambar). + +Після назви права додайте `.other`, щоб надати можливість використовувати іншим гравцям. + +#### `bukkit.command.restart` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/tpsbar (Player)`](commands.md#tpsbar). + +Після назви права додайте `.other`, щоб надати можливість використовувати іншим гравцям. + +#### `bukkit.command.timings` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Дізнайтеся більше про подібні команди на [Spark](https://spark.lucko.me/docs/Command-Usage). +{% кінець нагадування %} + +#### `bukkit.command.uptime` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє використовувати команду [`/gamemode (GameMode) (Player)`](commands.md#gamemode). + +Після назви права додайте `.other`, щоб надати можливість використовувати іншим гравцям. + +#### `paper.antixray.bypass` + +- **Стандартно**: `Немає` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Це дозволяє покращити продуктивність обох сторін. + +> Дізнайтеся більше про налаштування X-Ray на вказаній сторінці. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Стандартно**: `Немає` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% кінець нагадування %} + +#### `purpur.anvil.color` + +- **Стандартно**: `Немає` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Стандартно**: `Немає` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Стандартно**: `Немає` + +Дозволяє використовувати [міні-повідомлення теги](https://docs.advntr.dev/minimessage/format.html) на наковальні. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Стандартно**: `Немає` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Стандартно**: `Немає` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Стандартно**: `Немає` + +Виключає гравця з списку видалення за бездіяльність. + +#### `purpur.debug.f3n` + +- **Стандартно**: `Адміністратор світу` + +Дозволяє гравцю змінювати режим гри за допомогою клавіші `F3 + N`. + +Це працює тільки якщо у гравця є відповідне право. + +#### `purpur.drop.spawners` + +- **Стандартно**: `Немає` + +Після видобування спавнера за допомогою встановлених у конфігурації предметів, спавнер буде випущено. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Стандартно**: `Немає` + +Змінює розмір ендер-скрині. + +У `(NumberString)` можна ввести `one`, `two`, `three`, `four`, `five`, `six`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Стандартно**: `Немає` + +Дозволяє працювати з тотемом бессмертя, якщо він є в інвентарі. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Стандартно**: `Немає` + +Дозволяє гравцю ігнорувати обмеження на кількість підключених користувачів. + +#### `purpur.mending_shift_click` + +- **Стандартно**: `Немає` + +Дозволяє гравцю відремонтувати триманий предмет, коли він `присідає та взаємодіє`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Стандартно**: `Немає` + +Дозволяє гравцю встановлювати спавнери. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Стандартно**: `Немає` + +Забезпечує миттєве телепортування гравця після використання порталу до Незалежного Світу. + +#### `purpur.sign.color` + +- **Стандартно**: `Немає` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Стандартно**: `Немає` + +Дозволяє використовувати коди затемнення на табличках `(&о)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Стандартно**: `Немає` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Стандартно**: `Немає` + +Дозволяє гравцеві за допомогою ножиць `взаємодіяти` для запобігання вибуху TNT. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Представлені дозволи + +#### `plazma.bypass.ncr-require` + +- **Стандартно**: `Немає` + +Дозволяє гравцеві підключатися навіть якщо модуль [`NoChatReports`](https://modrinth.com/mod/no-chat-reports) не встановлено. + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Оператор. + +[^2]: Наприклад: `ender_dragon` diff --git a/uk/origin/plazma/adminstration/README.md b/uk/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..a39f47288 --- /dev/null +++ b/uk/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Створіть свій власний сервер за допомогою Plazma. +--- + +# ⚒️ Керівництво з управління сервером diff --git a/uk/origin/plazma/adminstration/expert/README.md b/uk/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..84fa43e96 --- /dev/null +++ b/uk/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про професійний спосіб роботи з Plazma. +--- + +# 🎓 Поглиблене diff --git a/uk/origin/plazma/adminstration/expert/fix-exploits.md b/uk/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..38a966ef3 --- /dev/null +++ b/uk/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про відомі уразливості та способи їх вирішення. +--- + +# ⚠️ Відомі уразливості та методи вирішення diff --git a/uk/origin/plazma/adminstration/expert/optimize.md b/uk/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..0339a732f --- /dev/null +++ b/uk/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, як оптимізувати Plazma. +--- + +# 🧹 Оптимізація diff --git a/uk/origin/plazma/adminstration/expert/vanillaize.md b/uk/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..69e5cb440 --- /dev/null +++ b/uk/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Дізнайтеся, як відновити патч Paper та ваніль. +--- + +# ↩️ Ванілізація + +{% hint style="warning" %} + +### У Paper відсутні варіанти виправлення більшості помилок ванільного сервера. + +Наразі Plazma розробляє можливість вимкнути такі виправлення помилок. + +Тому цей посібник все ще у процесі розробки і інформація може змінюватися. +{% кінець нагадування %} diff --git a/uk/origin/plazma/adminstration/faq.md b/uk/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..a000bbf38 --- /dev/null +++ b/uk/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Дізнайтеся більше про часто задавані питання. +--- + +# ⁉️ Часті питання + +{% нагадування стилю="інформація" %} + +### Не можете знайти потрібну відповідь? + +Задайте питання спільноті через [офіційний Discord сервер](https://discord.gg/MmfC52K8A8) або [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues)! +{% кінець нагадування %} + +### Повідомлення виводиться, але не виконується + +Якщо у консолі виводиться `no main manifest attribute, in plazma-(version).jar`,\ +завантажений файл є файлом API для розробників, вам потрібно завантажити **Reobf Paperweight** зі сторінки GitHub. + +Для отримання докладної інформації див. наступну сторінку. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Під час запуску сервера відображається попередження + +Plazma містить деякі нестабільні патчі і завжди може працювати некоректно, тому виводить попередження під час запуску сервера. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Це попередження можна вимкнути за допомогою системного властивості [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Для отримання докладної інформації див. наступну сторінку. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Доступно з версії 1.20.1 diff --git a/uk/origin/plazma/adminstration/getting-started/README.md b/uk/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..dacfe137d --- /dev/null +++ b/uk/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Дізнайтеся, як створити сервер за допомогою Plazma. +--- + +# 👟 Початок + +Для стабільного використання Plazma система повинна відповідати наступним вимогам. + +| | Мінімальні | Рекомендовані | +| :----------------: | ---------: | ------------: | +| Архітектура | x64 | - | +| ОЗП | 8 ГБ | 16 ГБ | +| Простір зберігання | 1 ГБ | 8 ГБ | +| JRE | 17 | 21 | + +Для зручного редагування файлів налаштувань, рекомендується встановити редактор, такий як [Visual Studio Code](https://code.visualstudio.com/download). + +*** + +## 1. Встановлення JRE + +Як вже зрозуміло з назви, Minecraft: **"Java"** Edition розроблено на Java, тому для запуску потрібно мати JRE[^1]. + +Оскільки Plazma базується на офіційній серверній платформі Mojang Studios[^2], для використання Plazma також потрібно встановити JRE. + +### 1.1 Перевірка наявності JRE + +Щоб перевірити, чи встановлено JRE на системі, введіть [`cmd /k java --version`](#user-content-fn-4)[^4] у вікно виклику команд і запустіть. + +Якщо вивід виглядає так, переходьте до [2 кроку](setup.md#id-2). + +{% code title="Правильний вивід" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Якщо вивід відрізняється або виглядає наступним чином, JRE відсутнє або занадто застаріле, тому потрібно виконати [1.2 крок](setup.md#id-1.2). + +{% code title="JRE не встановлене" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE занадто застаріле" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Встановлення JRE + +У цьому посібнику для JRE використовується один з видів Azul Zulu[^5]. + +Після встановлення повторно виконайте [1.1 крок](setup.md#id-1.1), щоб переконатися, що встановлення пройшло успішно. + +{% tabs %} +{% tab title="Windows" %} + +1. Спочатку завантажте **JDK 21** у форматі `.msi` з [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu). +2. Запустіть завантажений майстер встановлення та натисніть `Next`. +3. Після цього активуйте `Set JAVA_HOME variable` в центрі лівої частини вікна та натисніть `Next`. +4. Натисніть `Install`, щоб завершити встановлення JRE. + {% endtab %} + +{% tab title="macOS" %} +Завантажте **JDK 21** у форматі `.dmg` та встановіть JRE через майстер встановлення з [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu). +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Спочатку виконайте наступну команду в терміналі, щоб додати сховище Azul Zulu до APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Потім виконайте наступну команду в терміналі для встановлення JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Введіть наступну команду для встановлення JRE. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Завантаження Plazma + +Plazma надає різноманітні виконавчі файли. + +{% hint style="warning" %} + +### У більшості випадків використовується `Reobf Paperclip`. + +Нижче наведено інформацію для розробників або тих, хто цікавиться особливостями кожного типу.\ +Для звичайних користувачів можна пропустити до [3 кроку](setup.md#id-3) без проблем. +{% кінець нагадування %} + +
+ +Дізнатися більше + +Назва виконавчого файлу визначається як `plazma-(менеджер-версій)-1.20.4-R0.1-SNAPSHOT-(форма-картування).jar`. + +- **Форма картування**\ + Карта мапує реальний код Minecraft і змішаний код, подібно до карти. + - **Reobf**\ + Reobfuscation, також відомий як Spigot Mapping, використовується в більшості NMS плагінів.\ + Планується припинення використання з версії 1.20.5. + - **Mojmap**\ + Mojang Mapping, мапування Vanilla Minecraft. +- **Менеджер версій**\ + Менеджер версій - це лаунчер сервера, який необхідний для запуску сервера та патчення файлів сервера. + - **Paperclip**\ + Розроблений командою PaperMC для Paper та інших похідних платформ, завантажує бібліотеки та застосовує патчі на сервері. + - **Bundler**\ + Менеджер версій Vanilla Minecraft. + +
+ +*** + +## 3. Створення початкового скрипта + +Для простого запуску Plazma та автоматичного перезапуску сервера потрібно створити [початковий скрипт](#user-content-fn-6)[^6]. + +Можна створити початковий скрипт через [Flags.sh](https://flags.sh).\ +Просто введіть потрібний обсяг пам'яті для Plazma[^8], і команда автоматично оптимізується. + +Можна завантажити початковий скрипт, натиснувши кнопку завантаження у лівому нижньому кутку.\ +**Переконайтеся, що завантажений початковий скрипт відповідає вашій операційній системі.** + +*** + +## 4. Очищення файлів + +Тепер перемістіть завантажений початковий скрипт та Plazma в нову теку. + +{% hint style="warning" %} + +### Назва теки повинна бути без пробілів та англійською мовою. + +Інакше Plazma або JRE можуть не працювати належним чином. +{% кінець нагадування %} + +Тепер запустіть початковий скрипт. У вікні вибору дозволів для брандмауера Windows, обов'язково виберіть `Дозволити`. + +*** + +## 5. Погодження з EULA + +Після запуску початкового скрипта у теку буде створено `eula.txt`. + +EULA[^9] - це ліцензійна угода, яку потрібно погодитися з Mojang Studios[^10], щоб користуватися їхніми послугами. + +Якщо ви не погоджуєтесь з EULA, ви не зможете запустити сервер, а в разі порушення EULA вас можуть покарати, заборонити доступ і т. д. [санкції](#user-content-fn-11)[^11]. + +Для погодження з EULA змініть `eula=false` на `eula=true` у файлі `eula.txt` та збережіть зміни. + +*** + +## 6. Дозвіл на зовнішні підключення (Windows) + +Сучасні операційні системи за замовчуванням блокують зовнішні доступи за допомогою **брандмауера** та **маршрутизатора**. + +У випадку Windows, оскільки ви вже дозволили в [3 кроці](setup.md#id-3), вам лише потрібно налаштувати перенаправлення портів. + +{% нагадування стилю="інформація" %} + +### У цьому посібнику припускається, що ви використовуєте операційну систему Windows та [**UPnP**](#user-content-fn-12)[^12] для маршрутизатора. + +Якщо ваш маршрутизатор не підтримує UPnP, вам потрібно дослідити, які панелі керування має ваш маршрутизатор. + +Також можна створити тимчасову адресу через [Ngrok](https://ngrok.com/). +{% кінець нагадування %} + +{% hint style="warning" %} + +### Для операційних систем на базі Linux або macOS тощо, налаштування брандмауера для кожної служби може відрізнятися, тому вам потрібно дослідити самостійно. + +{% кінець нагадування %} + +### 6.1 Перевірка необхідності перенаправлення портів + +Введіть наступне у вікні виклику команд та запустіть. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Якщо вивід `True`, то все в порядку, якщо `False`, потрібно налаштувати перенаправлення портів. + +### 6.2 Підключення до сервера + +{% tabs %} +{% tab title="Підключення зовнішніх клієнтів" %} +Якщо вам не потрібно виконувати перенаправлення портів або ви вже успішно налаштували його, ви можете підключитися до сервера зараз. + +Адреса для підключення до сервера може бути знайдена [тут](https://ip.pe.kr/) +{% endtab %} + +{% tab title="Спроба налаштування UPnP для перенаправлення портів" %} +У файлі `purpur.yml` у папці сервера, активуйте параметр `network.upnp-port-forwarding` на значення `true`. + +Після цього, після перезапуску сервера, Plazma автоматично спробує налаштувати перенаправлення портів. + +Нижче наведено варіанти повідомлень, які виводяться в консолі в залежності від успішності UPnP, вони виглядають як `[UPnP] (повідомлення)`. + +| Повідомлення | Значення | +| --------------------------------- | --------------------------------------- | +| `Успішно відкритий порт (порт)` | Успішне перенаправлення порту. | +| `Порт (порт) вже відкритий` | Інший сервіс вже використовує цей порт. | +| `Не вдалося відкрити порт (порт)` | Невдале перенаправлення порту. | +| `Сервіс недоступний` | Маршрутизатор не підтримує UPnP. | + +Після завершення роботи сервера, Plazma автоматично закриє порт. +{% endtab %} + +{% tab title="Створення тимчасової адреси з Ngrok" %} +Використання Ngrok є корисним для тимчасових тестів, спільної гри або гри з друзями. + +1. Завантажте ZIP-файл `Windows (64-bit)` з [веб-сайту Ngrok](https://ngrok.com/download). +2. Розпакуйте завантажений Ngrok у папці сервера. +3. Створіть [токен автентифікації](https://dashboard.ngrok.com/get-started/your-authtoken) на панелі керування Ngrok. +4. Виконайте команду, яка відображається у вікні командного рядка папки сервера. +5. Додайте `start /b ngrok tcp --region jp 25565` у верхню частину сценарію запуску та `taskkill /f /t /im ngrok.exe` в нижню частину. +6. Адреса сервера буде `0.tcp.jp.ngrok.io:12345`, яка відображається у верхній частині консолі як `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`. +7. Тепер ви можете підключитися до сервера за допомогою цієї адреси зовнішнього доступу. + {% endtab %} + +{% tab title="Підключення з локальної мережі" %} +Якщо ви хочете підключитися до сервера з локальної мережі, виконайте команду `cmd /k ipconfig` в вікні виконання та скористайтеся `IPv4-адресою`, що відображається. + +Наприклад, якщо ви побачите такий результат після виконання команди, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Ви можете підключитися до сервера з локальної мережі, використовуючи `192.168.3.7`, який відображається як IPv4-адреса. + +Якщо сервер і гра запускаються на одному ПК, ви можете підключитися за допомогою `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Етап розвитку + +Якщо сервер успішно запущено і працює належним чином, тепер час налаштувати його відповідно до вашого бажання. + +Дізнайтеся, як налаштувати сервер, використовуючи наш посібник. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, середовище виконання Java. + +[^2]: Plazma, що базується на Paper, використовує Spigot, який, у свою чергу, базується на офіційній серверній платформі. + +[^3]: Комбінація клавіш Windows + R + +[^4]: У Linux виконайте `java --version` у терміналі + +[^5]: JRE є одним з відкритих проектів існує кілька видів, так само як і для серверів Minecraft. + +[^6]: Зазвичай відомий як **запускач**. + +[^7]: Активувавши "Автоматичний перезапуск", сервер буде перезапущений автоматично. Для завершення роботи введіть `Control + C`. + +[^8]: Не рекомендується встановлювати більше половини від загальної кількості системної пам'яті. + + Наприклад, якщо загальний обсяг пам'яті системи становить 8 ГБ, то не рекомендується встановлювати більше 4 ГБ. + +[^9]: EULA, Ліцензійна угода з кінцевим користувачем. Докладніше на [веб-сайті Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Корпорація Microsoft. + +[^11]: Згідно зі статтею 32 пунктом 1 пунктом 9 Закону Кореї про просування галузі гральної промисловості, **Корейська компанія Microsoft** може подати судову скаргу. + +[^12]: Universal Plug & Play. Purpur в Plazma використовує цю технологію для автоматичного спілкування з маршрутизатором лише тоді, коли сервер працює, тому не потрібно налаштовувати перенаправлення портів вручну. + +[^13]: Якщо у вас немає облікового запису, ви можете зареєструватися в Ngrok за допомогою облікового запису Google або GitHub. diff --git a/uk/origin/plazma/adminstration/getting-started/customization.md b/uk/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..ffb7cfb81 --- /dev/null +++ b/uk/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, як налаштувати сервер. +--- + +# 🎨 Налаштування користувача diff --git a/uk/origin/plazma/adminstration/reference/arguments.md b/uk/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..9eab59a60 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Дізнайтеся про початкові аргументи та властивості системи. +--- + +# 🎛️ Аргументи та властивості + +Початкові змінні та властивості системи - це значення, які додаються до [команд](#user-content-fn-1)[^1], що використовуються для запуску Plazma, щоб дозволити змінювати значення, які не можна змінити після запуску Plazma. + +Залежно від [місця додавання до команди](#user-content-fn-2)[^2], вони розділяються на **Початкові аргументи** та **Властивості системи**. + +*** + +## Властивості системи + +Властивості системи вводяться перед `-jar` і оброблюються JVM перед ініціалізацією Plazma. + +{% hint style="warning" %} + +### Змінюючи властивості системи, можна змінити роботу Plazma та JVM, що може суттєво вплинути на гру! + +Якщо ви не впевнені, яку роль відіграють окремі властивості системи, **абсолютно не використовуйте їх!** +{% endhint %} + +### Спосіб використання + +Властивості системи вводяться як аргументи Java між `java` та `-jar`. + +Наприклад, якщо ви хочете застосувати властивість системи `Plazma.dummyProperty`,\ +введіть наступне, і наступне значення `37` буде введено в наступну властивість для ініціалізації Plazma. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` позначає, що цей аргумент не вбудований у JVM, але є додатковим аргументом для Plazma, + +якщо ви не вводите жодного значення, воно буде [фіксоване як `true`.](#user-content-fn-3)[^3] + +{% нагадування стилю="інформація" %} + +### Платформа серверів серії Paperweight використовує крапку в іменах властивостей для розділення властивостей для кожної платформи. + +У деяких терміналах, таких як Windows Powershell, ці аргументи можуть бути недопустимі, тому додайте `"` на початку та в кінці аргументу.]\(#user-content-fn-4)[^4] +{% endhint %} + +### Повні властивості системи + +#### `convertLegacySigns` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Оновлює використані формати плакатів. + +#### `debug.entities` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Активує журнализацію для інформації про сутності. + +#### `debug.rewriteForIDE` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує NMS ревізію для коректного завантаження відлагоджувальної інформації в IDE,\ +та автоматично ремапує внутрішню версію. + +#### `disable.watchdog` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує систему попередження Watchdog у Spigot. + +#### `letMeReload` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує повідомлення підтвердження команди `/reload`. + +{% hint style="danger" %} + +### Команда `/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[^5]. + +#### `Paper.disableClassPrioritization` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує систему пріоритетів класів плагінів. + +Корисно у випадку проблем у плагінах Shade. + +#### `Paper.disableFlushConsolidate` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує систему консолідації Netty flush. + +#### `Paper.excessiveTELimit` + +- **Тип**: `Integer` +- **За замовчуванням**: `750` + +Якщо сутність перевищує вказане значення, вона розділиться на кілька пакетів для передачі. + +#### `Paper.filterThreshold` + +- **Тип**: `Integer` +- **За замовчуванням**: `8192` + +Встановлює максимальний розмір пакета, який сервер може прийняти за раз. + +#### `Paper.ignoreJavaVersion` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Деактивує перевірку версії Java. + +{% hint style="danger" %} + +### Це може дозволити JVM спробувати отримати доступ до неіснуючого коду! + +Це може призвести до пошкодження файлів усього світу та зламу всієї механіки гри. + +Всі проблеми, що виникли через це, є вашою відповідальністю, і Plamza не надає жодної підтримки в цьому випадку. +{% кінець нагадування %} + +#### `Paper.maxCustomChannelName` + +- **Тип**: `Integer` +- **За замовчуванням**: `64` + +Встановлює обмеження на ім'я каналу плагіна[^6]. + +#### `Paper.maxSignLength` + +- **Тип**: `Integer` +- **За замовчуванням**: `80` + +Встановлює максимальну довжину тексту на одному рядку плаката. + +#### `Paper.minPrecachedDatafixVersion` + +- **Тип**: `Integer` +- **За замовчуванням**: `(версія світу) + 1` + +Встановлює версію інформації про оновлення світу, яку потрібно ініціювати спочатку. + +Корисно при необхідності оновлення великої кількості чанків, але в інших випадках не використовується. + +#### `Paper.parseYamlCommentsByDefault` + +- **Тип**: `Boolean` +- **За замовчуванням**: `True` + +Активує обробку коментарів у YAML файлах. + +#### `Paper.playerConnection.keepAlive` + +- **Тип**: `Integer` +- **Значення за замовчуванням**: `30` + +Якщо гравець не отримує жодних даних протягом введеного гравцем значення (у секундах), він буде вилучений. + +Зазвичай гра[^7] продовжує надсилати [сигнали серцебиття](#user-content-fn-8)[^8] на сервер, тому [гравець не буде вилучений,](#user-content-fn-9)[^9] але якщо гра не відповідає, вона розглядається як зіткнення гри і сервер більше не оброблятиме гравця і вилучить його. + +#### `Paper.skipServerPropertiesComments` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Ігнорувати коментарі властивостей сервера. + +#### `Paper.debug-sync-loads` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Увімкнути відлагодження синхронного створення чанків. + +#### `Paper.enable-sync-chunk-writes` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Увімкнути [стандартну систему створення чанків](#user-content-fn-10)[^10] у Minecraft. + +Це призводить до значного погіршення продуктивності, оскільки кожен чанк зберігається послідовно. + +#### `Paper.explicit-flush` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Увімкнути явне очищення мережевого каналу. + +#### `Paper.strict-thread-checks` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Завжди реєструвати помилки, що не виникають у головному потоці. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Виводити попередження, якщо запланована робота має надмірну затримку. + +#### `Paperclip.patchOnly` + +- **Тип**: `Boolean` +- **За замовчуванням**: `False` + +Якщо використовується вбудований виконавчий файл, то застосовувати лише патчі, не запускаючи сервер. + +#### `Plazma.aggressiveOptimize` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `false` + +{% hint style="warning" %} + +### Ця властивість буде переміщена як параметр запуску після версії 1.20.5. + +{% кінець нагадування %} + +Застосовувати більш строгу оптимізацію конфігурації, що застосовується під час першого запуску. + +Її активація призведе до прискорення та підвищення безпеки сервера, але може блокувати деякі механіки або суттєво вплинути на геймплей. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `false` + +Приховати попередження, які виводяться при ініціалізації Plazma. + +### Вибрана властивість + +Нижче наведені системні властивості, які були відмічені як застарілі. + +#### `timings.bypassMax` + +- **Тип**: `Boolean` +- **Значення за замовчуванням**: `false` +- **Застаріло**: Після повного видалення Timings з Plazma + +Визначає, чи можна перевищувати максимально допустиме значення, яке можна передавати в API Timings Aikar. + +У разі відсутності обробки в API встановлюється обмеження швидкості. + +*** + +## Параметр запуску + +Параметри запуску вводяться після `-jar *.jar` для ініціалізації Plazma та обробки разом з ними. + +### Спосіб використання + +Системні властивості вводяться як аргументи командного рядка після `-jar *.jar`. + +Наприклад, якщо ви хочете застосувати параметр запуску `nogui`,\ +ви маєте ввести наступне, щоб Plazma обробив параметр `nogui` під час ініціалізації. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Повний список параметрів запуску + +#### `bukkit-settings` + +- **Псевдонім**: `b` +- **Значення за замовчуванням**: `bukkit.yml` + +Встановлює ім'я та розташування [файлу конфігурації Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Псевдонім**: `c` +- **Значення за замовчуванням**: `commands.yml` + +Встановлює ім'я та розташування [файлу конфігурації команд Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Псевдонім**: `c` +- **Значення за замовчуванням**: `server.properties` + +Встановлює ім'я та розташування [файлу властивостей сервера](../reference/configurations/property.md). + +#### `demo` + +Запускає сервер у демонстраційному режимі. + +#### `eraseCache` + +Видаляє залишкові файли кешу після оновлення світу. + +#### `forceUpgrade` + +Примусово [оновлює](#user-content-fn-12)[^12] світ, ігноруючи версію. + +#### `help` + +- **Псевдонім**: `?` + +Виводить повний список параметрів запуску та їх опис у Plazma. + +#### `initSettings` + +Створює лише конфігураційний файл та завершує роботу сервера. + +#### `jfrProfile` + +Увімкнути профілювання JFR. + +#### `max-players` + +- **Псевдоніми**: `s`, `size` +- **Значення за замовчуванням**: `(властивість сервера)` + +Встановлює максимальну кількість [гравців](#user-content-fn-14)[^14]. + +#### `nogui` + +Вимикає графічну панель інтерфейсу. + +#### `nojline` + +Деактивуйте JLine та використовуйте консоль ванільної версії. + +#### `online-mode` + +- **Псевдонім**: `o` +- **Значення за замовчуванням**: `(властивість сервера)` + +Вибір перевірки гравців на Mojang-сервері. + +**Якщо ви не використовуєте проксі, такі як Velocity, це може призвести до порушення [EULA](../getting-started/README.md#id-5) і покарання.** + +#### `paper-settings` + +- **Псевдонім**: `paper` +- **За замовчуванням**: `paper.yml` + +{% hint style="warning" %} + +### Цей аргумент було припинено використовувати після версії 1.19.4 + +{% кінець нагадування %} + +Встановлює місце розташування вимкненої конфігураційної файлу PaperSpigot. + +Це використовується для перенесення існуючої конфігурації в новий файл конфігурації та потім більше не використовується. + +#### `paper-settings-directory` + +- **Псевдонім**: `paper-dir` +- **За замовчуванням**: `config` + +Встановлює ім'я та розташування папки, де знаходиться [конфігураційний файл Paper](../reference/configurations/paper/README.md). + +#### `plazma-settings-directory` + +- **Псевдонім**: `plazma-dir` + +Встановлює ім'я та розташування папки, де знаходиться [конфігураційний файл Plazma](../reference/configurations/plazma/README.md). + +#### `plugins` + +- **Псевдонім**: `p` +- **За замовчуванням**: `plugins` + +Встановлює розташування папки з плагінами. + +#### `pufferfish-settings` + +- **Псевдонім**: `pufferfish` +- **За замовчуванням**: `pufferfish.yml` + +Встановлює назву та розташування [конфігураційного файлу Pufferfish](../reference/configurations/pufferfish.md). + +#### `purpur-settings` + +- **Псевдонім**: `purpur` +- **За замовчуванням**: `purpur.yml` + +Встановлює назву та розташування [конфігураційного файлу Purpur](../reference/configurations/purpur/README.md). + +#### `safeMode` + +Запускає сервер у повністю ванільному стані. + +#### `server-ip` + +- **Псевдонім**: `h`, `host` +- **Значення за замовчуванням**: `(властивість сервера)` + +Встановлює ім'я хоста сервера або Інтернет-протокольну адресу. + +#### `server-port` + +- **Псевдонім**: `p`, `port` +- **Значення за замовчуванням**: `(властивість сервера)` + +Встановлює порт сервера. + +#### `server-name` + +- **За замовчуванням**: `A Plazma Server` + +Встановлює назву сервера. + +#### `spigot-settings` + +- **Псевдонім**: `S` +- **За замовчуванням**: `spigot.yml` + +Встановлює ім'я та розташування [конфігураційного файлу Spigot](../reference/configurations/spigot.md). + +#### `version` + +- **Псевдонім**: `v` + +Виводить версію Plazma. + +#### `world-dir` + +- **Псевдонім**: `W`, `universe`, `world-container` +- **За замовчуванням**: `(папка сервера)` + +Встановлює місце збереження файлів світу. + +#### `world-name` + +- **Псевдонім**: `w`, `world` +- **Значення за замовчуванням**: `(властивість сервера)` + +Встановлює назву файлу світу. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: Порядок обробки аргументів змінюється в залежності від місця додавання. + +[^3]: Наприклад, якщо ви хочете встановити `Plazma.iKnowWhatIAmDoing` в `true` (активувати), ви можете ввести лише `-DPlazma.iKnowWhatIAmDoing`, а не `-DPlazma.iKnowWhatIAmDoing=true`, і вони будуть працювати однаково. + +[^4]: Наприклад, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: Детектор подій. + +[^6]: Детектор подій. + +[^7]: Клієнт. + +[^8]: Сигнал, що показує, що клієнт успішно підключений до сервера, подібно до серцевого ритму. + +[^9]: За допомогою функції вигнання AFK в Purpur можна вигнати гравця, який залишився без дії. + +[^10]: Система синхронного запису чанків, Sync Chunk Write System. + +[^11]: `WARNING! Plazma може викликати неочікувані проблеми, тому обов'язково протестуйте його перед використанням на публічному сервері.` + +[^12]: В грі `оптимізація світу` також працює за таким же принципом. + +[^13]: Протокол Інтернету, IP. + +[^14]: Менеджери рівня 2 та вище виключаються. diff --git a/uk/origin/plazma/adminstration/reference/commands.md b/uk/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..382afcbdd --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про доступні команди у Plazma. +--- + +# 🖥️ Команди diff --git a/uk/origin/plazma/adminstration/reference/configurations/bukkit.md b/uk/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..e1ef6faad --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/uk/origin/plazma/adminstration/reference/configurations/paper/README.md b/uk/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..f163b4232 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, для чого призначений кожний файл у папці config. +--- + +# 🛩️ Папір diff --git a/uk/origin/plazma/adminstration/reference/configurations/paper/global.md b/uk/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..fa9e47177 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у paper-global.yml. +--- + +# 🛩️ Папір (глобальний конфіг) diff --git a/uk/origin/plazma/adminstration/reference/configurations/paper/world.md b/uk/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..3d7c6ff78 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у paper-world.yml. +--- + +# 🛩️ Paper (склад світу) diff --git a/uk/origin/plazma/adminstration/reference/configurations/plazma/README.md b/uk/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..d2de310b5 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, для чого призначений кожний файл у папці config. +--- + +# ✨ Плазма diff --git a/uk/origin/plazma/adminstration/reference/configurations/plazma/global.md b/uk/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..828359fdf --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у plazma-global.yml. +--- + +# ✨ Plazma (глобальна конфігурація) diff --git a/uk/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/uk/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..0c8bf9c9a --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Світовий склад diff --git a/uk/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/uk/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..07982555d --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у plazma-world.yml. +--- + +# ✨ Plazma (склад за світами) diff --git a/uk/origin/plazma/adminstration/reference/configurations/property.md b/uk/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..6cdb46e06 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у server.properties. +--- + +# 🪨 Server.properties diff --git a/uk/origin/plazma/adminstration/reference/configurations/pufferfish.md b/uk/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..fd43de5f3 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у pufferfish.yml. +--- + +# 🐡 Риба-балон diff --git a/uk/origin/plazma/adminstration/reference/configurations/purpur/README.md b/uk/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..5e0330a5a --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у purpur.yml. +--- + +# 🦑 Purpur diff --git a/uk/origin/plazma/adminstration/reference/configurations/purpur/global.md b/uk/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..916358f58 --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у purpur.yml. +--- + +# 🦑 Пурпур (глобальна структура) diff --git a/uk/origin/plazma/adminstration/reference/configurations/purpur/world.md b/uk/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..1dd8b2a5a --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у purpur.yml. +--- + +# 🦑 Пурпур (склад світу) diff --git a/uk/origin/plazma/adminstration/reference/configurations/spigot.md b/uk/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..fdd20642d --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся, що означає кожен вузол у spigot.yml. +--- + +# 🚰 Spigot diff --git a/uk/origin/plazma/adminstration/reference/permissions.md b/uk/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..9d2d2ce9b --- /dev/null +++ b/uk/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Дізнайтеся про дозволи Plazma. +--- + +# 🛡️ Дозволи diff --git a/uk/origin/plazma/developers.md b/uk/origin/plazma/developers.md new file mode 100644 index 000000000..7a4347f9e --- /dev/null +++ b/uk/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Розробляйте сторонні проекти за допомогою Plazma. +--- + +# ⚙️ Керівництво розробника diff --git a/uk/origin/thunderbolt/README.md b/uk/origin/thunderbolt/README.md new file mode 100644 index 000000000..6051dd73a --- /dev/null +++ b/uk/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt - це платформа на основі Plazma, яка дозволяє використовувати експериментальні патчі, розділяючи їх за смаком. +--- + +# 🌩️ Посібник з використання Thunderbolt diff --git a/uk/origin/volt/README.md b/uk/origin/volt/README.md new file mode 100644 index 000000000..a41af6549 --- /dev/null +++ b/uk/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt - це відкритий шаблон, який дозволяє розробляти власну платформу сервера Paperweight на основі Plazma. +--- + +# ⚡ Посібник з розробки Volt diff --git a/vi/origin/README.md b/vi/origin/README.md new file mode 100644 index 000000000..ea7bb8aa5 --- /dev/null +++ b/vi/origin/README.md @@ -0,0 +1,41 @@ +--- +description: Nếu có câu hỏi, vui lòng đặt câu hỏi qua Discord hoặc Thảo luận trên GitHub. +--- + +# 🏠 Chào mừng đến với Cổng Tài liệu + +{% hint style="info" %} + +**Tài liệu của Plazma hiện đang được dịch bằng máy.** + +[![Trạng thái Dịch](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +Tham gia dịch tài liệu tại [https://translate.plazmamc.org/](https://translate.plazmamc.org/) để cải thiện tài liệu. + +{% endhint %} + +### Nếu gặp vấn đề khi sử dụng Plazma, bạn có thể làm gì? + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### Nếu bạn quan tâm đến Thunderbolt? + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` 더 많은 Minecraft 관련 정보가 필요하다면? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/vi/origin/SUMMARY.md b/vi/origin/SUMMARY.md new file mode 100644 index 000000000..81cf3cc1b --- /dev/null +++ b/vi/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# Mục lục + +- [🏠 Chào mừng đến với Cổng Tài liệu](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Tài Liệu Sử Dụng Plazma](plazma/README.md) +- [❓ Plazma là gì?](plazma/about/README.md) + - [⬇️ Tải xuống](plazma/about/downloads.md) + - [✅ Trạng thái hỗ trợ phiên bản](plazma/about/supported-versions.md) +- [⚒️ Hướng dẫn quản trị máy chủ](plazma/administration/README.md) + - [👟 Bắt đầu](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 Tài liệu tham khảo](plazma/administration/reference/README.md) + - [🖥️ Lệnh](plazma/administration/reference/commands.md) + - [🛡️ Quyền](plazma/administration/reference/permissions.md) + - [🎛️ Đối số và Thuộc tính](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 Thuộc tính](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 Cấu hình Toàn cầu](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ Cấu hình theo thế giới](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 Cấu hình Toàn cầu](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ Cấu hình theo thế giới](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 Cấu hình Toàn cầu](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ Cấu hình theo thế giới](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 Sâu hơn](plazma/administration/expert/README.md) + - [🧹 Tối ưu hóa](plazma/administration/expert/optimize.md) + - [🔀 Proxy](plazma/administration/expert/proxy.md) + - [↩️ Biến thành Vanilla](plazma/administration/expert/vanillaize.md) + - [🩻 Chặn X-Ray](plazma/administration/expert/xray.md) + - [⚠️ Lỗ hổng và Cách khắc phục](plazma/administration/expert/fix-exploits.md) + - [⁉️ Câu hỏi thường gặp](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ Hướng dẫn cho nhà phát triển](plazma/developers.md) + - [✏️ Đóng góp](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ Hướng dẫn sử dụng Thunderbolt](thunderbolt/README.md) + +## Volt + +- [⚡ Hướng dẫn phát triển Volt](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ Tải xuống Toàn bộ](plazma/about/downloads-all.md) diff --git a/vi/origin/miscellaneous/README.md b/vi/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/vi/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/vi/origin/plazma/README.md b/vi/origin/plazma/README.md new file mode 100644 index 000000000..cabb41fdf --- /dev/null +++ b/vi/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma là một nền tảng máy chủ mã nguồn mở dành cho Minecraft: Java Edition, kết hợp tối ưu hóa thử nghiệm dựa trên giấy và việc cá nhân hóa nhiều cơ chế trò chơi." +--- + +# ✨ Tài liệu Sử dụng Plazma + +## 👋 Chào mừng đến với Tài liệu Plazma + +Chào mừng bạn đến với Tài liệu Sử dụng Plazma! + +{% hint style="info" %} + +**Không thể giải quyết vấn đề qua hướng dẫn?** + +[Máy chủ Discord chính thức](https://discord.gg/MmfC52K8A8) hoặc [Thảo luận trên GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) để đặt câu hỏi trong cộng đồng! + +{% endhint %} + +### Về Plazma + +> Tìm hiểu về Plazma là gì. + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### Dành cho Quản trị viên + +> Tạo máy chủ riêng của bạn bằng cách sử dụng Plazma. + +{% content-ref url="administration/" %} +[administration](administration/) +{% endcontent-ref %} + +### Dành cho Nhà phát triển + +> Phát triển dự án bên thứ ba bằng cách sử dụng Plazma. + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/vi/origin/plazma/about/README.md b/vi/origin/plazma/about/README.md new file mode 100644 index 000000000..585891888 --- /dev/null +++ b/vi/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: Tìm hiểu về Plazma là gì. +--- + +# ❓ Plazma là gì? + +- **Plazma** là nền tảng máy chủ dựa trên [Paper](https://github.com/PaperMC/Paper) mang lại những điểm mạnh từ [Andromeda](https://github.com/EarendelArchived/Andromeda) và [Fusion](https://github.com/RuinedTechnologyUnify/Fusion). +- Luôn cố gắng cung cấp sự ổn định cao và hiệu suất mạnh mẽ, cập nhật nhanh chóng và nhiều tính năng phong phú. + +## 📋 Mục tiêu của Plazma + +- Đang cố gắng trở thành một nền tảng máy chủ với cập nhật nhanh chóng và ổn định cao. +- Đang cố gắng cung cấp nhiều tính năng và hiệu suất mạnh mẽ không kém phần nền tảng mod. +- Đang cố gắng tạo ra một nền tảng tự do có thể tùy chỉnh các bản vá của Vanilla. + +## ⚙️ Đặc điểm chính + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **Cập nhật nhanh nhất**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate) giữ cho các bản vá trong Plazma luôn cập nhật, cung cấp cập nhật nhanh nhất trong các nền tảng máy chủ dựa trên Paper. +6. **Tối ưu hóa tệp cấu hình mặc định**\ + Tệp cấu hình mặc định đã được tối ưu hóa, không cần phải tối ưu hóa tệp cấu hình một cách riêng lẻ. +7. **Hoạt động đa luồng hệ thống có tổ chức**\ + Bất kỳ cơ chế hệ thống không liên quan đến cơ chế trò chơi nào được bất đồng bộ hóa, giảm [thời gian trễ](#user-content-fn-4)[^4] để tối ưu hóa máy chủ. +8. **Chặn việc sử dụng không cần thiết của không gian**\ + Hợp nhất dữ liệu có giá trị tương tự lại với nhau để giảm bộ nhớ sử dụng. + +## ✨ Ứng dụng thực tế + +- **Nền tảng xử lý plugin phức tạp một cách chính xác**\ + Plazma được sử dụng trên máy chủ của nhà phát triển [IPECTER](https://github.com/IPECTER).\ + Với các plugin tự phát triển hoạt động bằng NMS và Reflection, cùng với số lượng lớn dữ liệu pack phức tạp, + máy chủ vẫn có thể chứa hơn 100 người chơi mà không giảm hiệu suất. +- **Nền tảng duy trì hiệu suất nhanh chóng trên máy chủ RPG**\ + Duy trì 100 người chơi trên một cụm mà không giảm TPS,\ + và cho phép tổng cộng 250 người chơi chơi một cách mượt mà trên 4 cụm. +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **Nhiều nền tảng được nhiều streamer lựa chọn**\ + Được sử dụng như một phần của thùng chứa khán giả của nhiều streamer. + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ Tải xuống + +Bạn có thể tải Plazma từ trang dưới đây. + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### Bạn muốn biết thông tin chi tiết về việc hỗ trợ phiên bản? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot plugin và Paper, Pufferfish, Purpur plugin. + +[^2]: Được cung cấp bởi Microsoft Corporation. + +[^3]: Nếu vô hiệu hóa hệ thống báo cáo trò chuyện, việc trò chuyện chỉ được xử lý trên máy chủ, ngăn chặn việc theo dõi trò chuyện từ Mojang. + +[^4]: Thời gian dừng game trong một khoảng thời gian ngắn để hệ thống hoạt động. diff --git a/vi/origin/plazma/about/downloads-all.md b/vi/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..b33fd4ba0 --- /dev/null +++ b/vi/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Tải xuống toàn bộ tệp Plazma +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| Phiên bản | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/vi/origin/plazma/about/downloads.md b/vi/origin/plazma/about/downloads.md new file mode 100644 index 000000000..f66f03f7b --- /dev/null +++ b/vi/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: Hãy tải Plazma ngay bây giờ và trải nghiệm trực tiếp. +--- + +# ⬇️ Tải xuống + +#### Bạn muốn biết thông tin chi tiết về việc hỗ trợ phiên bản? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**Dưới đây là tệp thực thi dành cho người dùng thông thường.** + +Nếu bạn là một nhà phát triển và cần một loại tệp khác, vui lòng tham khảo trang dưới đây. + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Phiên bảnTải xuống
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 다운로드 +
1.20.1 + Tải_xuống +
1.19.4 + Tải_xuống +
+ +*** diff --git a/vi/origin/plazma/about/patches-list.md b/vi/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..80d7aedc5 --- /dev/null +++ b/vi/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu tất cả các tính năng được thêm vào Plazma. +--- + +# 📑 Bản vá bao gồm diff --git a/vi/origin/plazma/about/supported-versions.md b/vi/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..caaa8b1da --- /dev/null +++ b/vi/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "Tìm hiểu về phiên bản Minecraft: Java Edition được hỗ trợ trong Plazma." +--- + +# ✅ Trạng thái hỗ trợ phiên bản + +{% hint style="info" %} + +**Plazma được phát triển từ phiên bản 1.19.4 trở lên, các phiên bản dưới 1.19.4 không còn được phát triển nữa.** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: +[idv]: https://badge.plazmamc.org/1/개발중 +[atv]: https://badge.plazmamc.org/2/지원중 +[fse]: https://badge.plazmamc.org/6/기능%20지원%20중단 +[eol]: https://badge.plazmamc.org/4/지원%20종료 +[ukn]: https://badge.plazmamc.org/0/Thông%20tin%20không%20có +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/보통 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![개발중][idv] ![지원중][atv] ![기능 지원 중단][fse] ![지원 종료][eol] + +| Phiên bản | Độ ổn định và Hỗ trợ chức năng | Trạng thái xây dựng | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![Trạng thái xây dựng](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![Trạng thái xây dựng](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/vi/origin/plazma/administration/README.md b/vi/origin/plazma/administration/README.md new file mode 100644 index 000000000..123e924df --- /dev/null +++ b/vi/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: Tạo máy chủ riêng của bạn bằng cách sử dụng Plazma. +--- + +# ⚒️ Hướng dẫn quản lý máy chủ diff --git a/vi/origin/plazma/administration/diagnosis/README.md b/vi/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..9d0942715 --- /dev/null +++ b/vi/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: 알아보세요 문제가 발생했을 때 대처하는 방법을 +--- + +# 🧾 진단 diff --git a/vi/origin/plazma/administration/diagnosis/plugins.md b/vi/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..e53f0537f --- /dev/null +++ b/vi/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách khắc phục khi plugin không hoạt động đúng cách. +--- + +# 📜 플러그인 diff --git a/vi/origin/plazma/administration/expert/README.md b/vi/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..cfba35314 --- /dev/null +++ b/vi/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách xử lý Plazma một cách chuyên nghiệp. +--- + +# 🎓 Sâu hơn diff --git a/vi/origin/plazma/administration/expert/fix-exploits.md b/vi/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..eb10854a2 --- /dev/null +++ b/vi/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu về các lỗ hổng đã biết và cách khắc phục chúng. +--- + +# ⚠️ Các lỗ hổng đã biết và cách khắc phục diff --git a/vi/origin/plazma/administration/expert/optimize.md b/vi/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..29d1655e4 --- /dev/null +++ b/vi/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách tối ưu hóa Plazma. +--- + +# 🧹 Tối ưu hóa diff --git a/vi/origin/plazma/administration/expert/proxy.md b/vi/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..289690b02 --- /dev/null +++ b/vi/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách cấu hình an toàn cho nền tảng Proxy "Velocity". +--- + +# 🔀 Proxy diff --git a/vi/origin/plazma/administration/expert/vanillaize.md b/vi/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..c5a2e6c65 --- /dev/null +++ b/vi/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: Tìm hiểu cách khôi phục bản vá giữa Paper và Vanilla. +--- + +# ↩️ Vanilla hóa + +{% hint style="warning" %} + +**Paper không thêm lựa chọn vào hầu hết các bản vá lỗi của Vanilla.** + +Hiện tại, Plazma đang phát triển cách vô hiệu hóa việc sửa lỗi này thông qua cấu hình. + +Vì vậy, hướng dẫn này vẫn đang được viết và thông tin có thể thay đổi bất cứ lúc nào. + +{% endhint %} diff --git a/vi/origin/plazma/administration/expert/xray.md b/vi/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..ce752ffe9 --- /dev/null +++ b/vi/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu về các phương pháp tích hợp khác nhau để ngăn chặn X-Ray. +--- + +# 🩻 Ngăn chặn X-Ray diff --git a/vi/origin/plazma/administration/faq.md b/vi/origin/plazma/administration/faq.md new file mode 100644 index 000000000..0f7e63d71 --- /dev/null +++ b/vi/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: Tìm hiểu về các câu hỏi thường gặp. +--- + +# ⁉️ Câu hỏi thường gặp + +{% hint style="info" %} + +**Không tìm thấy câu trả lời bạn muốn?** + +[Máy chủ Discord chính thức](https://discord.gg/MmfC52K8A8) hoặc [Thảo luận trên GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) để đặt câu hỏi trong cộng đồng! + +{% endhint %} + +### Plazma không khởi động được + +Nếu bạn thấy thông báo `no main manifest attribute, in plazma-(version).jar` trên cửa sổ console,\ +file bạn đã tải xuống là file API dành cho phát triển, bạn cần phải tải **Reobf Paperweight** từ trang GitHub. + +Để biết thêm chi tiết, vui lòng tham khảo trang sau. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Cảnh báo xuất hiện mỗi khi máy chủ khởi động + +Plazma chứa một số bản vá không ổn định và luôn có khả năng gây sự cố, vì vậy máy chủ sẽ hiển thị thông báo sau mỗi lần khởi động. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Bạn có thể vô hiệu hóa thông báo này bằng cách sử dụng thuộc tính hệ thống [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Để biết thêm chi tiết, vui lòng tham khảo trang sau. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Có sẵn từ phiên bản 1.20.1 trở lên diff --git a/vi/origin/plazma/administration/getting-started/README.md b/vi/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..efd44b8a3 --- /dev/null +++ b/vi/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,317 @@ +--- +description: Tìm hiểu cách tạo máy chủ bằng Plazma. +--- + +# 👟 Bắt đầu + +Để sử dụng Plazma một cách ổn định, hệ thống cần đáp ứng các yêu cầu sau. + +| | Tối thiểu | Đề nghị | +| :----------------: | --------- | ------- | +| Kiến trúc | x64 | - | +| RAM | 8GB | 16GB | +| Dung lượng lưu trữ | 1GB | 8GB | +| JDK | 17 | 21 | + +Để dễ dàng chỉnh sửa tệp cấu hình, cài đặt trình soạn thảo như [Visual Studio Code](https://code.visualstudio.com/download) cũng là một ý tưởng tốt. + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="Đầu ra chính xác" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. Trước tiên, tải JDK 21 từ [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu) dưới dạng `.msi`. +2. Chạy trình cài đặt đã tải xuống và nhấn `Next`. +3. **Kích hoạt `Set JAVA_HOME variable` trong menu hiển thị ở giữa bên trái của cửa sổ,** sau đó nhấn `Next`. +4. Nhấn `Install` để hoàn tất quá trình cài đặt JRE. + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Sau đó, chạy lệnh sau trong Terminal để cài đặt JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Tải xuống Plazma + +Plazma cung cấp nhiều loại tệp thực thi khác nhau. + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +Tìm hiểu thêm + +Tên tệp thực thi được xác định là `plazma-(quản lý phiên bản)-1.20.4-R0.1-SNAPSHOT-(kiểu ánh xạ).jar`. + +- **Kiểu ánh xạ**\ + Ánh xạ là một loại bản đồ kết nối giữa mã nguồn thực và mã nguồn đã bị làm rối. + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **Quản lý phiên bản**\ + Quản lý phiên bản là một loại trình khởi chạy máy chủ cung cấp thư viện cần thiết cho việc chạy máy chủ và áp dụng bản vá cho máy chủ. + - **Paperclip**\ + Là một trình quản lý phát triển bởi nhóm PaperMC để tải về thư viện và áp dụng bản vá cho Paper và các nền tảng phát sinh khác. + - **Bundler**\ + Là trình quản lý phiên bản Minecraft vanilla. + +
+ +*** + +## 3. Tạo kịch bản khởi động + +Để bắt đầu Plazma một cách dễ dàng và tự động khởi động lại máy chủ, bạn cần tạo [kịch bản khởi động](#user-content-fn-6)[^6]. + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +Bạn có thể tải kịch bản khởi động thông qua nút tải xuống ở góc dưới bên trái.\ +**Hãy chắc chắn rằng tệp kịch bản khởi động đã được tải xuống đúng phiên bản của hệ điều hành của bạn.** + +*** + +## 4. Dọn dẹp tệp tin + +Di chuyển kịch bản khởi động và Plazma đã tải xuống vào một thư mục mới. + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +Chạy kịch bản khởi động bây giờ. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. Đồng ý với EULA + +Sau khi chạy kịch bản khởi động một lần, tệp `eula.txt` sẽ được tạo ra trong thư mục. + +EULA[^9] là hợp đồng cấp phép mà bạn phải đồng ý khi sử dụng dịch vụ của [Mojang Studios](#user-content-fn-10)[^10]. + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +Để đồng ý với EULA, chỉnh sửa `eula=false` trong tệp `eula.txt` thành `eula=true` và lưu lại. + +*** + +## 6. Cho phép kết nối từ bên ngoài (Windows) + +Hệ điều hành hiện đại mặc định chặn kết nối từ bên ngoài để ngăn chặn truy cập nguy hiểm thông qua **tường lửa** và **bộ định tuyến**. + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +Nếu bộ định tuyến không hỗ trợ UPnP, từng bộ định tuyến có cấu hình khác nhau, vì vậy bạn cần tìm kiếm thông tin trực tiếp. + +Hoặc bạn có thể sử dụng [Ngrok](https://ngrok.com/) để tạo địa chỉ tạm thời. +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 Kiểm tra cần thiết về chuyển tiếp cổng + +Nhập và chạy như sau trong cửa sổ chạy. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Nếu kết quả là `True`, bạn có thể dừng ở đây, nhưng nếu là `False`, bạn cần cấu hình chuyển tiếp cổng. + +### 6.2 Kết nối đến máy chủ + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +Địa chỉ được sử dụng để kết nối đến máy chủ có thể được xác nhận [tại đây](https://ip.pe.kr/). +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +Sau đó, khởi động lại máy chủ, Plazma sẽ tự động thử chuyển tiếp cổng. + +Dưới đây là kết quả thành công của UPnP dựa trên thông báo xuất hiện trên cửa sổ console, trên console sẽ hiển thị `[UPnP] (thông báo)`. + +| Thông báo | Ý nghĩa | +| --------------------------------- | -------------------------------------------------------- | +| `Successfully opened port (cổng)` | Chuyển tiếp cổng thành công. | +| `Port (cổng) is already open` | Cổng đang được sử dụng bởi dịch vụ khác. | +| `Failed to open port (cổng)` | Chuyển tiếp cổng thất bại. | +| `Service is unavailable` | Bộ định tuyến không hỗ trợ UPnP. | + +Khi máy chủ tắt, Plazma sẽ tự động đóng cổng. +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. Tải xuống tệp ZIP `Windows (64-bit)` từ [trang chủ Ngrok](https://ngrok.com/download). +2. Đặt tệp Ngrok đã tải xuống vào thư mục máy chủ. +3. Tạo [token xác thực](#user-content-fn-13) từ [bảng điều khiển Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) trong thư mục máy chủ. +4. Chạy lệnh được hiển thị trong `Command Line` trong thư mục máy chủ. +5. Thêm `start /b ngrok tcp --region jp 25565` vào đầu tập lệnh chạy và `taskkill /f /t /im ngrok.exe` vào cuối tập lệnh chạy. +6. Từ thông báo `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` ở đầu console, `0.tcp.jp.ngrok.io:12345` sẽ là địa chỉ của máy chủ. +7. Bây giờ bạn có thể kết nối từ bên ngoài thông qua địa chỉ đó. + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +Ví dụ, sau khi thực thi lệnh, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Khi thử kết nối đến máy chủ, sử dụng địa chỉ IPv4 được hiển thị là `192.168.3.7`. + +Nếu máy chủ và trò chơi chạy trên cùng một PC, bạn có thể kết nối bằng `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Phát triển + +Sau khi máy chủ khởi động thành công và hoạt động đúng cách, bây giờ là lúc cá nhân hóa máy chủ. + +Hãy tìm hiểu cách cá nhân hóa máy chủ thông qua hướng dẫn dưới đây. + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Paper, nền tảng của Plazma, dựa trên Spigot và Spigot dựa trên nền tảng máy chủ chính thức. + +[^3]: Phím Windows + R + +[^4]: Trong Linux, chạy `java --version` trong terminal + +[^5]: JRE là một trong những dự án mã nguồn mở, tương tự như nền tảng máy chủ Minecraft với nhiều loại khác nhau. + +[^6]: Thường được biết đến là **trình chạy**. + +[^7]: Kích hoạt "Tự động khởi động lại" sẽ tự động khởi động lại máy chủ. Nhấn `Control + C` để dừng. + +[^8]: Không khuyến khích vượt quá nửa dung lượng hệ thống. + + Ví dụ, nếu dung lượng bộ nhớ hệ thống là 8GB, không nên thiết lập trên 4GB. + +[^9]: End-User License Agreement, Thỏa thuận Sử dụng cuối cùng. Vui lòng kiểm tra chi tiết tại [trang chủ Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Tập đoàn Microsoft. + +[^11]: Theo Điều 32, Khoản 1, Mục 9 của Luật Phát triển Ngành công nghiệp Game của Hàn Quốc, **Công ty TNHH Microsoft Hàn Quốc** có thể bị truy tố hợp pháp. + +[^12]: Universal Plug & Play. Purpur đi kèm trong Plazma sử dụng công nghệ này để tự động giao tiếp với bộ định tuyến và mở cổng chỉ khi máy chủ đang chạy, không cần phải chuyển tiếp cổng trực tiếp. + +[^13]: Nếu không có tài khoản, đăng ký Ngrok thông qua tài khoản Google hoặc GitHub. diff --git a/vi/origin/plazma/administration/getting-started/customization.md b/vi/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..a26e89b0b --- /dev/null +++ b/vi/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,126 @@ +--- +description: Tìm hiểu cách tùy chỉnh máy chủ. +--- + +# 🎨 Tùy chỉnh người dùng + +Lý do sử dụng nền tảng máy chủ được sửa đổi như Plazma thay vì sử dụng nền tảng chính thức do Mojang Studios cung cấp là khả năng **tùy chỉnh** mạnh mẽ nhất. + +Dưới đây là một số cách để tùy chỉnh và sử dụng Plazma. + +## Sửa đổi cấu hình + +Cách đơn giản nhất để tùy chỉnh Plazma là chỉnh sửa cấu hình. + +Plazma cung cấp cấu hình mạnh mẽ từ cơ chế trò chơi đến thuộc tính của quái vật. + +Vui lòng xem chi tiết về cấu hình của Plazma tại trang dưới đây. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## Sử dụng plugin + +{% hint style="success" %} + +**Plazma hỗ trợ tất cả các plugin dựa trên Paper một cách bình thường.** + +Với các plugin Spigot, có thể có một số plugin không hoạt động do sự thay đổi về ánh xạ của Paper từ phiên bản 1.20.5 trở đi, +nhưng hầu hết các plugin dựa trên Paper như Paper, Pufferfish và Purpur đều hoạt động trên Plazma +và nếu không hoạt động đúng cách, đó là lỗi của Plazma nên bạn vui lòng [báo cáo ngay.](../diagnosis/plugins.md) + +{% endhint %} + +Đây là lý do chính khiến bạn nên sử dụng Plazma và cũng là cách mạnh mẽ nhất để cá nhân hóa Plazma. +Hệ sinh thái plugin mạnh mẽ của Plazma giúp bạn dễ dàng cá nhân hóa máy chủ. + +Có nhiều cách để tìm kiếm và tải plugin. Một số plugin +được tải lên dịch vụ kho lưu trữ công cộng, trong khi một số plugin khác được tải lên GitHub hoặc trang web +của họ. + +{% hint style="caution" %} + +**Plugin có thể truy cập trực tiếp vào hệ thống của bạn!** + +Luôn kiểm tra plugin bằng dịch vụ như VirusTotal trước khi áp dụng, +hoặc tải plugin từ dịch vụ đáng tin cậy. + +{% endhint %} + +Có nhiều dịch vụ để tải plugin. Trong số đó, các dịch vụ như [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) sẽ kiểm duyệt plugin trước khi được tải lên, +và chỉ phân phối các plugin an toàn. + +### Áp dụng Plugin + +Sau khi tải plugin, bạn có thể áp dụng chúng. + +1. Plugin có dạng `.jar` hoặc `Java Executable File`.\ + Một số plugin được nén thành tập tin nén, trong trường hợp đó + bạn cần giải nén và sử dụng tập tin chứa `bukkit`, `spigot` hoặc `paper`, + nếu có tập tin `fat` đi kèm, sử dụng tập tin `fat`. +2. Đặt tập tin đã tải vào thư mục `plugins` của máy chủ và khởi động (lại) máy chủ. +3. Khi Plazma khởi động, thông tin mới sẽ được hiển thị trên bảng điều khiển. + Điều này có nghĩa là Plazma đã tải plugin một cách bình thường. +4. Dù Plazma đã tải plugin một cách bình thường, có thể plugin chưa khởi động được. + Sử dụng lệnh `/plugins` để xem danh sách plugin đang hoạt động trên máy chủ. + Nếu tên plugin cài đặt không được hiển thị màu đỏ + màu xanh lá cây thì plugin đã được tải đúng cách. + +Nếu plugin không được tải đúng cách, bạn có thể tìm thấy cách khắc phục trên trang dưới đây. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## Sử dụng Data Pack + +Data Pack là cách cá nhân hóa Minecraft mà trò chơi cung cấp sẵn, tương tự như +[Resource Pack](#user-content-fn-1)[^1]. + +Với Data Pack, bạn có thể thêm nhóm sinh vật mới và thách thức mới vào trò chơi +và chỉnh sửa một số phần của trò chơi. + +{% hint style="caution" %} + +**Data Pack có thể làm hỏng thế giới của bạn!** + +Một số Data Pack bị hỏng có thể làm hỏng thế giới của bạn và điều này không thể khôi phục được. + +Do đó, việc sao lưu thế giới trước khi áp dụng Data Pack được khuyến khích. + +{% endhint %} + +Data Pack cũng có thể tải từ nhiều dịch vụ như [CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) và nhiều dịch vụ khác. + +Sau khi tải Data Pack, bạn có thể đặt chúng vào thư mục `datapacks` trong thế giới của máy chủ để áp dụng. +Nếu không có thư mục, bạn có thể tạo một thư mục và thêm vào đó. + +{% hint style="warning" %} + +**Một số Data Pack có thể không áp dụng đúng lần đầu.** + +Trong trường hợp này, khuyến nghị khởi động máy chủ **2 lần**. + +{% endhint %} + +Data Pack có thể dễ bị hỏng mỗi khi Minecraft được cập nhật. + +Đặc biệt, nếu Data Pack bị hỏng hoàn toàn, máy chủ có thể bị sự cố, +cho nên việc thử nghiệm kỹ lưỡng trước khi cập nhật máy chủ là rất quan trọng. + +{% hint style="info" %} + +**Sau lệnh khởi động máy chủ, nhập `safeMode` để tắt tất cả Data Pack và khởi động máy chủ.** + +[Xem thêm tại `Reference > Arguments` để biết thông tin chi tiết.](../reference/arguments.md) + +{% endhint %} + +Data Pack đã áp dụng có thể được kiểm tra thông qua lệnh `/datapack list`. + +*** + +[^1]: Hoặc Add-on cho Minecraft: Bedrock Edition. + +[^2]: Bao gồm việc thêm nhóm sinh vật vào trò chơi. diff --git a/vi/origin/plazma/administration/getting-started/next-step.md b/vi/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..ef701a31c --- /dev/null +++ b/vi/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,171 @@ +--- +description: Tìm hiểu cách tùy chỉnh máy chủ. +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +Dưới đây là một số cách để tùy chỉnh và sử dụng Plazma. + +## Sửa đổi cấu hình + +Cách đơn giản nhất để tùy chỉnh Plazma là chỉnh sửa cấu hình. + +Plazma cung cấp cấu hình mạnh mẽ từ cơ chế trò chơi đến thuộc tính của quái vật. + +Vui lòng xem chi tiết về cấu hình của Plazma tại trang dưới đây. + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## Sử dụng plugin + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +Đây là lý do chính khiến bạn nên sử dụng Plazma và cũng là cách mạnh mẽ nhất để cá nhân hóa Plazma. Hệ sinh thái plugin mạnh mẽ của Plazma giúp bạn dễ dàng cá nhân hóa máy chủ. + +Có nhiều cách để tìm kiếm và tải plugin. 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +Có nhiều dịch vụ để tải plugin. Trong số đó, các dịch vụ như [SpigotMC Forum](https://www.spigotmc.org/resources/), [BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins), [Modrinth](https://modrinth.com/plugins), [Hanger](https://hangar.papermc.io/) sẽ kiểm duyệt plugin trước khi được tải lên, +và chỉ phân phối các plugin an toàn. + +### Áp dụng Plugin + +Sau khi tải plugin, bạn có thể áp dụng chúng. + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. Đặt tập tin đã tải vào thư mục `plugins` của máy chủ và khởi động (lại) máy chủ. +3. Khi Plazma khởi động, thông tin mới sẽ được hiển thị trên bảng điều khiển. Điều này có nghĩa là Plazma đã tải plugin một cách bình thường. +4. Dù Plazma đã tải plugin một cách bình thường, có thể plugin chưa khởi động được. Sử dụng lệnh `/plugins` để xem danh sách plugin đang hoạt động trên máy chủ. 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +Nếu plugin không được tải đúng cách, bạn có thể tìm thấy cách khắc phục trên trang dưới đây. + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## Sử dụng Data Pack + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +Với Data Pack, bạn có thể thêm nhóm sinh vật mới và thách thức mới vào trò chơi +và chỉnh sửa một số phần của trò chơi. + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +Một số Data Pack bị hỏng có thể làm hỏng thế giới của bạn và điều này không thể khôi phục được. + +Do đó, việc sao lưu thế giới trước khi áp dụng Data Pack được khuyến khích. +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +Sau khi tải Data Pack, bạn có thể đặt chúng vào thư mục `datapacks` trong thế giới của máy chủ để áp dụng. Nếu không có thư mục, bạn có thể tạo một thư mục và thêm vào đó. + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +Trong trường hợp này, khuyến nghị khởi động máy chủ **2 lần**. +{% endhint %} + +Data Pack có thể dễ bị hỏng mỗi khi Minecraft được cập nhật. + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +Data Pack đã áp dụng có thể được kiểm tra thông qua lệnh `/datapack list`. + +*** + +## Tối ưu hóa + +Plazma đã áp dụng nhiều bản vá tối ưu hóa. 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## Proxy + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +Vui lòng tham khảo thông tin về cấu hình proxy an toàn và chính xác tại trang dưới đây. + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## An toàn + +Với sự phát triển của các mod, Minecraft có thể dễ dàng bị tấn công bởi [engine xâm nhập](#user-content-fn-3)[^3] trên mạng. + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### Thiết lập quyền + +Một số lệnh quản trị của các plugin có thể tồn tại lỗ hổng nếu quyền không được cấu hình đúng. + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### Chặn X-Ray + +X-Ray là một trong những lỗ hổng dễ dàng sử dụng trên các client tối ưu hóa cơ bản. + +Plazma cung cấp cấu hình để chặn X-Ray mặc định. + +Vui lòng tham khảo cách chặn X-Ray và mô tả tại trang dưới đây. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### Danh sách trắng + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +Để xem danh sách người chơi được phép kết nối, sử dụng `/whitelist query`. + +*** + +[^1]: Hoặc Add-on cho Minecraft: Bedrock Edition. + +[^2]: Bao gồm việc thêm nhóm sinh vật vào trò chơi. + +[^3]: Thường được gọi là "hack". + +[^4]: Trong trường hợp cấu hình chưa được tối ưu hóa, Plazma lỗi thời hoặc có lỗ hổng mới, có thể không chặn được. + +[^5]: Khi người chơi kết nối vào máy chủ, thông qua máy chủ proxy Ngrok, địa chỉ Ngrok được cấp phát mỗi lần khởi động sẽ khác nhau. diff --git a/vi/origin/plazma/administration/reference/README.md b/vi/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..ea237a474 --- /dev/null +++ b/vi/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: Tìm hiểu cách tùy chỉnh cơ bản được cung cấp bởi Plazma. +--- + +# 📜 리퍼런스 + +Plazma cung cấp nhiều cách tùy chỉnh khác nhau. + +Trong đó, có 4 cách tùy chỉnh sau đây là cách tùy chỉnh có thể sử dụng ngay mà không cần thêm bất kỳ công việc nào. + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[Máy chủ Discord chính thức](https://discord.gg/MmfC52K8A8) hoặc [Thảo luận trên GitHub](https://github.com/PlazmaMC/PlazmaBukkit/discussions) để đặt câu hỏi trong cộng đồng! +{% endhint %} + +*** + +## 🖥️ Lệnh + +> Lệnh cho phép thu thập thông tin trong trò chơi hoặc tùy chỉnh môi trường chơi. + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ Quyền + +> Quyền xác định phạm vi mà người chơi có thể tương tác. + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ Tham số và Thuộc tính + +> Tham số và Thuộc tính ảnh hưởng đến hoạt động của Plazma một cách toàn diện. + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 Cấu hình + +> Cấu hình là cách tùy chỉnh cơ bản nhất của Plazma. + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/vi/origin/plazma/administration/reference/arguments.md b/vi/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..6678d456e --- /dev/null +++ b/vi/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: Tìm hiểu về đối số khởi đầu và thuộc tính hệ thống. +--- + +# 🎛️ Đối số và thuộc tính + +Bắt đầu và thuộc tính hệ thống là các giá trị được thêm vào [lệnh được sử dụng](#user-content-fn-1)[^1] trong việc thực thi Plazma, ảnh hưởng tổng thể đến hoạt động của Plazma. + +[위치에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 매개변수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## Thuộc tính hệ thống + +Thuộc tính hệ thống được nhập trước `-jar` và được xử lý trong JVM trước khi Plazma khởi tạo. + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### Cách sử dụng + +Thuộc tính hệ thống được nhập như một đối số lệnh Java giữa `java` và `-jar`. + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` chỉ ra rằng đối số này không được tích hợp trong JVM mà là đối số riêng của Plazma, + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### Toàn bộ thuộc tính hệ thống + +#### `convertLegacySigns` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Cập nhật định dạng biển báo đã ngưng sử dụng. + +#### `debug.entities` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi liên quan đến thông tin thực thể. + +#### `debug.rewriteForIDE` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa NMS revision để IDE có thể đọc thông tin gỡ lỗi một cách chính xác và tự động làm lại thông tin phiên bản nội bộ. + +#### `disable.watchdog` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa hệ thống cảnh báo Watchdog của Spigot. + +#### `letMeReload` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa thông báo xác nhận lệnh `/reload`. + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +Nếu bạn là nhà phát triển plugin và cần phải cập nhật plugin, hãy sử dụng hotswap thay vì `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa plugin sử dụng hệ thống nhập/xuất tiêu chuẩn. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Cảnh báo khi phát hiện định dạng cũ trong thành phần chat. + +#### `Paper.bypassHostCheck` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa kiểm tra khớp mẫu máy chủ khi người chơi kết nối đến máy chủ. + +#### `Paper.debugDynamicMissingKeys` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi cho các khóa bị thiếu trong đối tượng NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi cho các hồ sơ đầu mạc không hợp lệ. + +Nhật ký này sẽ ghi lại tất cả các hồ sơ đầu mạc không hợp lệ trong thế giới cùng với vị trí của chúng. + +#### `Paper.disableChannelLimit` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa hệ thống ưu tiên lớp plugin. + +Hữu ích khi gặp vấn đề trong plugin shade. + +#### `Paper.disableFlushConsolidate` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa hệ thống gộp nén flush của Netty. + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **Giá trị mặc định**: `750` + +Nếu số thực thể vượt quá giá trị được đặt, chúng sẽ được chia thành các gói tin đa phần và gửi đi. + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **Giá trị mặc định**: `8192` + +Thiết lập kích thước tối đa của gói tin mà máy chủ có thể nhận được trong một lần. + +#### `Paper.ignoreJavaVersion` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa kiểm tra phiên bản Java. + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +Có thể dẫn đến hỏng toàn bộ tệp trong thế giới và làm hỏng cơ chế trò chơi. + +Mọi vấn đề phát sinh từ việc này là trách nhiệm của bạn và Plamza sẽ không hỗ trợ bất kỳ vấn đề nào liên quan. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **Giá trị mặc định**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **Giá trị mặc định**: `80` + +Thiết lập độ dài tối đa của mỗi dòng trên biển báo. + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **Giá trị mặc định**: `(phiên bản thế giới) + 1` + +Thiết lập phiên bản thông tin cập nhật thế giới cần khởi tạo trước hết. + +Hữu ích khi cần cập nhật lượng lớn chunk, nhưng không cần thiết trong các trường hợp khác. + +#### `Paper.parseYamlCommentsByDefault` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `True` + +Kích hoạt xử lý chú thích trong tệp YAML mặc định. + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **Giá trị mặc định**: `30` + +Khi không nhận được bất kỳ dữ liệu nào từ người chơi trong thời gian được chỉ định (giây), máy chủ sẽ đuổi người chơi. + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Bỏ qua các chú thích trong tệp cấu hình máy chủ. + +#### `Paper.debug-sync-loads` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi việc tải đồng bộ chunk. + +#### `Paper.enable-sync-chunk-writes` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt hệ thống ghi chunk theo trình tự mặc định của Minecraft. + +Điều này làm cho việc lưu trữ mỗi chunk theo thứ tự, gây ra sự giảm hiệu suất lớn. + +#### `Paper.explicit-flush` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt việc xả của mạng chanel một cách rõ ràng. + +#### `Paper.strict-thread-checks` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Luôn ghi log lỗi không xảy ra trên luồng chính. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Xuất cảnh báo nếu công việc đặt trước có thời gian chờ quá lâu. + +#### `Paperclip.patchOnly` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Khi sử dụng tệp thực thi mặc định, chỉ áp dụng bản vá mà không khởi động máy chủ. + +#### `Plazma.aggressiveOptimize` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` +- **충돌**: `Plazma.disableConfigOptimization` + +초기 구성을 더 강하게 최적화 합니다. + +활성화 하면 서버가 더욱 빨라지고 안전해지지만, 게임 플레이에 큰 영향을 줄 수 있습니다. + +#### `Plazma.disableConfigOptimization` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` +- **충돌**: `Plazma.aggressiveOptimize` + +초기 구성을 최적화하지 않습니다. + +이는 Paper의 기본 구성을 사용하도록 합니다. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` + +Plazma 브랜딩을 비활성화 하고 바닐라 기본 서버 패비콘을 사용하도록 합니다. + +#### `Plazma.useVanillaConfiguration` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` +- **충돌**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +이는 서버 안전 및 성능에 크게 영향을 줄 수 있습니다. + +해당 속성을 사용하여 발생하는 모든 문제는 서버 관리자에게 있습니다. +{% endhint %} + +초기 구성을 Mojang에서 제공하는 기본값으로 제공합니다. + +이는 Paper에서 적용한 모든 취약점 패치를 비활성화 합니다. + +취약점 패치는 Paper 구성 또는 Plazma 구성에서 다시 활성화 할 수 있습니다. + +#### `Plazma.vanillaize` + +- **Loại**: `Boolean` +- **기본값**: `true` +- **충돌**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +초기 구성을 바닐라에 가깝게 설정합니다. + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### Thuộc tính đã bị ngưng sử dụng + +Dưới đây là các thuộc tính hệ thống đã bị ngưng sử dụng. + +#### `timings.bypassMax` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` +- **ĐÃ NGƯNG SỬ DỤNG**: Timings đã bị loại bỏ hoàn toàn khỏi Plazma từ sau + +Quyết định xem có thể vượt quá giá trị tối đa có thể gửi đến API Timings của Aikar. + +Ngay cả khi điều này xảy ra, nếu không được xử lý bởi API, giới hạn tần suất sẽ được áp dụng. + +*** + +## Tham số bắt đầu + +Tham số bắt đầu được nhập sau `-jar *.jar` để khởi tạo Plazma và xử lý cùng với nhau. + +### Cách sử dụng + +Thuộc tính hệ thống được nhập như tham số lệnh chương trình sau `-jar *.jar`. + +Ví dụ, nếu bạn muốn áp dụng tham số bắt đầu `nogui`,\ +hãy nhập như sau để Plazma xử lý tham số `nogui` trong quá trình khởi tạo. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Toàn bộ tham số bắt đầu + +#### `bukkit-settings` + +- **Bí danh**: `b` +- **Giá trị mặc định**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **Bí danh**: `c` +- **Giá trị mặc định**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **Bí danh**: `c` +- **Giá trị mặc định**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +Khởi động máy chủ vào thế giới demo. + +#### `eraseCache` + +Xóa tệp cache còn lại sau nâng cấp thế giới. + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **Bí danh**: `?` + +Xuất toàn bộ tham số khởi đầu và mô tả của Plazma. + +#### `initSettings` + +Chỉ tạo tệp cấu hình và kết thúc máy chủ. + +#### `jfrProfile` + +Kích hoạt hồ sơ JFR. + +#### `max-players` + +- **Bí danh**: `s`, `size` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +Vô hiệu hóa bảng điều khiển giao diện đồ họa. + +#### `nojline` + +비활성화된 JLine을 사용하고 바닐라 콘솔을 사용합니다. + +#### `온라인 모드` + +- **별칭**: `o` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +Mojang 인증 서버에서 플레이어를 인증할지 선택합니다. + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 서버를 완전한 바닐라 상태로 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 표시합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 위치에 따라 처리되는 인수가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing`만 입력해도 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 이벤트 감지기. + +[^6]: 이벤트 감지기. + +[^7]: 클라이언트. + +[^8]: 서버와의 정상적인 연결을 나타내는 신호. + +[^9]: Purpur의 AFK 추방 기능을 사용하면 자리를 비운 플레이어도 추방할 수 있습니다. + +[^10]: 동기 청크 작성 시스템, Sync Chunk Write System. + +[^11]: `주의! Plazma는 예기치 않은 문제를 일으킬 수 있으므로 공개 서버에 사용하기 전에 충분히 테스트하십시오.` + +[^12]: 게임에서 `월드 최적화`도 이와 같은 원리로 작동합니다. + +[^13]: `레벨 2` 이상의 관리자는 제외합니다. + +[^14]: 인터넷 프로토콜, IP. diff --git a/vi/origin/plazma/administration/reference/commands.md b/vi/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..aa586b4fd --- /dev/null +++ b/vi/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu về các lệnh có sẵn trong Plazma. +--- + +# 🖥️ Lệnh diff --git a/vi/origin/plazma/administration/reference/configurations/README.md b/vi/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..fff0f67e6 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: Cấu hình là cách tùy chỉnh cơ bản nhất của Plazma. +--- + +# 🧾 구성 + +*** + +## 🪨 Thuộc tính + +> Thuộc tính là tệp cấu hình cơ bản nhất được cung cấp trong Minecraft. Sử dụng thuộc tính để thay đổi cơ chế cơ bản của trò chơi. + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Cấu hình Bukkit + +> Cấu hình Bukkit là tệp cấu hình cơ bản nhất được cung cấp trong Plazma. Sử dụng cấu hình Bukkit để thay đổi cơ chế cơ bản của máy chủ Minecraft. + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Cấu hình Spigot + +> Cấu hình Spigot cho phép chỉnh sửa các cơ chế chi tiết của trò chơi, xử lý người chơi, lệnh và tin nhắn. + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Cấu hình Paper + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Cấu hình Pufferfish + +> Cấu hình Pufferfish cho phép chỉnh sửa xử lý thế giới và thực thể trong Plazma. + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Cấu hình Purpur + +> Thuộc tính Purpur cho phép chỉnh sửa dữ liệu cơ bản tổng thể của trò chơi. + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Cấu hình Plazma + +> Cấu hình Plazma cho phép cá nhân hóa chức năng của Plazma. + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/vi/origin/plazma/administration/reference/configurations/bukkit.md b/vi/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..04a831588 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong tệp bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/vi/origin/plazma/administration/reference/configurations/paper/README.md b/vi/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..0523ea64f --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu mục đích của từng tệp trong thư mục cấu hình. +--- + +# 🛩️ Giấy diff --git a/vi/origin/plazma/administration/reference/configurations/paper/global.md b/vi/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..76d262d6c --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong paper-global.yml. +--- + +# 🌏 전역 구성 diff --git a/vi/origin/plazma/administration/reference/configurations/paper/world.md b/vi/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..f2db38f86 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong tệp paper-world.yml. +--- + +# 🏳️ 세계별 구성 + +Thế giới mỗi diff --git a/vi/origin/plazma/administration/reference/configurations/plazma/README.md b/vi/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..b5ddea011 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu mục đích của từng tệp trong thư mục cấu hình. +--- + +# ✨ Plazma diff --git a/vi/origin/plazma/administration/reference/configurations/plazma/global.md b/vi/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..acbf76d3e --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong tệp plazma-global.yml. +--- + +# 🌏 전역 구성 diff --git a/vi/origin/plazma/administration/reference/configurations/plazma/world.md b/vi/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..fb53995d8 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong plazma-world.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/vi/origin/plazma/administration/reference/configurations/plazma/worlds.md b/vi/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d7d00f9a4 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong plazma-world.yml. +--- + +# ✨ Plazma (Cấu trúc Thế giới) diff --git a/vi/origin/plazma/administration/reference/configurations/property.md b/vi/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..e397ba9da --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong server.properties. +--- + +# 🪨 Server.properties diff --git a/vi/origin/plazma/administration/reference/configurations/pufferfish.md b/vi/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7485003bc --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong pufferfish.yml. +--- + +# 🐡 Cá nóc diff --git a/vi/origin/plazma/administration/reference/configurations/purpur/README.md b/vi/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..0f14cd27a --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong purpur.yml. +--- + +# 🦑 Purpur diff --git a/vi/origin/plazma/administration/reference/configurations/purpur/global.md b/vi/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..b7f28d8ad --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong purpur.yml. +--- + +# 🌏 전역 구성 diff --git a/vi/origin/plazma/administration/reference/configurations/purpur/world.md b/vi/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..a4403356b --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong purpur.yml. +--- + +# 🏳️ 세계별 구성 diff --git a/vi/origin/plazma/administration/reference/configurations/spigot.md b/vi/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..1e5b8d642 --- /dev/null +++ b/vi/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong tệp spigot.yml. +--- + +# 🚰 Spigot diff --git a/vi/origin/plazma/administration/reference/permissions.md b/vi/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..eeefb4ba4 --- /dev/null +++ b/vi/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: Tìm hiểu về quyền của Plazma. +--- + +# 🛡️ Quyền + +Quyền là một công cụ bảo mật đơn giản để thiết lập phạm vi mà người chơi trên máy chủ có thể tương tác với nhau. + +Để sử dụng quyền một cách hiệu quả và dễ dàng chỉnh sửa, bạn cần sử dụng các plugin như [LuckPerms](https://luckperms.net). + +*** + +## Hiểu về hệ thống quyền mặc định + +Trong Minecraft, có các nhóm quyền quản lý cơ bản được cung cấp. + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **Người chơi**\ + Thường là nhóm quyền mà tất cả người chơi được cấp. +2. **Trung gian**\ + Có thể bỏ qua bảo vệ spawn. +3. **Quản trị viên thế giới**\ + Có thể sử dụng tất cả các lệnh và khối lệnh liên quan đến quản lý thế giới.\ + Là nhóm quyền mặc định cho dữ liệu và khối lệnh. +4. **Quản trị viên**\ + Có thể sử dụng tất cả các lệnh liên quan đến quản lý người chơi. +5. **Chủ quản trị**\ + Có thể sử dụng tất cả các lệnh liên quan đến quản lý máy chủ.\ + Là nhóm quyền mặc định cho bảng điều khiển và quản trị viên. + +*** + +## Thiết lập quyền + +*** + +## Toàn bộ quyền + +*** + +#### `allow.ride.(Namespaced Key)` + +- **Mặc định**: `Không` + +Cho phép người chơi `ngồi và tương tác` với thực thể để lên thực thể. + +Khi lên thực thể, bạn có thể điều khiển di chuyển của thực thể bằng `phím di chuyển` và có thể nhảy hoặc bay bằng `phím nhảy`. + +Trong `(Namespaced Key)` sẽ là [ID Namespaced của thực thể](#user-content-fn-2)[^2]. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **Mặc định**: `Không` + +Cho phép người chơi sử dụng kỹ năng đặc biệt của thực thể khi đang lên thực thể. + +Không phải tất cả các kỹ năng đặc biệt của thực thể đều có sẵn. Xem danh sách toàn bộ kỹ năng đặc biệt có sẵn dưới đây. + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +Hãy chia sẻ ý tưởng của bạn tại [Plazma Discord](https://plazmamc.org/discord) hoặc [GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)! +{% endhint %} + +
+ +Xem danh sách kỹ năng đặc biệt có sẵn hiện tại + +- **`crepper`**\ + Khi nhấn `phím nhảy`, sẽ phát nổ.\ + Nếu người chơi có quyền `allow.powered.creeper`, họ có thể giữ `phím nhảy` để nạp năng lượng. +- **`dolphin`**\ + Khi nhấn `phím nhảy`, sẽ lao về phía trước. +- **`phantom`**\ + Khi nhấn `phím nhảy`, sẽ phun lửa. +- **`wither`**\ + Khi `tương tác`, sẽ phóng đầu wither. + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/compass`](commands.md#compass). + +#### `bukkit.command.credits` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/credits (Người chơi)`](commands.md#credits). + +Thêm `.other` sau tên quyền để cho phép người chơi khác sử dụng. + +#### `bukkit.command.demo` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/demo (Người chơi)`](commands.md#demo). + +Thêm `.other` sau tên quyền để cho phép người chơi khác sử dụng. + +#### `bukkit.command.ping` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/ping (Người chơi)`](commands.md#ping). + +Thêm `.other` sau tên quyền để cho phép người chơi khác sử dụng. + +#### `bukkit.command.ram` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/ram`](commands.md#ram). + +#### `bukkit.command.rambar` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/rambar (Người chơi)`](commands.md#rambar). + +Thêm `.other` sau tên quyền để cho phép người chơi khác sử dụng. + +#### `bukkit.command.restart` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/restart`](commands.md#restart). + +#### `bukkit.command.tps` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/tps`](commands.md#tps). + +#### `bukkit.command.tpsbar` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/tpsbar (Người chơi)`](commands.md#tpsbar). + +Thêm `.other` sau tên quyền để cho phép người chơi khác sử dụng. + +#### `bukkit.command.timings` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/timings`](commands.md#timings). + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +Để biết thêm về các lệnh tương tự, hãy xem trang [Spark](https://spark.lucko.me/docs/Command-Usage). +{% endhint %} + +#### `bukkit.command.uptime` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh [`/uptime`](commands.md#uptime). + +#### `minecraft.command.gamemode.(GameMode)` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép sử dụng lệnh `/gamemode (GameMode) (Người chơi)`. + +Thêm `.other` sau tên quyền để cho phép người chơi khác sử dụng. + +#### `paper.antixray.bypass` + +- **Mặc định**: `Không` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +Điều này giúp cả hai bên trải nghiệm cải thiện hiệu suất. + +> Để biết cách cấu hình chống X-Ray, hãy tham khảo trang dưới đây. + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **Mặc định**: `Không` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **Mặc định**: `Không` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **Mặc định**: `Không` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **Mặc định**: `Không` + +Cho phép sử dụng [Thẻ MiniMessage](https://docs.advntr.dev/minimessage/format.html) trên mỏ. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **Mặc định**: `Không` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **Mặc định**: `Không` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **Mặc định**: `Không` + +Loại bỏ người chơi khỏi danh sách đuổi vì không hoạt động. + +#### `purpur.debug.f3n` + +- **Mặc định**: `Quản trị viên thế giới` + +Cho phép người chơi thay đổi chế độ game bằng phím `F3 + N`. + +Không hoạt động nếu không có quyền cho chế độ game đó. + +#### `purpur.drop.spawners` + +- **Mặc định**: `Không` + +Khi đào mỏ với vật phẩm được cấu hình, sẽ rơi ra khối spawner. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **Mặc định**: `Không` + +Thay đổi kích thước của hòm kỹ lưu. + +Có thể nhập `one`, `two`, `three`, `four`, `five`, `six` vào `(NumberString)`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **Mặc định**: `Không` + +Cho phép bảo vệ bất tử hoạt động khi còn trong hòm đồ. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **Mặc định**: `Không` + +Cho phép người chơi bỏ qua giới hạn số người truy cập. + +#### `purpur.mending_shift_click` + +- **Mặc định**: `Không` + +Cho phép người chơi sửa chữa vật phẩm đang cầm khi họ `ngồi xuống và tương tác`. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **Mặc định**: `Không` + +Cho phép người chơi cài đặt trứng sinh vật. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **Mặc định**: `Không` + +Cho phép người chơi di chuyển ngay lập tức khi họ sử dụng cổng Nether. + +#### `purpur.sign.color` + +- **Mặc định**: `Không` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **Mặc định**: `Không` + +Cho phép sử dụng mã hóa độc đáo `(&o)` trên biển chỉ dẫn. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **Mặc định**: `Không` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **Mặc định**: `Không` + +Cho phép người chơi ngăn chặn vụ nổ TNT bằng cách `tương tác` với nó bằng kéo. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### Quyền sắp được cung cấp + +#### `plazma.bypass.ncr-require` + +- **Mặc định**: `Không` + +Cho phép người chơi kết nối mà không cần cài đặt mod [`NoChatReports`](https://modrinth.com/mod/no-chat-reports). + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: Người điều hành. + +[^2]: Ví dụ: `ender_dragon` diff --git a/vi/origin/plazma/adminstration/README.md b/vi/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..123e924df --- /dev/null +++ b/vi/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: Tạo máy chủ riêng của bạn bằng cách sử dụng Plazma. +--- + +# ⚒️ Hướng dẫn quản lý máy chủ diff --git a/vi/origin/plazma/adminstration/expert/README.md b/vi/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..cfba35314 --- /dev/null +++ b/vi/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách xử lý Plazma một cách chuyên nghiệp. +--- + +# 🎓 Sâu hơn diff --git a/vi/origin/plazma/adminstration/expert/fix-exploits.md b/vi/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..eb10854a2 --- /dev/null +++ b/vi/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu về các lỗ hổng đã biết và cách khắc phục chúng. +--- + +# ⚠️ Các lỗ hổng đã biết và cách khắc phục diff --git a/vi/origin/plazma/adminstration/expert/optimize.md b/vi/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..29d1655e4 --- /dev/null +++ b/vi/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách tối ưu hóa Plazma. +--- + +# 🧹 Tối ưu hóa diff --git a/vi/origin/plazma/adminstration/expert/vanillaize.md b/vi/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..8a183c830 --- /dev/null +++ b/vi/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: Tìm hiểu cách khôi phục bản vá giữa Paper và Vanilla. +--- + +# ↩️ Vanilla hóa + +{% hint style="warning" %} + +### Paper không cung cấp lựa chọn cho hầu hết các bản vá sửa lỗi của Vanilla. + +Hiện tại, Plazma đang phát triển cách vô hiệu hóa việc sửa lỗi này thông qua cấu hình. + +Vì vậy, hướng dẫn này vẫn đang được viết và thông tin có thể thay đổi bất cứ lúc nào. +{% endhint %} diff --git a/vi/origin/plazma/adminstration/faq.md b/vi/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..a07f0fb57 --- /dev/null +++ b/vi/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: Tìm hiểu về các câu hỏi thường gặp. +--- + +# ⁉️ Câu hỏi thường gặp + +{% hint style="info" %} + +### Không thể tìm thấy câu trả lời bạn muốn? + +[Máy chủ Discord chính thức](https://discord.gg/MmfC52K8A8) hoặc [Vấn đề GitHub](https://github.com/PlazmaMC/PlazmaBukkit/issues) để đặt câu hỏi trong cộng đồng! +{% endhint %} + +### Không thể thực thi với thông báo xuất hiện + +Nếu bạn thấy thông báo `no main manifest attribute, in plazma-(version).jar` trên cửa sổ console,\ +file bạn đã tải xuống là file API dành cho phát triển, bạn cần phải tải **Reobf Paperweight** từ trang GitHub. + +Để biết thêm chi tiết, vui lòng tham khảo trang sau. + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### Cảnh báo xuất hiện mỗi khi máy chủ khởi động + +Plazma chứa một số bản vá không ổn định và luôn có khả năng gây sự cố, vì vậy máy chủ sẽ hiển thị thông báo sau mỗi lần khởi động. + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +Bạn có thể vô hiệu hóa thông báo này bằng cách sử dụng thuộc tính hệ thống [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]. + +Để biết thêm chi tiết, vui lòng tham khảo trang sau. + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: Có sẵn từ phiên bản 1.20.1 trở lên diff --git a/vi/origin/plazma/adminstration/getting-started/README.md b/vi/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..9a7d2db71 --- /dev/null +++ b/vi/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: Tìm hiểu cách tạo máy chủ bằng Plazma. +--- + +# 👟 Bắt đầu + +Để sử dụng Plazma một cách ổn định, hệ thống cần đáp ứng các yêu cầu sau. + +| | Tối thiểu | Đề nghị | +| :----------------: | --------: | ------: | +| Kiến trúc | x64 | - | +| RAM | 8GB | 16GB | +| Dung lượng lưu trữ | 1GB | 8GB | +| JRE | 17 | 21 | + +Để dễ dàng chỉnh sửa tệp cấu hình, cài đặt trình soạn thảo như [Visual Studio Code](https://code.visualstudio.com/download) cũng là một ý tưởng tốt. + +*** + +## 1. Cài đặt JRE + +Như tên gọi, Minecraft: **"Java"** Edition được phát triển bằng Java, vì vậy để chạy, cần cài đặt JRE[^1]. + +Plazma là nền tảng máy chủ chính thức của Mojang Studios [dựa trên](#user-content-fn-2)[^2], vì vậy để sử dụng Plazma cũng cần cài đặt JRE. + +### 1.1 Kiểm tra sự tồn tại của JRE + +Để kiểm tra xem JRE đã được cài đặt trên hệ thống hay chưa, hãy nhập [`cmd /k java --version`](#user-content-fn-4)[^4] vào cửa sổ chạy và chạy nó. + +Nếu xuất hiện như sau, bỏ qua [Bước 2](setup.md#id-2). + +{% code title="Kết quả đúng" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +Nếu không xuất hiện như trên hoặc xuất hiện như sau, có nghĩa là không có JRE hoặc quá cũ, vì vậy cần thực hiện [Bước 1.2](setup.md#id-1.2). + +{% code title="Không có JRE được cài đặt" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE đã quá cũ" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 Cài đặt JRE + +Trong hướng dẫn này, chúng ta sẽ sử dụng Azul Zulu là [một trong những loại](#user-content-fn-5)[^5] của JRE. + +Sau khi cài đặt xong, hãy thực hiện lại [Bước 1.1](setup.md#id-1.1) để kiểm tra xem quá trình cài đặt đã hoàn tất đúng cách hay chưa. + +{% tabs %} +{% tab title="Windows" %} + +1. Trước tiên, tải JDK 21 từ [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu) dưới dạng `.msi`. +2. Chạy trình cài đặt đã tải xuống và nhấn `Next`. +3. **Kích hoạt `Set JAVA_HOME variable` trong menu hiển thị ở giữa bên trái của cửa sổ,** sau đó nhấn `Next`. +4. Nhấn `Install` để hoàn tất quá trình cài đặt JRE. + {% endtab %} + +{% tab title="macOS" %} +Tải JDK 21 dưới dạng `.dmg` từ [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu) và chạy trình cài đặt để cài đặt JRE. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +Đầu tiên, chạy lệnh sau trong Terminal để thêm kho lưu trữ Azul Zulu vào APT. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +Sau đó, chạy lệnh sau trong Terminal để cài đặt JRE. + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +Bạn có thể cài đặt JRE bằng cách nhập lệnh sau. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. Tải xuống Plazma + +Plazma cung cấp nhiều loại tệp thực thi khác nhau. + +{% hint style="warning" %} + +### Trong hầu hết các trường hợp, hãy sử dụng `Reobf Paperclip`. + +Nội dung dưới đây dành cho những người muốn tìm hiểu về các nhà phát triển hoặc đặc điểm của từng loại.\ +Nếu bạn là người dùng thông thường, có thể bỏ qua [Bước 3](setup.md#id-3) mà không gặp vấn đề. +{% endhint %} + +
+ +Tìm hiểu thêm + +Tên tệp thực thi được xác định là `plazma-(quản lý phiên bản)-1.20.4-R0.1-SNAPSHOT-(kiểu ánh xạ).jar`. + +- **Kiểu ánh xạ**\ + Ánh xạ là một loại bản đồ kết nối giữa mã nguồn thực và mã nguồn đã bị làm rối. + - **Reobf**\ + Reobfuscation, còn được gọi là Spigot mapping và được sử dụng trong hầu hết các plugin NMS.\ + Sẽ ngừng sử dụng từ phiên bản 1.20.5 trở đi. + - **Mojmap**\ + Mojang mapping, là ánh xạ Minecraft vanilla. +- **Quản lý phiên bản**\ + Quản lý phiên bản là một loại trình khởi chạy máy chủ cung cấp thư viện cần thiết cho việc chạy máy chủ và áp dụng bản vá cho máy chủ. + - **Paperclip**\ + Là một trình quản lý phát triển bởi nhóm PaperMC để tải về thư viện và áp dụng bản vá cho Paper và các nền tảng phát sinh khác. + - **Bundler**\ + Là trình quản lý phiên bản Minecraft vanilla. + +
+ +*** + +## 3. Tạo kịch bản khởi động + +Để bắt đầu Plazma một cách dễ dàng và tự động khởi động lại máy chủ, bạn cần tạo [kịch bản khởi động](#user-content-fn-6)[^6]. + +Bạn có thể tạo kịch bản khởi động thông qua [Flags.sh](https://flags.sh).\ +Chỉ cần nhập [số lượng bộ nhớ sẽ sử dụng cho Plazma](#user-content-fn-8)[^8], lệnh sẽ tự động tối ưu hóa. + +Bạn có thể tải kịch bản khởi động thông qua nút tải xuống ở góc dưới bên trái.\ +**Hãy chắc chắn rằng tệp kịch bản khởi động đã được tải xuống đúng phiên bản của hệ điều hành của bạn.** + +*** + +## 4. Dọn dẹp tệp tin + +Di chuyển kịch bản khởi động và Plazma đã tải xuống vào một thư mục mới. + +{% hint style="warning" %} + +### Tên thư mục phải không có dấu cách và được đặt bằng tiếng Anh. + +Nếu không, Plazma hoặc JRE có thể không hoạt động đúng cách. +{% endhint %} + +Chạy kịch bản khởi động bây giờ. Đối với Windows, trong hộp thoại chọn cho phép qua tường lửa, nhất định chọn**Cho phép**. + +*** + +## 5. Đồng ý với EULA + +Sau khi chạy kịch bản khởi động một lần, tệp `eula.txt` sẽ được tạo ra trong thư mục. + +EULA[^9] là hợp đồng cấp phép mà bạn phải đồng ý khi sử dụng dịch vụ của [Mojang Studios](#user-content-fn-10)[^10]. + +Nếu không đồng ý với EULA, bạn sẽ không thể khởi động máy chủ và có thể bị xử phạt nếu vi phạm EULA, chẳng hạn như bị đình chỉ tài khoản. + +Để đồng ý với EULA, chỉnh sửa `eula=false` trong tệp `eula.txt` thành `eula=true` và lưu lại. + +*** + +## 6. Cho phép kết nối từ bên ngoài (Windows) + +Hệ điều hành hiện đại mặc định chặn kết nối từ bên ngoài để ngăn chặn truy cập nguy hiểm thông qua **tường lửa** và **bộ định tuyến**. + +Trong trường hợp của Windows, sau khi đã cho phép ở [Bước 3](setup.md#id-3), chỉ cần cấu hình chuyển tiếp cổng. + +{% hint style="info" %} + +### Hướng dẫn này giả định rằng bạn đang sử dụng hệ điều hành Windows và [**UPnP**](#user-content-fn-12)[^12] có sẵn trên bộ định tuyến. + +Nếu bộ định tuyến không hỗ trợ UPnP, từng bộ định tuyến có cấu hình khác nhau, vì vậy bạn cần tìm kiếm thông tin trực tiếp. + +Hoặc bạn có thể sử dụng [Ngrok](https://ngrok.com/) để tạo địa chỉ tạm thời. +{% endhint %} + +{% hint style="warning" %} + +### Đối với hệ điều hành dựa trên UNIX như Linux hoặc macOS, cần tìm hiểu cách cấu hình từng dịch vụ tường lửa một cách riêng biệt vì cách thiết lập khác nhau. + +{% endhint %} + +### 6.1 Kiểm tra cần thiết về chuyển tiếp cổng + +Nhập và chạy như sau trong cửa sổ chạy. + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +Nếu kết quả là `True`, bạn có thể dừng ở đây, nhưng nếu là `False`, bạn cần cấu hình chuyển tiếp cổng. + +### 6.2 Kết nối đến máy chủ + +{% tabs %} +{% tab title="Kết nối từ bên ngoài" %} +Nếu không cần thiết phải chuyển tiếp cổng hoặc đã thành công trong việc chuyển tiếp cổng, bạn có thể kết nối đến máy chủ ngay bây giờ. + +Địa chỉ được sử dụng để kết nối đến máy chủ có thể được xác nhận [tại đây](https://ip.pe.kr/). +{% endtab %} + +{% tab title="Thử UPnP để chuyển tiếp cổng" %} +Trong `purpur.yml` của thư mục máy chủ, bật `network.upnp-port-forwarding` thành `true`. + +Sau đó, khởi động lại máy chủ, Plazma sẽ tự động thử chuyển tiếp cổng. + +Dưới đây là kết quả thành công của UPnP dựa trên thông báo xuất hiện trên cửa sổ console, trên console sẽ hiển thị `[UPnP] (thông báo)`. + +| Thông báo | Ý nghĩa | +| --------------------------------- | ---------------------------------------- | +| `Successfully opened port (cổng)` | Chuyển tiếp cổng thành công. | +| `Port (cổng) is already open` | Cổng đang được sử dụng bởi dịch vụ khác. | +| `Failed to open port (cổng)` | Chuyển tiếp cổng thất bại. | +| `Service is unavailable` | Bộ định tuyến không hỗ trợ UPnP. | + +Khi máy chủ tắt, Plazma sẽ tự động đóng cổng. +{% endtab %} + +{% tab title="Tạo địa chỉ tạm thời thông qua Ngrok" %} +Phương pháp sử dụng Ngrok thích hợp cho các bài kiểm tra ngắn hạn, chơi cùng hoặc với bạn bè. + +1. Tải xuống tệp ZIP `Windows (64-bit)` từ [trang chủ Ngrok](https://ngrok.com/download). +2. Đặt tệp Ngrok đã tải xuống vào thư mục máy chủ. +3. Tạo [token xác thực](#user-content-fn-13) từ [bảng điều khiển Ngrok](https://dashboard.ngrok.com/get-started/your-authtoken) trong thư mục máy chủ. +4. Chạy lệnh được hiển thị trong `Command Line` trong thư mục máy chủ. +5. Thêm `start /b ngrok tcp --region jp 25565` vào đầu tập lệnh chạy và `taskkill /f /t /im ngrok.exe` vào cuối tập lệnh chạy. +6. Từ thông báo `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` ở đầu console, `0.tcp.jp.ngrok.io:12345` sẽ là địa chỉ của máy chủ. +7. Bây giờ bạn có thể kết nối từ bên ngoài thông qua địa chỉ đó. + {% endtab %} + +{% tab title="Kết nối từ máy tính cục bộ" %} +Nếu bạn muốn kết nối đến máy chủ từ máy tính cục bộ, chạy `cmd /k ipconfig` trong cửa sổ thực thi. + +Ví dụ, sau khi thực thi lệnh, + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +Khi thử kết nối đến máy chủ, sử dụng địa chỉ IPv4 được hiển thị là `192.168.3.7`. + +Nếu máy chủ và trò chơi chạy trên cùng một PC, bạn có thể kết nối bằng `localhost`. +{% endtab %} +{% endtabs %} + +## 7. Bước Phát triển + +Sau khi máy chủ khởi động thành công và hoạt động đúng cách, bây giờ là lúc cá nhân hóa máy chủ. + +Tìm hiểu cách cá nhân hóa máy chủ thông qua hướng dẫn dưới đây. + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java Runtime Environment, Môi trường thực thi Java. + +[^2]: Paper, nền tảng của Plazma, dựa trên Spigot và Spigot dựa trên nền tảng máy chủ chính thức. + +[^3]: Phím Windows + R + +[^4]: Trong Linux, chạy `java --version` trong terminal + +[^5]: JRE là một trong những dự án mã nguồn mở, tương tự như nền tảng máy chủ Minecraft với nhiều loại khác nhau. + +[^6]: Thường được biết đến là **trình chạy**. + +[^7]: Kích hoạt "Tự động khởi động lại" sẽ tự động khởi động lại máy chủ. Nhấn `Control + C` để dừng. + +[^8]: Không khuyến khích vượt quá nửa dung lượng hệ thống. + + Ví dụ, nếu dung lượng bộ nhớ hệ thống là 8GB, không nên thiết lập trên 4GB. + +[^9]: End-User License Agreement, Thỏa thuận Sử dụng cuối cùng. Vui lòng kiểm tra chi tiết tại [trang chủ Minecraft](https://www.minecraft.net/ko-kr/usage-guidelines). + +[^10]: Tập đoàn Microsoft. + +[^11]: Theo Điều 32, Khoản 1, Mục 9 của Luật Phát triển Ngành công nghiệp Game của Hàn Quốc, **Công ty TNHH Microsoft Hàn Quốc** có thể bị truy tố hợp pháp. + +[^12]: Universal Plug & Play. Purpur đi kèm trong Plazma sử dụng công nghệ này để tự động giao tiếp với bộ định tuyến và mở cổng chỉ khi máy chủ đang chạy, không cần phải chuyển tiếp cổng trực tiếp. + +[^13]: Nếu không có tài khoản, đăng ký Ngrok thông qua tài khoản Google hoặc GitHub. diff --git a/vi/origin/plazma/adminstration/getting-started/customization.md b/vi/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..ec160bee2 --- /dev/null +++ b/vi/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu cách tùy chỉnh máy chủ. +--- + +# 🎨 Tùy chỉnh người dùng diff --git a/vi/origin/plazma/adminstration/reference/arguments.md b/vi/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..0b1d89508 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: Tìm hiểu về đối số khởi đầu và thuộc tính hệ thống. +--- + +# 🎛️ Đối số và thuộc tính + +Đối số khởi đầu và thuộc tính hệ thống là các giá trị được thêm vào các [lệnh được sử dụng](#user-content-fn-1)[^1] trong quá trình chạy Plazma,\ +cho phép thay đổi giá trị không thể thay đổi sau khi Plazma đã chạy. + +Tùy thuộc vào [vị trí thêm vào lệnh](#user-content-fn-2)[^2], **đối số khởi đầu** và **thuộc tính hệ thống** được phân chia. + +*** + +## Thuộc tính hệ thống + +Thuộc tính hệ thống được nhập trước `-jar` và được xử lý trong JVM trước khi Plazma khởi tạo. + +{% hint style="warning" %} + +### Việc chỉnh sửa thuộc tính hệ thống có thể thay đổi cách hoạt động của Plazma và JVM, ảnh hưởng lớn đến trò chơi! + +Nếu không chắc chắn về vai trò của từng thuộc tính hệ thống, **đừng bao giờ sử dụng!** +{% endhint %} + +### Cách sử dụng + +Thuộc tính hệ thống được nhập như một đối số lệnh Java giữa `java` và `-jar`. + +Ví dụ, nếu muốn áp dụng thuộc tính hệ thống `Plazma.dummyProperty`,\ +bằng cách nhập như sau, giá trị `37` sẽ được nhập vào thuộc tính tiếp theo và Plazma sẽ khởi tạo. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D` chỉ ra rằng đối số này không được tích hợp trong JVM mà là đối số riêng của Plazma, + +Nếu không nhập giá trị, giá trị sẽ được [`true` cố định.](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Nền tảng máy chủ loại Paperweight phân biệt các thuộc tính hệ thống bằng cách bao gồm dấu `.` trong tên thuộc tính. + +Trong một số terminal như Windows Powershell, có thể không chấp nhận các đối số này, do đó, bạn cần thêm `"` vào cả hai đầu của đối số. [Thêm vào.](#user-content-fn-4)[^4] +{% endhint %} + +### Toàn bộ thuộc tính hệ thống + +#### `convertLegacySigns` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Cập nhật định dạng biển báo đã ngưng sử dụng. + +#### `debug.entities` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi liên quan đến thông tin thực thể. + +#### `debug.rewriteForIDE` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa NMS revision để IDE có thể đọc thông tin gỡ lỗi một cách chính xác và tự động làm lại thông tin phiên bản nội bộ. + +#### `disable.watchdog` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa hệ thống cảnh báo Watchdog của Spigot. + +#### `letMeReload` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa thông báo xác nhận lệnh `/reload`. + +{% hint style="danger" %} + +### Lệnh `/reload` rất không ổn định, vì vậy, mọi vấn đề xảy ra sau khi sử dụng `/reload` là trách nhiệm của người dùng. + +Nếu bạn là nhà phát triển plugin và cần phải cập nhật plugin, hãy sử dụng hotswap thay vì `/reload`. +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa plugin sử dụng hệ thống nhập/xuất tiêu chuẩn. + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Cảnh báo khi phát hiện định dạng cũ trong thành phần chat. + +#### `Paper.bypassHostCheck` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa kiểm tra khớp mẫu máy chủ khi người chơi kết nối đến máy chủ. + +#### `Paper.debugDynamicMissingKeys` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi cho các khóa bị thiếu trong đối tượng NBT. + +#### `Paper.debugInvalidSkullProfiles` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi cho các hồ sơ đầu mạc không hợp lệ. + +Nhật ký này sẽ ghi lại tất cả các hồ sơ đầu mạc không hợp lệ trong thế giới cùng với vị trí của chúng. + +#### `Paper.disableChannelLimit` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa giới hạn 128 kênh plugin mỗi người chơi[^5]. + +#### `Paper.disableClassPrioritization` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa hệ thống ưu tiên lớp plugin. + +Hữu ích khi gặp vấn đề trong plugin shade. + +#### `Paper.disableFlushConsolidate` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa hệ thống gộp nén flush của Netty. + +#### `Paper.excessiveTELimit` + +- **Loại**: `Integer` +- **Giá trị mặc định**: `750` + +Nếu số thực thể vượt quá giá trị được đặt, chúng sẽ được chia thành các gói tin đa phần và gửi đi. + +#### `Paper.filterThreshold` + +- **Loại**: `Integer` +- **Giá trị mặc định**: `8192` + +Thiết lập kích thước tối đa của gói tin mà máy chủ có thể nhận được trong một lần. + +#### `Paper.ignoreJavaVersion` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Vô hiệu hóa kiểm tra phiên bản Java. + +{% hint style="danger" %} + +### Việc này có thể khiến JVM truy cập vào mã không tồn tại! + +Có thể dẫn đến hỏng toàn bộ tệp trong thế giới và làm hỏng cơ chế trò chơi. + +Mọi vấn đề phát sinh từ việc này là trách nhiệm của bạn và Plamza sẽ không hỗ trợ bất kỳ vấn đề nào liên quan. +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **Loại**: `Integer` +- **Giá trị mặc định**: `64` + +Thiết lập giới hạn tên kênh plugin[^6]. + +#### `Paper.maxSignLength` + +- **Loại**: `Integer` +- **Giá trị mặc định**: `80` + +Thiết lập độ dài tối đa của mỗi dòng trên biển báo. + +#### `Paper.minPrecachedDatafixVersion` + +- **Loại**: `Integer` +- **Giá trị mặc định**: `(phiên bản thế giới) + 1` + +Thiết lập phiên bản thông tin cập nhật thế giới cần khởi tạo trước hết. + +Hữu ích khi cần cập nhật lượng lớn chunk, nhưng không cần thiết trong các trường hợp khác. + +#### `Paper.parseYamlCommentsByDefault` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `True` + +Kích hoạt xử lý chú thích trong tệp YAML mặc định. + +#### `Paper.playerConnection.keepAlive` + +- **Loại**: `Integer` +- **Giá trị mặc định**: `30` + +Khi không nhận được bất kỳ dữ liệu nào từ người chơi trong thời gian được chỉ định (giây), máy chủ sẽ đuổi người chơi. + +Thường thì trò chơi[^7] sẽ tiếp tục gửi [tín hiệu đập tim](#user-content-fn-8)[^8] đến máy chủ, [không bị đuổi,](#user-content-fn-9)[^9] nhưng nếu trò chơi không phản hồi, máy chủ sẽ coi đó là sự xung đột và ngưng xử lý người chơi. + +#### `Paper.skipServerPropertiesComments` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Bỏ qua các chú thích trong tệp cấu hình máy chủ. + +#### `Paper.debug-sync-loads` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt nhật ký gỡ lỗi việc tải đồng bộ chunk. + +#### `Paper.enable-sync-chunk-writes` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt hệ thống ghi chunk theo trình tự mặc định của Minecraft. + +Điều này làm cho việc lưu trữ mỗi chunk theo thứ tự, gây ra sự giảm hiệu suất lớn. + +#### `Paper.explicit-flush` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Kích hoạt việc xả của mạng chanel một cách rõ ràng. + +#### `Paper.strict-thread-checks` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Luôn ghi log lỗi không xảy ra trên luồng chính. + +#### `Paper.tickList-warn-on-excessive-delay` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Xuất cảnh báo nếu công việc đặt trước có thời gian chờ quá lâu. + +#### `Paperclip.patchOnly` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `False` + +Khi sử dụng tệp thực thi mặc định, chỉ áp dụng bản vá mà không khởi động máy chủ. + +#### `Plazma.aggressiveOptimize` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` + +{% hint style="warning" %} + +### Thuộc tính này sẽ được chuyển sang đối số khởi đầu sau Plazma 1.20.5. + +{% endhint %} + +Áp dụng tối ưu hóa cấu hình ban đầu một cách nghiêm ngặt hơn khi khởi đầu lần đầu. + +Khi kích hoạt, máy chủ sẽ trở nhanh hơn và an toàn hơn, nhưng có thể chặn một số lỗi hoặc ảnh hưởng lớn đến trò chơi. + +#### `Plazma.iKnowWhatIAmDoing` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` + +Ngăn chặn cảnh báo xuất hiện khi Plazma được khởi tạo. + +### Thuộc tính đã bị ngưng sử dụng + +Dưới đây là các thuộc tính hệ thống đã bị ngưng sử dụng. + +#### `timings.bypassMax` + +- **Loại**: `Boolean` +- **Giá trị mặc định**: `false` +- **ĐÃ NGƯNG SỬ DỤNG**: Timings đã bị loại bỏ hoàn toàn khỏi Plazma từ sau + +Quyết định xem có thể vượt quá giá trị tối đa có thể gửi đến API Timings của Aikar. + +Ngay cả khi điều này xảy ra, nếu không được xử lý bởi API, giới hạn tần suất sẽ được áp dụng. + +*** + +## Tham số bắt đầu + +Tham số bắt đầu được nhập sau `-jar *.jar` để khởi tạo Plazma và xử lý cùng với nhau. + +### Cách sử dụng + +Thuộc tính hệ thống được nhập như tham số lệnh chương trình sau `-jar *.jar`. + +Ví dụ, nếu bạn muốn áp dụng tham số bắt đầu `nogui`,\ +hãy nhập như sau để Plazma xử lý tham số `nogui` trong quá trình khởi tạo. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### Toàn bộ tham số bắt đầu + +#### `bukkit-settings` + +- **Bí danh**: `b` +- **Giá trị mặc định**: `bukkit.yml` + +Đặt tên và vị trí của [Tệp cấu hình Bukkit](../reference/configurations/bukkit.md). + +#### `command-settings` + +- **Bí danh**: `c` +- **Giá trị mặc định**: `commands.yml` + +Đặt tên và vị trí của [Tệp cấu hình lệnh Bukkit](../reference/configurations/bukkit.md). + +#### `config` + +- **Bí danh**: `c` +- **Giá trị mặc định**: `server.properties` + +Đặt tên và vị trí của tệp [Thuộc tính máy chủ](../reference/configurations/property.md). + +#### `demo` + +Khởi động máy chủ vào thế giới demo. + +#### `eraseCache` + +Xóa tệp cache còn lại sau nâng cấp thế giới. + +#### `forceUpgrade` + +Bỏ qua phiên bản và bắt buộc nâng cấp thế giới [^12]. + +#### `help` + +- **Bí danh**: `?` + +Xuất toàn bộ tham số khởi đầu và mô tả của Plazma. + +#### `initSettings` + +Chỉ tạo tệp cấu hình và kết thúc máy chủ. + +#### `jfrProfile` + +Kích hoạt hồ sơ JFR. + +#### `max-players` + +- **Bí danh**: `s`, `size` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +Thiết lập số lượng [người chơi](#user-content-fn-14)[^14] tối đa được phép. + +#### `nogui` + +Vô hiệu hóa bảng điều khiển giao diện đồ họa. + +#### `nojline` + +비활성화된 JLine을 사용하고 바닐라 콘솔을 사용합니다. + +#### `온라인 모드` + +- **별칭**: `o` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +Mojang 인증 서버에서 플레이어를 인증할지 선택합니다. + +**Velocity 또는 기타 프록시를 사용하지 않는 경우 [EULA](../getting-started/README.md#id-5) 위반으로 처벌될 수 있습니다.** + +#### `paper-settings` + +- **별칭**: `paper` +- **기본값**: `paper.yml` + +{% hint style="warning" %} + +### 이 인수는 1.19.4 이후 사용되지 않습니다 + +{% endhint %} + +사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다. + +기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다. + +#### `paper-settings-directory` + +- **별칭**: `paper-dir` +- **기본값**: `config` + +[Paper 구성 파일](../reference/configurations/paper/README.md)이 위치하는 폴더의 이름과 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **별칭**: `plazma-dir` + +[Plazma 구성 파일](../reference/configurations/plazma/README.md)이 위치하는 폴더의 이름과 위치를 설정합니다. + +#### `plugins` + +- **별칭**: `p` +- **기본값**: `plugins` + +플러그인 폴더의 위치를 설정합니다. + +#### `pufferfish-settings` + +- **별칭**: `pufferfish` +- **기본값**: `pufferfish.yml` + +[Pufferfish 구성 파일](../reference/configurations/pufferfish.md)의 이름과 위치를 설정합니다. + +#### `purpur-settings` + +- **별칭**: `purpur` +- **기본값**: `purpur.yml` + +[Purpur 구성 파일](../reference/configurations/purpur/README.md)의 이름과 위치를 설정합니다. + +#### `safeMode` + +(안전 모드) 서버를 완전한 바닐라 상태로 시작합니다. + +#### `server-ip` + +- **별칭**: `h`, `host` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-13)[^13] 주소를 설정합니다. + +#### `server-port` + +- **별칭**: `p`, `port` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +서버의 포트를 설정합니다. + +#### `server-name` + +- **기본값**: `A Plazma Server` + +서버의 이름을 설정합니다. + +#### `spigot-settings` + +- **별칭**: `S` +- **기본값**: `spigot.yml` + +[Spigot 구성 파일](../reference/configurations/spigot.md)의 이름과 위치를 설정합니다. + +#### `version` + +- **별칭**: `v` + +Plazma 버전을 표시합니다. + +#### `world-dir` + +- **별칭**: `W`, `universe`, `world-container` +- **기본값**: `(서버 폴더)` + +월드 파일이 저장되는 위치를 설정합니다. + +#### `world-name` + +- **별칭**: `w`, `world` +- **Giá trị mặc định**: `(Thuộc tính máy chủ)` + +월드 파일의 이름을 설정합니다. + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 위치에 따라 처리되는 인수가 변경됩니다. + +[^3]: 예를 들어, `Plazma.iKnowWhatIAmDoing`을 `true`로 설정하려는 경우, `-DPlazma.iKnowWhatIAmDoing=true` 대신 `-DPlazma.iKnowWhatIAmDoing`만 입력해도 작동합니다. + +[^4]: 예를 들어, `"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 이벤트 감지기. + +[^6]: 이벤트 감지기. + +[^7]: 클라이언트. + +[^8]: 서버와의 정상적인 연결을 나타내는 신호. + +[^9]: Purpur의 AFK 추방 기능을 사용하면 자리를 비운 플레이어도 추방할 수 있습니다. + +[^10]: 동기 청크 작성 시스템, Sync Chunk Write System. + +[^11]: `주의! Plazma는 예기치 않은 문제를 일으킬 수 있으므로 공개 서버에 사용하기 전에 충분히 테스트하십시오.` + +[^12]: 게임에서 `월드 최적화`도 이와 같은 원리로 작동합니다. + +[^13]: 인터넷 프로토콜, IP. + +[^14]: `레벨 2` 이상의 관리자는 제외합니다. diff --git a/vi/origin/plazma/adminstration/reference/commands.md b/vi/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..aa586b4fd --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu về các lệnh có sẵn trong Plazma. +--- + +# 🖥️ Lệnh diff --git a/vi/origin/plazma/adminstration/reference/configurations/bukkit.md b/vi/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..04a831588 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong tệp bukkit.yml. +--- + +# 🪣 Bukkit diff --git a/vi/origin/plazma/adminstration/reference/configurations/paper/README.md b/vi/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..0523ea64f --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu mục đích của từng tệp trong thư mục cấu hình. +--- + +# 🛩️ Giấy diff --git a/vi/origin/plazma/adminstration/reference/configurations/paper/global.md b/vi/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..c2ea8f602 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong paper-global.yml. +--- + +# 🛩️ Paper (Cấu hình Toàn cầu) diff --git a/vi/origin/plazma/adminstration/reference/configurations/paper/world.md b/vi/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..2b778ae5c --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong tệp paper-world.yml. +--- + +# 🛩️ Paper (Cấu trúc theo thế giới) diff --git a/vi/origin/plazma/adminstration/reference/configurations/plazma/README.md b/vi/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..b5ddea011 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu mục đích của từng tệp trong thư mục cấu hình. +--- + +# ✨ Plazma diff --git a/vi/origin/plazma/adminstration/reference/configurations/plazma/global.md b/vi/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..a126c285c --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong tệp plazma-global.yml. +--- + +# ✨ Plazma (Cấu hình Toàn cầu) diff --git a/vi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/vi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..c36cfbd78 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ Thế giới theo quốc gia diff --git a/vi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/vi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..d7d00f9a4 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong plazma-world.yml. +--- + +# ✨ Plazma (Cấu trúc Thế giới) diff --git a/vi/origin/plazma/adminstration/reference/configurations/property.md b/vi/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..e397ba9da --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong server.properties. +--- + +# 🪨 Server.properties diff --git a/vi/origin/plazma/adminstration/reference/configurations/pufferfish.md b/vi/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..7485003bc --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của mỗi nút trong pufferfish.yml. +--- + +# 🐡 Cá nóc diff --git a/vi/origin/plazma/adminstration/reference/configurations/purpur/README.md b/vi/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..0f14cd27a --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong purpur.yml. +--- + +# 🦑 Purpur diff --git a/vi/origin/plazma/adminstration/reference/configurations/purpur/global.md b/vi/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..2ac039674 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong purpur.yml. +--- + +# 🦑 Purpur (cấu trúc toàn cầu) diff --git a/vi/origin/plazma/adminstration/reference/configurations/purpur/world.md b/vi/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..41f66e3d7 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong purpur.yml. +--- + +# 🦑 Purpur (cấu trúc theo thế giới) diff --git a/vi/origin/plazma/adminstration/reference/configurations/spigot.md b/vi/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..1e5b8d642 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu ý nghĩa của từng nút trong tệp spigot.yml. +--- + +# 🚰 Spigot diff --git a/vi/origin/plazma/adminstration/reference/permissions.md b/vi/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..b3cbb0f32 --- /dev/null +++ b/vi/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: Tìm hiểu về quyền của Plazma. +--- + +# 🛡️ Quyền diff --git a/vi/origin/plazma/developers.md b/vi/origin/plazma/developers.md new file mode 100644 index 000000000..15b32729c --- /dev/null +++ b/vi/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: Phát triển dự án bên thứ ba bằng cách sử dụng Plazma. +--- + +# ⚙️ Hướng dẫn cho nhà phát triển diff --git a/vi/origin/thunderbolt/README.md b/vi/origin/thunderbolt/README.md new file mode 100644 index 000000000..8ea00b675 --- /dev/null +++ b/vi/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt là một nền tảng máy chủ dựa trên Plazma cho phép người dùng trải nghiệm các bản vá thử nghiệm dưới dạng Flavor. +--- + +# 🌩️ Hướng dẫn Sử dụng Thunderbolt diff --git a/vi/origin/volt/README.md b/vi/origin/volt/README.md new file mode 100644 index 000000000..b548c58e6 --- /dev/null +++ b/vi/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt là một mẫu mã nguồn mở cho phép phát triển nền tảng máy chủ Paperweight riêng dựa trên Plazma. +--- + +# ⚡ Hướng dẫn Phát triển Volt diff --git a/zh-CN/origin/README.md b/zh-CN/origin/README.md new file mode 100644 index 000000000..a8ef281c5 --- /dev/null +++ b/zh-CN/origin/README.md @@ -0,0 +1,41 @@ +--- +description: 如有任何问题，请通过Discord或GitHub讨论区提出。 +--- + +# 🏠 欢迎来到文档门户 + +{% hint style="info" %} + +**Plazma的文档目前处于机器翻译状态。** + +[![翻译状态](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +在[https://translate.plazmamc.org/](https://translate.plazmamc.org/)上参与文件翻译以改进文件。 + +{% endhint %} + +### 如果在使用Plazma时遇到问题怎么办？ + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### 对Thunderbolt感兴趣吗？ + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` 더 많은 Minecraft 관련 정보가 필요하다면? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/zh-CN/origin/SUMMARY.md b/zh-CN/origin/SUMMARY.md new file mode 100644 index 000000000..9033d7868 --- /dev/null +++ b/zh-CN/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# 目录 + +- [🏠 欢迎来到文档门户](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma 使用文档](plazma/README.md) +- [❓ Plazma是什么？](plazma/about/README.md) + - [⬇️ 下载](plazma/about/downloads.md) + - [✅ 版本支持状态](plazma/about/supported-versions.md) +- [⚒️ 服务器管理指南](plazma/administration/README.md) + - [👟 开始](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 参考资料](plazma/administration/reference/README.md) + - [🖥️ 命令](plazma/administration/reference/commands.md) + - [🛡️ 权限](plazma/administration/reference/permissions.md) + - [🎛️ 参数和属性](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 属性](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 全局配置](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ 世界级配置](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 全局配置](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ 世界级配置](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 全局配置](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ 世界级配置](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 深入](plazma/administration/expert/README.md) + - [🧹 优化](plazma/administration/expert/optimize.md) + - [🔀 代理](plazma/administration/expert/proxy.md) + - [↩️ 原版化](plazma/administration/expert/vanillaize.md) + - [🩻 X射线阻挡](plazma/administration/expert/xray.md) + - [⚠️ 漏洞和解决方法](plazma/administration/expert/fix-exploits.md) + - [⁉️ 常见问题](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ 开发者指南](plazma/developers.md) + - [✏️ 贡献](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ 雷霆使用指南](thunderbolt/README.md) + +## Volt + +- [⚡ 伏特开发指南](volt/README.md) + +## 杂项 + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ 下载全部查看](plazma/about/downloads-all.md) diff --git a/zh-CN/origin/miscellaneous/README.md b/zh-CN/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/zh-CN/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/zh-CN/origin/plazma/README.md b/zh-CN/origin/plazma/README.md new file mode 100644 index 000000000..4f73db90c --- /dev/null +++ b/zh-CN/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma是为Minecraft: Java Edition添加了基于纸张的实验性优化和多种游戏机制定制功能的开源服务器平台。" +--- + +# ✨ Plazma 使用文档 + +## 👋 欢迎来到 Plazma 文档 + +欢迎访问 Plazma 使用文档！ + +{% hint style="info" %} + +**无法通过说明书解决问题吗？** + +[官方 Discord 服务器](https://discord.gg/MmfC52K8A8)或通过[GitHub 讨论](https://github.com/PlazmaMC/PlazmaBukkit/discussions)向社区提问！ + +{% endhint %} + +### 关于 Plazma + +> 了解 Plazma 是什么样的服务器平台。 + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### 对于管理员 + +> 利用 Plazma 创建自己的服务器。 + +{% content-ref url="administration/" %} +[管理](administration/) +{% endcontent-ref %} + +### 对于开发者 + +> 利用 Plazma 开发第三方项目。 + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/zh-CN/origin/plazma/about/README.md b/zh-CN/origin/plazma/about/README.md new file mode 100644 index 000000000..09f68863d --- /dev/null +++ b/zh-CN/origin/plazma/about/README.md @@ -0,0 +1,73 @@ +--- +description: 了解 Plazma 是什么样的服务器平台。 +--- + +# ❓ Plazma是什么？ + +- **Plazma**是基于[Paper](https://github.com/PaperMC/Paper)的服务器平台，汲取了[Andromeda](https://github.com/EarendelArchived/Andromeda)和[Fusion](https://github.com/RuinedTechnologyUnify/Fusion)的优点。 +- 我们致力于提供高度稳定性、强大性能、快速更新和丰富功能。 + +## 📋 Plazma的目标 + +- 我们努力成为一个快速更新、高度稳定的服务器平台。 +- 我们努力提供与模组平台不相上下的丰富功能和强大性能。 +- 我们努力创建一个可以自由定制甚至调整Vanilla补丁的平台。 + +## ⚙️ 主要特点 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **最快的更新**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)确保Plazma的内置补丁始终保持最新，为基于Paper的服务器平台提供最快的更新速度。 +6. **优化默认配置文件**\ + 默认应用的配置文件已经优化，无需自行优化配置文件。 +7. **多线程高效运行**\ + 通过异步化与游戏机制无关的系统机制，减少[延迟时间](#user-content-fn-4)[^4]以优化服务器。 +8. **阻止不必要的空间使用**\ + 将具有相似值的数据合并为一个以减少内存使用。 + +## ✨ 应用案例 + +- **能正确处理复杂插件的平台**\ + 由开发者[IPECTER](https://github.com/IPECTER)的服务器使用Plazma。\ + 使用NMS和反射运行的自制插件，应用了复杂和庞大的数据包，即使有100多名玩家，也能保持性能稳定。 +- **在RPG服务器上保持快速性能的平台**\ + 在单个集群中，保持100名玩家的TPS稳定， + 在4个集群中，总共250名玩家可以愉快地游玩。 +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **许多主播选择的平台**\ + 被许多主播的观众用作参与的桶。 + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ 下载 + +您可以在下面的页面上下载Plazma。 + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### 想了解版本支持的详细信息？ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit、CraftBukkit、Spigot插件以及Paper、Pufferfish、Purpur插件。 + +[^2]: 由Microsoft Corporation提供。 + +[^3]: 禁用聊天举报系统将使聊天完全在服务器上处理，阻止Mojang的聊天跟踪。 + +[^4]: 系统机制需要暂停游戏以运行。 diff --git a/zh-CN/origin/plazma/about/downloads-all.md b/zh-CN/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..88338f955 --- /dev/null +++ b/zh-CN/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma执行文件下载全部查看 +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| 版本 | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/zh-CN/origin/plazma/about/downloads.md b/zh-CN/origin/plazma/about/downloads.md new file mode 100644 index 000000000..b9571f40f --- /dev/null +++ b/zh-CN/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: 立即下载Plazma并自行使用。 +--- + +# ⬇️ 下载 + +#### 想了解版本支持的详细信息？ + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**以下下载是一般用户用的可执行文件。** + +如果您是开发者，并且需要其他形式的文件，请参考下面的页面。 + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
版本下载
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 下载 +
1.20.1 + 下载 +
1.19.4 + 下载 +
+ +*** diff --git a/zh-CN/origin/plazma/about/patches-list.md b/zh-CN/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..6885f5e7b --- /dev/null +++ b/zh-CN/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: 了解所有添加到Plazma中的功能。 +--- + +# 📑 包含的补丁 diff --git a/zh-CN/origin/plazma/about/supported-versions.md b/zh-CN/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..8b2fc481e --- /dev/null +++ b/zh-CN/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "了解Plazma支持的Minecraft: Java Edition版本。" +--- + +# ✅ 版本支持状态 + +{% hint style="info" %} + +**Plazma从1.19.4版本开始开发，1.19.4版本以下的版本不再开发。** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/开发中 +[atv]: https://badge.plazmamc.org/2/支持中 +[fse]: https://badge.plazmamc.org/6/功能支持中断 +[eol]: https://badge.plazmamc.org/4/支持结束 +[ukn]: https://badge.plazmamc.org/0/没有信息 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/普通 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![开发中][idv] ![支持中][atv] ![功能支持中断][fse] ![支持结束][eol] + +| 版本 | 稳定性 和 功能支持 | 构建状态 | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![构建状态](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![构建状态](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![构建状态](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/zh-CN/origin/plazma/administration/README.md b/zh-CN/origin/plazma/administration/README.md new file mode 100644 index 000000000..6e3c20559 --- /dev/null +++ b/zh-CN/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: 利用 Plazma 创建自己的服务器。 +--- + +# ⚒️ 服务器管理指南 diff --git a/zh-CN/origin/plazma/administration/diagnosis/README.md b/zh-CN/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..bc46ea4ee --- /dev/null +++ b/zh-CN/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: 当问题发生时，了解如何应对。 +--- + +# 🧾 진단 diff --git a/zh-CN/origin/plazma/administration/diagnosis/plugins.md b/zh-CN/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..780a002f4 --- /dev/null +++ b/zh-CN/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: 当插件无法正常工作时，请了解如何解决。 +--- + +# 📜 플러그인 diff --git a/zh-CN/origin/plazma/administration/expert/README.md b/zh-CN/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..ae628a1bf --- /dev/null +++ b/zh-CN/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: 了解如何专业处理Plazma。 +--- + +# 🎓 深入 diff --git a/zh-CN/origin/plazma/administration/expert/fix-exploits.md b/zh-CN/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..5c382f3c3 --- /dev/null +++ b/zh-CN/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 了解已知漏洞及解决方法。 +--- + +# ⚠️ 已知漏洞及解决方法 diff --git a/zh-CN/origin/plazma/administration/expert/optimize.md b/zh-CN/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..7a869a949 --- /dev/null +++ b/zh-CN/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: 了解如何优化Plazma。 +--- + +# 🧹 优化 diff --git a/zh-CN/origin/plazma/administration/expert/proxy.md b/zh-CN/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..4ac1cb092 --- /dev/null +++ b/zh-CN/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: 学习如何安全配置代理平台“Velocity”。 +--- + +# 🔀 代理 diff --git a/zh-CN/origin/plazma/administration/expert/vanillaize.md b/zh-CN/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..dec1d1a82 --- /dev/null +++ b/zh-CN/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: 了解如何恢复Paper和Vanilla的修补程序。 +--- + +# ↩️ 进行香草化 + +{% hint style="warning" %} + +**Paper不会为大多数修复Vanilla错误的补丁添加选择。** + +目前，Plazma正在开发使这些错误修复配置无效的功能。 + +因此，本指南仍在编写中，并且信息随时可能更改。 + +{% endhint %} diff --git a/zh-CN/origin/plazma/administration/expert/xray.md b/zh-CN/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..3bf11956c --- /dev/null +++ b/zh-CN/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: 了解阻止X射线的多种内置方法。 +--- + +# 🩻 阻止X射线 diff --git a/zh-CN/origin/plazma/administration/faq.md b/zh-CN/origin/plazma/administration/faq.md new file mode 100644 index 000000000..0b0c9211a --- /dev/null +++ b/zh-CN/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: 了解常见问题。 +--- + +# ⁉️ 常见问题 + +{% hint style="info" %} + +**找不到想要的答案吗？** + +[官方 Discord 服务器](https://discord.gg/MmfC52K8A8)或通过[GitHub 讨论](https://github.com/PlazmaMC/PlazmaBukkit/discussions)向社区提问！ + +{% endhint %} + +### Plazma无法启动 + +如果控制台显示 `no main manifest attribute, in plazma-(version).jar`， +则下载的文件是开发 API 文件，应从 GitHub 页面下载 **Reobf Paperweight**。 + +请参考以下页面以获取更多信息。 + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### 每次启动服务器时都会显示警告 + +Plazma 包含一些不稳定的补丁，因此可能会出现故障。因此，在服务器启动时始终显示以下警告消息。 + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +使用 [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] 系统属性可以禁用此警告消息。 + +请参考以下页面以获取更多信息。 + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 从1.20.1版本开始提供 diff --git a/zh-CN/origin/plazma/administration/getting-started/README.md b/zh-CN/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..d769b9cd8 --- /dev/null +++ b/zh-CN/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: 了解如何使用Plazma创建服务器。 +--- + +# 👟 开始 + +为了稳定地使用Plazma，系统必须满足以下要求。 + +| | 最低 | 建议 | +| :--: | --- | ---- | +| 架构 | x64 | - | +| RAM | 8GB | 16GB | +| 存储空间 | 1GB | 8GB | +| JDK | 17 | 21 | + +为了顺利修改配置文件，建议安装像[Visual Studio Code](https://code.visualstudio.com/download)这样的编辑器。 + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="正确的输出" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'不是内部或外部命令，也不是可运行的程序或批处理文件。 +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 首先，在[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu)上下载**JDK 21**的`.msi`安装程序。 +2. 运行下载的安装向导，点击`下一步`。 +3. 在左上角的菜单中激活`Set JAVA_HOME variable`，然后点击`下一步`。 +4. 点击`安装`完成JRE安装。 + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +然后，运行以下命令以安装JRE。 + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. 下载Plazma + +Plazma提供多种形式的可执行文件。 + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +了解更多 + +执行文件的名称为`plazma-(版本管理器)-1.20.4-R0.1-SNAPSHOT-(映射形式).jar`。 + +- **映射形式**\ + 映射是连接Minecraft实际代码和混淆代码的一种地图。 + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang映射，即原始Minecraft映射。 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **版本管理器**\ + 版本管理器是运行服务器所需的库和修补服务器文件的启动器。 + - **Paperclip**\ + 由PaperMC团队为Paper和其他衍生平台开发的管理器，负责下载库并应用补丁到服务器。 + - **Bundler**\ + 原始Minecraft版本管理器。 + +
+ +*** + +## 3. 创建启动脚本 + +要简单启动Plazma并自动重新启动服务器，需要创建[启动脚本](#user-content-fn-6)。 + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +通过底部的下载按钮下载启动脚本。\ +**请确保下载的启动脚本与您的操作系统相匹配。** + +*** + +## 4. 文件整理 + +现在将下载的启动脚本和Plazma移动到新文件夹中。 + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +现在运行启动脚本。 Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. 同意EULA + +运行启动脚本后，文件夹中将生成`eula.txt`。 + +EULA[^9]是使用[Mojang Studios](#user-content-fn-10)的服务时必须同意的许可协议。 + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +要同意EULA，请将`eula.txt`文件中的`eula=false`修改为`eula=true`并保存。 + +*** + +## 6. 允许外部访问（Windows） + +现代操作系统默认通过**防火墙**和**路由器**阻止外部访问以防止危险访问。 + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +如果路由器不支持UPnP，则由于每个路由器面板不同，您需要自行搜索资料。 + +或者，您可以通过[Ngrok](https://ngrok.com/)生成临时地址。 +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 检查是否需要端口转发 + +输入以下内容并运行。 + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +如果输出为`True`，则可以结束，否则需要设置端口转发。 + +### 6.2 连接服务器 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +连接服务器时使用的地址可以在[这里](https://ip.pe.kr/)进行确认。 +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +然后，重新启动服务器后，Plazma将自动尝试进行端口转发。 + +以下是根据控制台输出的消息判断UPnP成功与否，控制台将显示`[UPnP] (消息)`。 + +| 消息 | 含义 | +| ------------- | ------------- | +| `成功打开端口 (端口)` | 端口转发成功。 | +| `端口 (端口)已打开` | 另一个服务正在使用该端口。 | +| `无法打开端口 (端口)` | 端口转发失败。 | +| `服务不可用` | 路由器不支持UPnP。 | + +服务器关闭后，Plazma会自动关闭端口。 +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. 从[Ngrok官网](https://ngrok.com/download)下载`Windows (64-bit)` ZIP文件。 +2. 将下载的Ngrok放入服务器文件夹中。 +3. 在[Ngrok仪表板](https://dashboard.ngrok.com/get-started/your-authtoken)上生成[授权令牌](#user-content-fn-13)[^13]。 +4. 在服务器文件夹中运行显示在下方`Command Line`中的命令。 +5. 在执行脚本的顶部添加`start /b ngrok tcp --region jp 25565`，在底部添加`taskkill /f /t /im ngrok.exe`。 +6. 在控制台顶部显示的`Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`中，`0.tcp.jp.ngrok.io:12345`将成为服务器地址。 +7. 现在可以通过该地址从外部访问。 + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +例如，运行命令后，输出如下： + +```log +Windows IP配置 + +以太网适配器 以太网: + + 连接的 DNS 后缀. . . . . . . : + IPv4 地址. . . . . . . . : 192.168.3.7 + 子网掩码 . . . . . . . : 255.255.255.0 + 默认网关 . . . . . . . : 192.168.3.1 + +``` + +尝试使用显示的`192.168.3.7`进行本地连接到服务器。 + +如果服务器和游戏在同一台PC上运行，则可以使用`localhost`进行连接。 +{% endtab %} +{% endtabs %} + +## 7。 发展 + +如果服务器成功启动并正常运行，则现在是个性化服务器的时候了。 + +请查看以下手册以了解如何个性化服务器。 + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma基于Paper，而Paper基于Spigot，Spigot基于官方服务器平台。 + +[^3]: Windows键 + R + +[^4]: 对于Linux，请在终端中运行`java --version`。 + +[^5]: JRE是一个开源项目，类似于Minecraft服务器平台，有多种类型。 + +[^6]: 通常被称为**运行器**。 + +[^7]: 启用"自动重启"将导致服务器自动重新启动。 可以使用`Control + C`来结束。 + +[^8]: 不建议超过系统的一半。 + + 例如，如果系统总内存容量为8GB，则不建议将其设置为4GB以上。 + +[^9]: 最终用户许可协议，EULA。 有关详细信息，请查看[Minecraft网站](https://www.minecraft.net/ko-kr/usage-guidelines)。 + +[^10]: 微软公司。 + +[^11]: 根据韩国游戏产业促进法第32条第1款第9号，**韩国微软有限公司**可以根据法律提起诉讼。 + +[^12]: 通用即插即用。 Plazma中包含的Purpur通过此技术自动与路由器通信，在服务器运行时仅打开端口，因此无需直接进行端口转发。 + +[^13]: 如果没有帐户，请通过Google或GitHub帐户注册Ngrok。 diff --git a/zh-CN/origin/plazma/administration/getting-started/customization.md b/zh-CN/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..caec5adfe --- /dev/null +++ b/zh-CN/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,117 @@ +--- +description: 了解如何定制服务器。 +--- + +# 🎨 用户定制 + +使用修改后的服务器平台，如Plazma，而不是使用Mojang Studios提供的官方服务器平台的原因是可以实现强大的**用户定制**能力。 + +以下是使用Plazma进行定制和利用的多种方法。 + +## 配置修改 + +对Plazma进行定制的最基本方法就是修改配置。 + +Plazma提供强大的配置设置，从游戏机制到怪物属性等。 + +请参考以下页面了解Plazma的配置。 + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## 使用插件 + +{% hint style="success" %} + +**Plazma支持基于Paper的所有插件。** + +对于Spigot插件，由于1.20.5版本后Paper的映射变化，可能会导致部分插件无法正常工作，但是基于Paper的插件，如Paper、Pufferfish和Purpur等，都可以在Plazma上正常运行。如果插件无法正常工作，请立即[报告给Plazma](../diagnosis/plugins.md)。 + +{% endhint %} + +这是使用Plazma的主要原因，也是个性化Plazma的最强大方式。 +Plazma强大的插件生态系统使服务器可以轻松个性化。 + +查找和下载插件有多种方法。 一些插件会将插件上传到公共存储库服务，而另一些插件则会上传到GitHub或自己的网站。 + +{% hint style="caution" %} + +**插件可以直接访问系统！** + +使用VirusTotal等服务在应用插件之前始终确保安全，或者从可信赖的服务下载插件。 + +{% endhint %} + +有多种服务可用于下载插件。 其中，[SpigotMC论坛](https://www.spigotmc.org/resources/)、[BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins)、[Modrinth](https://modrinth.com/plugins)、[Hanger](https://hangar.papermc.io/)等服务在上传插件之前经过审核，只允许安全的插件流通。 + +### 应用插件 + +如果已下载插件，则现在是应用插件的时候了。 + +1. 插件是以`.jar`或`Java可执行文件`的形式存在。\ + 有些插件可能被压缩成压缩文件，在这种情况下， + 解压缩并找到名称中包含`bukkit`、`spigot`或`paper`的文件， + 如果有`fat`文件，则使用`fat`文件。 +2. 将下载的文件放入服务器文件夹的`plugins`文件夹中，并重新启动服务器。 +3. Plazma启动后，控制台将输出新内容。 + 这表示Plazma已成功加载插件。 +4. 即使Plazma已成功加载插件，某些插件可能无法启动。 + 使用`/plugins`命令可以查看当前加载到服务器的插件。 + 如果安装的插件名称不是红色，而是绿色，则表示插件已成功加载。 + +如果插件未能成功加载，请查看下面的页面以找到解决方法。 + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 使用数据包 + +数据包是Minecraft提供的一种用户自定义方法，类似于[资源包](#user-content-fn-1)[^1]。 + +使用数据包可以添加新的生物群系和挑战，修改游戏内的一些部分。 + +{% hint style="caution" %} + +**数据包可能损坏世界！** + +一些损坏的数据包可能会损坏世界，这是不可逆转的。 + +因此，在应用数据包之前建议备份世界。 + +{% endhint %} + +数据包也可以从多个服务中下载，如[CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs)、[Modrinth](https://modrinth.com/datapacks)、[Planet Minecraft](https://www.planetminecraft.com/data-packs)等服务。 + +下载数据包后，将其放入服务器的世界文件夹中的`datapacks`文件夹中以应用。 +如果没有该文件夹，可以创建一个并添加数据包。 + +{% hint style="warning" %} + +**某些[数据包](#user-content-fn-2)[^2]在首次应用时可能无法正常应用。** + +为此，建议重新启动服务器**2次**。 + +{% endhint %} + +随着Minecraft版本的更新，数据包可能会很容易损坏。 + +特别是当数据包完全损坏时，服务器可能会崩溃， +因此，在更新服务器之前进行充分测试非常重要。 + +{% hint style="info" %} + +**在启动服务器命令后输入`safeMode`，可以禁用所有数据包并启动服务器。** + +[有关详细信息，请参阅`参考 > 参数和属性`。](../reference/arguments.md) + +{% endhint %} + +应用的数据包可以通过`/datapack list`命令进行确认。 + +*** + +[^1]: 或者Minecraft: Bedrock Edition的插件。 + +[^2]: 添加生物群系等。 diff --git a/zh-CN/origin/plazma/administration/getting-started/next-step.md b/zh-CN/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..f24605750 --- /dev/null +++ b/zh-CN/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: 了解如何定制服务器。 +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +以下是使用Plazma进行定制和利用的多种方法。 + +## 配置修改 + +对Plazma进行定制的最基本方法就是修改配置。 + +Plazma提供强大的配置设置，从游戏机制到怪物属性等。 + +请参考以下页面了解Plazma的配置。 + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## 使用插件 + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +这是使用Plazma的主要原因，也是个性化Plazma的最强大方式。 Plazma强大的插件生态系统使服务器可以轻松个性化。 + +查找和下载插件有多种方法。 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +有多种服务可用于下载插件。 其中，[SpigotMC论坛](https://www.spigotmc.org/resources/)、[BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins)、[Modrinth](https://modrinth.com/plugins)、[Hanger](https://hangar.papermc.io/)等服务在上传插件之前经过审核，只允许安全的插件流通。 + +### 应用插件 + +如果已下载插件，则现在是应用插件的时候了。 + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 将下载的文件放入服务器文件夹的`plugins`文件夹中，并重新启动服务器。 +3. Plazma启动后，控制台将输出新内容。 这表示Plazma已成功加载插件。 +4. 即使Plazma已成功加载插件，某些插件可能无法启动。 使用`/plugins`命令可以查看当前加载到服务器的插件。 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +如果插件未能成功加载，请查看下面的页面以找到解决方法。 + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 使用数据包 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +使用数据包可以添加新的生物群系和挑战，修改游戏内的一些部分。 + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +一些损坏的数据包可能会损坏世界，这是不可逆转的。 + +因此，在应用数据包之前建议备份世界。 +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +下载数据包后，将其放入服务器的世界文件夹中的`datapacks`文件夹中以应用。 如果没有该文件夹，可以创建一个并添加数据包。 + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +为此，建议重新启动服务器**2次**。 +{% endhint %} + +随着Minecraft版本的更新，数据包可能会很容易损坏。 + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +应用的数据包可以通过`/datapack list`命令进行确认。 + +*** + +## 优化 + +Plazma已应用许多优化补丁。 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 代理 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +有关安全且正确的代理设置信息，请参阅以下页面。 + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 安全 + +随着Minecraft模组的发展，可以轻松在线获取[漏洞攻击引擎](#user-content-fn-3)[^3]。 + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 权限设置 + +一些插件的管理员命令存在未正确设置权限的漏洞。 + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X射线阻挡 + +X射线是基本优化客户端中容易使用的漏洞之一。 + +Plazma提供了阻止X射线的配置。 + +有关X射线阻止方法和说明，请参阅以下页面。 + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 白名单 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +要查看已允许连接的玩家，请使用`/whitelist query`。 + +*** + +[^1]: 或者Minecraft: Bedrock Edition的插件。 + +[^2]: 添加生物群系等。 + +[^3]: 通常被称为"作弊"。 + +[^4]: 如果配置不佳，Plazma过时，或者发现了新的漏洞，则可能未阻止玩家使用。 + +[^5]: 玩家通过Ngrok代理服务器连接到服务器，每次重新启动都会分配一个新的Ngrok地址。 diff --git a/zh-CN/origin/plazma/administration/reference/README.md b/zh-CN/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..8ff18f713 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: 了解Plazma提供的基本自定义方法。 +--- + +# 📜 리퍼런스 + +Plazma提供了多种自定义方法。 + +其中，以下4种方法是可以直接使用而无需额外操作的自定义方法。 + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[官方 Discord 服务器](https://discord.gg/MmfC52K8A8)或通过[GitHub 讨论](https://github.com/PlazmaMC/PlazmaBukkit/discussions)向社区提问！ +{% endhint %} + +*** + +## 🖥️ 命令 + +> 命令允许在游戏中收集信息或自定义游戏环境。 + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ 权限 + +> 权限确定玩家可以互动的范围。 + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ 参数和属性 + +> 参数和属性对Plazma的运行产生全面影响。 + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 配置 + +> 配置是自定义Plazma的最基本方法。 + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/zh-CN/origin/plazma/administration/reference/arguments.md b/zh-CN/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..a6f907ac4 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,568 @@ +--- +description: 了解启动参数和系统属性。 +--- + +# 🎛️ 参数和属性 + +起始输入和系统属性是Plazma执行时附加到[用于执行的命令](#user-content-fn-1)[^1]的值，对Plazma的运行产生全面影响。 + +[命令中添加的位置](#user-content-fn-2)[^2]将被分为**起始参数**和**系统属性**。 + +*** + +## 系统属性 + +系统属性是在 `-jar` 前输入的值，在Plazma初始化之前由JVM处理。 + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 用法 + +系统属性作为Java命令参数输入，位于`java`和`-jar`之间。 + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`表示该参数不是JVM内置的，而是附加到Plazma的专用参数， + +如果未输入任何值，则值将被固定为[`true`](#user-content-fn-3)[^3]。 + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 全部系统属性 + +#### `convertLegacySigns` + +- **类型**: `布尔值` +- **默认值**: `False` + +更新停用的标志格式。 + +#### `debug.entities` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用与实体信息相关的调试日志。 + +#### `debug.rewriteForIDE` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用NMS修订以便IDE正确加载调试信息，\ +并自动重新映射内部版本信息。 + +#### `disable.watchdog` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Spigot的看门狗警告系统。 + +#### `letMeReload` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用`/reload`命令的重新加载消息。 + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +如果您是插件开发者并需要更新插件，请使用热交换而不是`/reload`。 +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用使用标准输入/输出的插件。 + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **类型**: `布尔值` +- **默认值**: `False` + +检测到聊天组件中使用的停用格式时发出警告。 + +#### `Paper.bypassHostCheck` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用玩家连接到服务器时的主机匹配验证。 + +#### `Paper.debugDynamicMissingKeys` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对NBT对象中缺失键的调试日志。 + +#### `Paper.debugInvalidSkullProfiles` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对具有无效配置文件信息的头骨块的调试日志。 + +记录世界中所有无效头骨块的位置。 + +#### `Paper.disableChannelLimit` + +- **类型**: `布尔值` +- **默认值**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用插件类优先级系统。 + +在插件阴影中出现问题时很有用。 + +#### `Paper.disableFlushConsolidate` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Netty刷新合并系统。 + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **默认值**: `750` + +如果实体数量超过设置值，则分割为多个数据包进行传输。 + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **默认值**: `8192` + +设置服务器一次接收的最大数据包大小。 + +#### `Paper.ignoreJavaVersion` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Java版本检查。 + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +可能会永久损坏世界和其他文件，并使游戏机制崩溃。 + +由此导致的所有问题由用户自行承担，Plamza不提供任何支持。 +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **默认值**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **默认值**: `80` + +设置标志一行可输入的最大字符数。 + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **默认值**: `(world version) + 1` + +设置要首先初始化的世界更新信息的版本。 + +对于需要大量更新块的情况很有用，但在其他情况下不使用。 + +#### `Paper.parseYamlCommentsByDefault` + +- **类型**: `布尔值` +- **默认值**: `True` + +启用默认情况下解析YAML文件的注释。 + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **默认值**: `30` + +当玩家在指定时间内（以秒为单位）未收到任何数据时，将踢出玩家。 + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **类型**: `布尔值` +- **默认值**: `False` + +忽略服务器属性的注释。 + +#### `Paper.debug-sync-loads` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用同步块写入的调试日志。 + +#### `Paper.enable-sync-chunk-writes` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用Minecraft的[默认块写入系统](#user-content-fn-10)[^10]。 + +这会按顺序保存每个块，导致严重性能下降。 + +#### `Paper.explicit-flush` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用网络通道的显式刷新。 + +#### `Paper.strict-thread-checks` + +- **类型**: `布尔值` +- **默认值**: `False` + +始终记录不是在主线程上发生的错误。 + +#### `Paper.tickList-warn-on-excessive-delay` + +- **类型**: `布尔值` +- **默认值**: `False` + +如果预定任务具有过多的延迟，将输出警告。 + +#### `Paperclip.patchOnly` + +- **类型**: `布尔值` +- **默认值**: `False` + +如果使用默认提供的执行文件，则仅应用补丁而不启动服务器。 + +#### `Plazma.aggressiveOptimize` + +- **类型**: `布尔值` +- **默认值**: `false` +- **冲突**: `Plazma.disableConfigOptimization` + +加强初始化配置优化。 + +启用后，服务器将更快更安全，但可能会对游戏玩法产生重大影响。 + +#### `Plazma.disableConfigOptimization` + +- **类型**: `布尔值` +- **默认值**: `false` +- **冲突**: `Plazma.aggressiveOptimize` + +不优化初始配置。 + +将使用Paper的默认配置。 + +#### `Plazma.iKnowWhatIAmDoing` + +- **类型**: `布尔值` +- **默认值**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **类型**: `布尔值` +- **默认值**: `false` + +禁用Plazma品牌，并使用原始服务器默认favicon。 + +#### `Plazma.useVanillaConfiguration` + +- **类型**: `布尔值` +- **默认值**: `false` +- **冲突**: `Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +这可能严重影响服务器的安全性和性能。 + +出现任何问题都由服务器管理员负责。 +{% endhint %} + +将初始配置设置为由Mojang提供的默认值。 + +将禁用Paper上应用的所有漏洞修补。 + +可以在Paper配置或Plazma配置中重新启用漏洞修补。 + +#### `Plazma.vanillaize` + +- **类型**: `布尔值` +- **默认值**: `true` +- **冲突**: `Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +将初始配置设置为接近原始。 + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 已停用的属性 + +以下系统属性已停用。 + +#### `timings.bypassMax` + +- **类型**: `布尔值` +- **默认值**: `false` +- **已停用**：自Plazma中删除Timings以来 + +决定是否可以超过Aikar的Timings API可发送的最大值。 + +即使如此，如果API未处理异常，则会应用速率限制。 + +*** + +## 起始参数 + +起始参数是在`-jar *.jar`之后输入的，用于初始化Plazma并一起处理的值。 + +### 用法 + +系统属性作为`-jar *.jar`后的程序命令参数输入。 + +例如，如果要应用`nogui`起始参数，\ +请按以下方式输入，Plazma在初始化过程中将处理`nogui`参数。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 完整的起始参数 + +#### `bukkit-settings` + +- **别名**：`b` +- **默认值**：`bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **别名**：`c` +- **默认值**：`commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **别名**：`c` +- **默认值**：`server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +启动服务器到演示世界。 + +#### `eraseCache` + +删除升级后剩余的缓存文件。 + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **别名**：`?` + +显示Plazma的完整启动参数和说明。 + +#### `initSettings` + +仅创建配置文件并关闭服务器。 + +#### `jfrProfile` + +启用JFR分析。 + +#### `max-players` + +- **别名**：`s`，`size` +- **默认值**：`(服务器属性)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +禁用图形界面面板。 + +#### `nojline` + +禁用JLine并使用原始控制台。 + +#### `online-mode` + +- **别名**：`o` +- **默认值**：`(服务器属性)` + +选择是否要验证玩家到Mojang验证服务器。 + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **别名**：`paper` +- **默认值**：`paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +设置已停用的PaperSpigot配置文件位置。 + +此用于将现有配置迁移到新配置文件，之后不再使用。 + +#### `paper-settings-directory` + +- **别名**：`paper-dir` +- **默认值**：`config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **别名**：`plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **别名**：`p` +- **默认值**：`plugins` + +设置插件文件夹的位置。 + +#### `pufferfish-settings` + +- **别名**：`pufferfish` +- **默认值**：`pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **别名**：`purpur` +- **默认值**：`purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +以安全模式启动服务器，完全原始状态。 + +#### `server-ip` + +- **别名**：`h`，`host` +- **默认值**：`(服务器属性)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **别名**：`p`，`port` +- **默认值**：`(服务器属性)` + +设置服务器的端口。 + +#### `server-name` + +- **默认值**：`A Plazma Server` + +设置服务器的名称。 + +#### `spigot-settings` + +- **别名**：`S` +- **默认值**：`spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **别名**：`v` + +输出Plazma版本。 + +#### `world-dir` + +- **别名**：`W`，`universe`，`world-container` +- **默认值**：`(服务器文件夹)` + +设置存储世界文件的位置。 + +#### `world-name` + +- **别名**：`w`，`world` +- **默认值**：`(服务器属性)` + +设置世界文件的名称。 + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 根据追加的位置处理参数的位置会发生变化。 + +[^3]: 例如，如果要将 `Plazma.iKnowWhatIAmDoing` 设置为 `true`（启用），只需输入 `-DPlazma.iKnowWhatIAmDoing`，而不是 `-DPlazma.iKnowWhatIAmDoing=true`，它将同样有效。 + +[^4]: 例如，`"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 事件检测器。 + +[^6]: 事件检测器。 + +[^7]: 客户端。 + +[^8]: 像心跳一样向服务器发送连接正常的信号。 + +[^9]: 使用Purpur的AFK踢出功能，即使玩家离开也可以将其踢出。 + +[^10]: 同步区块写入系统，Sync Chunk Write System。 + +[^11]: \`警告！ Plazma可能会导致意外问题，因此请确保在将其用于公共服务器之前进行彻底测试。 + +[^12]: 在游戏中，“世界优化”也是按照这个原则运作的。 + +[^13]: 除了`级别 2`以上的管理员。 + +[^14]: Internet协议，IP。 diff --git a/zh-CN/origin/plazma/administration/reference/commands.md b/zh-CN/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..17ec97feb --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: 了解在Plazma中可用的命令。 +--- + +# 🖥️ 命令 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/README.md b/zh-CN/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..b1753edb2 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: 配置是自定义Plazma的最基本方法。 +--- + +# 🧾 구성 + +*** + +## 🪨 属性 + +> 属性是Minecraft提供的最基本的配置文件。 使用属性可以更改游戏的基本机制。 + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit 配置 + +> Bukkit配置是Plazma提供的最基本的配置文件。 使用Bukkit配置可以更改Minecraft服务器的基本机制。 + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot 配置 + +> Spigot配置允许修改游戏的详细机制，玩家处理，命令等操作和消息。 + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper 配置 + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish配置允许修改Plazma的世界和实体处理。 + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur 配置 + +> Purpur属性允许修改游戏的整体基础数据。 + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma 配置 + +> Plazma配置允许用户自定义Plazma的功能。 + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/zh-CN/origin/plazma/administration/reference/configurations/bukkit.md b/zh-CN/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..04658aa9d --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: 了解bukkit.yml中每个节点的含义。 +--- + +# 🪣 Bukkit diff --git a/zh-CN/origin/plazma/administration/reference/configurations/paper/README.md b/zh-CN/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b746d7ff1 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: 了解config文件夹中每个文件的用途。 +--- + +# 🛩️ 纸 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/paper/global.md b/zh-CN/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..a5520e3fc --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: 了解paper-global.yml的每个节点代表什么。 +--- + +# 🌏 전역 구성 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/paper/world.md b/zh-CN/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..732bb81b3 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: 了解每个节点在paper-world.yml中代表什么。 +--- + +# 🏳️ 세계별 구성 + +世界各地 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/plazma/README.md b/zh-CN/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..abcb18ceb --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: 了解config文件夹中每个文件的用途。 +--- + +# ✨ 皮拉兹玛 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/plazma/global.md b/zh-CN/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..51b205d9a --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: 了解plazma-global.yml中每个节点的含义。 +--- + +# 🌏 전역 구성 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/plazma/world.md b/zh-CN/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..3bf4be380 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: 了解每个节点在plazma-world.yml中代表什么。 +--- + +# 🏳️ 세계별 구성 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/plazma/worlds.md b/zh-CN/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..705fb6d43 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: 了解每个节点在plazma-world.yml中代表什么。 +--- + +# ✨ Plazma (按世界划分) diff --git a/zh-CN/origin/plazma/administration/reference/configurations/property.md b/zh-CN/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..a699be47b --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: 了解server.properties中每个节点代表的含义。 +--- + +# 🪨 Server.properties diff --git a/zh-CN/origin/plazma/administration/reference/configurations/pufferfish.md b/zh-CN/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..1cf5fad6e --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: 了解pufferfish.yml中每个节点代表什么。 +--- + +# 🐡 河豚 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/purpur/README.md b/zh-CN/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..10ecad64e --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: 查看purpur.yml中每个节点代表什么。 +--- + +# 🦑 Purpur diff --git a/zh-CN/origin/plazma/administration/reference/configurations/purpur/global.md b/zh-CN/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..8dd67dfe3 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: 查看purpur.yml中每个节点代表什么。 +--- + +# 🌏 전역 구성 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/purpur/world.md b/zh-CN/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..ed440934e --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: 查看purpur.yml中每个节点代表什么。 +--- + +# 🏳️ 세계별 구성 diff --git a/zh-CN/origin/plazma/administration/reference/configurations/spigot.md b/zh-CN/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..52a9118ec --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: 了解每个spigot.yml节点代表什么。 +--- + +# 🚰 Spigot diff --git a/zh-CN/origin/plazma/administration/reference/permissions.md b/zh-CN/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..2c168b7f1 --- /dev/null +++ b/zh-CN/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: 了解Plazma的权限。 +--- + +# 🛡️ 权限 + +权限是服务器内玩家可以互动的范围的简单安全工具。 + +要正确使用权限并轻松修改，请使用插件，如[LuckPerms](https://luckperms.net)。 + +*** + +## 理解基本权限系统 + +Minecraft提供了基本的管理权限组。 + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **玩家**\ + 通常是赋予所有玩家的权限组。 +2. **中介者**\ + 可以忽略生成保护。 +3. **世界管理员**\ + 可以使用与世界管理相关的所有命令和命令方块。\ + 是应用于数据包和命令方块的默认权限组。 +4. **管理员**\ + 可以使用与玩家管理相关的所有命令。 +5. **总管理员**\ + 可以使用包括服务器管理在内的所有命令。\ + 是应用于控制台和管理员的默认权限组。 + +*** + +## 设置权限 + +*** + +## 全部权限 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **默认提供**: `无` + +允许玩家`弯腰并互动`实体以骑乘实体。 + +骑乘实体后，可以使用`移动键`来控制实体的移动，使用`跳跃键`来跳跃或飞行。 + +`(Namespaced Key)`是实体的[命名空间ID](#user-content-fn-2)[^2]。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **默认提供**: `无` + +允许玩家在骑乘实体时使用实体的特殊技能。 + +并非所有实体的特殊功能都可用。 请参考下面的所有可用特殊技能。 + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +请在[Plazma Discord](https://plazmamc.org/discord)或[GitHub Discussions](https://github.com/PlazmaMC/PlazmaBukkit/discussions)上发布您的想法！ +{% endhint %} + +
+ +查看当前可用的特殊技能 + +- **`crepper`**\ + 按下`跳跃键`会爆炸。\ + 如果玩家拥有`allow.powered.creeper`权限，则可以按住`跳跃键`进行充能。 +- **`dolphin`**\ + 按下`跳跃键`会进行冲刺。 +- **`phantom`**\ + 按下`跳跃键`会发射火焰。 +- **`wither`**\ + 与其`互动`会发射凋零头。 + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **默认提供**: `世界管理员` + +允许使用[`/compass`命令](commands.md#compass)。 + +#### `bukkit.command.credits` + +- **默认提供**: `世界管理员` + +允许使用[`/credits (Player)`命令](commands.md#credits)。 + +在权限名后输入`.other`，可以允许其他玩家使用。 + +#### `bukkit.command.demo` + +- **默认提供**: `世界管理员` + +允许使用[`/demo (Player)`命令](commands.md#demo)。 + +在权限名后输入`.other`，可以允许其他玩家使用。 + +#### `bukkit.command.ping` + +- **默认提供**: `世界管理员` + +允许使用[`/ping (Player)`命令](commands.md#ping)。 + +在权限名后输入`.other`，可以允许其他玩家使用。 + +#### `bukkit.command.ram` + +- **默认提供**: `世界管理员` + +允许使用[`/ram`命令](commands.md#ram)。 + +#### `bukkit.command.rambar` + +- **默认提供**: `世界管理员` + +允许使用[`/rambar (Player)`命令](commands.md#rambar)。 + +在权限名后输入`.other`，可以允许其他玩家使用。 + +#### `bukkit.command.restart` + +- **默认提供**: `世界管理员` + +允许使用[`/restart`命令](commands.md#restart)。 + +#### `bukkit.command.tps` + +- **默认提供**: `世界管理员` + +允许使用[`/tps`命令](commands.md#tps)。 + +#### `bukkit.command.tpsbar` + +- **默认提供**: `世界管理员` + +允许使用[`/tpsbar (Player)`命令](commands.md#tpsbar)。 + +在权限名后输入`.other`，可以允许其他玩家使用。 + +#### `bukkit.command.timings` + +- **默认提供**: `世界管理员` + +允许使用[`/timings`命令](commands.md#timings)。 + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +要了解类似功能的命令，请查看[Spark](https://spark.lucko.me/docs/Command-Usage)。 +{% endhint %} + +#### `bukkit.command.uptime` + +- **默认提供**: `世界管理员` + +允许使用[`/uptime`命令](commands.md#uptime)。 + +#### `minecraft.command.gamemode.(GameMode)` + +- **默认提供**: `世界管理员` + +允许使用`/gamemode (GameMode) (Player)`命令。 + +在权限名后输入`.other`，可以允许其他玩家使用。 + +#### `paper.antixray.bypass` + +- **默认提供**: `无` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +这样双方都可以体验到性能的提升。 + +> 有关X射线设置的信息，请参考下面的页面。 + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **默认提供**: `无` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **默认提供**: `无` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **默认提供**: `无` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **默认提供**: `无` + +允许在铁砧上使用[MiniMessage标签](https://docs.advntr.dev/minimessage/format.html)。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **默认提供**: `无` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **默认提供**: `无` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **默认提供**: `无` + +允许玩家免受空闲踢出的影响。 + +#### `purpur.debug.f3n` + +- **默认提供**: `世界管理员` + +允许玩家使用`F3 + N`键切换游戏模式。 + +如果没有相应游戏模式的权限，则不起作用。 + +#### `purpur.drop.spawners` + +- **默认提供**: `无` + +当使用配置中的物品挖掘刷怪笼时，会掉落刷怪笼。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **默认提供**: `无` + +更改末影箱的大小。 + +可输入`one`、`two`、`three`、`four`、`five`、`six`到`(NumberString)`中。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **默认提供**: `无` + +允许即使在库存中有不死图腾也起作用。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **默认提供**: `无` + +允许玩家忽略连接限制。 + +#### `purpur.mending_shift_click` + +- **默认提供**: `无` + +允许玩家在`蹲下并互动`时修复手持物品。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **默认提供**: `无` + +允许玩家放置刷怪笼。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **默认提供**: `无` + +玩家使用下界传送门时立即传送。 + +#### `purpur.sign.color` + +- **默认提供**: `无` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **默认提供**: `无` + +允许在标志牌上使用混淆代码`(&o)`。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **默认提供**: `无` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **默认提供**: `无` + +允许玩家通过`互动`使用剪刀阻止TNT爆炸。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### 预设权限 + +#### `plazma.bypass.ncr-require` + +- **默认提供**: `无` + +允许玩家即使未安装[`NoChatReports`](https://modrinth.com/mod/no-chat-reports)模组也可以连接。 + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: 操作员。 + +[^2]: 例如：`ender_dragon` diff --git a/zh-CN/origin/plazma/adminstration/README.md b/zh-CN/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..6e3c20559 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: 利用 Plazma 创建自己的服务器。 +--- + +# ⚒️ 服务器管理指南 diff --git a/zh-CN/origin/plazma/adminstration/can-kao/README.md b/zh-CN/origin/plazma/adminstration/can-kao/README.md new file mode 100644 index 000000000..b41d4b74a --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/can-kao/README.md @@ -0,0 +1,2 @@ +# 📜 参考 + diff --git a/zh-CN/origin/plazma/adminstration/can-kao/pei-zhi-wen-jian/README.md b/zh-CN/origin/plazma/adminstration/can-kao/pei-zhi-wen-jian/README.md new file mode 100644 index 000000000..e08ef6f43 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/can-kao/pei-zhi-wen-jian/README.md @@ -0,0 +1,2 @@ +# 🎨 配置文件 + diff --git a/zh-CN/origin/plazma/adminstration/expert/README.md b/zh-CN/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..ae628a1bf --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: 了解如何专业处理Plazma。 +--- + +# 🎓 深入 diff --git a/zh-CN/origin/plazma/adminstration/expert/fix-exploits.md b/zh-CN/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..5c382f3c3 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 了解已知漏洞及解决方法。 +--- + +# ⚠️ 已知漏洞及解决方法 diff --git a/zh-CN/origin/plazma/adminstration/expert/optimize.md b/zh-CN/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..7a869a949 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: 了解如何优化Plazma。 +--- + +# 🧹 优化 diff --git a/zh-CN/origin/plazma/adminstration/expert/vanillaize.md b/zh-CN/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..1760ef2b2 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: 了解如何恢复Paper和Vanilla的修补程序。 +--- + +# ↩️ 进行香草化 + +{% hint style="warning" %} + +### Paper没有为解决Vanilla错误的大部分补丁提供选项。 + +目前，Plazma正在开发使这些错误修复配置无效的功能。 + +因此，本指南仍在编写中，并且信息随时可能更改。 +{% endhint %} diff --git a/zh-CN/origin/plazma/adminstration/faq.md b/zh-CN/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..5292d6181 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: 了解常见问题。 +--- + +# ⁉️ 常见问题 + +{% hint style="info" %} + +### 找不到所需的答案吗？ + +[官方 Discord 服务器](https://discord.gg/MmfC52K8A8)或者[GitHub 问题](https://github.com/PlazmaMC/PlazmaBukkit/issues)向社区提问！ +{% endhint %} + +### 打印消息后无法执行 + +如果控制台显示 `no main manifest attribute, in plazma-(version).jar`， +则下载的文件是开发 API 文件，应从 GitHub 页面下载 **Reobf Paperweight**。 + +请参考以下页面以获取更多信息。 + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### 每次启动服务器时都会显示警告 + +Plazma 包含一些不稳定的补丁，因此可能会出现故障。因此，在服务器启动时始终显示以下警告消息。 + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +使用 [`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1] 系统属性可以禁用此警告消息。 + +请参考以下页面以获取更多信息。 + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 从1.20.1版本开始提供 diff --git a/zh-CN/origin/plazma/adminstration/getting-started/README.md b/zh-CN/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..6172f84f0 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: 了解如何使用Plazma创建服务器。 +--- + +# 👟 开始 + +为了稳定地使用Plazma，系统必须满足以下要求。 + +| | 最低 | 建议 | +| :--: | --: | ---: | +| 架构 | x64 | - | +| RAM | 8GB | 16GB | +| 存储空间 | 1GB | 8GB | +| JRE | 17 | 21 | + +为了顺利修改配置文件，建议安装像[Visual Studio Code](https://code.visualstudio.com/download)这样的编辑器。 + +*** + +## 1. 安装JRE + +正如其名称所示，Minecraft: **"Java"** Edition是使用Java开发的，运行需要JRE[^1]。 + +由于Plazma基于Mojang Studios的官方服务器平台[^2]，因此使用Plazma也需要安装JRE。 + +### 1.1 检查JRE是否已安装 + +要检查系统中是否已安装JRE，请在[运行窗口](#user-content-fn-3)中输入[`cmd /k java --version`](#user-content-fn-4)并运行。 + +如果显示如下内容，请跳过到[第2步](setup.md#id-2)。 + +{% code title="正确输出" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +如果没有显示如上内容，或者显示如下内容，则表示没有安装JRE或者太旧，请执行[1.2步骤](setup.md#id-1.2)。 + +{% code title="JRE未安装" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE太旧" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 安装JRE + +本指南将使用Azul Zulu作为JRE的[一种类型](#user-content-fn-5)。 + +安装完成后，请重新执行[1.1步骤](setup.md#id-1.1)以确保安装正确完成。 + +{% tabs %} +{% tab title="Windows" %} + +1. 首先，在[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu)上下载**JDK 21**的`.msi`安装程序。 +2. 运行下载的安装向导，点击`下一步`。 +3. 在左上角的菜单中激活`Set JAVA_HOME variable`，然后点击`下一步`。 +4. 点击`安装`完成JRE安装。 + {% endtab %} + +{% tab title="macOS" %} +从[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu)下载**JDK 21**的`.dmg`安装程序并运行以安装JRE。 +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +首先，在终端中运行以下命令以向APT添加Azul Zulu存储库。 + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +然后，运行以下命令以安装JRE。 + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +通过输入以下命令来安装JRE。 + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. 下载Plazma + +Plazma提供多种形式的可执行文件。 + +{% hint style="warning" %} + +### 通常情况下，使用`Reobf Paperclip`。 + +以下内容适用于对开发人员或不同形式的特性感兴趣的人。\ +如果是普通用户，则跳过到[第3步](setup.md#id-3)也没有问题。 +{% endhint %} + +
+ +了解更多 + +执行文件的名称为`plazma-(版本管理器)-1.20.4-R0.1-SNAPSHOT-(映射形式).jar`。 + +- **映射形式**\ + 映射是连接Minecraft实际代码和混淆代码的一种地图。 + - **Reobf**\ + 重新混淆，也称为Spigot映射，在大多数NMS插件中使用。\ + 从1.20.5开始将停止使用。 + - **Mojmap**\ + Mojang映射，原始Minecraft映射。 +- **版本管理器**\ + 版本管理器是运行服务器所需的库和修补服务器文件的启动器。 + - **Paperclip**\ + 由PaperMC团队为Paper和其他衍生平台开发的管理器，负责下载库并应用补丁到服务器。 + - **Bundler**\ + 原始Minecraft版本管理器。 + +
+ +*** + +## 3. 创建启动脚本 + +要简单启动Plazma并自动重新启动服务器，需要创建[启动脚本](#user-content-fn-6)。 + +您可以通过[Flags.sh](https://flags.sh)创建启动脚本。\ +只需输入要用于Plazma的[内存](#user-content-fn-8)，命令将自动优化。 + +通过底部的下载按钮下载启动脚本。\ +**请确保下载的启动脚本与您的操作系统相匹配。** + +*** + +## 4. 文件整理 + +现在将下载的启动脚本和Plazma移动到新文件夹中。 + +{% hint style="warning" %} + +### 文件夹名称必须没有空格并且必须用英文设置。 + +否则，Plazma或JRE可能无法正常工作。 +{% endhint %} + +现在运行启动脚本。 对于Windows，请在防火墙允许选择窗口中，务必选择**允许**。 + +*** + +## 5. 同意EULA + +运行启动脚本后，文件夹中将生成`eula.txt`。 + +EULA[^9]是使用[Mojang Studios](#user-content-fn-10)的服务时必须同意的许可协议。 + +如果不同意EULA，则无法启动服务器，并且违反EULA可能受到处罚，例如暂停帐户等[制裁](#user-content-fn-11)。 + +要同意EULA，请将`eula.txt`文件中的`eula=false`修改为`eula=true`并保存。 + +*** + +## 6. 允许外部访问（Windows） + +现代操作系统默认通过**防火墙**和**路由器**阻止外部访问以防止危险访问。 + +对于Windows，由于在[第3步](setup.md#id-3)中已经允许了防火墙，因此只需进行端口转发。 + +{% hint style="info" %} + +### 本指南假定您使用Windows操作系统和[**UPnP**](#user-content-fn-12)可用的路由器。 + +如果路由器不支持UPnP，则由于每个路由器面板不同，您需要自行搜索资料。 + +或者，您可以通过[Ngrok](https://ngrok.com/)生成临时地址。 +{% endhint %} + +{% hint style="warning" %} + +### 像Linux或macOS等（准）UNIX系统操作系统，每个防火墙服务的设置方法都不同，因此您需要自行搜索资料。 + +{% endhint %} + +### 6.1 检查是否需要端口转发 + +输入以下内容并运行。 + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +如果输出为`True`，则可以结束，否则需要设置端口转发。 + +### 6.2 连接服务器 + +{% tabs %} +{% tab title="外部访问" %} +如果不需要端口转发，或者已经成功进行了端口转发，则现在可以连接到服务器。 + +连接服务器时使用的地址可以在[这里](https://ip.pe.kr/)进行确认。 +{% endtab %} + +{% tab title="尝试使用UPnP进行端口转发" %} +在服务器文件夹的`purpur.yml`中，将`network.upnp-port-forwarding`设置为`true`以启用。 + +然后，重新启动服务器后，Plazma将自动尝试进行端口转发。 + +以下是根据控制台输出的消息判断UPnP成功与否，控制台将显示`[UPnP] (消息)`。 + +| 消息 | 含义 | +| ------------- | ------------- | +| `成功打开端口 (端口)` | 端口转发成功。 | +| `端口 (端口)已打开` | 另一个服务正在使用该端口。 | +| `无法打开端口 (端口)` | 端口转发失败。 | +| `服务不可用` | 路由器不支持UPnP。 | + +服务器关闭后，Plazma会自动关闭端口。 +{% endtab %} + +{% tab title="使用Ngrok创建临时地址" %} +使用Ngrok的方法对于短期测试、参与或与朋友一起玩非常有用。 + +1. 从[Ngrok官网](https://ngrok.com/download)下载`Windows (64-bit)` ZIP文件。 +2. 将下载的Ngrok放入服务器文件夹中。 +3. 在[Ngrok仪表板](https://dashboard.ngrok.com/get-started/your-authtoken)上生成[授权令牌](#user-content-fn-13)[^13]。 +4. 在服务器文件夹中运行显示在下方`Command Line`中的命令。 +5. 在执行脚本的顶部添加`start /b ngrok tcp --region jp 25565`，在底部添加`taskkill /f /t /im ngrok.exe`。 +6. 在控制台顶部显示的`Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565`中，`0.tcp.jp.ngrok.io:12345`将成为服务器地址。 +7. 现在可以通过该地址从外部访问。 + {% endtab %} + +{% tab title="本地连接" %} +如果要从本地连接到服务器，请在运行窗口中运行`cmd /k ipconfig`并使用显示的`IPv4地址`进行连接。 + +例如，运行命令后，输出如下： + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +尝试使用显示的`192.168.3.7`进行本地连接到服务器。 + +如果服务器和游戏在同一台PC上运行，则可以使用`localhost`进行连接。 +{% endtab %} +{% endtabs %} + +## 7。 发展阶段 + +如果服务器成功启动并正常运行，则现在是个性化服务器的时候了。 + +通过以下指南了解如何个性化服务器。 + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java运行环境，Java执行环境。 + +[^2]: Plazma基于Paper，而Paper基于Spigot，Spigot基于官方服务器平台。 + +[^3]: Windows键 + R + +[^4]: 对于Linux，请在终端中运行`java --version`。 + +[^5]: JRE是一个开源项目，类似于Minecraft服务器平台，有多种类型。 + +[^6]: 通常被称为**运行器**。 + +[^7]: 启用"自动重启"将导致服务器自动重新启动。 可以使用`Control + C`来结束。 + +[^8]: 不建议超过系统的一半。 + + 例如，如果系统总内存容量为8GB，则不建议将其设置为4GB以上。 + +[^9]: 最终用户许可协议，EULA。 有关详细信息，请查看[Minecraft网站](https://www.minecraft.net/ko-kr/usage-guidelines)。 + +[^10]: 微软公司。 + +[^11]: 根据韩国游戏产业促进法第32条第1款第9号，**韩国微软有限公司**可以根据法律提起诉讼。 + +[^12]: 通用即插即用。 Plazma中包含的Purpur通过此技术自动与路由器通信，在服务器运行时仅打开端口，因此无需直接进行端口转发。 + +[^13]: 如果没有帐户，请通过Google或GitHub帐户注册Ngrok。 diff --git a/zh-CN/origin/plazma/adminstration/getting-started/customization.md b/zh-CN/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..d14036f5b --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: 了解如何定制服务器。 +--- + +# 🎨 用户定制 diff --git a/zh-CN/origin/plazma/adminstration/reference/arguments.md b/zh-CN/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..61a680622 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,527 @@ +--- +description: 了解启动参数和系统属性。 +--- + +# 🎛️ 参数和属性 + +启动变量和系统属性是附加到[用于执行Plazma的命令](#user-content-fn-1)[^1]的值，\ +允许更改Plazma在执行后无法更改的值。 + +根据[添加到命令的位置](#user-content-fn-2)[^2]，分为 **启动参数** 和 **系统属性**。 + +*** + +## 系统属性 + +系统属性是在 `-jar` 前输入的值，在Plazma初始化之前由JVM处理。 + +{% hint style="warning" %} + +### 修改系统属性可能会改变Plazma和JVM的运行方式，并可能对游戏产生重大影响！ + +如果不确定每个系统属性的作用，请**绝对不要使用！** +{% endhint %} + +### 用法 + +系统属性作为Java命令参数输入，位于`java`和`-jar`之间。 + +例如，要应用`Plazma.dummyProperty`系统属性，\ +输入如下内容将值`37`添加到下一个属性，然后Plazma将初始化。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`表示该参数不是JVM内置的，而是附加到Plazma的专用参数， + +如果没有输入任何值，则该值将被固定为[`true`。](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight系列服务器平台为区分每个平台的系统属性，在属性名称中包含`.`。 + +在Windows Powershell等某些终端中，可能不允许使用这些参数，因此在参数两端添加`"`。[添加必要。](#user-content-fn-4)[^4] +{% endhint %} + +### 全部系统属性 + +#### `convertLegacySigns` + +- **类型**: `布尔值` +- **默认值**: `False` + +更新停用的标志格式。 + +#### `debug.entities` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用与实体信息相关的调试日志。 + +#### `debug.rewriteForIDE` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用NMS修订以便IDE正确加载调试信息，\ +并自动重新映射内部版本信息。 + +#### `disable.watchdog` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Spigot的看门狗警告系统。 + +#### `letMeReload` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用`/reload`命令的重新加载消息。 + +{% hint style="danger" %} + +### 由于`/reload`命令非常不稳定，使用后导致的所有服务器问题由用户自行承担。 + +如果您是插件开发者并需要更新插件，请使用热交换而不是`/reload`。 +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用使用标准输入/输出的插件。 + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **类型**: `布尔值` +- **默认值**: `False` + +检测到聊天组件中使用的停用格式时发出警告。 + +#### `Paper.bypassHostCheck` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用玩家连接到服务器时的主机匹配验证。 + +#### `Paper.debugDynamicMissingKeys` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对NBT对象中缺失键的调试日志。 + +#### `Paper.debugInvalidSkullProfiles` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对具有无效配置文件信息的头骨块的调试日志。 + +记录世界中所有无效头骨块的位置。 + +#### `Paper.disableChannelLimit` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用每个玩家的128个插件频道[^5]的限制。 + +#### `Paper.disableClassPrioritization` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用插件类优先级系统。 + +在插件阴影中出现问题时很有用。 + +#### `Paper.disableFlushConsolidate` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Netty刷新合并系统。 + +#### `Paper.excessiveTELimit` + +- **类型**: `整数` +- **默认值**: `750` + +如果实体数量超过设置值，则分割为多个数据包进行传输。 + +#### `Paper.filterThreshold` + +- **类型**: `整数` +- **默认值**: `8192` + +设置服务器一次接收的最大数据包大小。 + +#### `Paper.ignoreJavaVersion` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Java版本检查。 + +{% hint style="danger" %} + +### 这可能导致JVM尝试访问不存在的代码！ + +可能会永久损坏世界和其他文件，并使游戏机制崩溃。 + +由此导致的所有问题由用户自行承担，Plamza不提供任何支持。 +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **类型**: `整数` +- **默认值**: `64` + +设置插件频道[^6]名称的限制。 + +#### `Paper.maxSignLength` + +- **类型**: `整数` +- **默认值**: `80` + +设置标志一行可输入的最大字符数。 + +#### `Paper.minPrecachedDatafixVersion` + +- **类型**: `整数` +- **默认值**: `(world version) + 1` + +设置要首先初始化的世界更新信息的版本。 + +对于需要大量更新块的情况很有用，但在其他情况下不使用。 + +#### `Paper.parseYamlCommentsByDefault` + +- **类型**: `布尔值` +- **默认值**: `True` + +启用默认情况下解析YAML文件的注释。 + +#### `Paper.playerConnection.keepAlive` + +- **类型**: `整数` +- **默认值**: `30` + +当玩家在指定时间内（以秒为单位）未收到任何数据时，将踢出玩家。 + +通常，游戏[^7]会继续向服务器发送[心跳信号](#user-content-fn-8)[^8]，\ +如果没有响应，游戏将认为发生了冲突，并在不再处理玩家的情况下将其踢出。 + +#### `Paper.skipServerPropertiesComments` + +- **类型**: `布尔值` +- **默认值**: `False` + +忽略服务器属性的注释。 + +#### `Paper.debug-sync-loads` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用同步块写入的调试日志。 + +#### `Paper.enable-sync-chunk-writes` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用Minecraft的[默认块写入系统](#user-content-fn-10)[^10]。 + +这会按顺序保存每个块，导致严重性能下降。 + +#### `Paper.explicit-flush` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用网络通道的显式刷新。 + +#### `Paper.strict-thread-checks` + +- **类型**: `布尔值` +- **默认值**: `False` + +始终记录不是在主线程上发生的错误。 + +#### `Paper.tickList-warn-on-excessive-delay` + +- **类型**: `布尔值` +- **默认值**: `False` + +如果预定任务具有过多的延迟，将输出警告。 + +#### `Paperclip.patchOnly` + +- **类型**: `布尔值` +- **默认值**: `False` + +如果使用默认提供的执行文件，则仅应用补丁而不启动服务器。 + +#### `Plazma.aggressiveOptimize` + +- **类型**: `布尔值` +- **默认值**: `false` + +{% hint style="warning" %} + +### 此属性将在1.20.5之后移至启动参数中。 + +{% endhint %} + +更严格地应用于初始配置优化。 + +激活后，服务器会变得更快、更安全，但可能会阻止某些游戏机制或对游戏玩法产生重大影响。 + +#### `Plazma.iKnowWhatIAmDoing` + +- **类型**: `布尔值` +- **默认值**: `false` + +抑制Plazma初始化时显示的警告[^11]。 + +### 已停用的属性 + +以下系统属性已停用。 + +#### `timings.bypassMax` + +- **类型**: `布尔值` +- **默认值**: `false` +- **已停用**：自Plazma中删除Timings以来 + +决定是否可以超过Aikar的Timings API可发送的最大值。 + +即使如此，如果API未处理异常，则会应用速率限制。 + +*** + +## 起始参数 + +起始参数是在`-jar *.jar`之后输入的，用于初始化Plazma并一起处理的值。 + +### 用法 + +系统属性作为`-jar *.jar`后的程序命令参数输入。 + +例如，如果要应用`nogui`起始参数，\ +请按以下方式输入，Plazma在初始化过程中将处理`nogui`参数。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 完整的起始参数 + +#### `bukkit-settings` + +- **别名**：`b` +- **默认值**：`bukkit.yml` + +设置[Bukkit配置文件](../reference/configurations/bukkit.md)的名称和位置。 + +#### `command-settings` + +- **别名**：`c` +- **默认值**：`commands.yml` + +设置[Bukkit命令配置文件](../reference/configurations/bukkit.md)的名称和位置。 + +#### `config` + +- **别名**：`c` +- **默认值**：`server.properties` + +设置[服务器属性](../reference/configurations/property.md)文件的名称和位置。 + +#### `demo` + +启动服务器到演示世界。 + +#### `eraseCache` + +删除升级后剩余的缓存文件。 + +#### `forceUpgrade` + +忽略版本并强制[升级](#user-content-fn-12)[^12]世界。 + +#### `help` + +- **别名**：`?` + +显示Plazma的完整启动参数和说明。 + +#### `initSettings` + +仅创建配置文件并关闭服务器。 + +#### `jfrProfile` + +启用JFR分析。 + +#### `max-players` + +- **别名**：`s`，`size` +- **默认值**：`(服务器属性)` + +设置允许的最大[玩家](#user-content-fn-14)[^14]数量。 + +#### `nogui` + +禁用图形界面面板。 + +#### `nojline` + +禁用JLine并使用原始控制台。 + +#### `online-mode` + +- **别名**：`o` +- **默认值**：`(服务器属性)` + +选择是否要验证玩家到Mojang验证服务器。 + +**如果不使用Velocity等代理，可能会因违反[EULA](../getting-started/README.md#id-5)而受到制裁。** + +#### `paper-settings` + +- **别名**：`paper` +- **默认值**：`paper.yml` + +{% hint style="warning" %} + +### 此参数在1.19.4之后停用 + +{% endhint %} + +设置已停用的PaperSpigot配置文件位置。 + +此用于将现有配置迁移到新配置文件，之后不再使用。 + +#### `paper-settings-directory` + +- **别名**：`paper-dir` +- **默认值**：`config` + +设置包含[Paper配置文件](../reference/configurations/paper/README.md)的文件夹名称和位置。 + +#### `plazma-settings-directory` + +- **别名**：`plazma-dir` + +设置包含[Plazma配置文件](../reference/configurations/plazma/README.md)的文件夹名称和位置。 + +#### `plugins` + +- **别名**：`p` +- **默认值**：`plugins` + +设置插件文件夹的位置。 + +#### `pufferfish-settings` + +- **别名**：`pufferfish` +- **默认值**：`pufferfish.yml` + +设置[Pufferfish配置文件](../reference/configurations/pufferfish.md)的名称和位置。 + +#### `purpur-settings` + +- **别名**：`purpur` +- **默认值**：`purpur.yml` + +设置[Purpur配置文件](../reference/configurations/purpur/README.md)的名称和位置。 + +#### `safeMode` + +以安全模式启动服务器，完全原始状态。 + +#### `server-ip` + +- **别名**：`h`，`host` +- **默认值**：`(服务器属性)` + +设置服务器的主机名或[Internet Protocol](#user-content-fn-13)[^13]地址。 + +#### `server-port` + +- **别名**：`p`，`port` +- **默认值**：`(服务器属性)` + +设置服务器的端口。 + +#### `server-name` + +- **默认值**：`A Plazma Server` + +设置服务器的名称。 + +#### `spigot-settings` + +- **别名**：`S` +- **默认值**：`spigot.yml` + +设置[Spigot配置文件](../reference/configurations/spigot.md)的名称和位置。 + +#### `version` + +- **别名**：`v` + +输出Plazma版本。 + +#### `world-dir` + +- **别名**：`W`，`universe`，`world-container` +- **默认值**：`(服务器文件夹)` + +设置存储世界文件的位置。 + +#### `world-name` + +- **别名**：`w`，`world` +- **默认值**：`(服务器属性)` + +设置世界文件的名称。 + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 根据追加的位置处理参数的位置会发生变化。 + +[^3]: 例如，如果要将 `Plazma.iKnowWhatIAmDoing` 设置为 `true`（启用），只需输入 `-DPlazma.iKnowWhatIAmDoing`，而不是 `-DPlazma.iKnowWhatIAmDoing=true`，它将同样有效。 + +[^4]: 例如，`"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 事件检测器。 + +[^6]: 事件检测器。 + +[^7]: 客户端。 + +[^8]: 像心跳一样向服务器发送连接正常的信号。 + +[^9]: 使用Purpur的AFK踢出功能，即使玩家离开也可以将其踢出。 + +[^10]: 同步区块写入系统，Sync Chunk Write System。 + +[^11]: \`警告！ Plazma可能会导致意外问题，因此请确保在将其用于公共服务器之前进行彻底测试。 + +[^12]: 在游戏中，“世界优化”也是按照这个原则运作的。 + +[^13]: Internet协议，IP。 + +[^14]: 除了`级别 2`以上的管理员。 diff --git a/zh-CN/origin/plazma/adminstration/reference/commands.md b/zh-CN/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..17ec97feb --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: 了解在Plazma中可用的命令。 +--- + +# 🖥️ 命令 diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/bukkit.md b/zh-CN/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..04658aa9d --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: 了解bukkit.yml中每个节点的含义。 +--- + +# 🪣 Bukkit diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/paper/README.md b/zh-CN/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..b746d7ff1 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: 了解config文件夹中每个文件的用途。 +--- + +# 🛩️ 纸 diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/paper/global.md b/zh-CN/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..9f498a302 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: 了解paper-global.yml的每个节点代表什么。 +--- + +# 🛩️ 纸（全球配置） diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/paper/world.md b/zh-CN/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..d303634ea --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: 了解每个节点在paper-world.yml中代表什么。 +--- + +# 🛩️ Paper (按世界划分) diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/README.md b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..abcb18ceb --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: 了解config文件夹中每个文件的用途。 +--- + +# ✨ 皮拉兹玛 diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/global.md b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..1ee121e1f --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: 了解plazma-global.yml中每个节点的含义。 +--- + +# ✨ Plazma（全球配置） diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..f18434af0 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ 世界各地的组成 diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..705fb6d43 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: 了解每个节点在plazma-world.yml中代表什么。 +--- + +# ✨ Plazma (按世界划分) diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/property.md b/zh-CN/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..a699be47b --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: 了解server.properties中每个节点代表的含义。 +--- + +# 🪨 Server.properties diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/pufferfish.md b/zh-CN/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..1cf5fad6e --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: 了解pufferfish.yml中每个节点代表什么。 +--- + +# 🐡 河豚 diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/README.md b/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..10ecad64e --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: 查看purpur.yml中每个节点代表什么。 +--- + +# 🦑 Purpur diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/global.md b/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..644eb6915 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: 查看purpur.yml中每个节点代表什么。 +--- + +# 🦑 Purpur (全球结构) diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/world.md b/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..9c0ae30c2 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: 查看purpur.yml中每个节点代表什么。 +--- + +# 🦑 Purpur (世界构成) diff --git a/zh-CN/origin/plazma/adminstration/reference/configurations/spigot.md b/zh-CN/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..52a9118ec --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: 了解每个spigot.yml节点代表什么。 +--- + +# 🚰 Spigot diff --git a/zh-CN/origin/plazma/adminstration/reference/permissions.md b/zh-CN/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..358104f05 --- /dev/null +++ b/zh-CN/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: 了解Plazma的权限。 +--- + +# 🛡️ 权限 diff --git a/zh-CN/origin/plazma/developers.md b/zh-CN/origin/plazma/developers.md new file mode 100644 index 000000000..2c0783fd4 --- /dev/null +++ b/zh-CN/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: 利用 Plazma 开发第三方项目。 +--- + +# ⚙️ 开发者指南 diff --git a/zh-CN/origin/thunderbolt/README.md b/zh-CN/origin/thunderbolt/README.md new file mode 100644 index 000000000..eb14048f2 --- /dev/null +++ b/zh-CN/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt是基于Plazma的服务器平台，将实验性补丁分为Flavor，以便用户可以直接使用。 +--- + +# 🌩️ Thunderbolt使用指南 diff --git a/zh-CN/origin/volt/README.md b/zh-CN/origin/volt/README.md new file mode 100644 index 000000000..f6b939a40 --- /dev/null +++ b/zh-CN/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt是基于Plazma开发自己的Paperweight服务器平台的开源模板。 +--- + +# ⚡ Volt开发指南 diff --git a/zh-TW/origin/README.md b/zh-TW/origin/README.md new file mode 100644 index 000000000..c6d7dbcd8 --- /dev/null +++ b/zh-TW/origin/README.md @@ -0,0 +1,41 @@ +--- +description: 如有問題，請通過Discord或GitHub討論發問。 +--- + +# 🏠 歡迎來到文檔門戶 + +{% hint style="info" %} + +**Plazma的文件目前是机器翻译状态。** + +[![翻譯狀態](https://badge.plazmamc.org/internal/crowdin)](https://translate.plazmamc.org/) + +在 [https://translate.plazmamc.org/](https://translate.plazmamc.org/) 參與文件翻譯，助您改善文件。 + +{% endhint %} + +### 如果在使用Plazma時遇到問題呢？ + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +### 對Thunderbolt感興趣嗎？ + +{% content-ref url="thunderbolt/" %} +[thunderbolt](thunderbolt/) +{% endcontent-ref %} + +### Volt로 자신만의 서버 플랫폼을 만들고 싶다면? + +{% content-ref url="volt/" %} +[volt](volt/) +{% endcontent-ref %} + +*** + +#### `SPONSOR` 더 많은 Minecraft 관련 정보가 필요하다면? + +{% embed url="https://discord.gg/AZwXTA9Pgx" fullWidth="false" %} + +*** diff --git a/zh-TW/origin/SUMMARY.md b/zh-TW/origin/SUMMARY.md new file mode 100644 index 000000000..373ed4c6a --- /dev/null +++ b/zh-TW/origin/SUMMARY.md @@ -0,0 +1,59 @@ +# 目錄 + +- [🏠 歡迎來到文件門戶](README.md) + - [⚛️ GitHub](https://github.com/PlazmaMC/PlazmaBukkit) + - [💬 Discord](https://discord.gg/MmfC52K8A8) + - [📊 bStats](https://bstats.org/plugin/server-implementation/Plazma) + +## Plazma + +- [✨ Plazma 使用說明文件](plazma/README.md) +- [❓ Plazma是什麼？](plazma/about/README.md) + - [⬇️ 下載](plazma/about/downloads.md) + - [✅ 版本支援狀態](plazma/about/supported-versions.md) +- [⚒️ 伺服器管理指南](plazma/administration/README.md) + - [👟 開始使用](plazma/administration/getting-started/README.md) + - [🎨 발전하기](plazma/administration/getting-started/next-step.md) + - [📜 參考資料](plazma/administration/reference/README.md) + - [🖥️ 命令](plazma/administration/reference/commands.md) + - [🛡️ 權限](plazma/administration/reference/permissions.md) + - [🎛️ 參數和屬性](plazma/administration/reference/arguments.md) + - [🧾 구성](plazma/administration/reference/configurations/README.md) + - [🪨 屬性](plazma/administration/reference/configurations/property.md) + - [🪣 Bukkit](plazma/administration/reference/configurations/bukkit.md) + - [🚰 Spigot](plazma/administration/reference/configurations/spigot.md) + - [🛩️ Paper](plazma/administration/reference/configurations/paper/README.md) + - [🌏 全域組態](plazma/administration/reference/configurations/paper/global.md) + - [🏳️ 世界級配置](plazma/administration/reference/configurations/paper/world.md) + - [🐡 Pufferfish](plazma/administration/reference/configurations/pufferfish.md) + - [🦑 Purpur](plazma/administration/reference/configurations/purpur/README.md) + - [🌏 全域組態](plazma/administration/reference/configurations/purpur/global.md) + - [🏳️ 世界級配置](plazma/administration/reference/configurations/purpur/world.md) + - [✨ Plazma](plazma/administration/reference/configurations/plazma/README.md) + - [🌏 全域組態](plazma/administration/reference/configurations/plazma/global.md) + - [🏳️ 世界級配置](plazma/administration/reference/configurations/plazma/world.md) + - [🎓 深入](plazma/administration/expert/README.md) + - [🧹 優化](plazma/administration/expert/optimize.md) + - [🔀 代理](plazma/administration/expert/proxy.md) + - [↩️ 變成基本](plazma/administration/expert/vanillaize.md) + - [🩻 X-Ray 阻擋](plazma/administration/expert/xray.md) + - [⚠️ 漏洞和解決方法](plazma/administration/expert/fix-exploits.md) + - [⁉️ 常見問題](plazma/administration/faq.md) + - [🧾 진단](plazma/administration/diagnosis/README.md) + - [📜 플러그인](plazma/administration/diagnosis/plugins.md) +- [⚙️ 開發者指南](plazma/developers.md) + - [✏️ 貢獻](https://github.com/PlazmaMC/PlazmaBukkit/blob/main/CONTRIBUTION.md) + - [☕ Javadocs](https://jd.plazmamc.org/) + +## Thunderbolt + +- [🌩️ 雷電使用指南](thunderbolt/README.md) + +## Volt + +- [⚡ Volt開發指南](volt/README.md) + +## Miscellaneous + +- [⏬ Miscellaneous](miscellaneous/README.md) + - [⬇️ 下載完整檢視](plazma/about/downloads-all.md) diff --git a/zh-TW/origin/miscellaneous/README.md b/zh-TW/origin/miscellaneous/README.md new file mode 100644 index 000000000..07afde00d --- /dev/null +++ b/zh-TW/origin/miscellaneous/README.md @@ -0,0 +1,5 @@ +--- +hidden: true +--- + +# ⏬ Miscellaneous diff --git a/zh-TW/origin/plazma/README.md b/zh-TW/origin/plazma/README.md new file mode 100644 index 000000000..34d22b4cb --- /dev/null +++ b/zh-TW/origin/plazma/README.md @@ -0,0 +1,43 @@ +--- +description: "Plazma是為Minecraft: Java Edition添加了基於紙張的實驗性優化和多種遊戲機制定制功能的開源服務器平台。" +--- + +# ✨ Plazma 使用文檔 + +## 👋 歡迎來到 Plazma 文檔 + +歡迎訪問 Plazma 使用文檔！ + +{% hint style="info" %} + +**無法透過說明書解決問題嗎？** + +[官方 Discord 伺服器](https://discord.gg/MmfC52K8A8) 或者透過 [GitHub 討論區](https://github.com/PlazmaMC/PlazmaBukkit/discussions) 向社群提問！ + +{% endhint %} + +### 關於 Plazma + +> 了解 Plazma 是什麼服務器平台。 + +{% content-ref url="about/" %} +[about](about/) +{% endcontent-ref %} + +### 對於管理員 + +> 利用 Plazma 創建自己的服務器。 + +{% content-ref url="administration/" %} +[管理](administration/) +{% endcontent-ref %} + +### 對於開發人員 + +> 利用 Plazma 開發第三方項目。 + +{% content-ref url="developers.md" %} +[developers.md](developers.md) +{% endcontent-ref %} + +*** diff --git a/zh-TW/origin/plazma/about/README.md b/zh-TW/origin/plazma/about/README.md new file mode 100644 index 000000000..9c555f8c0 --- /dev/null +++ b/zh-TW/origin/plazma/about/README.md @@ -0,0 +1,74 @@ +--- +description: 了解 Plazma 是什麼服務器平台。 +--- + +# ❓ 什麼是Plazma? + +- **Plazma**是基於[Andromeda](https://github.com/EarendelArchived/Andromeda)和[Fusion](https://github.com/RuinedTechnologyUnify/Fusion)的優點，以[Paper](https://github.com/PaperMC/Paper)為基礎的服務器平台。 +- 我們致力於提供高度穩定性和強大性能、快速更新和豐富功能。 + +## 📋 Plazma的目標 + +- 我們致力於成為一個擁有快速更新和高度穩定性的服務器平台。 +- 我們致力於提供與模組平台不相上下的豐富功能和強大性能。 +- 我們致力於創建一個可以自由定制甚至自訂Vanilla補丁的平台。 + +## ⚙️ 主要特點 + +1. **강력한 플러그인 생태계**\ + [Paper](https://github.com/PaperMC/Paper)를 기반으로 하고 있어, 인터넷에서 다운로드 가능한 대부분의 [최신 플러그인](#user-content-fn-1)[^1]이 정상 작동합니다. +2. **설정이 필요 없는 최적화**\ + [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)의 모든 패치가 포함되어 있으며, 일부 자체 최적화와 모드가 내장되어 있어 최고의 성능을 제공합니다. +3. **원하는 대로 사용자화하는 게임**\ + Plazma에 포함된 [Purpur](https://github.com/PurpurMC/Purpur)는 게임의 전반적인 속성을 수정할 수 있게 해줍니다. +4. **안전하게 플레이하는 서버**\ + [No Chat Reports](https://github.com/Aizistral-Studios/No-Chat-Reports)가 포함되어 있어 1.19부터 추가된 Mojang[^2]의 [채팅 신고 시스템](#user-content-fn-3)[^3]을 비활성화 할 수 있으며,\ + 진단 정보 수집기가 완전 제거되어 추적 없는 안전한 서버를 플레이 할 수 있습니다. +5. **最快的更新**\ + [AlwaysUpToDate](https://github.com/PlazmaMC/AlwaysUpToDate)確保Plazma的補丁始終保持最新，提供Paper基礎伺服器平台中最快的更新。 +6. **優化的預設配置文件**\ + 預設應用的配置文件已優化，無需自行優化配置文件。 +7. **多線程運作**\ + 通過異步化與遊戲機制無關的系統機制，減少[延遲時間](#user-content-fn-4)[^4]以優化伺服器。 +8. **阻止不必要空間使用**\ + 將具有相似值的數據合併為一個以減少內存使用。 + +## ✨ 應用案例 + +- **能夠正確處理複雜插件的平台**\ + 由開發者[IPECTER](https://github.com/IPECTER)的伺服器使用Plazma。\ + 自身插件使用NMS和反射運作，應用了複雜和龐大的數據包，\ + 即使有超過100名玩家，也能在沒有性能下降的情況下接受。 +- **在RPG伺服器上保持快速性能的平台**\ + 在單個集群中，100名玩家能夠穩定地保持TPS無下降，\ + 在4個集群中，共有250名玩家可以愉快遊玩。 +- **청크/엔티티에서 빛을 보이는 플랫폼**\ + 기존에 청크와 엔티티를 처리하는 데 지연이 발생하던 서바이벌 서버의 플랫폼을 Purpur에서 Plazma로 변경하며 대부분의 지연을 줄일 수 있었습니다. +- **許多串流媒體選擇的平台**\ + 許多串流媒體的觀眾參與桶被選擇並使用。 + +[![실시간 Plazma 사용자 추이](https://badge.plazmamc.org/internal/bstats)](https://bstats.org/plugin/server-implementation/Plazma/18047) + +## ⬇️ 下載 + +您可以在以下頁面下載Plazma。 + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +#### 想了解支援的版本詳情? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +[^1]: Bukkit, CraftBukkit, Spigot插件以及Paper, Pufferfish, Purpur插件。 + +[^2]: 由Microsoft Corporation提供。 + +[^3]: 停用聊天舉報系統後，聊天將完全在伺服器上處理，防止Mojang的聊天追踪。 + +[^4]: 系統機制需要暫停遊戲以運作。 diff --git a/zh-TW/origin/plazma/about/downloads-all.md b/zh-TW/origin/plazma/about/downloads-all.md new file mode 100644 index 000000000..fd83e2d80 --- /dev/null +++ b/zh-TW/origin/plazma/about/downloads-all.md @@ -0,0 +1,39 @@ +--- +description: Plazma執行檔下載完整檢視 +--- + +# ⬇️ 다운로드 전체보기 + +{% hint style="info" %} +**해당 페이지는 전문가용 입니다.** + +일반 사용자이고, 각 타입이 어떠한 역할을 가지는지 잘 알지 못하는 경우, 아래 페이지에서 다운로드 하세요. +{% endhint %} + +{% content-ref url="downloads.md" %} +[downloads.md](downloads.md) +{% endcontent-ref %} + +![릴리스 대기중](https://badge.plazmamc.org/0/릴리스%20대기중) ![개발중](https://badge.plazmamc.org/1/개발중) ![지원중](https://badge.plazmamc.org/2/지원중) ![기능 지원 중단](https://badge.plazmamc.org/6/기능%20지원%20중단) ![지원 종료](https://badge.plazmamc.org/4/지원%20종료) + +| 版本 | MP[^1] | RP[^2] | MB[^3] | RB[^4] | +| :-------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://git.plazmamc.org/1.21.3) | 개발중 | 개발중 | 개발중 | 개발중 | +| [![1.21.4](https://badge.plazmamc.org/1/1.21.4)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-paperclip-1.21.4-R0.1-SNAPSHOT-reobf.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-mojmap.jar) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/lastSuccessfulBuild/artifact/build/libs/plazma-bundler-1.21.4-R0.1-SNAPSHOT-reobf.jar) | +| [![1.21.3](https://badge.plazmamc.org/2/1.21.3)](https://git.plazmamc.org/1.21.3) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.3/3) | +| [![1.21.1](https://badge.plazmamc.org/4/1.21.1)](https://git.plazmamc.org/1.21.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.21.1/3) | +| [![1.20.6](https://badge.plazmamc.org/6/1.20.6)](https://git.plazmamc.org/1.20.6) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.6/3) | +| [![1.20.4](https://badge.plazmamc.org/4/1.20.4)](https://git.plazmamc.org/1.20.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.4/3) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.2/3) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.20.1/3) | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/0) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/1) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/2) | [![다운로드](https://badge.plazmamc.org/1/다운로드)](https://dl.plazmamc.org/1.19.4/3) | + +*** + +[^1]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^2]: Reobf Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^3]: Mojmap Paperclip. [자세히 알아보기](../administration/getting-started/#id-2) + +[^4]: Reobf Bundler. [자세히 알아보기](../administration/getting-started/#id-2) diff --git a/zh-TW/origin/plazma/about/downloads.md b/zh-TW/origin/plazma/about/downloads.md new file mode 100644 index 000000000..d0c12e9ba --- /dev/null +++ b/zh-TW/origin/plazma/about/downloads.md @@ -0,0 +1,94 @@ +--- +description: 立即下載 Plazma 並立即使用。 +--- + +# ⬇️ 下載 + +#### 想了解支援的版本詳情? + +{% content-ref url="supported-versions.md" %} +[supported-versions.md](supported-versions.md) +{% endcontent-ref %} + +*** + +{% hint style="info" %} + +**以下下載是一般使用者的執行檔。** + +如果您是開發人員，需要其他形式的檔案，請參考以下頁面。 + +{% endhint %} + +{% content-ref url="downloads-all.md" %} +[downloads-all.md](downloads-all.md) +{% endcontent-ref %} + +*** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
版本下載
1.21.4 (하드포크) + 개발중 +
1.21.4 + 다운로드 +
1.21.3 + 다운로드 +
1.21.1 + 다운로드 +
1.20.6 + 다운로드 +
1.20.4 + 다운로드 +
1.20.2 + 下載 +
1.20.1 + 下載 +
1.19.4 + 下載 +
+ +*** diff --git a/zh-TW/origin/plazma/about/patches-list.md b/zh-TW/origin/plazma/about/patches-list.md new file mode 100644 index 000000000..56c31d5ee --- /dev/null +++ b/zh-TW/origin/plazma/about/patches-list.md @@ -0,0 +1,5 @@ +--- +description: 了解所有添加到Plazma的功能。 +--- + +# 📑 包括的補丁 diff --git a/zh-TW/origin/plazma/about/supported-versions.md b/zh-TW/origin/plazma/about/supported-versions.md new file mode 100644 index 000000000..d8be92ea7 --- /dev/null +++ b/zh-TW/origin/plazma/about/supported-versions.md @@ -0,0 +1,39 @@ +--- +description: "在 Plazma 中查看支持的 Minecraft: Java Edition 版本。" +--- + +# ✅ 版本支持状态 + +{% hint style="info" %} + +**Plazma 從 1.19.4 開始開發，1.19.4 以下的版本已不再開發。** + +1.19.4 미만의 플랫폼을 찾고 있다면, [Prismarine (`1.18.1 ~ 1.19.2`)](https://github.com/PrismarineTeam/Prismarine) 또는 [Fusion (`1.19.2 ~ 1.19.3`)](https://github.com/RuinedTechnologyUnify/Fusion)을 사용해 주시기 바랍니다. + +{% endhint %} + +[wtr]: https://badge.plazmamc.org/0/릴리스%20대기중 +[idv]: https://badge.plazmamc.org/1/開發中 +[atv]: https://badge.plazmamc.org/2/支援中 +[fse]: https://badge.plazmamc.org/6/功能支援中斷 +[eol]: https://badge.plazmamc.org/4/支援結束 +[ukn]: https://badge.plazmamc.org/0/無信息 +[vgd]: https://badge.plazmamc.org/2/매우%20좋음 +[mid]: https://badge.plazmamc.org/6/一般 +[100]: https://badge.plazmamc.org/percent/100 + +![릴리스 대기중][wtr] ![開發中][idv] ![支援中][atv] ![功能支援中斷][fse] ![支援結束][eol] + +| 版本 | 穩定性 及 功能支援 | 建置狀態 | +| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [![1.21.4 (하드포크)](https://badge.plazmamc.org/0/1.21.4%20\(하드포크\))](https://github.com/PlazmaMC/PlazmaBukkit/tree/feat/1.21.4/hard-fork) | ![개발중][idv] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FFeature%20Previews%2Fjob%2Ffeat%25252F1.21.4%25252Fhard-fork%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.4](https://badge.plazmamc.org/0/1.21.4)](https://git.plazmamc.org/1.21.4) | ![개발중][idv]![100%][100] | [![빌드 상태](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FPlazmaMC%2Fjob%2FPlazma%2Fjob%2Fdev%25252F1.21.4%2F\&style=for-the-badge)](https://ci.codemc.io/job/PlazmaMC/job/Plazma/job/dev%252F1.21.4/) | +| [![1.21.3](https://badge.plazmamc.org/1/1.21.3)](https://git.plazmamc.org/1.21.3) | ![지원중][atv]![100%][100] | [![빌드 상태](https://build.plazmamc.org/1.21.3)](https://build.plazmamc.org/1.21.3?redirect=true) | +| [![1.21.1](https://badge.plazmamc.org/6/1.21.1)](https://git.plazmamc.org/1.21.1) | ![지원 종료][eol]![60%](https://badge.plazmamc.org/percent/60) | [![빌드 상태](https://build.plazmamc.org/1.21.1)](https://build.plazmamc.org/1.21.1?redirect=true) | +| [![1.20.6](https://badge.plazmamc.org/2/1.20.6)](https://git.plazmamc.org/1.20.6) | ![기능 지원 종료][fse]![100%][100] | [![建置狀態](https://build.plazmamc.org/1.20.6)](https://build.plazmamc.org/1.20.6?redirect=true) | +| [![1.20.4](https://badge.plazmamc.org/6/1.20.4)](https://git.plazmamc.org/1.20.4) | ![지원 종료][eol]![100%][100] | [![建置狀態](https://build.plazmamc.org/1.20.4)](https://build.plazmamc.org/1.20.4?redirect=true) | +| [![1.20.2](https://badge.plazmamc.org/4/1.20.2)](https://git.plazmamc.org/1.20.2) | ![지원 종료][eol]![100%][100] | [![建置狀態](https://build.plazmamc.org/1.20.2)](https://build.plazmamc.org/1.20.2?redirect=true) | +| [![1.20.1](https://badge.plazmamc.org/4/1.20.1)](https://git.plazmamc.org/1.20.1) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | +| [![1.19.4](https://badge.plazmamc.org/4/1.19.4)](https://git.plazmamc.org/1.19.4) | ![지원 종료][eol]![100%][100] | ![빌드 상태][ukn] | + +*** diff --git a/zh-TW/origin/plazma/administration/README.md b/zh-TW/origin/plazma/administration/README.md new file mode 100644 index 000000000..34af60cfa --- /dev/null +++ b/zh-TW/origin/plazma/administration/README.md @@ -0,0 +1,5 @@ +--- +description: 利用 Plazma 創建自己的服務器。 +--- + +# ⚒️ 伺服器管理指南 diff --git a/zh-TW/origin/plazma/administration/diagnosis/README.md b/zh-TW/origin/plazma/administration/diagnosis/README.md new file mode 100644 index 000000000..c65af7d0c --- /dev/null +++ b/zh-TW/origin/plazma/administration/diagnosis/README.md @@ -0,0 +1,5 @@ +--- +description: 當問題發生時，請了解應對方法。 +--- + +# 🧾 진단 diff --git a/zh-TW/origin/plazma/administration/diagnosis/plugins.md b/zh-TW/origin/plazma/administration/diagnosis/plugins.md new file mode 100644 index 000000000..ed741f9c2 --- /dev/null +++ b/zh-TW/origin/plazma/administration/diagnosis/plugins.md @@ -0,0 +1,5 @@ +--- +description: 當插件無法正常運作時，請查看如何解決。 +--- + +# 📜 플러그인 diff --git a/zh-TW/origin/plazma/administration/expert/README.md b/zh-TW/origin/plazma/administration/expert/README.md new file mode 100644 index 000000000..678cb1bf0 --- /dev/null +++ b/zh-TW/origin/plazma/administration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: 了解專業處理Plazma的方法。 +--- + +# 🎓 深化 diff --git a/zh-TW/origin/plazma/administration/expert/fix-exploits.md b/zh-TW/origin/plazma/administration/expert/fix-exploits.md new file mode 100644 index 000000000..dda4d6eb7 --- /dev/null +++ b/zh-TW/origin/plazma/administration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 了解已知漏洞及其解决方法。 +--- + +# ⚠️ 已知漏洞及解決方法 diff --git a/zh-TW/origin/plazma/administration/expert/optimize.md b/zh-TW/origin/plazma/administration/expert/optimize.md new file mode 100644 index 000000000..8cfb33c4b --- /dev/null +++ b/zh-TW/origin/plazma/administration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: 了解如何優化Plazma。 +--- + +# 🧹 優化 diff --git a/zh-TW/origin/plazma/administration/expert/proxy.md b/zh-TW/origin/plazma/administration/expert/proxy.md new file mode 100644 index 000000000..e98f7c941 --- /dev/null +++ b/zh-TW/origin/plazma/administration/expert/proxy.md @@ -0,0 +1,5 @@ +--- +description: 學習如何安全地配置代理平台“Velocity”。 +--- + +# 🔀 代理 diff --git a/zh-TW/origin/plazma/administration/expert/vanillaize.md b/zh-TW/origin/plazma/administration/expert/vanillaize.md new file mode 100644 index 000000000..b22680e24 --- /dev/null +++ b/zh-TW/origin/plazma/administration/expert/vanillaize.md @@ -0,0 +1,15 @@ +--- +description: 了解如何恢復Paper和Vanilla的補丁。 +--- + +# ↩️ 讓它變成Vanilla + +{% hint style="warning" %} + +**Paper不提供選擇來解決大多數Vanilla錯誤的補丁。** + +目前Plazma正在開發使這些錯誤修復配置失效的功能。 + +因此，本指南仍在撰寫中，信息隨時可能更改。 + +{% endhint %} diff --git a/zh-TW/origin/plazma/administration/expert/xray.md b/zh-TW/origin/plazma/administration/expert/xray.md new file mode 100644 index 000000000..740903fc2 --- /dev/null +++ b/zh-TW/origin/plazma/administration/expert/xray.md @@ -0,0 +1,5 @@ +--- +description: 瞭解阻擋X射線的多種內建方法。 +--- + +# 🩻 阻擋X射線 diff --git a/zh-TW/origin/plazma/administration/faq.md b/zh-TW/origin/plazma/administration/faq.md new file mode 100644 index 000000000..b3a9cd134 --- /dev/null +++ b/zh-TW/origin/plazma/administration/faq.md @@ -0,0 +1,44 @@ +--- +description: 瞭解常見問題。 +--- + +# ⁉️ 常見問題 + +{% hint style="info" %} + +**找不到您想要的答案嗎？** + +[官方 Discord 伺服器](https://discord.gg/MmfC52K8A8) 或者透過 [GitHub 討論區](https://github.com/PlazmaMC/PlazmaBukkit/discussions) 向社群提問！ + +{% endhint %} + +### Plazma無法啟動 + +如果在控制台上輸出`no main manifest attribute, in plazma-(version).jar`，\ +下載的文件是開發API文件，應該從GitHub頁面下載**Reobf Paperweight**。 + +請參考以下頁面以獲得詳細資訊。 + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### 每次啟動伺服器時都會顯示警告 + +Plazma包含一些不穩定的修補程式，因此可能會總是在伺服器啟動時輸出以下警告訊息。 + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +可以使用[`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]系統屬性來停用此警告訊息。 + +請參考以下頁面以獲得詳細資訊。 + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 從1.20.1版本開始可用 diff --git a/zh-TW/origin/plazma/administration/getting-started/README.md b/zh-TW/origin/plazma/administration/getting-started/README.md new file mode 100644 index 000000000..86f3afd49 --- /dev/null +++ b/zh-TW/origin/plazma/administration/getting-started/README.md @@ -0,0 +1,316 @@ +--- +description: 請了解如何使用Plazma創建服務器。 +--- + +# 👟 開始 + +為了穩定使用Plazma，系統必須滿足以下要求。 + +| | 最低 | 建議 | +| :--: | --- | ---- | +| 架構 | x64 | - | +| RAM | 8GB | 16GB | +| 儲存空間 | 1GB | 8GB | +| JDK | 17 | 21 | + +為了方便進行配置文件修改，建議安裝類似[Visual Studio Code](https://code.visualstudio.com/download)的編輯器。 + +*** + +## 1. JDK 설치 + +이름에서 알 수 있듯이, Minecraft: **"Java"** Edition 은 Java로 개발되어, 실행을 위해선 JDK[^1]를 필요로 합니다. + +Plazma는 Mojang Studios의 공식 서버 플랫폼을 [기반으로 하므로](#user-content-fn-2)[^2], Plazma를 사용하기 위해서도 JDK를 설치해야 합니다. + +### 1.1 JDK 설치 유무 확인 + +JDK가 시스템에 설치되어 있는지 확인하려면, [실행 창](#user-content-fn-3)[^3]에 [`cmd /k java --version`](#user-content-fn-4)[^4]을 입력하고 실행합니다. + +다음과 같이 출력되면 [2 단계](./#id-2)로 건너뜁니다. + +{% code title="正確的輸出" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, [1.2 단계](./#id-1.2)를 수행해야 합니다. + +{% code title="JDK가 설치되어 있지 않음" lineNumbers="true" %} + +```log +'java'不是内部或外部命令，也不是可运行的程序或批处理文件。 +``` + +{% endcode %} + +{% code title="JDK가 너무 오래됨" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 JDK 설치 + +본 설명서에서는 JDK의 [종류 중 하나](#user-content-fn-5)[^5]로 Azul Zulu를 사용합니다. + +설치를 완료한 후, [1.1 단계](./#id-1.1)을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요. + +{% tabs %} +{% tab title="Windows" %} + +1. 首先，從[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=windows\\&architecture=x86-64-bit\\&package=jdk#zulu)下載**JDK 21**的`.msi`安裝程序。 +2. 運行下載的安裝精靈，然後點擊“下一步”。 +3. 在左上角的菜單中啟用`Set JAVA_HOME variable`，然後點擊“下一步”。 +4. 點擊“安裝”完成JRE的安裝。 + {% endtab %} + +{% tab title="macOS" %} +[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\\&os=macos\\&architecture=x86-64-bit\\&package=jdk#zulu) 에서 **JDK 21**을 `.dmg` 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다. +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다. + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +然後，執行以下命令以安裝JRE。 + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +다음 명령어를 입력하여 JDK를 설치할 수 있습니다. + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. 下載Plazma + +Plazma提供多種形式的執行文件。 + +{% hint style="warning" %} +**대부분의 경우에는 `Mojang-mapped Paperclip`을 사용합니다.** + +아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.\ +일반 사용자라면 [3 단계](./#id-3)로 뛰어 넘겨도 문제되지 않습니다. +{% endhint %} + +
+ +了解更多 + +執行文件名為`plazma-(版本管理者)-1.20.4-R0.1-SNAPSHOT-(映射形式).jar`。 + +- **映射形式**\ + 映射是將Minecraft的實際代碼與混淆代碼連接起來的一種地圖。 + - **Reobf**\ + Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다.\ + 1.20.6부터 지원이 종료되었습니다. + - **Mojmap**\ + Mojang-mapped, 原版Minecraft映射。 1.20.6 이후의 모던 플러그인에서 사용합니다. +- **版本管理者**\ + 版本管理者是運行服務器所需的庫和修補服務器文件的啟動器。 + - **Paperclip**\ + 由PaperMC團隊為Paper和其他衍生平台開發的管理者，負責下載庫並應用修補到服務器。 + - **Bundler**\ + 原始Minecraft版本管理者。 + +
+ +*** + +## 3. 創建啟動腳本 + +要簡單啟動Plazma並自動重新啟動服務器，需要創建[啟動腳本](#user-content-fn-6)[^6]。 + +[Flags.sh](https://flags.sh)를 통해 시작 스크립트를 생성[^7]할 수 있습니다.\ +Plazma에 [사용할 메모리](#user-content-fn-8)[^8]만 입력하면 명령어가 자동으로 최적화 됩니다. + +通過左下角的下載按鈕下載啟動腳本。\ +**請確認下載的啟動腳本與您的操作系統相符。** + +*** + +## 4. 整理文件 + +現在將下載的啟動腳本和Plazma移動到新文件夾中。 + +{% hint style="warning" %} +**폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.** + +그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다. +{% endhint %} + +現在執行啟動腳本。 Windows의 경우, 방화벽 허용 선택 창에서, 반드시 **허용**을 선택해야 합니다. + +*** + +## 5. EULA同意 + +執行啟動腳本後，文件夾中將生成`eula.txt`。 + +EULA[^9]是使用Mojang Studios的服務時必須同意的使用權協議。 + +{% hint style="warning" %} +만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재[^11]를 받을 수 있습니다. +{% endhint %} + +要同意EULA，請將`eula.txt`文件中的`eula=false`修改為`eula=true`，然後保存。 + +*** + +## 6. 允許外部訪問（Windows） + +現代操作系統通常會阻止外部訪問以防止危險訪問。 + +Windows의 경우, 방화벽은 [3 단계](./#id-3)에서 허용했으므로, 포트 포워딩만 하면 됩니다. + +{% hint style="info" %} +**해당 설명서는 Windows 운영 체제 및** [**UPnP**](#user-content-fn-12)[^12]**를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.** + +如果路由器不支持UPnP，則由於每個路由器的面板不同，您需要自行查找信息。 + +或者可以使用[Ngrok](https://ngrok.com/)生成臨時地址。 +{% endhint %} + +{% hint style="warning" %} +**Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.** +{% endhint %} + +### 6.1 檢查是否需要端口轉發 + +輸入以下命令並運行。 + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +如果輸出為`True`，則可以結束，否則需要設置端口轉發。 + +### 6.2 連接到服務器 + +{% tabs %} +{% tab title="외부에서 접속" %} +포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다. + +連接到伺服器時使用的地址可以在[這裡](https://ip.pe.kr/)找到。 +{% endtab %} + +{% tab title="UPnP로 포트포워딩 시도" %} +서버 폴더의 `purpur.yml`에서, `network.upnp-port-forwarding`을 `true`로 활성화합니다. + +然後重新啟動伺服器，Plazma將自動嘗試進行端口轉發。 + +以下是根據控制台輸出的消息來判斷UPnP是否成功，控制台將顯示類似`[UPnP]（消息）`的消息。 + +| 消息 | 意義 | +| ------------ | ------------ | +| `成功打開端口（端口）` | 端口轉發成功。 | +| `端口（端口）已打開` | 另一服務正在使用該端口。 | +| `無法打開端口（端口）` | 端口轉發失敗。 | +| `服務不可用` | 路由器不支援UPnP。 | + +當伺服器關閉時，Plazma會自動關閉埠。 +{% endtab %} + +{% tab title="Ngrok으로 임시 주소 생성" %} +Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다. + +1. 從[Ngrok官網](https://ngrok.com/download)下載 `Windows (64-bit)` ZIP檔案。 +2. 將下載的Ngrok放入伺服器資料夾中。 +3. 在[Ngrok儀表板](https://dashboard.ngrok.com/get-started/your-authtoken)上生成[授權令牌](#user-content-fn-13)[^13]。 +4. 在伺服器資料夾中執行顯示在下方`Command Line`的命令。 +5. 在執行腳本的最上方添加 `start /b ngrok tcp --region jp 25565`，在最底部添加 `taskkill /f /t /im ngrok.exe`。 +6. 在控制台頂部顯示的 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 中，`0.tcp.jp.ngrok.io:12345`將成為伺服器的地址。 +7. 現在您可以通過該地址從外部訪問。 + {% endtab %} + +{% tab title="로컬에서 접속" %} +로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 `cmd /k ipconfig`를 실행하여 출력된 `IPv4 주소` 로 접속할 수 있습니다. + +例如，當執行命令後，輸出如下： + +```log +Windows IP配置 + +以太网适配器 以太网: + + 连接的 DNS 后缀. . . . . . . : + IPv4 地址. . . . . . . . . : 192.168.3.7 + 子网掩码 . . . . . . . . : 255.255.255.0 + 默认网关 . . . . . . . . : 192.168.3.1 + +``` + +在此，您可以嘗試使用IPv4地址中顯示的 `192.168.3.7` 進行本地伺服器連接。 + +如果伺服器和遊戲在同一台PC上運行，則可以使用 `localhost` 進行連接。 +{% endtab %} +{% endtabs %} + +## 7. 發展 + +如果伺服器成功啟動並正常運行，現在輪到您自定義伺服器了。 + +请查看以下说明书以了解如何个性化服务器。 + +{% content-ref url="next-step.md" %} +[next-step.md](next-step.md) +{% endcontent-ref %} + +*** + +[^1]: Java Development Kit (Java 개발 환경), Java Runtime Environment (JRE, Java 실행 환경) 을 포함하고 있으며, Plazma 에서는 JDK 에서만 제공되는 일부 기능을 이용하고 있으므로 JDK 설치를 필요로 합니다. + +[^2]: Plazma基於Spigot，而Spigot基於官方伺服器平台。 + +[^3]: Windows鍵 + R + +[^4]: 對於Linux，可以在終端中運行 `java --version`。 + +[^5]: JRE是一個開源項目，類似Minecraft伺服器平台，有多種類型。 + +[^6]: 通常被稱為**運行器**。 + +[^7]: 啟用"自動重新啟動"後，伺服器將自動重新啟動。 您可以輸入`Control + C`來結束。 + +[^8]: 不建議超過系統的一半。 + + 例如，如果系統的總記憶體容量為8GB，則不建議設置超過4GB。 + +[^9]: 最終用戶許可協議，最終使用者授權協議。 請查看[Minecraft官網](https://www.minecraft.net/ko-kr/usage-guidelines)以獲得詳細信息。 + +[^10]: Microsoft Corporation。 + +[^11]: 根據韓國遊戲產業促進法第32條第1項第9號，**韓國微軟**可以根據法律提出訴訟。 + +[^12]: 通用即插即用。 Plazma附帶的Purpur通過這項技術與路由器自動通信，僅在伺服器運行時打開埠，因此無需直接進行埠轉發。 + +[^13]: 如果沒有帳戶，可以使用Google或GitHub帳戶註冊Ngrok。 diff --git a/zh-TW/origin/plazma/administration/getting-started/customization.md b/zh-TW/origin/plazma/administration/getting-started/customization.md new file mode 100644 index 000000000..8c290e70d --- /dev/null +++ b/zh-TW/origin/plazma/administration/getting-started/customization.md @@ -0,0 +1,117 @@ +--- +description: 瞭解如何自訂伺服器。 +--- + +# 🎨 使用者化 + +Mojang Studios提供的官方伺服器平台，與Plazma等修改過的伺服器平台不同，最主要的原因是可以進行強大的**使用者自訂**。 + +以下是使用Plazma進行自訂和利用的多種方法。 + +## 配置修改 + +對Plazma進行自訂的最基本方法就是修改配置。 + +Plazma提供了從遊戲機制到怪物屬性等強大的配置設定。 + +有關Plazma配置的說明，請參考下面的頁面。 + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +## 使用插件 + +{% hint style="success" %} + +**Plazma支持所有基于Paper的插件。** + +对于Spigot插件，由于从1.20.5开始，由于Paper的映射变化，某些插件可能无法正常工作，但是基于Paper的插件，如Paper、Pufferfish和Purpur等，都可以在Plazma上正常运行。如果插件无法正常工作，请立即[报告给Plazma](../diagnosis/plugins.md)。 + +{% endhint %} + +这是使用Plazma的主要原因，也是使Plazma个性化的最强大方法。 +Plazma强大的插件生态系统使服务器易于个性化。 + +有多种方法可以查找并下载插件。 一些插件会将插件上传到公共存储库服务，而另一些插件则会上传到GitHub或自己的网站。 + +{% hint style="caution" %} + +**插件可以直接访问系统！** + +使用VirusTotal等服务在应用插件之前始终确保安全性，或者从可信任的服务下载插件。 + +{% endhint %} + +有多种服务可用于下载插件。 其中，[SpigotMC论坛](https://www.spigotmc.org/resources/)、[BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins)、[Modrinth](https://modrinth.com/plugins)、[Hanger](https://hangar.papermc.io/)等服务在上传插件之前经过审核，只有安全的插件才会被分发。 + +### 应用插件 + +如果已经下载了插件，现在可以应用插件了。 + +1. 插件是`.jar`或`Java可执行文件`。\ + 有些插件可能被压缩成压缩文件，这种情况下 + 解压缩并包含`bukkit`、`spigot`或`paper`的名称， + 如果有`fat`文件，则使用`fat`文件。 +2. 将下载的文件放入服务器文件夹中的`plugins`文件夹中，然后重新启动服务器。 +3. Plazma启动后，控制台将输出新内容。 + 这表示Plazma已成功加载插件。 +4. 即使Plazma已成功加载插件，某些插件可能无法启动。 + 使用`/plugins`命令可以加载当前服务器上加载的插件。 + 如果安装的插件名称不是红色，而是 绿色，则插件已正常加载。 + +如果插件未能正常加载，请查看以下页面以找到解决方案。 + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +## 使用数据包 + +数据包是Minecraft默认提供的个性化方式，类似于[资源包](#user-content-fn-1)[^1]。 + +使用数据包可以添加新生物群系和挑战，修改游戏内的部分内容。 + +{% hint style="caution" %} + +**数据包可能会损坏世界！** + +一些损坏的数据包可能会损坏世界，这是无法挽回的。 + +因此，建议在应用数据包之前备份世界。 + +{% endhint %} + +数据包也可以从多个服务中下载，如[CurseForge](https://www.curseforge.com/minecraft/search?page=1\&pageSize=50\&sortBy=relevancy\&class=data-packs)、[Modrinth](https://modrinth.com/datapacks)、[Planet Minecraft](https://www.planetminecraft.com/data-packs/)等服务。 + +下载数据包后，将其放入服务器世界文件夹中的`datapacks`文件夹中以应用。 +如果文件夹不存在，可以创建文件夹并添加。 + +{% hint style="warning" %} + +**某些[数据包](#user-content-fn-2)[^2]在第一次应用时可能无法正确应用。** + +为此，建议重新启动服务器**2次**。 + +{% endhint %} + +数据包在Minecraft更新时很容易损坏。 + +特别是当数据包完全损坏时，服务器会崩溃， +因此，在更新服务器之前进行充分测试非常重要。 + +{% hint style="info" %} + +**在服务器启动命令后输入`safeMode`，可以禁用所有数据包后启动服务器。** + +[有关详细信息，请参阅`参考 > 参数和属性`。](../reference/arguments.md) + +{% endhint %} + +应用的数据包可以通过`/datapack list`命令进行确认。 + +*** + +[^1]: 或者Minecraft: Bedrock Edition的插件。 + +[^2]: 添加新生物群系等。 diff --git a/zh-TW/origin/plazma/administration/getting-started/next-step.md b/zh-TW/origin/plazma/administration/getting-started/next-step.md new file mode 100644 index 000000000..63da924c1 --- /dev/null +++ b/zh-TW/origin/plazma/administration/getting-started/next-step.md @@ -0,0 +1,169 @@ +--- +description: 瞭解如何自訂伺服器。 +--- + +# 🎨 발전하기 + +Mojang Studios에서 제공하는 공식 서버 플랫폼을 사용하지 않고 Plazma와 같이 수정된 서버 플랫폼을 사용하는 이유는 강력한 **사용자화**가 가능하다는 점이 가장 클 것입니다. + +以下是使用Plazma進行自訂和利用的多種方法。 + +## 配置修改 + +對Plazma進行自訂的最基本方法就是修改配置。 + +Plazma提供了從遊戲機制到怪物屬性等強大的配置設定。 + +有關Plazma配置的說明，請參考下面的頁面。 + +{% content-ref url="../reference/configurations/" %} +[configurations](../reference/configurations/) +{% endcontent-ref %} + +*** + +## 使用插件 + +{% hint style="success" %} +**Plazma는 Paper 기반의 모든 플러그인을 정상 지원합니다.** + +Spigot 플러그인의 경우 1.20.5부터 Paper의 매핑 변화로 일부 동작하지 않을 수 있지만, Paper, Pufferfish 및 Purpur 등 Paper를 기반으로 하는 대부분의 플러그인은 Plazma에서도 모두 작동하며, 만약 정상적으로 작동하지 않을 경우 Plazma의 오류이므로 즉시 [신고해주시기 바랍니다.](../diagnosis/plugins.md) +{% endhint %} + +这是使用Plazma的主要原因，也是使Plazma个性化的最强大方法。 Plazma强大的插件生态系统使服务器易于个性化。 + +有多种方法可以查找并下载插件。 어떤 플러그인은 공개 저장소 서비스에 플러그인을 업로드 하고, 어떤 플러그인은 GitHub 또는 자체 사이트에 업로드하기도 합니다. + +{% hint style="info" %} +**플러그인은 시스템에 직접적으로 접근할 수 있습니다!** + +VirusTotal 등의 서비스를 이용하여 플러그인을 적용하기 전 항상 안전한지 확인하거나, 신뢰 가능한 서비스에서 플러그인을 다운로드 하세요. +{% endhint %} + +有多种服务可用于下载插件。 其中，[SpigotMC论坛](https://www.spigotmc.org/resources/)、[BukkitDev (CurseForge)](https://dev.bukkit.org/bukkit-plugins)、[Modrinth](https://modrinth.com/plugins)、[Hanger](https://hangar.papermc.io/)等服务在上传插件之前经过审核，只有安全的插件才会被分发。 + +### 应用插件 + +如果已经下载了插件，现在可以应用插件了。 + +1. 플러그인은 `.jar` 또는 `Java Executable File` 로 되어 있습니다.\ + 일부 플러그인은 압축 파일로 압축되어 있는 경우도 있는데, 그런 경우 압축을 풀어 이름에 `bukkit`, `spigot` 또는 `paper` 가 포함되어 있고, `fat`이 포함된 파일이 함께 있는 경우 `fat` 파일을 사용하면 됩니다. +2. 将下载的文件放入服务器文件夹中的`plugins`文件夹中，然后重新启动服务器。 +3. Plazma启动后，控制台将输出新内容。 这表示Plazma已成功加载插件。 +4. 即使Plazma已成功加载插件，某些插件可能无法启动。 使用`/plugins`命令可以加载当前服务器上加载的插件。 설치한 플러그인의 이름이 적색이 아닌 녹색이라면 플러그인이 정상적으로 로드된 것입니다. + +如果插件未能正常加载，请查看以下页面以找到解决方案。 + +{% content-ref url="../diagnosis/plugins.md" %} +[plugins.md](../diagnosis/plugins.md) +{% endcontent-ref %} + +*** + +## 使用数据包 + +데이터팩은 Minecraft가 기본적으로 제공하는 사용자화 방법으로써, 리소스팩[^1]과 유사합니다. + +使用数据包可以添加新生物群系和挑战，修改游戏内的部分内容。 + +{% hint style="info" %} +**데이터팩은 월드를 손상시킬 수 있습니다!** + +一些损坏的数据包可能会损坏世界，这是无法挽回的。 + +因此，建议在应用数据包之前备份世界。 +{% endhint %} + +데이터팩 또한 여러 서비스에서 다운로드 할 수 있으며, [CurseForge](https://www.curseforge.com/minecraft/search?page=1\\&pageSize=50\\&sortBy=relevancy\\&class=data-packs), [Modrinth](https://modrinth.com/datapacks), [Planet Minecraft](https://www.planetminecraft.com/data-packs/) 등 여러 서비스에서 찾을 수 있습니다. + +下载数据包后，将其放入服务器世界文件夹中的`datapacks`文件夹中以应用。 如果文件夹不存在，可以创建文件夹并添加。 + +{% hint style="warning" %} +[**일부 데이터팩**](#user-content-fn-2)[^2]**의 경우 처음 적용시 정상적으로 적용되지 않을 수 있습니다.** + +为此，建议重新启动服务器**2次**。 +{% endhint %} + +数据包在Minecraft更新时很容易损坏。 + +특히, 데이터팩이 완전히 손상된 경우, 서버가 충돌하기 때문에, 서버를 업데이트하기 전 충분한 테스트를 거치는 것이 중요합니다. + +{% hint style="info" %} +**서버 시작 명령어 뒤에 `safeMode`를 입력하여 데이터팩을 모두 비활성화 한 뒤 서버를 시작할 수 있습니다.** + +[자세한 내용은 `리퍼런스 > 인수와 속성`을 참고하세요.](../reference/arguments.md#safemode) +{% endhint %} + +应用的数据包可以通过`/datapack list`命令进行确认。 + +*** + +## 最佳化 + +Plazma已經應用了許多最佳化補丁。 또한, Plazma가 처음으로 시작되면 자동으로 구성을 최적화 하므로 [시작하기](./) 설명서를 따른 경우 추가적인 최적화 작업을 할 필요가 없습니다. + +하지만, 많은 플레이어가 접속하거나, 월드의 크기가 방대한 경우, 아래 설명서를 통해 추가적인 최적화 작업을 할 수 있습니다. + +{% content-ref url="../expert/optimize.md" %} +[optimize.md](../expert/optimize.md) +{% endcontent-ref %} + +*** + +## 代理 + +프록시는 서버를 서로 연결하고 플레이어가 추가적인 작업 없이 서버를 이동하거나, 다른 서버와 소통할 수 있게 합니다. + +有關安全且正確的代理設置的信息，請參閱以下頁面。 + +{% content-ref url="../expert/proxy.md" %} +[proxy.md](../expert/proxy.md) +{% endcontent-ref %} + +*** + +## 安全 + +由於Minecraft的模組化發展，甚至在線上也很容易獲得[弱點攻擊引擎](#user-content-fn-3)[^3]。 + +일반 게임에서도 실행 가능한 대부분의 취약점은 [기본적으로 차단되어 있지만](#user-content-fn-4)[^4], 서드파티 로더를 통해 취약점을 공격하는것은 차단되어 있지 않습니다. + +따라서, 서버가 공개되어 있는 경우, 안티 치트 플러그인 등을 설치하여 취약점 사용을 차단하고, 프록시 및 자동 재시작, 백업 등을 구성하여 서버가 다운되어도 빠르게 복구할 수 있도록 하는 것이 권장됩니다. + +### 權限設定 + +一些插件的管理員命令存在未正確設置權限的弱點。 + +[LuckPerms](https://luckperms.net/) 등의 권한 관리 플러그인을 사용하여 일반 사용자의 권한을 제한하는 조치를 하는것이 권장됩니다. + +### X射線阻擋 + +X射線是一種基本最佳化客戶端中很容易使用的弱點之一。 + +Plazma提供了可以基本阻擋X射線的配置。 + +有關X射線阻擋方法和說明，請參考以下頁面。 + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +### 白名單 + +일부 사용자만 서버에 접속할 수 있도록 하는 경우, [Ngrok](./#id-6.2)을 사용하여 [난독화된 서버 주소를 사용](#user-content-fn-5)[^5] 하거나, 화이트리스트를 설정하여 다른 플레이어가 서버에 접속하지 못하도록 하는 것도 권장됩니다. + +서버 콘솔에서 `/whitelist add ` 를 통해 플레이어의 접속을 허용하거나, `/whitelist remove ` 로 플레이어의 접속을 다시 금지할 수 있습니다. + +要查看已允許訪問的玩家，請使用 `/whitelist query`。 + +*** + +[^1]: 或者Minecraft: Bedrock Edition的插件。 + +[^2]: 添加新生物群系等。 + +[^3]: 通常被稱為"作弊"。 + +[^4]: 如果配置未最佳化，Plazma過時，或者發現了新的弱點，則可能未阻擋。 + +[^5]: 玩家通過Ngrok代理服務器訪問，每次重新啟動時發放的Ngrok地址都會有所不同。 diff --git a/zh-TW/origin/plazma/administration/reference/README.md b/zh-TW/origin/plazma/administration/reference/README.md new file mode 100644 index 000000000..d1b6be221 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/README.md @@ -0,0 +1,57 @@ +--- +description: 在Plazma中了解基本提供的用戶化方法。 +--- + +# 📜 리퍼런스 + +Plazma提供了多種用戶化方法。 + +其中，以下4種方法是可以直接使用的用戶化方法，無需進行額外操作。 + +{% hint style="info" %} +**설명서를 통해 문제를 해결할 수 없나요?** + +[官方 Discord 伺服器](https://discord.gg/MmfC52K8A8) 或者透過 [GitHub 討論區](https://github.com/PlazmaMC/PlazmaBukkit/discussions) 向社群提問！ +{% endhint %} + +*** + +## 🖥️ 指令 + +> 指令可讓玩家在遊戲中收集信息或自定義遊戲環境。 + +{% content-ref url="commands.md" %} +[commands.md](commands.md) +{% endcontent-ref %} + +*** + +## 🛡️ 權限 + +> 權限指定玩家可以互動的範圍。 + +{% content-ref url="permissions.md" %} +[permissions.md](permissions.md) +{% endcontent-ref %} + +*** + +## 🎛️ 參數和屬性 + +> 參數和屬性對Plazma的運作產生全面影響。 + +{% content-ref url="arguments.md" %} +[arguments.md](arguments.md) +{% endcontent-ref %} + +*** + +## 📋 組態 + +> 組態是用戶化Plazma的最基本方法。 + +{% content-ref url="configurations/" %} +[configurations](configurations/) +{% endcontent-ref %} + +*** diff --git a/zh-TW/origin/plazma/administration/reference/arguments.md b/zh-TW/origin/plazma/administration/reference/arguments.md new file mode 100644 index 000000000..a452caafb --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/arguments.md @@ -0,0 +1,567 @@ +--- +description: 了解启动参数和系统属性。 +--- + +# 🎛️ 启动参数和属性 + +開始入口和系統屬性是Plazma執行所使用的命令[^1]所附加的值，對Plazma的操作產生整體影響。 + +[명령어에 덧붙이는 위치](#user-content-fn-2)[^2]에 따라 **시작 인수**와 **시스템 속성**으로 나뉘게 됩니다. + +*** + +## 系统属性 + +系统属性是在`-jar`之前输入的值，在Plazma初始化之前由JVM处理。 + +{% hint style="warning" %} +**시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!** + +각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, **절대 사용하지 마세요!** +{% endhint %} + +### 使用方法 + +系统属性作为Java命令参数输入在`java`和`-jar`之间。 + +예를 들어, `Plazma.dummyProperty` 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 `37`이 입력되어 Plazma가 초기화 됩니다. + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`表示该参数不是JVM内置的，而是添加到Plazma的专用参数， + +속성에 아무런 값도 입력하지 않으면 값이 [`true`로 고정](#user-content-fn-3)[^3]됩니다. + +{% hint style="info" %} +**Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 `.`을 포함하고 있습니다.** + +Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 `"`를 추가해야[^4] 합니다. +{% endhint %} + +### 全部系统属性 + +#### `convertLegacySigns` + +- **类型**: `布尔值` +- **默认值**: `False` + +更新停用的标志格式。 + +#### `debug.entities` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用与实体信息相关的调试日志。 + +#### `debug.rewriteForIDE` + +- **类型**: `布尔值` +- **默认值**: `False` + +为了正确加载IDE中的调试信息，禁用NMS修订，并自动重新映射内部版本信息。 + +#### `disable.watchdog` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Spigot的看门狗警告系统。 + +#### `letMeReload` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用`/reload`命令的重新加载消息。 + +{% hint style="danger" %} +**`/reload` 명령어는 매우 불안정하므로, `/reload` 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.** + +如果您是插件开发人员并且需要更新插件，请使用热交换而不是`/reload`。 +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用使用标准输入输出系统的插件。 + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **类型**: `布尔值` +- **默认值**: `False` + +检测到聊天组件中已停用的格式时发出警告。 + +#### `Paper.bypassHostCheck` + +- **类型**: `布尔值` +- **默认值**: `False` + +连接到服务器时禁用服务器的主机检查。 + +#### `Paper.debugDynamicMissingKeys` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对NBT对象中丢失键的调试日志。 + +#### `Paper.debugInvalidSkullProfiles` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对具有无效头骨配置文件的调试日志。 + +这将记录世界中所有无效的头骨配置文件及其位置。 + +#### `Paper.disableChannelLimit` + +- **类型**: `布尔值` +- **默认值**: `False` + +플레이어당 적용되는 128개의 플러그인 채널[^5]의 개수 제한을 비활성화 합니다. + +#### `Paper.disableClassPrioritization` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用插件类优先级系统。 + +在插件Shade中遇到问题时很有用。 + +#### `Paper.disableFlushConsolidate` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Netty刷新合并系统。 + +#### `Paper.excessiveTELimit` + +- **형태**: `Integer` +- **默认值**: `750` + +如果实体超过设置的值，则将其分割为多个数据包进行传输。 + +#### `Paper.filterThreshold` + +- **형태**: `Integer` +- **默认值**: `8192` + +设置服务器一次接收的最大数据包大小。 + +#### `Paper.ignoreJavaVersion` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Java版本检查。 + +{% hint style="danger" %} +**이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!** + +可能会永久损坏世界等文件，并破坏游戏的整个机制。 + +由此产生的所有问题由用户承担，Plamza不提供任何支持。 +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **형태**: `Integer` +- **默认值**: `64` + +플러그인 채널[^6] 이름의 제한을 설정합니다. + +#### `Paper.maxSignLength` + +- **형태**: `Integer` +- **默认值**: `80` + +设置牌子一行中可以输入的最大字符数。 + +#### `Paper.minPrecachedDatafixVersion` + +- **형태**: `Integer` +- **默认值**: `(世界版本) + 1` + +设置要首先初始化的世界更新信息的版本。 + +对于需要大量更新的区块很有用，但在其他情况下不使用。 + +#### `Paper.parseYamlCommentsByDefault` + +- **类型**: `布尔值` +- **默认值**: `True` + +启用处理YAML文件注释。 + +#### `Paper.playerConnection.keepAlive` + +- **형태**: `Integer` +- **默认值**: `30` + +当玩家在输入值（秒）后未收到任何数据时，将踢出玩家。 + +일반적인 경우, 게임[^7]은 서버로 계속해서 [하트비트 신호](#user-content-fn-8)[^8]를 전송하므로, [추방되지 않지만,](#user-content-fn-9)[^9] 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다. + +#### `Paper.skipServerPropertiesComments` + +- **类型**: `布尔值` +- **默认值**: `False` + +忽略服务器属性的注释。 + +#### `Paper.debug-sync-loads` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用同步区块写入的调试日志。 + +#### `Paper.enable-sync-chunk-writes` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用Minecraft的[默认区块写入系统](#user-content-fn-10)[^10]。 + +这将按顺序保存每个区块，导致严重的性能下降。 + +#### `Paper.explicit-flush` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用网络通道的显式刷新。 + +#### `Paper.strict-thread-checks` + +- **类型**: `布尔值` +- **默认值**: `False` + +始终记录在主线程之外发生的错误。 + +#### `Paper.tickList-warn-on-excessive-delay` + +- **类型**: `布尔值` +- **默认值**: `False` + +如果预定任务具有过多等待时间，则输出警告。 + +#### `Paperclip.patchOnly` + +- **类型**: `布尔值` +- **默认值**: `False` + +使用默认提供的执行文件时，仅应用补丁而不启动服务器。 + +#### `Plazma.aggressiveOptimize` + +- **类型**: `布尔值` +- **默认值**: `false` +- **衝突**：`Plazma.disableConfigOptimization` + +加強初始化配置的優化。 + +啟用後，伺服器速度更快，更安全，但可能會對遊戲遊玩產生重大影響。 + +#### `Plazma.disableConfigOptimization` + +- **类型**: `布尔值` +- **默认值**: `false` +- **衝突**：`Plazma.aggressiveOptimize` + +不對初始化配置進行優化。 + +使用Paper的默認配置。 + +#### `Plazma.iKnowWhatIAmDoing` + +- **类型**: `布尔值` +- **默认值**: `false` + +Plazma가 초기화될 때 출력되는 경고문[^11]을 억제합니다. + +#### `Plazma.useVanillaFavicon` + +- **类型**: `布尔值` +- **默认值**: `false` + +停用Plazma品牌，使用基本的Vanilla伺服器favicon。 + +#### `Plazma.useVanillaConfiguration` + +- **类型**: `布尔值` +- **默认值**: `false` +- **衝突**：`Plazma.disableConfigOptimization` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +{% hint style="danger" %} +**해당 속성은 패치된 모든 취약점을 되돌립니다!** + +這可能會對伺服器的安全性和效能造成重大影響。 + +所有使用此屬性引起的問題應由伺服器管理員負責。 +{% endhint %} + +將初始化配置提供為Mojang提供的默認值。 + +將所有Paper應用的漏洞修補停用。 + +漏洞修補可重新在Paper配置或Plazma配置中啟用。 + +#### `Plazma.vanillaize` + +- **类型**: `布尔值` +- **默認**：`true` +- **衝突**：`Plazma.aggressiveOptimize` + +{% hint style="info" %} +**해당 속성은 아직 개발중입니다.** +{% endhint %} + +將初始化配置設置為接近Vanilla。 + +이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, `Plazma.disableConfigOptimization` 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다. + +### 已停用屬性 + +以下系統屬性已停用。 + +#### `timings.bypassMax` + +- **类型**: `布尔值` +- **默认值**: `false` +- **已停用**: Timings自Plazma中完全移除後 + +決定是否可以超過Aikar的Timings API可接受的最大值。 + +即使這樣做，如果API未處理異常，將應用速率限制。 + +*** + +## 起始引數 + +起始引數被輸入在 `-jar *.jar` 之後，Plazma將初始化並處理一起處理的值。 + +### 用法 + +系統屬性被輸入為 `-jar *.jar` 之後的程序命令引數。 + +例如，如果要應用 `nogui` 起始引數，\ +輸入以下內容將使Plazma在初始化期間處理 `nogui` 引數。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 完整起始引數 + +#### `bukkit-settings` + +- **別名**: `b` +- **預設值**: `bukkit.yml` + +[Bukkit 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `command-settings` + +- **別名**: `c` +- **預設值**: `commands.yml` + +[Bukkit 명령어 구성 파일](configurations/bukkit.md)의 이름 및 위치를 설정합니다. + +#### `config` + +- **別名**: `c` +- **預設值**: `server.properties` + +[서버 속성](configurations/property.md) 파일의 이름 및 위치를 설정합니다. + +#### `demo` + +啟動服務器到演示世界。 + +#### `eraseCache` + +刪除升級後剩餘的快取文件。 + +#### `forceUpgrade` + +버전을 무시하고 월드를 강제로 업그레이드[^12] 합니다. + +#### `help` + +- **別名**: `?` + +顯示Plazma的完整啟動引數和說明。 + +#### `initSettings` + +僅生成配置文件並關閉服務器。 + +#### `jfrProfile` + +啟用JFR配置。 + +#### `max-players` + +- **別名**: `s`, `size` +- **預設值**: `(服務器屬性)` + +허용되는 최대 플레이어[^13] 수를 설정합니다. + +#### `nogui` + +禁用圖形界面面板。 + +#### `nojline` + +禁用JLine並使用原始控制台。 + +#### `online-mode` + +- **別名**: `o` +- **預設值**: `(服務器屬性)` + +選擇是否要通過Mojang驗證服務器驗證玩家。 + +**Velocity 등 프록시를 사용하는 것이 아닌 경우** [**EULA**](../getting-started/#id-5) **위반으로 제재될 수 있습니다.** + +#### `paper-settings` + +- **別名**: `paper` +- **預設值**: `paper.yml` + +{% hint style="warning" %} +**이 인수는 1.19.4 이후 사용이 중지되었습니다** +{% endhint %} + +設置停用的PaperSpigot配置文件位置。 + +這是為了將現有配置轉移到新配置文件而使用的，之後將不再使用。 + +#### `paper-settings-directory` + +- **別名**: `paper-dir` +- **預設值**: `config` + +[Paper 구성 파일](configurations/paper/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plazma-settings-directory` + +- **別名**: `plazma-dir` + +[Plazma 구성 파일](configurations/plazma/)이 위치하는 폴더의 이름 및 위치를 설정합니다. + +#### `plugins` + +- **別名**: `p` +- **預設值**: `plugins` + +設置插件文件夾的位置。 + +#### `pufferfish-settings` + +- **別名**: `pufferfish` +- **預設值**: `pufferfish.yml` + +[Pufferfish 구성 파일](configurations/pufferfish.md)의 이름 및 위치를 설정합니다. + +#### `purpur-settings` + +- **別名**: `purpur` +- **預設值**: `purpur.yml` + +[Purpur 구성 파일](configurations/purpur/)의 이름 및 위치를 설정합니다. + +#### `safeMode` + +以完全原始狀態啟動服務器（安全模式）。 + +#### `server-ip` + +- **別名**: `h`, `host` +- **預設值**: `(服務器屬性)` + +서버의 호스트 이름 또는 [인터넷 프로토콜](#user-content-fn-14)[^14] 주소를 설정합니다. + +#### `server-port` + +- **別名**: `p`, `port` +- **預設值**: `(服務器屬性)` + +設置服務器的端口。 + +#### `server-name` + +- **預設值**: `A Plazma Server` + +設置服務器的名稱。 + +#### `spigot-settings` + +- **別名**: `S` +- **預設值**: `spigot.yml` + +[Spigot 구성 파일](configurations/spigot.md)의 이름 및 위치를 설정합니다. + +#### `version` + +- **別名**: `v` + +顯示Plazma版本。 + +#### `world-dir` + +- **別名**: `W`, `universe`, `world-container` +- **預設值**: `(服務器文件夾)` + +設置存儲世界文件的位置。 + +#### `world-name` + +- **別名**: `w`, `world` +- **預設值**: `(服務器屬性)` + +設置世界文件的名稱。 + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 根據附加位置處理引數的位置會發生變化。 + +[^3]: 例如，如果要將 `Plazma.iKnowWhatIAmDoing` 設置為 `true`（啟用），則只需輸入 `-DPlazma.iKnowWhatIAmDoing` 與 `-DPlazma.iKnowWhatIAmDoing=true` 相同。 + +[^4]: 例如，`"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 事件偵測器。 + +[^6]: 事件偵測器。 + +[^7]: 客戶端。 + +[^8]: 像心跳一樣向伺服器發送連接正常的信號。 + +[^9]: 使用Purpur的AFK踢出功能，即使玩家離開也可以進行踢出。 + +[^10]: 同步區塊寫入系統，Sync Chunk Write System。 + +[^11]: \`警告！ Plazma可能會導致意外問題，所以請務必在將其用於公共伺服器之前進行全面測試。 + +[^12]: 在遊戲中，`世界優化` 也遵循這個原則。 + +[^13]: 管理員排除`等級2`以上。 + +[^14]: 網際網路協定，IP。 diff --git a/zh-TW/origin/plazma/administration/reference/commands.md b/zh-TW/origin/plazma/administration/reference/commands.md new file mode 100644 index 000000000..17ec97feb --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: 了解在Plazma中可用的命令。 +--- + +# 🖥️ 命令 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/README.md b/zh-TW/origin/plazma/administration/reference/configurations/README.md new file mode 100644 index 000000000..28b31639a --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/README.md @@ -0,0 +1,77 @@ +--- +description: 組態是用戶化Plazma的最基本方法。 +--- + +# 🧾 구성 + +*** + +## 🪨 屬性 + +> 屬性是Minecraft提供的最基本的組態文件。 使用屬性可以改變遊戲的基本機制。 + +{% content-ref url="property.md" %} +[property.md](property.md) +{% endcontent-ref %} + +*** + +## 🪣 Bukkit 組態 + +> Bukkit組態是Plazma提供的最基本的組態文件。 使用Bukkit組態可以改變Minecraft伺服器的基本機制。 + +{% content-ref url="bukkit.md" %} +[bukkit.md](bukkit.md) +{% endcontent-ref %} + +*** + +## 🚰 Spigot 組態 + +> Spigot組態允許修改遊戲的細節機制，玩家處理，指令等操作和消息。 + +{% content-ref url="spigot.md" %} +[spigot.md](spigot.md) +{% endcontent-ref %} + +*** + +## 🛩️ Paper 組態 + +> Paper 구성은 Plazma의 전반적인 메커니즘을 수정하고, [각종 최적화와 취약점 해결](./#user-content-fn-1)\[^1]을 활성화 할 수 있게 합니다. + +{% content-ref url="paper/" %} +[paper](paper/) +{% endcontent-ref %} + +*** + +## 🐡 Pufferfish + +> Pufferfish組態允許修改Plazma的世界和實體處理。 + +{% content-ref url="pufferfish.md" %} +[pufferfish.md](pufferfish.md) +{% endcontent-ref %} + +*** + +## 🦑 Purpur 組態 + +> Purpur屬性允許修改遊戲的整體基本數據。 + +{% content-ref url="purpur/" %} +[purpur](purpur/) +{% endcontent-ref %} + +*** + +## ✨ Plazma 組態 + +> Plazma組態允許自定義Plazma的功能。 + +{% content-ref url="plazma/" %} +[plazma](plazma/) +{% endcontent-ref %} + +*** diff --git a/zh-TW/origin/plazma/administration/reference/configurations/bukkit.md b/zh-TW/origin/plazma/administration/reference/configurations/bukkit.md new file mode 100644 index 000000000..04658aa9d --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: 了解bukkit.yml中每个节点的含义。 +--- + +# 🪣 Bukkit diff --git a/zh-TW/origin/plazma/administration/reference/configurations/paper/README.md b/zh-TW/origin/plazma/administration/reference/configurations/paper/README.md new file mode 100644 index 000000000..754321a3b --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: 瞭解每個config文件夾中文件的用途。 +--- + +# 🛩️ 紙 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/paper/global.md b/zh-TW/origin/plazma/administration/reference/configurations/paper/global.md new file mode 100644 index 000000000..6d02de8ca --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: 查看paper-global.yml的每個節點代表什麼。 +--- + +# 🌏 전역 구성 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/paper/world.md b/zh-TW/origin/plazma/administration/reference/configurations/paper/world.md new file mode 100644 index 000000000..732bb81b3 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/paper/world.md @@ -0,0 +1,7 @@ +--- +description: 了解每个节点在paper-world.yml中代表什么。 +--- + +# 🏳️ 세계별 구성 + +世界各地 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/plazma/README.md b/zh-TW/origin/plazma/administration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..ba75676fa --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: 瞭解每個config文件夾中文件的用途。 +--- + +# ✨ Plazma diff --git a/zh-TW/origin/plazma/administration/reference/configurations/plazma/global.md b/zh-TW/origin/plazma/administration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..538ded734 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: 查看plazma-global.yml的每個節點代表什麼。 +--- + +# 🌏 전역 구성 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/plazma/world.md b/zh-TW/origin/plazma/administration/reference/configurations/plazma/world.md new file mode 100644 index 000000000..fdd288f02 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/plazma/world.md @@ -0,0 +1,5 @@ +--- +description: 查看每个节点在plazma-world.yml中代表什么。 +--- + +# 🏳️ 세계별 구성 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/plazma/worlds.md b/zh-TW/origin/plazma/administration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..bb226a1f9 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: 查看每个节点在plazma-world.yml中代表什么。 +--- + +# ✨ Plazma (世界構成) diff --git a/zh-TW/origin/plazma/administration/reference/configurations/property.md b/zh-TW/origin/plazma/administration/reference/configurations/property.md new file mode 100644 index 000000000..60fd6b359 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: 查看每個節點在 server.properties 中代表什麼。 +--- + +# 🪨 Server.properties diff --git a/zh-TW/origin/plazma/administration/reference/configurations/pufferfish.md b/zh-TW/origin/plazma/administration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..ae30219b9 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml的每個節點代表什麼？ +--- + +# 🐡 河豚 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/purpur/README.md b/zh-TW/origin/plazma/administration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..c9e68beff --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: 了解purpur.yml中每个节点的含义。 +--- + +# 🦑 Purpur diff --git a/zh-TW/origin/plazma/administration/reference/configurations/purpur/global.md b/zh-TW/origin/plazma/administration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..e4d656432 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: 了解purpur.yml中每个节点的含义。 +--- + +# 🌏 전역 구성 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/purpur/world.md b/zh-TW/origin/plazma/administration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..7eeb8e064 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: 了解purpur.yml中每个节点的含义。 +--- + +# 🏳️ 세계별 구성 diff --git a/zh-TW/origin/plazma/administration/reference/configurations/spigot.md b/zh-TW/origin/plazma/administration/reference/configurations/spigot.md new file mode 100644 index 000000000..e45a0ffb7 --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: 了解每個spigot.yml節點的含義。 +--- + +# 🚰 Spigot diff --git a/zh-TW/origin/plazma/administration/reference/permissions.md b/zh-TW/origin/plazma/administration/reference/permissions.md new file mode 100644 index 000000000..3d3b6209e --- /dev/null +++ b/zh-TW/origin/plazma/administration/reference/permissions.md @@ -0,0 +1,382 @@ +--- +description: 了解Plazma的權限。 +--- + +# 🛡️ 權限 + +權限是一種簡單的安全工具，用於設定伺服器內玩家可以互動的範圍。 + +為了正確使用權限並輕鬆修改，應使用像 [LuckPerms](https://luckperms.net) 這樣的插件。 + +*** + +## 了解基本權限系統 + +在Minecraft中，提供了基本管理權限組。 + +운영자[^1] 및 명령 블록의 권한을 설정할 수 있으며, [서버 속성](configurations/property.md)에서 수정할 수 있습니다. + +1. **玩家**\ + 通常是給予所有玩家的權限組。 +2. **調停者**\ + 可以忽略重生保護。 +3. **世界管理員**\ + 可以使用與世界管理相關的所有指令和命令方塊。\ + 這是應用於資料包和命令方塊的預設權限組。 +4. **管理員**\ + 可以使用與玩家管理相關的所有指令。 +5. **總管理員**\ + 可以使用包括伺服器管理在內的所有指令。\ + 這是控制台和管理員的預設權限組。 + +*** + +## 設置權限 + +*** + +## 完整權限 + +*** + +#### `allow.ride.(Namespaced Key)` + +- **預設值**: `無` + +允許玩家蹲下並與實體互動以騎乘該實體。 + +騎乘實體後，可以使用`移動鍵`來控制實體移動，使用`跳躍鍵`來跳躍或飛行。 + +`(Namespaced Key)`是實體的[命名空間 ID](#user-content-fn-2)[^2]。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `allow.special.(Namespaced Key)` + +- **預設值**: `無` + +當玩家騎乘實體時，允許使用實體的特殊技能。 + +並非所有實體的特殊功能都可以使用。 請參閱下方可用的所有特殊技能。 + +{% hint style="info" %} +**특수 기술에 대한 좋은 아이디어가 있나요?** + +請在[Plazma Discord](https://plazmamc.org/discord)或[GitHub討論](https://github.com/PlazmaMC/PlazmaBukkit/discussions)上發布您的想法！ +{% endhint %} + +
+ +查看當前可用的特殊技能 + +- **`crepper`**\ + 按下`跳躍鍵`會爆炸。\ + 如果玩家擁有`allow.powered.creeper`權限，則可以長按`跳躍鍵`來充能。 +- **`dolphin`**\ + 按下`跳躍鍵`會衝刺。 +- **`phantom`**\ + 按下`跳躍鍵`會發射火焰。 +- **`wither`**\ + 與實體`互動`會發射凋零頭。 + +
+ +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `(Entity) > ridable`을 활성화 한 경우에만 작동합니다.** +{% endhint %} + +#### `bukkit.command.compass` + +- **預設值**: `世界管理員` + +允許使用[`/compass`指令](commands.md#compass)。 + +#### `bukkit.command.credits` + +- **預設值**: `世界管理員` + +允許使用[`/credits (Player)`指令](commands.md#credits)。 + +在權限名後加入`.other`，可以允許其他玩家使用。 + +#### `bukkit.command.demo` + +- **預設值**: `世界管理員` + +允許使用[`/demo (Player)`指令](commands.md#demo)。 + +在權限名後加入`.other`，可以允許其他玩家使用。 + +#### `bukkit.command.ping` + +- **預設值**: `世界管理員` + +允許使用[`/ping (Player)`指令](commands.md#ping)。 + +在權限名後加入`.other`，可以允許其他玩家使用。 + +#### `bukkit.command.ram` + +- **預設值**: `世界管理員` + +允許使用[`/ram`指令](commands.md#ram)。 + +#### `bukkit.command.rambar` + +- **預設值**: `世界管理員` + +允許使用[`/rambar (Player)`指令](commands.md#rambar)。 + +在權限名後加入`.other`，可以允許其他玩家使用。 + +#### `bukkit.command.restart` + +- **預設值**: `世界管理員` + +允許使用[`/restart`指令](commands.md#restart)。 + +#### `bukkit.command.tps` + +- **預設值**: `世界管理員` + +允許使用[`/tps`指令](commands.md#tps)。 + +#### `bukkit.command.tpsbar` + +- **預設值**: `世界管理員` + +允許使用[`/tpsbar (Player)`指令](commands.md#tpsbar)。 + +在權限名後加入`.other`，可以允許其他玩家使用。 + +#### `bukkit.command.timings` + +- **預設值**: `世界管理員` + +允許使用[`/timings`指令](commands.md#timings)。 + +{% hint style="warning" %} +**해당 명령어는 사용이 중단되었습니다.** + +要了解類似功能的指令，請查看[Spark](https://spark.lucko.me/docs/Command-Usage)。 +{% endhint %} + +#### `bukkit.command.uptime` + +- **預設值**: `世界管理員` + +允許使用[`/uptime`指令](commands.md#uptime)。 + +#### `minecraft.command.gamemode.(GameMode)` + +- **預設值**: `世界管理員` + +允許使用`/gamemode (GameMode) (Player)`指令。 + +在權限名後加入`.other`，可以允許其他玩家使用。 + +#### `paper.antixray.bypass` + +- **預設值**: `無` + +[X-Ray 차단](../expert/xray.md)이 활성화 되어 있는 경우, 권한이 등록된 플레이어에게는 X-Ray 차단용 블록 난독화를 진행하지 않습니다. + +這樣雙方都可以獲得性能提升。 + +> 要了解X射線設置方法，請參閱下方頁面。 + +{% content-ref url="../expert/xray.md" %} +[xray.md](../expert/xray.md) +{% endcontent-ref %} + +#### `plazma.bypass-moved-to-quickly-check` + +- **預設值**: `無` + +{% hint style="warning" %} +해당 권한은 1.20.5에서 `plazma.bypass.watchdog` 으로 변경될 예정입니다. +{% endhint %} + +#### `purpur.anvil.color` + +- **預設值**: `無` + +모루에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.format` + +- **預設值**: `無` + +모루에 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)을 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.minimessage` + +- **預設值**: `無` + +允許在鐵砧上使用[MiniMessage標籤](https://docs.advntr.dev/minimessage/format.html)。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-minimessages`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.anvil.remove_italics` + +- **預設值**: `無` + +모루에 [`&r` 스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)로 `글자 기울임`을 비활성화 할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `anvil > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.book.color.sign` + +- **預設值**: `無` + +플레이어가 책을 서명하면 [스타일링 코드](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)가 적용되도록 합니다. + +#### `purpur.bypassIdleKick` + +- **預設值**: `無` + +排除玩家不被視為閒置被踢出的對象。 + +#### `purpur.debug.f3n` + +- **預設值**: `世界管理員` + +允許玩家使用`F3 + N`鍵來更改遊戲模式。 + +如果沒有相應的遊戲模式權限，則將無法運作。 + +#### `purpur.drop.spawners` + +- **預設值**: `無` + +挖掘配置中設置的物品時，將掉落創造蛋。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.enderchest.rows.(NumberString)` + +- **預設值**: `無` + +更改終界箱的大小。 + +可以輸入`one`、`two`、`three`、`four`、`five`、`six`到`(NumberString)`。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `ender_chest > six-rows` 및 `ender_chest > use-permissions-for-rows`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.inventory_totem` + +- **預設值**: `無` + +即使擁有不死圖騰，也允許其正常運作。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `totem-of-undying-works-in-inventory`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.joinFullServer` + +- **預設值**: `無` + +允許玩家忽略連接人數限制。 + +#### `purpur.mending_shift_click` + +- **預設值**: `無` + +允許玩家進行`下蹲互動`以修復手持物品。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `shift-right-click-repairs-mending-points`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.place.spawners` + +- **預設值**: `無` + +允許玩家放置生成器。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `gameplay-mechanics > silk-touch`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.portal.instant` + +- **預設值**: `無` + +當玩家使用下界傳送門時立即傳送。 + +#### `purpur.sign.color` + +- **預設值**: `無` + +표지판에 [색 코드](https://minecraft.wiki/w/Formatting\_codes#Color\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.magic` + +- **預設值**: `無` + +允許在標誌上使用難讀碼`(&o)`。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.sign.style` + +- **預設值**: `無` + +표지판에 [스타일링 코드 `(&o 제외)`](https://minecraft.wiki/w/Formatting\_codes#Formatting\_codes)를 사용할 수 있도록 허용합니다. + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `sign > allow-colors`를 활성화 해야 작동합니다.** +{% endhint %} + +#### `purpur.tnt.defuse` + +- **預設值**: `無` + +允許玩家使用剪刀進行`互動`以阻止TNT爆炸。 + +{% hint style="info" %} +[**Purpur 세계별 구성**](configurations/purpur/world.md)**에서 `defuse-tnt-change`가 `0.0` 이상이어야 작동합니다.** +{% endhint %} + +### 預定權限 + +#### `plazma.bypass.ncr-require` + +- **預設值**: `無` + +允許玩家即使未安裝[`NoChatReports`](https://modrinth.com/mod/no-chat-reports)模組也可以登入。 + +{% hint style="info" %} +[**Plazma 세계별 구성**](configurations/plazma/world.md)**에서 `no-chat-reports > require-install`를 활성화 해야 작동합니다.** +{% endhint %} + +*** + +[^1]: 操作者。 + +[^2]: 例如：`ender_dragon` diff --git a/zh-TW/origin/plazma/adminstration/README.md b/zh-TW/origin/plazma/adminstration/README.md new file mode 100644 index 000000000..34af60cfa --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/README.md @@ -0,0 +1,5 @@ +--- +description: 利用 Plazma 創建自己的服務器。 +--- + +# ⚒️ 伺服器管理指南 diff --git a/zh-TW/origin/plazma/adminstration/can-kao-zi-liao/README.md b/zh-TW/origin/plazma/adminstration/can-kao-zi-liao/README.md new file mode 100644 index 000000000..a95d856ec --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/can-kao-zi-liao/README.md @@ -0,0 +1,2 @@ +# 📜 參考資料 + diff --git a/zh-TW/origin/plazma/adminstration/can-kao-zi-liao/she-ding-wen-jian/README.md b/zh-TW/origin/plazma/adminstration/can-kao-zi-liao/she-ding-wen-jian/README.md new file mode 100644 index 000000000..33e649bb7 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/can-kao-zi-liao/she-ding-wen-jian/README.md @@ -0,0 +1,2 @@ +# 🎨 設定文件 + diff --git a/zh-TW/origin/plazma/adminstration/expert/README.md b/zh-TW/origin/plazma/adminstration/expert/README.md new file mode 100644 index 000000000..678cb1bf0 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/expert/README.md @@ -0,0 +1,5 @@ +--- +description: 了解專業處理Plazma的方法。 +--- + +# 🎓 深化 diff --git a/zh-TW/origin/plazma/adminstration/expert/fix-exploits.md b/zh-TW/origin/plazma/adminstration/expert/fix-exploits.md new file mode 100644 index 000000000..dda4d6eb7 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/expert/fix-exploits.md @@ -0,0 +1,5 @@ +--- +description: 了解已知漏洞及其解决方法。 +--- + +# ⚠️ 已知漏洞及解決方法 diff --git a/zh-TW/origin/plazma/adminstration/expert/optimize.md b/zh-TW/origin/plazma/adminstration/expert/optimize.md new file mode 100644 index 000000000..8cfb33c4b --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/expert/optimize.md @@ -0,0 +1,5 @@ +--- +description: 了解如何優化Plazma。 +--- + +# 🧹 優化 diff --git a/zh-TW/origin/plazma/adminstration/expert/vanillaize.md b/zh-TW/origin/plazma/adminstration/expert/vanillaize.md new file mode 100644 index 000000000..b51eeb0b7 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/expert/vanillaize.md @@ -0,0 +1,14 @@ +--- +description: 了解如何恢復Paper和Vanilla的補丁。 +--- + +# ↩️ 讓它變成Vanilla + +{% hint style="warning" %} + +### Paper沒有在大多數Vanilla修補程序中提供選擇。 + +目前Plazma正在開發使這些錯誤修復配置失效的功能。 + +因此，本指南仍在撰寫中，信息隨時可能更改。 +{% endhint %} diff --git a/zh-TW/origin/plazma/adminstration/faq.md b/zh-TW/origin/plazma/adminstration/faq.md new file mode 100644 index 000000000..68320b5c6 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/faq.md @@ -0,0 +1,43 @@ +--- +description: 瞭解常見問題。 +--- + +# ⁉️ 常見問題 + +{% hint style="info" %} + +### 找不到想要的答案嗎？ + +[官方 Discord 伺服器](https://discord.gg/MmfC52K8A8) 或 [GitHub Issues](https://github.com/PlazmaMC/PlazmaBukkit/issues) 向社區提問！ +{% endhint %} + +### 執行時顯示訊息但未執行 + +如果在控制台上輸出`no main manifest attribute, in plazma-(version).jar`，\ +下載的文件是開發API文件，應該從GitHub頁面下載**Reobf Paperweight**。 + +請參考以下頁面以獲得詳細資訊。 + +{% content-ref url="getting-started/" %} +[getting-started](getting-started#id-2) +{% endcontent-ref %} + +### 每次啟動伺服器時都會顯示警告 + +Plazma包含一些不穩定的修補程式，因此可能會總是在伺服器啟動時輸出以下警告訊息。 + +```log +[12:34:56 WARN]: Warning! Plazma may cause unexpected problems, so be sure to test it thoroughly before using it on a public server. +``` + +可以使用[`-DPlazma.iKnowWhatIAmDoing`](#user-content-fn-1)[^1]系統屬性來停用此警告訊息。 + +請參考以下頁面以獲得詳細資訊。 + +{% content-ref url="reference/arguments.md" %} +[arguments.md](reference/arguments.md#plazma.iknowwhatiamdoing) +{% endcontent-ref %} + +*** + +[^1]: 從1.20.1版本開始可用 diff --git a/zh-TW/origin/plazma/adminstration/getting-started/README.md b/zh-TW/origin/plazma/adminstration/getting-started/README.md new file mode 100644 index 000000000..e0b6ef775 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/getting-started/README.md @@ -0,0 +1,320 @@ +--- +description: 請了解如何使用Plazma創建服務器。 +--- + +# 👟 開始 + +為了穩定使用Plazma，系統必須滿足以下要求。 + +| | 最低 | 建議 | +| :--: | --: | ---: | +| 架構 | x64 | - | +| RAM | 8GB | 16GB | +| 儲存空間 | 1GB | 8GB | +| JRE | 17 | 21 | + +為了方便進行配置文件修改，建議安裝類似[Visual Studio Code](https://code.visualstudio.com/download)的編輯器。 + +*** + +## 1. 安裝JRE + +正如名稱所示，Minecraft: **"Java"** Edition是使用Java開發的，為了運行，需要JRE[^1]。 + +由於Plazma是基於Mojang Studios的官方服務器平台[^2]，要使用Plazma也需要安裝JRE。 + +### 1.1 確認JRE是否已安裝 + +要檢查系統是否已安裝JRE，請在\[執行]視窗中輸入[`cmd /k java --version`](#user-content-fn-4)[^4]並運行。 + +如果輸出如下，請跳至[第2步](setup.md#id-2)。 + +{% code title="正確輸出" overflow="wrap" lineNumbers="true" %} + +```log +openjdk 21.0.2 2024-01-16 LTS +OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS) +OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing) +``` + +{% endcode %} + +如果輸出不符合上述要求，或者如下所示，則表示JRE不存在或者太舊，需要執行[1.2步驟](setup.md#id-1.2)。 + +{% code title="JRE未安裝" overflow="wrap" lineNumbers="true" %} + +```log +'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 +배치 파일이 아닙니다. +``` + +{% endcode %} + +{% code title="JRE太舊" overflow="wrap" lineNumbers="true" %} + +```log +Unrecognized option: --version +Error: Could not create the Java Virtual Machine. +Error: A fatal exception has occurred. Program will exit. +``` + +{% endcode %} + +### 1.2 安裝JRE + +本指南將使用Azul Zulu作為JRE的一種[類型](#user-content-fn-5)[^5]。 + +安裝完成後，請重新執行[1.1步驟](setup.md#id-1.1)以確認安裝是否成功。 + +{% tabs %} +{% tab title="Windows" %} + +1. 首先，從[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=windows\&architecture=x86-64-bit\&package=jdk#zulu)下載**JDK 21**的`.msi`安裝程序。 +2. 運行下載的安裝精靈，然後點擊“下一步”。 +3. 在左上角的菜單中啟用`Set JAVA_HOME variable`，然後點擊“下一步”。 +4. 點擊“安裝”完成JRE的安裝。 + {% endtab %} + +{% tab title="macOS" %} +從[Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts\&os=macos\&architecture=x86-64-bit\&package=jdk#zulu)下載**JDK 21**的`.dmg`安裝程序，然後運行以安裝JRE。 +{% endtab %} + +{% tab title="Debian/Ubuntu" %} +首先，在終端中執行以下命令以將Azul Zulu存儲庫添加到APT。 + +```bash +sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y + +curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg + +echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list +``` + +然後，執行以下命令以安裝JRE。 + +```bash +sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless +``` + +{% endtab %} + +{% tab title="Fedora/RHEL" %} +輸入以下命令即可安裝JRE。 + +```bash +sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm + +sudo dnf install -y zulu21-ca-jre-headless +``` + +{% endtab %} +{% endtabs %} + +*** + +## 2. 下載Plazma + +Plazma提供多種形式的執行文件。 + +{% hint style="warning" %} + +### 通常情況下，使用`Reobf Paperclip`。 + +以下內容供開發人員或對各種形式感興趣的人參考。\ +如果是一般用戶，可以跳過到[第3步](setup.md#id-3)。 +{% endhint %} + +
+ +了解更多 + +執行文件名為`plazma-(版本管理者)-1.20.4-R0.1-SNAPSHOT-(映射形式).jar`。 + +- **映射形式**\ + 映射是將Minecraft的實際代碼與混淆代碼連接起來的一種地圖。 + - **Reobf**\ + 重新混淆，也稱為Spigot映射，在大多數NMS插件中使用。\ + 從1.20.5開始將停止使用。 + - **Mojmap**\ + Mojang映射，原始Minecraft映射。 +- **版本管理者**\ + 版本管理者是運行服務器所需的庫和修補服務器文件的啟動器。 + - **Paperclip**\ + 由PaperMC團隊為Paper和其他衍生平台開發的管理者，負責下載庫並應用修補到服務器。 + - **Bundler**\ + 原始Minecraft版本管理者。 + +
+ +*** + +## 3. 創建啟動腳本 + +要簡單啟動Plazma並自動重新啟動服務器，需要創建[啟動腳本](#user-content-fn-6)[^6]。 + +可以透過[Flags.sh](https://flags.sh)來生成啟動腳本。\ +只需輸入要用於Plazma的[記憶體](#user-content-fn-8)[^8]，命令將自動優化。 + +通過左下角的下載按鈕下載啟動腳本。\ +**請確認下載的啟動腳本與您的操作系統相符。** + +*** + +## 4. 整理文件 + +現在將下載的啟動腳本和Plazma移動到新文件夾中。 + +{% hint style="warning" %} + +### 文件夾名稱必須沒有空格並且必須用英文設置。 + +否則，Plazma或JRE可能無法正常運作。 +{% endhint %} + +現在執行啟動腳本。 對於Windows，在防火牆允許選擇窗口中，必須 選擇**允許**。 + +*** + +## 5. EULA同意 + +執行啟動腳本後，文件夾中將生成`eula.txt`。 + +EULA[^9]是使用Mojang Studios的服務時必須同意的使用權協議。 + +如果不同意EULA，將無法啟動服務器，並且違反EULA可能導致帳戶被凍結等[懲罰](#user-content-fn-11)[^11]。 + +要同意EULA，請將`eula.txt`文件中的`eula=false`修改為`eula=true`，然後保存。 + +*** + +## 6. 允許外部訪問（Windows） + +現代操作系統通常會阻止外部訪問以防止危險訪問。 + +對於Windows，由於在[第3步](setup.md#id-3)中已經允許防火牆，因此僅需進行端口轉發。 + +{% hint style="info" %} + +### 本指南假設使用Windows操作系統和[**UPnP**](#user-content-fn-12)[^12]可用的路由器。 + +如果路由器不支持UPnP，則由於每個路由器的面板不同，您需要自行查找信息。 + +或者可以使用[Ngrok](https://ngrok.com/)生成臨時地址。 +{% endhint %} + +{% hint style="warning" %} + +### 對於Linux或macOS等（準）UNIX系統，由於每個防火牆服務的設置方法不同，您需要自行查找信息。 + +{% endhint %} + +### 6.1 檢查是否需要端口轉發 + +輸入以下命令並運行。 + +```batch +powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content" +``` + +如果輸出為`True`，則可以結束，否則需要設置端口轉發。 + +### 6.2 連接到服務器 + +{% tabs %} +{% tab title="外部訪問" %} +如果無需端口轉發，或者已經成功設置了端口轉發，現在可以連接到服務器。 + +連接到伺服器時使用的地址可以在[這裡](https://ip.pe.kr/)找到。 +{% endtab %} + +{% tab title="嘗試使用UPnP進行端口轉發" %} +在伺服器資料夾的`purpur.yml`中，將`network.upnp-port-forwarding`設置為`true`以啟用。 + +然後重新啟動伺服器，Plazma將自動嘗試進行端口轉發。 + +以下是根據控制台輸出的消息來判斷UPnP是否成功，控制台將顯示類似`[UPnP]（消息）`的消息。 + +| 消息 | 意義 | +| ------------ | ------------ | +| `成功打開端口（端口）` | 端口轉發成功。 | +| `端口（端口）已打開` | 另一服務正在使用該端口。 | +| `無法打開端口（端口）` | 端口轉發失敗。 | +| `服務不可用` | 路由器不支援UPnP。 | + +當伺服器關閉時，Plazma會自動關閉埠。 +{% endtab %} + +{% tab title="使用Ngrok建立臨時地址" %} +使用Ngrok的方法非常適合進行短期測試、參與或與朋友一起玩遊戲。 + +1. 從[Ngrok官網](https://ngrok.com/download)下載 `Windows (64-bit)` ZIP檔案。 +2. 將下載的Ngrok放入伺服器資料夾中。 +3. 在[Ngrok儀表板](https://dashboard.ngrok.com/get-started/your-authtoken)上生成[授權令牌](#user-content-fn-13)[^13]。 +4. 在伺服器資料夾中執行顯示在下方`Command Line`的命令。 +5. 在執行腳本的最上方添加 `start /b ngrok tcp --region jp 25565`，在最底部添加 `taskkill /f /t /im ngrok.exe`。 +6. 在控制台頂部顯示的 `Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565` 中，`0.tcp.jp.ngrok.io:12345`將成為伺服器的地址。 +7. 現在您可以通過該地址從外部訪問。 + {% endtab %} + +{% tab title="從本地訪問" %} +如果您想從本地訪問伺服器，在執行窗口中執行 `cmd /k ipconfig`，使用輸出的 `IPv4地址` 進行連接。 + +例如，當執行命令後，輸出如下： + +```log +Windows IP 구성 + +이더넷 어댑터 이더넷: + + 연결된 DNS 접미사. . . . : + IPv4 주소. . . . . . . . . : 192.168.3.7 + 서브넷 마스크 . . . . . . . : 255.255.255.0 + 기본 게이트웨이 . . . . . . : 192.168.3.1 + +``` + +在此，您可以嘗試使用IPv4地址中顯示的 `192.168.3.7` 進行本地伺服器連接。 + +如果伺服器和遊戲在同一台PC上運行，則可以使用 `localhost` 進行連接。 +{% endtab %} +{% endtabs %} + +## 7. 進階階段 + +如果伺服器成功啟動並正常運行，現在輪到您自定義伺服器了。 + +通過以下指南了解如何自定義伺服器。 + +{% content-ref url="customization.md" %} +[customization.md](customization.md) +{% endcontent-ref %} + +*** + +[^1]: Java執行環境，Java執行環境。 + +[^2]: Plazma基於Spigot，而Spigot基於官方伺服器平台。 + +[^3]: Windows鍵 + R + +[^4]: 對於Linux，可以在終端中運行 `java --version`。 + +[^5]: JRE是一個開源項目，類似Minecraft伺服器平台，有多種類型。 + +[^6]: 通常被稱為**運行器**。 + +[^7]: 啟用"自動重新啟動"後，伺服器將自動重新啟動。 您可以輸入`Control + C`來結束。 + +[^8]: 不建議超過系統的一半。 + + 例如，如果系統的總記憶體容量為8GB，則不建議設置超過4GB。 + +[^9]: 最終用戶許可協議，最終使用者授權協議。 請查看[Minecraft官網](https://www.minecraft.net/ko-kr/usage-guidelines)以獲得詳細信息。 + +[^10]: Microsoft Corporation。 + +[^11]: 根據韓國遊戲產業促進法第32條第1項第9號，**韓國微軟**可以根據法律提出訴訟。 + +[^12]: 通用即插即用。 Plazma附帶的Purpur通過這項技術與路由器自動通信，僅在伺服器運行時打開埠，因此無需直接進行埠轉發。 + +[^13]: 如果沒有帳戶，可以使用Google或GitHub帳戶註冊Ngrok。 diff --git a/zh-TW/origin/plazma/adminstration/getting-started/customization.md b/zh-TW/origin/plazma/adminstration/getting-started/customization.md new file mode 100644 index 000000000..abf422a34 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/getting-started/customization.md @@ -0,0 +1,5 @@ +--- +description: 瞭解如何自訂伺服器。 +--- + +# 🎨 使用者化 diff --git a/zh-TW/origin/plazma/adminstration/reference/arguments.md b/zh-TW/origin/plazma/adminstration/reference/arguments.md new file mode 100644 index 000000000..b75db5496 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/arguments.md @@ -0,0 +1,525 @@ +--- +description: 了解启动参数和系统属性。 +--- + +# 🎛️ 启动参数和属性 + +启动变量和系统属性是附加到Plazma执行中使用的命令[^1]的值，\ +允许更改无法在Plazma执行后更改的值。 + +根据[添加到命令的位置](#user-content-fn-2)[^2]，将分为**启动参数**和**系统属性**。 + +*** + +## 系统属性 + +系统属性是在`-jar`之前输入的值，在Plazma初始化之前由JVM处理。 + +{% hint style="warning" %} + +### 修改系统属性可能会改变Plazma和JVM的运行方式，并可能对游戏产生重大影响！ + +如果不确定每个系统属性的作用，请**绝对不要使用！** +{% endhint %} + +### 使用方法 + +系统属性作为Java命令参数输入在`java`和`-jar`之间。 + +例如，要应用`Plazma.dummyProperty`系统属性，\ +输入如下将在下一个属性中输入`37`以初始化Plazma。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...) +``` + +`-D`表示该参数不是JVM内置的，而是添加到Plazma的专用参数， + +如果没有输入任何值，则该值将固定为[`true`。](#user-content-fn-3)[^3] + +{% hint style="info" %} + +### Paperweight系列服务器平台为区分每个平台的系统属性在属性名称中包含`.`。 + +在Windows Powershell等某些终端中，可能不允许这些参数，因此必须在参数两端添加`"`。[添加。](#user-content-fn-4)[^4] +{% endhint %} + +### 全部系统属性 + +#### `convertLegacySigns` + +- **类型**: `布尔值` +- **默认值**: `False` + +更新停用的标志格式。 + +#### `debug.entities` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用与实体信息相关的调试日志。 + +#### `debug.rewriteForIDE` + +- **类型**: `布尔值` +- **默认值**: `False` + +为了正确加载IDE中的调试信息，禁用NMS修订，并自动重新映射内部版本信息。 + +#### `disable.watchdog` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Spigot的看门狗警告系统。 + +#### `letMeReload` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用`/reload`命令的重新加载消息。 + +{% hint style="danger" %} + +### 由于`/reload`命令非常不稳定，因此在使用`/reload`后出现的所有服务器问题由用户自行承担。 + +如果您是插件开发人员并且需要更新插件，请使用热交换而不是`/reload`。 +{% endhint %} + +#### `io.papermc.paper.suppress.sout.nags` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用使用标准输入输出系统的插件。 + +#### `net.kyori.adventure.text.warnWhenLegacyFormattingDetected` + +- **类型**: `布尔值` +- **默认值**: `False` + +检测到聊天组件中已停用的格式时发出警告。 + +#### `Paper.bypassHostCheck` + +- **类型**: `布尔值` +- **默认值**: `False` + +连接到服务器时禁用服务器的主机检查。 + +#### `Paper.debugDynamicMissingKeys` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对NBT对象中丢失键的调试日志。 + +#### `Paper.debugInvalidSkullProfiles` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用对具有无效头骨配置文件的调试日志。 + +这将记录世界中所有无效的头骨配置文件及其位置。 + +#### `Paper.disableChannelLimit` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用每个玩家的应用于128个插件频道[^5]的限制数。 + +#### `Paper.disableClassPrioritization` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用插件类优先级系统。 + +在插件Shade中遇到问题时很有用。 + +#### `Paper.disableFlushConsolidate` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Netty刷新合并系统。 + +#### `Paper.excessiveTELimit` + +- **类型**: `整数` +- **默认值**: `750` + +如果实体超过设置的值，则将其分割为多个数据包进行传输。 + +#### `Paper.filterThreshold` + +- **类型**: `整数` +- **默认值**: `8192` + +设置服务器一次接收的最大数据包大小。 + +#### `Paper.ignoreJavaVersion` + +- **类型**: `布尔值` +- **默认值**: `False` + +禁用Java版本检查。 + +{% hint style="danger" %} + +### 这将允许JVM尝试访问不存在的代码！ + +可能会永久损坏世界等文件，并破坏游戏的整个机制。 + +由此产生的所有问题由用户承担，Plamza不提供任何支持。 +{% endhint %} + +#### `Paper.maxCustomChannelName` + +- **类型**: `整数` +- **默认值**: `64` + +设置插件频道[^6]名称的限制。 + +#### `Paper.maxSignLength` + +- **类型**: `整数` +- **默认值**: `80` + +设置牌子一行中可以输入的最大字符数。 + +#### `Paper.minPrecachedDatafixVersion` + +- **类型**: `整数` +- **默认值**: `(世界版本) + 1` + +设置要首先初始化的世界更新信息的版本。 + +对于需要大量更新的区块很有用，但在其他情况下不使用。 + +#### `Paper.parseYamlCommentsByDefault` + +- **类型**: `布尔值` +- **默认值**: `True` + +启用处理YAML文件注释。 + +#### `Paper.playerConnection.keepAlive` + +- **类型**: `整数` +- **默认值**: `30` + +当玩家在输入值（秒）后未收到任何数据时，将踢出玩家。 + +通常，游戏[^7]会继续向服务器发送[心跳信号](#user-content-fn-8)[^8]，因此[不会被踢出，](#user-content-fn-9)[^9]但如果游戏不响应，则被视为游戏崩溃并不再处理玩家并将其踢出。 + +#### `Paper.skipServerPropertiesComments` + +- **类型**: `布尔值` +- **默认值**: `False` + +忽略服务器属性的注释。 + +#### `Paper.debug-sync-loads` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用同步区块写入的调试日志。 + +#### `Paper.enable-sync-chunk-writes` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用Minecraft的[默认区块写入系统](#user-content-fn-10)[^10]。 + +这将按顺序保存每个区块，导致严重的性能下降。 + +#### `Paper.explicit-flush` + +- **类型**: `布尔值` +- **默认值**: `False` + +启用网络通道的显式刷新。 + +#### `Paper.strict-thread-checks` + +- **类型**: `布尔值` +- **默认值**: `False` + +始终记录在主线程之外发生的错误。 + +#### `Paper.tickList-warn-on-excessive-delay` + +- **类型**: `布尔值` +- **默认值**: `False` + +如果预定任务具有过多等待时间，则输出警告。 + +#### `Paperclip.patchOnly` + +- **类型**: `布尔值` +- **默认值**: `False` + +使用默认提供的执行文件时，仅应用补丁而不启动服务器。 + +#### `Plazma.aggressiveOptimize` + +- **类型**: `布尔值` +- **默认值**: `false` + +{% hint style="warning" %} + +### 该属性将在1.20.5之后移至启动参数。 + +{% endhint %} + +对应用于初始启动的配置进行更严格的优化。 + +啟用後，伺服器將變得更快速且更安全，但可能會阻止某些功能或對遊戲遊玩造成重大影響。 + +#### `Plazma.iKnowWhatIAmDoing` + +- **类型**: `布尔值` +- **默认值**: `false` + +抑制在Plazma初始化時顯示的警告[^11]。 + +### 已停用屬性 + +以下系統屬性已停用。 + +#### `timings.bypassMax` + +- **类型**: `布尔值` +- **默认值**: `false` +- **已停用**: Timings自Plazma中完全移除後 + +決定是否可以超過Aikar的Timings API可接受的最大值。 + +即使這樣做，如果API未處理異常，將應用速率限制。 + +*** + +## 起始引數 + +起始引數被輸入在 `-jar *.jar` 之後，Plazma將初始化並處理一起處理的值。 + +### 用法 + +系統屬性被輸入為 `-jar *.jar` 之後的程序命令引數。 + +例如，如果要應用 `nogui` 起始引數，\ +輸入以下內容將使Plazma在初始化期間處理 `nogui` 引數。 + +```batch +java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...) +``` + +### 完整起始引數 + +#### `bukkit-settings` + +- **別名**: `b` +- **預設值**: `bukkit.yml` + +設置[Bukkit配置文件](../reference/configurations/bukkit.md)的名稱和位置。 + +#### `command-settings` + +- **別名**: `c` +- **預設值**: `commands.yml` + +設置[Bukkit命令配置文件](../reference/configurations/bukkit.md)的名稱和位置。 + +#### `config` + +- **別名**: `c` +- **預設值**: `server.properties` + +設置[服務器屬性](../reference/configurations/property.md)文件的名稱和位置。 + +#### `demo` + +啟動服務器到演示世界。 + +#### `eraseCache` + +刪除升級後剩餘的快取文件。 + +#### `forceUpgrade` + +忽略版本並強制升級世界[^12]。 + +#### `help` + +- **別名**: `?` + +顯示Plazma的完整啟動引數和說明。 + +#### `initSettings` + +僅生成配置文件並關閉服務器。 + +#### `jfrProfile` + +啟用JFR配置。 + +#### `max-players` + +- **別名**: `s`, `size` +- **預設值**: `(服務器屬性)` + +設置允許的最大[玩家](#user-content-fn-14)[^14]數。 + +#### `nogui` + +禁用圖形界面面板。 + +#### `nojline` + +禁用JLine並使用原始控制台。 + +#### `online-mode` + +- **別名**: `o` +- **預設值**: `(服務器屬性)` + +選擇是否要通過Mojang驗證服務器驗證玩家。 + +**如果不使用Velocity等代理，可能會因違反[EULA](../getting-started/README.md#id-5)而受到制裁。** + +#### `paper-settings` + +- **別名**: `paper` +- **預設值**: `paper.yml` + +{% hint style="warning" %} + +### 此引數在1.19.4之後停用 + +{% endhint %} + +設置停用的PaperSpigot配置文件位置。 + +這是為了將現有配置轉移到新配置文件而使用的，之後將不再使用。 + +#### `paper-settings-directory` + +- **別名**: `paper-dir` +- **預設值**: `config` + +設置[Paper配置文件](../reference/configurations/paper/README.md)所在的文件夾名稱和位置。 + +#### `plazma-settings-directory` + +- **別名**: `plazma-dir` + +設置[Plazma配置文件](../reference/configurations/plazma/README.md)所在的文件夾名稱和位置。 + +#### `plugins` + +- **別名**: `p` +- **預設值**: `plugins` + +設置插件文件夾的位置。 + +#### `pufferfish-settings` + +- **別名**: `pufferfish` +- **預設值**: `pufferfish.yml` + +設置[Pufferfish配置文件](../reference/configurations/pufferfish.md)的名稱和位置。 + +#### `purpur-settings` + +- **別名**: `purpur` +- **預設值**: `purpur.yml` + +設置[Purpur配置文件](../reference/configurations/purpur/README.md)的名稱和位置。 + +#### `safeMode` + +以完全原始狀態啟動服務器（安全模式）。 + +#### `server-ip` + +- **別名**: `h`, `host` +- **預設值**: `(服務器屬性)` + +設置服務器的主機名稱或[互聯網協議](#user-content-fn-13)[^13]地址。 + +#### `server-port` + +- **別名**: `p`, `port` +- **預設值**: `(服務器屬性)` + +設置服務器的端口。 + +#### `server-name` + +- **預設值**: `A Plazma Server` + +設置服務器的名稱。 + +#### `spigot-settings` + +- **別名**: `S` +- **預設值**: `spigot.yml` + +設置[Spigot配置文件](../reference/configurations/spigot.md)的名稱和位置。 + +#### `version` + +- **別名**: `v` + +顯示Plazma版本。 + +#### `world-dir` + +- **別名**: `W`, `universe`, `world-container` +- **預設值**: `(服務器文件夾)` + +設置存儲世界文件的位置。 + +#### `world-name` + +- **別名**: `w`, `world` +- **預設值**: `(服務器屬性)` + +設置世界文件的名稱。 + +*** + +[^1]: `java (...) -jar server.jar (...)` + +[^2]: 根據附加位置處理引數的位置會發生變化。 + +[^3]: 例如，如果要將 `Plazma.iKnowWhatIAmDoing` 設置為 `true`（啟用），則只需輸入 `-DPlazma.iKnowWhatIAmDoing` 與 `-DPlazma.iKnowWhatIAmDoing=true` 相同。 + +[^4]: 例如，`"-DPlazma.iKnowWhatIAmDoing"` + +[^5]: 事件偵測器。 + +[^6]: 事件偵測器。 + +[^7]: 客戶端。 + +[^8]: 像心跳一樣向伺服器發送連接正常的信號。 + +[^9]: 使用Purpur的AFK踢出功能，即使玩家離開也可以進行踢出。 + +[^10]: 同步區塊寫入系統，Sync Chunk Write System。 + +[^11]: \`警告！ Plazma可能會導致意外問題，所以請務必在將其用於公共伺服器之前進行全面測試。 + +[^12]: 在遊戲中，`世界優化` 也遵循這個原則。 + +[^13]: 網際網路協定，IP。 + +[^14]: 管理員排除`等級2`以上。 diff --git a/zh-TW/origin/plazma/adminstration/reference/commands.md b/zh-TW/origin/plazma/adminstration/reference/commands.md new file mode 100644 index 000000000..17ec97feb --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/commands.md @@ -0,0 +1,5 @@ +--- +description: 了解在Plazma中可用的命令。 +--- + +# 🖥️ 命令 diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/bukkit.md b/zh-TW/origin/plazma/adminstration/reference/configurations/bukkit.md new file mode 100644 index 000000000..04658aa9d --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/bukkit.md @@ -0,0 +1,5 @@ +--- +description: 了解bukkit.yml中每个节点的含义。 +--- + +# 🪣 Bukkit diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/paper/README.md b/zh-TW/origin/plazma/adminstration/reference/configurations/paper/README.md new file mode 100644 index 000000000..754321a3b --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/paper/README.md @@ -0,0 +1,5 @@ +--- +description: 瞭解每個config文件夾中文件的用途。 +--- + +# 🛩️ 紙 diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/paper/global.md b/zh-TW/origin/plazma/adminstration/reference/configurations/paper/global.md new file mode 100644 index 000000000..b485ab3d8 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/paper/global.md @@ -0,0 +1,5 @@ +--- +description: 查看paper-global.yml的每個節點代表什麼。 +--- + +# 🛩️ 紙（全球配置） diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/paper/world.md b/zh-TW/origin/plazma/adminstration/reference/configurations/paper/world.md new file mode 100644 index 000000000..1e3823cb3 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/paper/world.md @@ -0,0 +1,5 @@ +--- +description: 了解每个节点在paper-world.yml中代表什么。 +--- + +# 🛩️ 紙（世界組成） diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/README.md b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/README.md new file mode 100644 index 000000000..ba75676fa --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/README.md @@ -0,0 +1,5 @@ +--- +description: 瞭解每個config文件夾中文件的用途。 +--- + +# ✨ Plazma diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/global.md b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/global.md new file mode 100644 index 000000000..9eba80d59 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/global.md @@ -0,0 +1,5 @@ +--- +description: 查看plazma-global.yml的每個節點代表什麼。 +--- + +# ✨ Plazma (全局配置) diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/undefined.md b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/undefined.md new file mode 100644 index 000000000..3b68226f7 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/undefined.md @@ -0,0 +1 @@ +# 🏳️ 世界各地組成 diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/worlds.md b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/worlds.md new file mode 100644 index 000000000..bb226a1f9 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/plazma/worlds.md @@ -0,0 +1,5 @@ +--- +description: 查看每个节点在plazma-world.yml中代表什么。 +--- + +# ✨ Plazma (世界構成) diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/property.md b/zh-TW/origin/plazma/adminstration/reference/configurations/property.md new file mode 100644 index 000000000..60fd6b359 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/property.md @@ -0,0 +1,5 @@ +--- +description: 查看每個節點在 server.properties 中代表什麼。 +--- + +# 🪨 Server.properties diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/pufferfish.md b/zh-TW/origin/plazma/adminstration/reference/configurations/pufferfish.md new file mode 100644 index 000000000..ae30219b9 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/pufferfish.md @@ -0,0 +1,5 @@ +--- +description: pufferfish.yml的每個節點代表什麼？ +--- + +# 🐡 河豚 diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/README.md b/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/README.md new file mode 100644 index 000000000..c9e68beff --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/README.md @@ -0,0 +1,5 @@ +--- +description: 了解purpur.yml中每个节点的含义。 +--- + +# 🦑 Purpur diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/global.md b/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/global.md new file mode 100644 index 000000000..ddd7c24b6 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/global.md @@ -0,0 +1,5 @@ +--- +description: 了解purpur.yml中每个节点的含义。 +--- + +# 🦑 Purpur (全球構成) diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/world.md b/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/world.md new file mode 100644 index 000000000..4f77ad06d --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/purpur/world.md @@ -0,0 +1,5 @@ +--- +description: 了解purpur.yml中每个节点的含义。 +--- + +# 🦑 Purpur (世界範圍組織) diff --git a/zh-TW/origin/plazma/adminstration/reference/configurations/spigot.md b/zh-TW/origin/plazma/adminstration/reference/configurations/spigot.md new file mode 100644 index 000000000..e45a0ffb7 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/configurations/spigot.md @@ -0,0 +1,5 @@ +--- +description: 了解每個spigot.yml節點的含義。 +--- + +# 🚰 Spigot diff --git a/zh-TW/origin/plazma/adminstration/reference/permissions.md b/zh-TW/origin/plazma/adminstration/reference/permissions.md new file mode 100644 index 000000000..ebec99f70 --- /dev/null +++ b/zh-TW/origin/plazma/adminstration/reference/permissions.md @@ -0,0 +1,5 @@ +--- +description: 了解Plazma的權限。 +--- + +# 🛡️ 權限 diff --git a/zh-TW/origin/plazma/developers.md b/zh-TW/origin/plazma/developers.md new file mode 100644 index 000000000..b442b8dd9 --- /dev/null +++ b/zh-TW/origin/plazma/developers.md @@ -0,0 +1,5 @@ +--- +description: 利用 Plazma 開發第三方項目。 +--- + +# ⚙️ 開發者指南 diff --git a/zh-TW/origin/thunderbolt/README.md b/zh-TW/origin/thunderbolt/README.md new file mode 100644 index 000000000..d10afb69a --- /dev/null +++ b/zh-TW/origin/thunderbolt/README.md @@ -0,0 +1,5 @@ +--- +description: Thunderbolt是一個基於Plazma的伺服器平台，它將實驗性的補丁分為Flavor，讓用戶可以直接使用。 +--- + +# 🌩️ Thunderbolt使用指南 diff --git a/zh-TW/origin/volt/README.md b/zh-TW/origin/volt/README.md new file mode 100644 index 000000000..93eed6057 --- /dev/null +++ b/zh-TW/origin/volt/README.md @@ -0,0 +1,5 @@ +--- +description: Volt是一個基於Plazma開發自己的Paperweight伺服器平台的開源模板。 +--- + +# ⚡ Volt 開發指南