PlayerControl - 玩家行为日志

注意：本插件已停止更新！如需功能更完善的替代品，请使用作者的 PlayerControlPlus 插件：

https://www.spigotmc.org/resources/...ayers-activity-on-your-server-1-8-1-15.78599/

PlayerControl 是一款轻量级的玩家行为记录插件。它会为每位玩家生成独立的日志文件，按日期保存其在服务器上的各类活动信息，例如聊天、执行命令、切换世界、破坏方块等，便于管理员追溯玩家行为、排查异常。

💡主要特性

• 按玩家生成日志文件：每位玩家拥有独立的日志记录。
• 记录多种事件类型：
• 加入/离开服务器
• 聊天内容
• 执行的命令
• 世界切换
• 方块破坏与放置（可用于侦测透视行为）
• 击杀与死亡
• 物品丢弃
• 实时查看玩家活动：可开启实时消息推送，监控玩家当前行为。
• 日志清晰易读：格式规整，便于查阅。
• 自动清理旧日志：可设置保留天数，自动删除过期记录。
• 支持 PlaceholderAPI：提供丰富的变量用于自定义消息。
• 兼容性强：支持 Spigot/CraftBukkit，适用于 1.8 及以上版本。

🎮配置说明

玩家日志存储在插件目录下的 players 文件夹中。您可以通过编辑 config.yml 文件来自定义需要记录的事件类型。

配置文件示例 (config.yml)

Config:
  player_log_remove: 7
  player_log_save_when_leave: false
  new-version-reminder: true
  save_join_leave: true
  save_chat: true
  save_commands: true
  save_worldChange: true
  save_blockBreak:
    enabled: true
    block_list:
      - DIAMOND_ORE
      - EMERALD_ORE
  save_blockPlace:
    enabled: true
    block_list:
      - CHEST
  save_drops: false
  save_playerKill_playerDeath: true
  save_cancelled_events: false
  save_data_permission:
    enabled: false
    permission: "playercontrol.savedata"
  real_time_command_enabled_events:
    - commands
    - worldChange
    - blockBreak
    - blockPlace
    - drops

Messages:
  log_message_general: "[%time%] %event%"
  log_message_join: "<joined the server (IP: %ip%)>"
  log_message_leave: "<left the server>"
  log_message_chat: "<chat: %message%>"
  log_message_commands: "<command: %command%>"
  log_message_worldChange: "<world change: FROM (%worldFrom%) TO (%worldTo%)"
  log_message_blockBreak: "<block break: %block% (%block_x% %block_y% %block_z% %block_world%)"
  log_message_blockPlace: "<block place: %block% (%block_x% %block_y% %block_z% %block_world%)"
  log_message_playerKill: "<killed: %victim%>"
  log_message_playerDeath: "<killed by: %killer%> (Total Deaths: %statistic_deaths%)"
  log_message_drops: "<drop: x%amount% %item%>"
  real_time_message: "&8&o[&c&o%player%&8&o][&e&o%time%&8&o] &7&o%event%"

关键配置项说明

• player_log_remove：日志保留天数。例如设置为 7，则7天前的日志数据将被自动清理。
• player_log_save_when_leave：玩家离开时立即保存日志。不推荐玩家数量众多的服务器开启。
• save_blockBreak / save_blockPlace：记录方块破坏/放置。需在 block_list 中指定要记录的方块类型（Material名称）。方块列表参考：Spigot Material Javadoc
• save_cancelled_events：是否记录被其他插件取消的事件（如因无权限而失败的指令，或被 WorldGuard 阻止的方块破坏）。
• save_data_permission：仅当玩家拥有指定权限时才记录其数据。

🔧可用变量

您可以在配置文件的日志消息中使用以下变量，也支持 PlaceholderAPI 变量。

全局变量 (可用于所有日志消息)

• %player%
• %player_x%, %player_y%, %player_z%
• %player_world%

事件专用变量

• 加入事件：%ip%
• 世界切换：%worldFrom%, %worldTo%
• 聊天：%message%
• 命令：%command%
• 方块破坏/放置：
• %block% (方块类型)
• %block_x%, %block_y%, %block_z%
• %block_world%
• %item% (用于破坏方块的物品)
• 玩家击杀：%victim%
• 玩家死亡：%killer%

⭐命令与权限

可用命令

• /playercontrol - 显示插件帮助信息。
• /playercontrol reload - 重载配置文件 (config.yml)。
• /playercontrol realtime <player> - 启用/禁用指定玩家的实时活动消息。启用后，管理员将收到该玩家所做之事的实时提示。
• /playercontrol save - 手动将缓存数据保存至日志文件（服务器关闭时会自动执行）。

权限

• playercontrol.admin - 使用所有插件命令的权限。