Skip to content

Commit 06ba5d3

Browse files
Dreeam-qwqPascalpex
Dreeam-qwq
and
Pascalpex
authored
Sync leaf config description (#41)
* Init * Complete config description * Translate new settings --------- Co-authored-by: Pascalpex <pascalpex@gmail.com>
1 parent bf83826 commit 06ba5d3

3 files changed

Lines changed: 258 additions & 9 deletions

File tree

‎pages/de/docs/config/data/leaf-global-latest.ts‎

Lines changed: 86 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,20 @@ const config: ConfigRoot = {
157157
__⚡Empfohlener Wert: \`true\`__`
158158
}
159159
},
160+
"despawn-time": {
161+
"proactive-weak-loading-despawn": {
162+
default: false,
163+
desc: `Ob die proaktive Despawn-Prüfung für weak-loaded Entities aktiviert werden soll.<br>
164+
Dies kann helfen, Lag zu reduzieren, der durch das Laden und Ticking einer großen Menge angesammelter Entities in weak-loaded Chunks verursacht wird.<br>
165+
<br>
166+
__⚡Empfohlener Wert: \`true\`__<br>
167+
<br>
168+
<div class="warning custom-block">
169+
<p class="custom-block-title custom-block-title-default">Experimentell</p>
170+
Experimentelles Feature, das aktiv getestet wird. Bitte melde alle auftretenden Bugs.
171+
</div>`
172+
}
173+
},
160174
"dont-save-entity": {
161175
"dont-save-primed-tnt": {
162176
default: false,
@@ -239,6 +253,44 @@ const config: ConfigRoot = {
239253
<br>
240254
__⚡Empfohlener Wert: \`true\`__`
241255
},
256+
"entity-goal": {
257+
"start-tick-chance": {
258+
__desc__: `Wie oft die Startversuche für gewöhnliche Mob-Goals berechnet werden.<br>
259+
In Vanilla prüft das Goal jeden Tick, ob es starten kann. Durch das Erhöhen der untenstehenden Werte werden diese Prüfungen gedrosselt, was die Performance deutlich verbessern kann, aber kleinere Auswirkungen auf das Gameplay haben kann.<br>
260+
Wenn auf \`-1\` gesetzt, verhält sich die Tick-Frequenz wie in Vanilla.<br>
261+
<br>
262+
__⚡Empfohlene Werte:__
263+
<table>
264+
<thead><tr><th>Entity Goal</th><th>Start Tick Chance</th></tr></thead>
265+
<tbody>
266+
<tr><td>nearest-attackable-target</td><td>20</td></tr>
267+
<tr><td>follow-parent</td><td>20</td></tr>
268+
<tr><td>avoid-entity</td><td>20</td></tr>
269+
<tr><td>temptation</td><td>20</td></tr>
270+
<tr><td>enderman-look-for-player</td><td>20</td></tr>
271+
</tbody></table>`,
272+
"nearest-attackable-target": {
273+
default: -1,
274+
desc: "Wie oft das __nearest attackable target__ Goal versucht, für eine Entity zu starten."
275+
},
276+
"follow-parent": {
277+
default: -1,
278+
desc: "Wie oft das __follow parent__ Goal versucht, für eine Entity zu starten."
279+
},
280+
"avoid-entity": {
281+
default: -1,
282+
desc: "Wie oft das __avoid entity__ Goal versucht, für eine Entity zu starten."
283+
},
284+
temptation: {
285+
default: -1,
286+
desc: "Wie oft das __temptation__ Goal versucht, für eine Entity zu starten."
287+
},
288+
"enderman-look-for-player": {
289+
default: -1,
290+
desc: "Wie oft das __look for player__ Goal versucht, für einen Enderman zu starten."
291+
}
292+
}
293+
},
242294
"fast-biome-manager-seed-obfuscation": {
243295
enabled: {
244296
default: false,
@@ -306,6 +358,18 @@ const config: ConfigRoot = {
306358
Dies kann in seltenen Grenzfällen zu einer inkonsistenten Reihenfolge zukünftiger Compose-Tasks führen, was unterschiedliche Ergebnisse bei der Strukturgenerierung zur Folge haben kann.
307359
</div>`
308360
},
361+
"reuse-random-ticking-blockpos": {
362+
default: false,
363+
desc: `Ob ein Teil der blockpos-Instanz während des Random Block Tickings wiederverwendet werden soll.<br>
364+
Dies kann unnötige Speicherzuweisungen vermeiden und den GC-Overhead bei einer großen Menge an Random Block Ticking leicht reduzieren.<br>
365+
<br>
366+
__⚡Empfohlener Wert: \`false\`__<br>
367+
<br>
368+
<div class="warning custom-block">
369+
<p class="custom-block-title custom-block-title-default">Experimentell</p>
370+
Experimentelles Feature, das aktiv getestet wird. Es kann zu Konflikten mit einigen Plugins führen oder verursachen, dass Ticking-Positionen verschoben werden. Bitte mit Vorsicht verwenden und alle auftretenden Bugs melden.
371+
</div>`
372+
},
309373
"cache-biome": {
310374
enabled: {
311375
default: false,
@@ -595,9 +659,28 @@ const config: ConfigRoot = {
595659
}
596660
},
597661

598-
// fixes: {
599-
// __desc__: "Dieser Abschnitt enthält Bugfixes für spezifische Probleme.",
600-
// },
662+
fixes: {
663+
__desc__: "Dieser Abschnitt enthält Bugfixes für spezifische Probleme.",
664+
"prevent-moving-into-weak-loaded-chunks": {
665+
__desc__: "Ob verhindert werden soll, dass Entities sich in weak-loaded Chunks bewegen.",
666+
enabled: {
667+
default: false,
668+
desc: "Setze dies auf `true`, um die untenstehenden Optionen nutzen zu können."
669+
},
670+
projectiles: {
671+
default: false,
672+
desc: "Ob verhindert werden soll, dass Projektile sich in weak-loaded Chunks bewegen."
673+
}
674+
},
675+
"vanilla-bug-fix": {
676+
__desc__: "Dieser Abschnitt enthält Fixes für Vanilla Minecraft Bugs.",
677+
"mc-270656": {
678+
default: false,
679+
desc: `Ob die fehlerhafte Vergabe des \`Wer braucht schon Raketen?\` Advancements behoben werden soll.<br>
680+
Mojira-Link: [MC-270656](https://mojira.dev/MC-270656).`
681+
}
682+
}
683+
},
601684

602685
"gameplay-mechanisms": {
603686
__desc__: "Dieser Abschnitt enthält Funktionen, die die Spielmechanik modifizieren oder verbessern.",

‎pages/docs/config/data/leaf-global-latest.ts‎

Lines changed: 86 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,20 @@ const config: ConfigRoot = {
160160
__⚡Recommended value: \`true\`__`
161161
}
162162
},
163+
"despawn-time": {
164+
"proactive-weak-loading-despawn": {
165+
default: false,
166+
desc: `Whether to enable proactive despawn check for weak-loaded entities.<br>
167+
This can help reduce lag caused by loading and ticking a large amount of cumulative entities left in weak-loaded chunks.<br>
168+
<br>
169+
__⚡Recommended value: \`true\`__<br>
170+
<br>
171+
<div class="warning custom-block">
172+
<p class="custom-block-title custom-block-title-default">Experimental</p>
173+
Experimental feature, actively testing, please report any bugs you encounter.
174+
</div>`
175+
}
176+
},
163177
"dont-save-entity": {
164178
"dont-save-primed-tnt": {
165179
default: false,
@@ -242,6 +256,44 @@ const config: ConfigRoot = {
242256
<br>
243257
__⚡Recommended value: \`true\`__`
244258
},
259+
"entity-goal": {
260+
"start-tick-chance": {
261+
__desc__: `How often are the common mob goal attempts calculated.<br>
262+
In vanilla, the goal checks every tick whether the goal can start. By increasing the values below to throttle the checks, which can improve performance significantly, but may have minor gameplay implications.<br>
263+
If set to \`-1\`, it follows the tick frequency as vanilla does.<br>
264+
<br>
265+
__⚡Recommended values:__
266+
<table>
267+
<thead><tr><th>Entity Goal</th><th>Start Tick Chance</th></tr></thead>
268+
<tbody>
269+
<tr><td>nearest-attackable-target</td><td>20</td></tr>
270+
<tr><td>follow-parent</td><td>20</td></tr>
271+
<tr><td>avoid-entity</td><td>20</td></tr>
272+
<tr><td>temptation</td><td>20</td></tr>
273+
<tr><td>enderman-look-for-player</td><td>20</td></tr>
274+
</tbody></table>`,
275+
"nearest-attackable-target": {
276+
default: -1,
277+
desc: "How often does the __nearest attackable target__ goal attempt to start running for an entity."
278+
},
279+
"follow-parent": {
280+
default: -1,
281+
desc: "How often does the __follow parent__ goal attempt to start running for an entity."
282+
},
283+
"avoid-entity": {
284+
default: -1,
285+
desc: "How often does the __avoid entity__ goal attempt to start running for an entity."
286+
},
287+
temptation: {
288+
default: -1,
289+
desc: "How often does the __temptation__ goal attempt to start running for an entity."
290+
},
291+
"enderman-look-for-player": {
292+
default: -1,
293+
desc: "How often does the __look for player__ goal attempt to start running for an enderman."
294+
}
295+
}
296+
},
245297
"fast-biome-manager-seed-obfuscation": {
246298
enabled: {
247299
default: false,
@@ -316,6 +368,18 @@ const config: ConfigRoot = {
316368
This may cause the inconsistent order of future compose tasks in rare edge cases, which may lead to different structure generation results.
317369
</div>`
318370
},
371+
"reuse-random-ticking-blockpos": {
372+
default: false,
373+
desc: `Whether to reuse part of the blockpos instance during random block ticking.<br>
374+
This can avoid unnecessary memory allocation and reduce GC overhead slightly during a large amount of random block ticking.<br>
375+
<br>
376+
__⚡Recommended value: \`false\`__<br>
377+
<br>
378+
<div class="warning custom-block">
379+
<p class="custom-block-title custom-block-title-default">Experimental</p>
380+
Experimental feature, actively testing. It may conflict with some plugins or cause ticking positions to be offset. Please use with caution and report any bugs you encounter.
381+
</div>`
382+
},
319383
"cache-biome": {
320384
enabled: {
321385
default: false,
@@ -612,9 +676,28 @@ const config: ConfigRoot = {
612676
}
613677
},
614678

615-
// fixes: {
616-
// __desc__: "This section contains bug fixes for specific issues.",
617-
// },
679+
fixes: {
680+
__desc__: "This section contains bug fixes for specific issues.",
681+
"prevent-moving-into-weak-loaded-chunks": {
682+
__desc__: "Whether to prevent entities from moving into weak-loaded chunks.",
683+
enabled: {
684+
default: false,
685+
desc: "Set this to `true` to be able to use options below."
686+
},
687+
projectiles: {
688+
default: false,
689+
desc: "Whether to prevent projectiles from moving into weak-loaded chunks."
690+
}
691+
},
692+
"vanilla-bug-fix": {
693+
__desc__: "This section contains fixes for vanilla Minecraft bugs.",
694+
"mc-270656": {
695+
default: false,
696+
desc: `Whether to fix incorrect granting of \`Who needs rockets?\` advancement.<br>
697+
Mojira link: [MC-270656](https://mojira.dev/MC-270656).`
698+
}
699+
}
700+
},
618701

619702
"gameplay-mechanisms": {
620703
__desc__: "This section contains the features that modify or improve the game mechanics.",

‎pages/zh/docs/config/data/leaf-global-latest.ts‎

Lines changed: 86 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,20 @@ const config: ConfigRoot = {
159159
__⚡推荐值：\`true\`__`
160160
}
161161
},
162+
"despawn-time": {
163+
"proactive-weak-loading-despawn": {
164+
default: false,
165+
desc: `是否启用对弱加载实体的主动消失检查。<br>
166+
这可以帮助缓解在弱加载区块中加载和 tick 大量累积的实体而导致的卡顿。<br>
167+
<br>
168+
__⚡推荐值：\`true\`__<br>
169+
<br>
170+
<div class="warning custom-block">
171+
<p class="custom-block-title custom-block-title-default">实验性功能</p>
172+
实验性功能，正在积极测试中，如遇到问题请反馈。
173+
</div>`
174+
}
175+
},
162176
"dont-save-entity": {
163177
"dont-save-primed-tnt": {
164178
default: false,
@@ -242,6 +256,44 @@ const config: ConfigRoot = {
242256
<br>
243257
__⚡推荐值：\`true\`__`
244258
},
259+
"entity-goal": {
260+
"start-tick-chance": {
261+
__desc__: `常见生物的意向执行尝试的检查频率。<br>
262+
在原版中，生物会在每 tick 检查是否可以开始执行某个意向，随后执行意向任务。通过增加下方配置项的数值来降低检查频率，可以显著提高性能，但可能会对游戏体验有轻微影响。<br>
263+
如果设为 \`-1\`，则遵循原版的 tick 频率。<br>
264+
<br>
265+
__⚡推荐值:__
266+
<table>
267+
<thead><tr><th>生物</th><th>开始 Tick 的频率</th></tr></thead>
268+
<tbody>
269+
<tr><td>nearest-attackable-target</td><td>20</td></tr>
270+
<tr><td>follow-parent</td><td>20</td></tr>
271+
<tr><td>avoid-entity</td><td>20</td></tr>
272+
<tr><td>temptation</td><td>20</td></tr>
273+
<tr><td>enderman-look-for-player</td><td>20</td></tr>
274+
</tbody></table>`,
275+
"nearest-attackable-target": {
276+
default: -1,
277+
desc: "实体检查是否能执行 __最近的可攻击目标__ 意向的频率。"
278+
},
279+
"follow-parent": {
280+
default: -1,
281+
desc: "实体检查是否能执行 __跟随父母__ 意向的频率。"
282+
},
283+
"avoid-entity": {
284+
default: -1,
285+
desc: "实体检查是否能执行 __远离特定生物__ 意向的频率。"
286+
},
287+
temptation: {
288+
default: -1,
289+
desc: "实体检查是否能执行 __跟随手持指定物品玩家__ 意向的频率。"
290+
},
291+
"enderman-look-for-player": {
292+
default: -1,
293+
desc: "末影人检查是否能执行 __被玩家注视__ 意向的频率。"
294+
}
295+
}
296+
},
245297
"fast-biome-manager-seed-obfuscation": {
246298
enabled: {
247299
default: false,
@@ -316,6 +368,18 @@ const config: ConfigRoot = {
316368
在可能存在的边缘情况下，这可能会导致结构生成任务的合并顺序不一致，从而引起结构生成结果和原版有差异。
317369
</div>`
318370
},
371+
"reuse-random-ticking-blockpos": {
372+
default: false,
373+
desc: `是否在随机方块 tick 时是否复用部分 BlockPos 实例<br>
374+
这可以在大量随机方块 tick 时略微减少内存分配和 GC 开销。<br>
375+
<br>
376+
__⚡推荐值：\`false\`__<br>
377+
<br>
378+
<div class="warning custom-block">
379+
<p class="custom-block-title custom-block-title-default">实验性功能</p>
380+
实验性功能，正在积极测试中，可能与某些插件冲突或导致方块 tick 的位置偏移。请谨慎使用，并报告任何遇到的问题。
381+
</div>`
382+
},
319383
"cache-biome": {
320384
enabled: {
321385
default: false,
@@ -617,9 +681,28 @@ const config: ConfigRoot = {
617681
}
618682
},
619683

620-
// fixes: {
621-
// __desc__: "本节包含对特定问题的修复。",
622-
// },
684+
fixes: {
685+
__desc__: "本节包含对特定问题的修复。",
686+
"prevent-moving-into-weak-loaded-chunks": {
687+
__desc__: "是否阻止实体进入弱加载区块。",
688+
enabled: {
689+
default: false,
690+
desc: "设为 `true` 以启用以下功能。"
691+
},
692+
projectiles: {
693+
default: false,
694+
desc: "是否阻止弹射物进入弱加载区块。"
695+
}
696+
},
697+
"vanilla-bug-fix": {
698+
__desc__: "本节包含对 Minecraft 原版的问题修复。",
699+
"mc-270656": {
700+
default: false,
701+
desc: `是否修复 \`还要啥火箭啊？\` 进度触发的错误检查逻辑。<br>
702+
Mojira 问题跟踪链接：[MC-270656](https://mojira.dev/MC-270656).`
703+
}
704+
}
705+
},
623706

624707
"gameplay-mechanisms": {
625708
__desc__: "本节包含修改或改进游戏机制的相关功能。",

0 commit comments

Comments
 (0)