maicraft-mcp-server/config-template.yaml at main · ChangingSelf/maicraft-mcp-server · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
# Maicraft 客户端配置模板
# 将此文件复制为 config.yaml 并根据需要修改。

minecraft:
  host: 127.0.0.1        # Minecraft 服务器地址
  port: 25565            # 端口
  username: MaiBot       # 机器人用户名（离线模式）
  password:              # 在线模式密码（offline 留空）
  auth: offline          # offline | microsoft | mojang
  version: "1.19.0"      # 可选，留空自动检测

# 禁用的事件类型列表（黑名单机制）
# 列出要禁用的游戏事件类型，默认情况下所有事件都会被启用
# 移除注释即可禁用相应事件，留空表示启用所有事件
disabledEvents:
  # - chat
  # - playerJoined
  # - playerLeft
  # - death
  # - spawn
  # - rain
  # - kicked
  # - spawnReset
  # - health
  # - entityHurt
  # - entityDead
  # - playerCollect

# 不能破坏的方块列表配置
# 机器人路径查找时会避免破坏这些方块
blocksCantBreak:
  - chest        # 箱子
  - furnace      # 熔炉
  - bed          # 床
  - door         # 门
  - trapdoor     # 活板门
  - sign         # 告示牌
  - torch        # 火把
  - lantern      # 灯笼

# 调试命令系统配置
debugCommands:
  enabled: false           # 是否启用调试命令系统
  adminPlayers:           # 管理员玩家列表，只有这些玩家才能使用调试命令
    # - "YourPlayerName"    # 替换为你的游戏用户名
  chatFeedback: true      # 是否在游戏中显示调试命令的执行结果

# 聊天过滤配置
chatFilters:
  enabled: true           # 是否启用聊天过滤功能
  # 玩家黑名单：不接收这些玩家的消息
  blockedPlayers:
    # - "SpamBot"          # 示例：屏蔽垃圾消息机器人
    # - "AnnoyingPlayer"   # 示例：屏蔽讨厌的玩家
  # 消息黑名单：不接收匹配这些正则表达式的消息
  # 注意：如果调试命令系统未启用，将自动过滤以!开头的消息
  blockedMessagePatterns:
    # - "^\\s*spam\\s*$"    # 示例：屏蔽只包含"spam"的消息（不区分大小写）
    # - "广告"               # 示例：屏蔽包含"广告"的消息
    # - "\\b(?:fuck|shit|damn)\\b"  # 示例：屏蔽脏话（单词边界匹配）

# 日志配置
logging:
  level: INFO             # DEBUG | INFO | WARN | ERROR
  enableFileLog: true     # 是否启用文件日志
  logFilePath: ""         # 日志文件路径，留空使用默认路径 (logs/maicraft-*.log)
  useStderr: true         # 是否使用 stderr 输出（MCP 模式建议保持 true）
  colors: true            # 是否启用颜色输出
  timestamp: true         # 是否显示时间戳

# WebSocket日志服务器配置
websocket:
  enabled: true           # 是否启用WebSocket日志服务器
  port: 20915             # WebSocket服务器端口
  host: "localhost"       # WebSocket服务器监听地址

# MCP Server 配置
mcp:
  name: "Maicraft MCP"
  version: "0.1.0"
  tools:
    # 工具过滤配置（可选）
    # 方式1：黑名单模式（推荐）- 屏蔽指定工具，其他全部可用
    disabled:
      - use_chest
      - smelt_item
    # 方式2：白名单模式 - 仅暴露指定工具
    # enabled:
    #   - mine_block
    #   - place_block
    #   - follow_player
    # 方式3：同时使用 - 白名单允许的集合减去黑名单
    # enabled:
    #   - mine_block
    #   - place_block
    #   - chat
    # disabled:
    #   - chat
    # 方式4：不配置 - 默认暴露所有工具
    # （删除或注释掉 tools 部分）