Pumpkin-Docs/docs/zh_cn/config/basic.md
Alexander Medvedev 091c33d073 update config
2026-09-05 09:40:41 +02:00

461 lines
6.4 KiB
Markdown

# 基础配置
对应 `pumpkin.toml` 文件
## 服务器地址
服务器绑定的地址。
:::code-group
```toml
seed = "1790155153199293024"
default_difficulty = "Normal"
op_permission_level = 4
allow_nether = true
allow_end = true
hardcore = false
tps = 20.0
default_gamemode = "Survival"
force_gamemode = false
scrub_ips = true
use_favicon = true
default_level_name = "world"
allow_chat_reports = false
white_list = false
enforce_whitelist = false
[logging]
enabled = true
level = "info"
threads = false
thread_ids = false
target = false
color = true
timestamp = true
timestamp_format = "[hour]:[minute]:[second]"
file = "latest.log"
[resource_pack.java]
enabled = false
url = ""
sha1 = ""
prompt_message = ""
force = false
[resource_pack.bedrock]
enabled = false
force = false
packs = []
[world]
lighting = "default"
autosave_ticks = 6000
[world.chunk]
type = "anvil"
write_in_place = false
[world.chunk.compression]
algorithm = "LZ4"
level = 6
[networking.query]
enabled = false
address = "0.0.0.0:25565"
[networking.rcon]
enabled = false
address = "0.0.0.0:25575"
password = ""
max_connections = 10
[networking.rcon.logging]
logged_successfully = true
wrong_password = true
commands = true
quit = true
[networking.proxy]
enabled = false
[networking.proxy.velocity]
enabled = false
secret = ""
[networking.proxy.bungeecord]
enabled = false
secret = ""
[networking.lan_broadcast]
enabled = false
[networking.java]
enabled = true
address = "0.0.0.0:25565"
encryption = true
online_mode = true
max_players = 1000
view_distance = 16
simulation_distance = 10
keep_alive_time = 15
motd = "A blazingly fast Pumpkin server!"
[networking.java.compression]
enabled = true
threshold = 256
level = 4
[networking.java.authentication]
enabled = true
fallbacks = []
profile_by_name_fallbacks = []
profile_by_uuid_fallbacks = []
connect_timeout = 5000
read_timeout = 5000
prevent_proxy_connections = false
[networking.java.authentication.player_profile]
allow_banned_players = false
allowed_actions = ["FORCED_NAME_CHANGE", "USING_BANNED_SKIN"]
[networking.java.authentication.textures]
enabled = true
allowed_url_schemes = ["http", "https"]
allowed_url_domains = [".minecraft.net", ".mojang.com"]
[networking.java.authentication.textures.types]
skin = true
cape = true
elytra = true
[networking.java.packet_limiter]
enabled = true
max_packet_rate = 500.0
burst_capacity = 500.0
kick_message = "Kicked for spamming packets"
[networking.bedrock]
enabled = true
online_mode = true
max_players = 1000
view_distance = 16
simulation_distance = 10
motd = "A blazingly fast Pumpkin server!"
username_prefix = ""
replace_username_spaces = true
chunk_caching = true
[networking.bedrock.compression]
enabled = true
threshold = 256
level = 4
[networking.bedrock.authentication]
enabled = true
connect_timeout = 5000
read_timeout = 5000
[networking.bedrock.nethernet]
enabled = true
address = "0.0.0.0:19132"
identity_key = "nethernet-key.der"
stun_servers = []
[networking.bedrock.packet_limiter]
enabled = true
max_packet_rate = 500.0
burst_capacity = 500.0
kick_message = "Kicked for spamming packets"
[commands]
use_console = true
use_tty = true
log_console = true
broadcast_console_to_ops = true
default_op_level = 0
[commands.overrides]
[chat]
format = "<{DISPLAYNAME}> {MESSAGE}"
[chat.anti_spam]
enabled = true
spam_threshold = 200
message_cost = 20
decay_per_tick = 1
ops_bypass = true
[pvp]
enabled = true
hurt_animation = true
protect_creative = true
knockback = true
swing = true
[server_links]
enabled = true
bug_report = "https://github.com/Pumpkin-MC/Pumpkin/issues"
support = ""
status = ""
feedback = ""
community = ""
website = ""
forums = ""
news = ""
announcements = ""
[server_links.custom]
[player_data]
save_player_data = true
save_player_cron_interval = 300
[fun]
april_fools = true
[recipe]
send_recipes = true
[plugins]
enabled = true
hot_reload = false
ask_permission_confirmation = true
allow_unsigned = true
allowed_permissions = []
blocked_permissions = []
inherit_env = false
loopback_only = false
verify_signatures = true
[plugins.overrides]
[advancement]
save_advancements = true
```
:::
## 种子
世界生成的种子值。
:::code-group
```toml [pumpkin.toml] {2}
seed = ""
```
:::
## 最大玩家数
服务器允许的最大玩家数量。
:::code-group
```toml [pumpkin.toml] {2}
max_players = 100000
```
:::
## 视距
玩家的最大视距。
:::code-group
```toml [pumpkin.toml] {2}
view_distance = 10
```
:::
## 模拟距离
玩家的最大模拟距离。
:::code-group
```toml [pumpkin.toml] {2}
simulation_distance = 10
```
:::
## 默认难度
默认游戏难度。
:::code-group
```toml [pumpkin.toml] {2}
default_difficulty = "Normal"
```
:::
```toml
Peaceful # 和平
Easy # 简单
Normal # 普通
Hard # 困难
```
## 操作权限等级
`/op` 命令分配的权限等级。
:::code-group
```toml [pumpkin.toml] {2}
op_permission_level = 4
```
:::
## 允许下界
是否启用下界维度。
:::code-group
```toml [pumpkin.toml] {2}
allow_nether = true
```
:::
## 允许末地
是否启用末地维度。
:::code-group
```toml [pumpkin.toml] {2}
allow_end = true
```
:::
## 极限模式
服务器是否处于极限模式。
:::code-group
```toml [pumpkin.toml] {2}
hardcore = false
```
:::
## 在线模式
是否启用在线模式。需要有效的 Minecraft 账号。
:::code-group
```toml [pumpkin.toml] {2}
online_mode = true
```
:::
## 加密
是否启用数据包加密。
> [!IMPORTANT]重要
> 启用在线模式时需要此选项。
:::code-group
```toml [pumpkin.toml] {2}
encryption = true
```
:::
## MOTD
每日信息;在状态屏幕上显示的服务器描述。
:::code-group
```toml [pumpkin.toml] {2}
motd = "一款极速的南瓜服务器!"
```
:::
## TPS
服务器的目标刻率。
:::code-group
```toml [pumpkin.toml] {2}
tps = 20.0
```
:::
## 默认游戏模式
玩家的默认游戏模式。
:::code-group
```toml [pumpkin.toml] {2}
default_gamemode = "Survival"
```
:::
```toml
Undefined # 未定义
Survival # 生存模式
Creative # 创造模式
Adventure # 冒险模式
Spectator # 观察者模式
```
## IP 记录
是否从日志中移除玩家的 IP 地址。
:::code-group
```toml [pumpkin.toml] {2}
scrub_ips = true
```
:::
## 使用图标
是否使用服务器图标。
:::code-group
```toml [pumpkin.toml] {2}
use_favicon = true
```
:::
## 图标路径
服务器图标的路径。
:::code-group
```toml [pumpkin.toml] {2}
favicon_path = "icon.png"
```
:::