Pumpkin-Website/docs/zh_cn/config/authentication.md

身份验证

服务器使用 Mojang 的会话服务器进行身份验证，以确保客户端正在使用合法的付费账号。Pumpkin 允许你自定义配置身份验证系统。

配置身份验证

Warning

大多数服务器不应更改默认的身份验证配置。这样做可能会带来意想不到的后果。仅在你知道自己在做什么的情况下才更改这些设置！

enabled: 布尔值

是否启用身份验证。

:::code-group

[authentication]
enabled = false

:::

prevent_proxy_connections: 布尔值

是否阻止代理连接。

:::code-group

[authentication]
enabled = true
prevent_proxy_connections = true

:::

auth_url: 字符串 (可选)

用于身份验证的 URL。如果未指定，则使用 Mojang 的会话服务器进行身份验证。

占位符

占位符	描述
{username}	玩家用户名
{server_hash}	服务器的哈希值

:::code-group

[authentication]
auth_url = "[这里填写自定义身份验证服务器]"

:::

prevent_proxy_connection_auth_url: 字符串 (可选)

如果启用了 prevent_proxy_connections，则用于身份验证的 URL。如果未指定，则使用 Mojang 的会话服务器进行身份验证。

占位符

占位符	描述
{username}	玩家用户名
{server_hash}	服务器的哈希值
{ip}	玩家的 IP 地址

:::code-group

[authentication]
prevent_proxy_connection_auth_url = "[这里填写自定义身份验证服务器]"

:::

玩家信息

allow_banned_players: 布尔值

允许被 Mojang 标记的玩家。

:::code-group

[authentication.player_profile]
allow_banned_players = true

:::

allowed_actions: 字符串数组

如果启用了 allow_banned_players，允许的操作。

:::code-group

[authentication.player_profile]
allow_banned_players = true
allowed_actions = ["FORCED_NAME_CHANGE", "USING_BANNED_SKIN"]

:::

材质

enabled: 布尔值

是否过滤/验证玩家材质（例如皮肤/披风）。

:::code-group

[authentication.textures]
enabled = true

:::

allowed_url_schemes: 字符串数组

材质允许的 URL 方案。

:::code-group

[authentication.textures]
enabled = true
allowed_url_schemes = ["http", "https"]

:::

allowed_url_domains: 字符串数组

材质允许的 URL 域名。

:::code-group

[authentication.textures]
enabled = true
allowed_url_domains = [".minecraft.net", ".mojang.com"]

:::

材质类型

skin: 布尔值

是否使用玩家皮肤。

:::code-group

[authentication.textures.types]
skin = true

:::

cape: 布尔值

是否使用玩家披风。

:::code-group

[authentication.textures.types]
cape = true

:::

elytra: 布尔值

是否使用玩家鞘翅。

:::code-group

[authentication.textures.types]
elytra = true

:::

默认配置

默认情况下，身份验证已启用并使用 Mojang 的服务器。以下是默认配置： :::code-group

[authentication]
enabled = true
prevent_proxy_connections = false

[authentication.player_profile]
allow_banned_players = false
allowed_actions = ["FORCED_NAME_CHANGE", "USING_BANNED_SKIN"]

[authentication.textures]
enabled = true
allowed_url_schemes = ["http", "https"]
allowed_url_domains = [".minecraft.net", ".mojang.com"]

[authentication.textures.types]
skin = true
cape = true
elytra = true

:::