40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
# 聊天与反垃圾信息
|
||
|
||
Pumpkin 在 `pumpkin.toml` 的 `[chat]` 配置项下提供了可自定义的游戏内聊天格式以及内置的反垃圾信息（Anti-Spam）保护。
|
||
|
||
## 配置
|
||
|
||
:::code-group
|
||
|
||
```toml [pumpkin.toml]
|
||
[chat]
|
||
format = "<{DISPLAYNAME}> {MESSAGE}"
|
||
|
||
[chat.anti_spam]
|
||
enabled = true
|
||
spam_threshold = 200
|
||
message_cost = 20
|
||
decay_per_tick = 1
|
||
ops_bypass = true
|
||
```
|
||
|
||
:::
|
||
|
||
### 聊天设置
|
||
|
||
- **`format`**：聊天消息格式字符串（默认：`"<{DISPLAYNAME}> {MESSAGE}"`）。
|
||
- `{DISPLAYNAME}`：玩家显示名称。
|
||
- `{MESSAGE}`：聊天消息文本。
|
||
> [!NOTE]
|
||
> 当启用了安全聊天举报（`allow_chat_reports = true`）时，自定义聊天格式将不会生效。
|
||
|
||
### 反垃圾信息保护
|
||
|
||
Pumpkin 实现了漏桶算法垃圾信息计数器，以防止刷屏玩家和机器人泛洪攻击服务器：
|
||
|
||
- **`enabled`**：是否启用反垃圾信息保护（默认：`true`）。
|
||
- **`spam_threshold`**：踢出玩家的垃圾信息计数器阈值（以 Tick 为单位，默认：`200` Tick）。
|
||
- **`message_cost`**：每发送一条聊天消息或命令时，玩家垃圾信息计数器增加的数值（默认：`20` Tick）。
|
||
- **`decay_per_tick`**：服务器每 Tick 从玩家垃圾信息计数器中衰减扣除的数值（默认：`1` Tick）。
|
||
- **`ops_bypass`**：服务器管理员（OP）是否绕过反垃圾信息检查（默认：`true`）。
|