文档较为简略，且大量由AI总结生成。如果你需要最详细的文档，请你查阅配置文件注释。

Tatako文档

欢迎使用Tatako anticheat！我们推荐您阅读完文档后再使用。

概述

Tatako是一款先进的反作弊系统，用于Minecraft Java插件服务器，在Bukkit服务器上运行

Tatako基于Medusa框架构建，使用 PacketEvents2（retrooper）在数据包层面进行监听与处理。Tatako可以检测例如自动瞄准（AimBot）、飞行（Fly）、加速（Speed）、杀戮光环（KillAura）、连点器（AutoClicker）、搭路（Scaffold）等外挂。

Tatako是免费的。所有配置均通过 plugins/Tatako/config.yml 完成，插件启动时会自动检查并补全缺失的配置项，确保配置文件的完整性。

数据包层面检测（PacketEvents2）
基于机器学习的自动瞄准检测（LightGBM本地推理 + 云端AI推理）
Aura假人系统，可生成假人骗Aura
GUI管理检测
MySQL/MariaDB/Redis数据库支持，可跨子服同步VL
自定义主题、Alert格式、惩罚指令
智能拉回系统降低作弊者优势

河众测试服务器

测试服务器位于 tatako.hezhongkj.top

服务器提供多个反作弊的测试，包括免费反作弊和破解反作弊

目前提供的反作弊：Tatako AlexisCheatDetectionV1 Karhu NanaDetector MX StarryAC

快速使用

本栏目面向第一次使用Tatako的新手腐竹。Tatako默认设置开箱即用，你只需要做好下面几件事。

1. 安装并启动

将Tatako插件文件放入服务器 plugins 文件夹，重启服务器。Tatako会自动生成配置文件，无需手动修改即可直接运行。

2. 分配权限

在权限插件（如 LuckPerms）中给管理组/玩家添加权限 tatako.commands 和 tatako.commands.*。管理员进入服务器后即可使用Tatako的全部命令。

LuckPerms参考命令：

/lp user 你的名字 permission set tatako.commands true
/lp user 你的名字 permission set tatako.commands.* true

3. 开启警报

管理员在游戏内输入 /tatako alerts 开启作弊警报。之后有玩家作弊时，你会实时收到警报消息。

你也可以配置 tatako.alerts 权限来自动开启警报

4. 查看检测状态

输入 /tatako gui 查看所有检测及其启用状态。默认情况下，主要的检测均已开启，无需额外设置。

5. 设置惩罚（可选）

需要自动处理作弊玩家时，编辑 config.yml，在对应检测的 punish-command 下填写惩罚指令（语法格式见惩罚指令教程），然后执行 /tatako reload 生效。

常见问题

收不到警报？ 确认执行过 /tatako alerts，且服务器在受支持版本上。
误判较多？ 可在 /tatako gui 界面中直接点击关闭误判的检测，或调大该检测的 max-violations 再观察。若无法解决，立即上报给开发者！
需要跨服同步VL？ 只有使用 BungeeCord/Velocity 群组服时才需要配置数据库，单服无需数据库。
修改配置不生效？ 修改 config.yml 后需执行 /tatako reload 或重启服务器。
我还是不会用？ 推荐Deepseek 千问豆包，将配置文件和此文档发送给他们，输入问题，他们可以帮你解决你的问题。若确实有必要，可进QQ群寻求帮助。

如何上报问题

没有软件是完美的。遇到检测被绕过或误判，或者出现Bug/报错时，欢迎上报给开发者。上报前请先完成以下检查，避免被拒绝，同时提升问题修复的效率。

上报前请确认

服务器是否安装了会改变坐标或方块的"混淆坐标"类插件？
是否存在热重载反作弊（在运行中执行reload）？
jar文件是否完整？
请勿在你自己的服务器上复现、测试问题。请使用测试服务器！
如果你不信任开发者的建议，或不希望开发者登入你的服务器检查问题与调试，请不要上报问题

上报渠道

漏洞追踪器（推荐）：https://github.com/tjshtqwq/Tatako-Anticheat-issues/
联系QQ（推荐）
论坛（备用）：https://bbs.hezhongkj.top

需要提供的信息

无论上报哪类问题，以下项目必填：Tatako 版本号、MC 服务器版本、MC 服务器核心名称（例如 PaperSpigot），以及详细的问题描述（支持中文或英文，建议使用中文避免歧义）。

绕过或误判 — 需要 Tatako 日志（Tatako.log）与第一视角视频
错误或 Bug — 需要服务器完整日志、Tatako 日志与视频

上报误判时，请注明：是否使用闭源客户端（如 Lunar、Badlion）或开启 Optifine FastMath，是否使用特殊玩法插件（如 MCMMO）；上报绕过时，请提供作弊客户端名称、客户端是否私有，以及绕过的是哪个检测。

展开查看漏洞追踪器的上报模板

                    
---
name: Tatako Generic Issue
about: Tatako Generic issues
---

# Tatako Issue
### PLEASE SELECT ISSUE LABEL!
### Bypasses Or False Flags: Need TatakoLogs and Video
### Error or Bugs: Need ServerLogs, TatakoLogs, and Video
### Both need：Tatako Version, Minecraft Server Version, MC Server Core (e.g. PaperSpigot)
### Please Describe your issue.
### Supported Chinese or English. But we suggest you using chinese to avoid ambiguity.
# Tatako 问题追踪器
### 务必选择问题标签！
### 绕过或误判：需要Tatako日志和视频
### 错误或Bug：需要服务器日志，Tatako日志和视频
### 都需要：Tatako版本号，MC服务器版本，MC服务器核心名称（例如PaperSpigot）
### 请详细描述你的问题。
### 支持中文或英文。但我们建议你使用中文避免歧义。

Change - [ ] to - [X] to check the checkboxes below.
将 - [ ] 改成 - [X] 让复选框勾选

# Please Check 请检查：
- [ ] Tatako is up-to-date Tatako是最新的
- [ ] Tatako is running on a 1.8 ~ 1.21.4 spigot server. Tatako运行于1.8 ~ 1.21.4的Spigot服务器上
- [ ] No plugins are incompatible with Tatako. 没有不兼容的插件
- [ ] The issue happens with default config.yml 默认配置仍复现

# Generic 通用项
### You must fill the following items no matter what you report. 无论你报告什么，以下项目必填
**Server Version 服务器版本**

**Tatako Version Tatako版本**

**Client Version 客户端版本**

**Plugin List 插件列表**

# Bypass 绕过
**Hacked Client 作弊客户端名称**
**Is this Hacked Client private? 作弊客户端是否私有**
**What check bypassed 绕过了什么**
**Video for bypass 绕过视频**
**Check alerts and information (Using Tatako.log) Tatako警报和信息（使用Tatako.log）**

# False Flag 误判
- [ ] Using closed-source client (lunar,badlion,etc.) or optifine fastmath? 使用闭源客户端（例如Lunar Badlion等），或开启了Optifine的FastMath？
- [ ] Special gameplay plugin (MCMMO, etc.)? 特殊的玩法插件（例如 MCMMO）
**Client used 客户端名称**
**Check alerts and information (Using Tatako.log) Tatako警报和信息（使用Tatako.log）**
**Video for false flag 误报视频**

# Bug
- [ ] Using closed-source server? 使用闭源服务端？
- [ ] Using special/private server? 使用特殊/私有服务端？
**Full server log and tatako log**

使用

安装

前往官方网站点我，加入QQ群

在群中下载Tatako最新插件文件，放入服务器plugins文件夹

启动服务器，Tatako会自动生成 plugins/Tatako/ 目录。目录内包含：

config.yml — 主配置文件
model.txt — LightGBM 机器学习模型（从jar释放，用于 Aim (4) 检测）
Tatako.log — 日志文件（默认生成，可在 log 配置中调整或关闭）
data/、dataV2/ — AI 数据收集文件夹（仅在 Aim (S) / Aim (3) 开启 collect 时创建）

兼容性

Tatako为Minecraft 1.8.8开发，稳定兼容版本为Minecraft 1.8.8, 1.12.2

Tatako实验性兼容Minecraft 1.13 ~ 最新版本

部分检测依赖NMS，仅在标准1.8.8服务器上生效

Tatako不兼容任何多线程服务端，不兼容任何混合端，不兼容任何对Netty/Bukkit API改动较大的服务端

Bukkit服务端，Minecraft版本>=1.8.8，Java 版本至少为 8 (1.8)

配置

所有配置均在 plugins/Tatako/config.yml 中完成。插件启动时会自动检查并补全缺失的配置项，确保配置文件的完整性

检测配置

检测类型分为三大类：combat（战斗）、movement（移动）、player（玩家）。每个检测项均有以下基础配置：

enabled — 是否启用该检测
max-violations — 最大违规次数，超过后执行处罚命令
punish-command — 处罚命令（支持占位符与阈值格式，详见惩罚指令教程）
其他可调参数 — 每个检测项可能有独立的阈值、灵敏度等参数，详见 config.yml

通用检测行为设置：

checks.generic 下可配置 setback（拉回）开关、冷却时间、最小触发VL、是否允许拉回到虚空，等待

setback — 是否启用 LagBack（拉回）系统。检测到作弊后将玩家位置回弹到上一个合法位置，强制应用击退，降低作弊者优势
setback-cooldown — 两次拉回之间的最短间隔（毫秒）
min-vl-to-setback — 至少累计多少 VL 才执行拉回
allow-setback-to-void — 是否允许将玩家拉回虚空

如果你不是专业开发者或老挂逼，请勿修改检查配置中除了基础配置以外的其他自定义设置

数据库配置

Tatako 支持 MySQL / MariaDB / Redis 数据库，用于存储玩家的VL。相关配置位于 base.database下：

如果你使用BungeeCord/Velocity跨服群组，你必须使用数据库才能做到跨子服同步VL

enabled 是否启用数据库（true/false）
type 数据库类型，支持 mysql、maria（MariaDB）、redis（默认 mysql）
host 数据库地址（默认 localhost）
port 数据库端口（默认 3306，Redis 默认 6379）
user 数据库用户名
password 数据库密码
database 数据库名（默认 tatako）。如果你使用Redis，这里填写的是数据库索引（0~15）
table-prefix 表前缀/键前缀（默认 tatako）
reconnect-timeout 重连超时时间（秒），连接失败时 Tatako 会尝试重连

启用数据库后，需同时将 base.restore-violations-after-reconnect 设置为 true，才能使玩家连接时恢复VL

数据存储说明：

MySQL/MariaDB 使用 HikariCP 连接池（最大连接 8，最小空闲 2）。VL 数据以 JSON 形式存放在 <table-prefix>_violations 表中（uuid 为主键，violations 字段为JSON）
Redis 使用 Jedis 客户端，数据以 <table-prefix>_violations:<uuid> 为键存储在对应索引库中

外观配置

在 appearance 下可配置提示信息的前景色、强调色以及主题列表，支持通过 /tatako theme 命令切换主题。

prefix — 插件消息前缀（默认 &b&lTatako&7 >&f ）
appearance.themes — 内置主题列表：Tatako、TatakoCN、Vulcan、Spartan、Medusa、Matrix、Polar、Magic、Lon。每个主题包含自己的警报消息格式与两种强调色
appearance.accents.accentOne / accentTwo — 全局强调色（切换主题时会被主题覆盖）
appearance.random_anticheat_names — 随机反作弊名称列表，防止服务器被识别为Tatako而被针对性绕过，使用 %random_ac% 占位符引用

警报格式支持以下占位符：

占位符	说明
`%prefix%`	前缀
`%player%`	玩家名
`%uuid%`	玩家UUID
`%checkName%`	检查名称（如 Reach、AutoClicker、KillAura、Speed、Fly）
`%checkType%`	检查类型ID（如 A、B、C）
`%dev%`	实验性标记，实验性检查显示为 `*`
`%vl%`	当前违规等级（VL）
`%maxvl%`	最大违规等级
`%ping%`	玩家网络延迟（ms）
`%tps%`	服务器TPS
`%des%`	检查描述
`%bar%`	VL 对应的进度条
`%info%`	检查的提示信息
`%lagpoints%`	玩家卡顿点数

VL配置

在 violations 下可配置警报格式、警报冷却时间、最低显示VL数、自动清零VL的延迟与提示消息等。

什么是VL？VL的全写是Violation Level，即玩家触发作弊检查的次数，用于衡量玩家的作弊程度。

alert-format — 警报消息格式（支持上述占位符）
alert-cooldown — 警报冷却时间（毫秒），防止警报刷屏
minimum-vl-to-alert — 至少要多少VL才会发送警报
clear-violations-delay — 多少分钟后自动清除全部VL
clear-violations-message — VL清理后的消息（设置为 false 可关闭）
clear-offline-violations — 是否同时清理离线玩家的VL（含数据库中的VL）
punish-notice-format — 惩罚通知格式（当前无用）

基础设置

在 base 下可配置 Tatako 的底层运行行为：

permission-cache — 是否缓存权限检查（如果没有 LuckPerms 等权限插件，建议开启）
permission-cache-refresh-delay — 权限缓存刷新周期（游戏刻）
passive-mode — 被动模式。启用后 Tatako 不会主动检测玩家，需要由其他插件调用 TatakoPassiveModeCheckPlayer 事件（com.tjshawa.api.listener.PassiveModeCheckPlayerEvent）才会开始检测，推荐与举报插件配合使用
passive-check-time — 被动模式下每次检测玩家的时长（毫秒）
velocity.max-transaction-time — 最多等待玩家多久确认击退被接受（毫秒）
connection.lagging-protect / lagging-threshold — 玩家数据包卡顿超过阈值时降低检查力度防止误判
restore-violations-after-reconnect — 玩家重连后是否恢复违规等级（配合数据库实现跨服VL同步）
prevent-block-unsync — 主动预防方块不同步导致的误判（启用后可能造成一些 GroundSpoof 绕过）
using-strict-bnh — 使用严格的头顶方块检测（仅 Speed (K) 生效，建议关闭，将来可能废弃）
check-transaction-timeout — 是否检查 Transaction 数据包超时，配合 transaction-max-ping、transaction-max-ticks、transaction-timeout-kick-message 使用
entity-tracking-range — 实体追踪器追踪距离（Reach 检测需要）
try-reuse-transaction — 试验性功能，尝试复用 Transaction 数据包

日志配置

在 log 下可配置日志记录：

enable — 是否启用日志记录（默认 true）
file — 日志文件名，路径为 ./plugins/Tatako/<文件名>（默认 Tatako.log）

可在游戏内使用 /tatako readlog <页码> 分页查看日志。

加载器配置

配置加载时的行为：

turnOffAprilFool — 关闭愚人节彩蛋。彩蛋会影响反作弊正常工作，正式环境建议开启此项
allow-online-mode — 允许正版服务器启动。此项在 Tatako 1.0-b8-pe7 及以后版本不生效（默认允许正版服务器启动）
forceEnablePlugin — 即使检测到不兼容插件也强制启动。启用后开发组将不接受任何问题提交，也不对后果负责

命令 & 权限

主命令：/tatako，别名为 /ac、/anticheat、/ttk

基础权限：tatako.commands — 允许使用 Tatako 命令（不含具体子命令），各子命令还需 tatako.commands.<子命令名> 权限

额外权限节点见下表：

命令	用途	权限
`/tatako alerts`	开关作弊警报	`tatako.commands.alerts`
`/tatako checklist`	列出所有检测项及启用状态	`tatako.commands.checklist`
`/tatako debug <check/none>`	调试指定检测（显示该检测的详细触发信息），`none` 关闭调试	`tatako.commands.debug`
`/tatako debugpackets <packet/off>`	调试指定数据包（使用`flying`一次性调试4个Flying包：Position/Rotation/PositionAndRotation）	`tatako.commands.debugpackets`
`/tatako gui`	打开图形界面	`tatako.commands.gui`
`/tatako info [player/none]`	查看插件信息；指定玩家时显示其延迟、灵敏度、客户端品牌/版本、卡顿点数、BotID等详细信息	`tatako.commands.info`
`/tatako readlog <page>`	分页读取日志（支持点击翻页）	`tatako.commands.readlog`
`/tatako reload`	重载配置与检测（异步执行）	`tatako.commands.reload`
`/tatako reset`	重置所有玩家的违规记录（含数据库中的离线VL）	`tatako.commands.reset`
`/tatako staff <player> <action> [time]`	Staff 模式，对指定玩家执行操作。action 可选：`lagback/lag`（拉回）、`reducedamage/rd`（减伤，需第三参数秒数）、`velocity/kb`（施加击退）、`rotation/rot`（随机转头）、`crash`（崩溃其客户端，对拥有 `tatako.bypass` 权限的玩家无效）、`bot`（强制生成假人）	`tatako.commands.staff`
`/tatako theme [name]`	切换主题（不填参数时列出全部主题）	`tatako.commands.theme`
`/tatako verbose`	开关详细输出（显示检测的缓冲区增加等调试信息）	`tatako.commands.verbose`
`/tatako violations <player>`	查看指定玩家的违规详细信息（总/战斗/移动/玩家VL）	`tatako.commands.violations`

其他权限：

tatako.alerts 玩家加入服务器时自动开启警报
tatako.bypass 完全绕过 Tatako 检测（且无法被 /tatako staff crash 崩溃客户端）
tatako.gui 允许打开/操作图形化界面（配合 tatako.commands.gui）

GUI 使用

通过 /tatako gui 打开图形化界面。需要 tatako.commands、tatako.commands.gui 与 tatako.gui 权限。

主菜单（Tatako GUI）

共27格，包含三个功能按钮：

Check Manager — 打开检测管理界面
Server Info — 显示服务器信息：TPS、服务器版本、高版本警告（>1.9）、数据库是否启用
About Tatako — 显示插件版本与作者信息

检测管理界面（Checks）

每个检测以染色玻璃板显示：

绿色玻璃板 — 检测已启用
红色玻璃板 — 检测已禁用
黄色玻璃板 — 实验性检测（名称前带 *）

玻璃板的详细信息（Lore）会显示该检测的启用状态、描述、是否实验性、最大VL与惩罚指令。点击玻璃板即可切换该检测的启用/禁用，切换后立即生效。

注意：GUI 中修改的检测开关仅保存在内存中，不会写回 config.yml。执行 /tatako reload 或重启服务器后，检测开关会恢复为配置文件中的设置。如需持久化修改，请直接编辑 config.yml。

检测

Tatako 涵盖以下检测大类：

Combat（战斗） 包含 Aim（自动瞄准）、Aura（杀戮光环）、AutoClicker（自动点击）、Reach（碰撞箱检测）、Velocity（反击退）等
Movement（移动） 包含 Fly（飞行）、Speed（加速），Move（杂项移动检测），Jesus（水上漂）、Elytra（鞘翅）
Player（玩家） 包含 Interact（交互），Scaffold（搭路），BadPacket（网络），Chat（聊天）

每个检测均可单独开关、设置最大违规次数和处罚命令，参数可在 config.yml 中的 checks.<类型>.<检测名> 下调整。

Combat（战斗）检测

Aim（自动瞄准） — 检测自动瞄准，覆盖砖头GCD、定速转头，转头加速度、启发转头等。其中 Aim (S) 为云端 AI 检测，Aim (4) 为本地 LightGBM 机器学习检测，详见 TTKDAA 机学反自瞄
Aura（杀戮光环） — 检测自动防砍，多重攻击，穿墙攻击等。其中 Aura (Bot) 释放假人。
AutoClicker（连点器） — 检测CPS过高、固定式点击等。
Reach（长臂猿） — 检测攻击目标距离过远、修改攻击碰撞箱等。
Velocity（反击退） — 检测击退接受量，欺骗击退，自动跳跃重置

关于 Aura (Bot) 假人：当玩家的战斗VL达到 spawn-bot-vl（或开启 spawn-bot-on-attack 后每次攻击）时，Tatako 会在玩家身后生成一个用于检测杀戮的假人。杀戮一旦自动攻击假人即会被检测。假人相关参数（存活时间、移动速度、坐标偏移等）均可在 checks.combat.aura.bot 下调整。

Movement（移动）检测

Fly（飞行） — 检测欺骗地面状态、Y轴移动，攀爬过快，跳跃高度、坠落过快、船内飞、忽略漂浮等
Speed（加速） — 检测不可能的移动、忽略摩擦力、蜘蛛网方块上移动过快、取消疾跑包、反向疾跑等
Move（移动综合） — 检测坠落过快、打开背包时移动、爬墙等杂项作弊
Jesus（水速） — 检测液体中移动异常、水上行走等作弊
Elytra（鞘翅） — 检测鞘翅飞行

Player（玩家）检测

Scaffold（搭路） — 检测搭路过快、转头加速度、固定潜行Eagle、拓展搭路、同时有启发等
Interact（交互） — 检查与方块交互，挖掘方块过快，放置方块过快，方块Reach，与物品交互
Chat（聊天） — 检测许景良客户端自动Spam，与聊天刷屏
BadPacket（坏包） — 检测时间加速，无效包，Backtrack回溯位置等

惩罚指令教程

Tatako 的 punish-command 支持一系列语法来配置命令，可以使得惩罚更加智能。语法格式如下：

单次执行格式

vl1:命令1|vl2:命令2

使用 | 分隔多个命令，: 分隔VL阈值和命令。命令会在VL恰好等于阈值时执行一次。

周期执行格式

起始VL1.间隔VL1:命令1|起始VL2.间隔VL2:命令2

使用 . 分隔起始VL和间隔VL。命令会在达到起始VL后每隔间隔VL重复执行。

示例：

1.2:say %player% is cheating — VL=1 时执行，之后每间隔2个VL执行（VL=3,5,7...）
4:say %player% Cheating? — 仅在 VL=4 时执行一次
12:ac staff %player% bot|24:kick %player% &c[Tatako] Unfair Advantage — VL=12 时召唤假人检测，VL=24 时踢出

一次性执行（^ 前缀）

^ban %player% &cTatako detected cheating.

命令前带有 ^ 前缀时，该命令仅在VL达到 max-violations 时执行一次，执行后重置VL。

注意：只要玩家的VL值超过了 max-violations，无论是否真的执行了惩罚，Tatako 内部也会将此玩家标记为已惩罚并重置VL。你不应该在VL未达到 max-violations 前执行真正的踢出或封禁。

惩罚指令支持的占位符：

%player% — 玩家名
%checkName% — 检查名称
%checkType% — 检查类型
%random_ac% — 随机反作弊名称

TTKDAA 检查

TTKDAA检查为Aim (S, 3, 4)，其中Aim (S)检查已废弃，Aim (3)检查为云检查，Aim (4)检查为本地检查

Aim (4)检查会自动在服务器上运行，自动执行LightGBM推断

Aim (3)检查需要你配置云端服务器，具体见论坛教程

三者均为机学转头检测：收集玩家攻击实体时的各项转头特征，交给机器学习模型判断是否为机器瞄准。

Aim (S) — 老云端 AI 检测（已废弃）

Aim (3) — 云端 AI 检测

新的云端 AI 检测，时间窗口更优秀，数据收集目录为 ./Tatako/dataV2。相关配置项：

server-url — 云端推理服务地址）
token — 访问云端服务的令牌
collect — 是否将玩家转头特征写入 dataV2/<玩家名>.csv（用于模型数据的收集，上报此检查的误判或绕过需要这些文件）
max-buffer / buffer-reduce — 检测缓冲区及其衰减

Aim (4) — 本地 LightGBM 检测

无需云端服务器，插件内置的 model.txt（LightGBM 模型）在服务器本地进行推理。模型对每组转头提取各种特征，交由模型进行检测

模型文件 model.txt 位于 plugins/Tatako/，首次启动时自动从 jar 内释放，/tatako reload 时会重新加载。若模型加载失败，Aim (4) 将不生效。

联系方式：QQ群 1044580268，Discord 点击加入，邮箱 [email protected]。