AxoStudio Wiki

AxoAntiCheat

AxoStudio

AxoAntiCheat

AxoAntiCheat es un plugin antitrampas avanzado para servidores Paper y Folia. Supervisa movimiento, combate, paquetes, inventarios, interacciones, clientes y evidencias para ayudar al staff a detectar comportamientos sospechosos sin depender de una sola alerta aislada.

Plataforma

Paper y Folia

Tipo

Anticheat

Java Requerido

Java 25+

Autor

AxoStudio

Requisitos

Java 25 o superior.
Servidor Paper compatible con Minecraft moderno.
PacketEvents instalado como plugin del servidor.
PlaceholderAPI, Geyser, Floodgate, LiteBans y AdvancedBan son opcionales.

Caracteristicas principales

Checks de movimiento, combate, inventario, mundo y proteccion contra exploits.
Alertas configurables para staff con confianza, ping, plataforma y nivel de violacion.
Buffers y decaimiento para evitar sanciones por una sola anomalia aislada.
Modo de pruebas para guardar evidencia sin cancelar acciones ni sancionar.
Compatibilidad con jugadores Java y Bedrock mediante perfiles separados.
Replay visual para revisar momentos importantes desde el servidor.
Menus editables inspirados en zMenu.
Mensajes e idiomas desde archivos lang/.

Checks incluidos

La lista puede cambiar segun la version del plugin. Cada check puede activarse, desactivarse y ajustarse desde checks.yml.

Categoria	Checks
Movimiento	`Simulation A`, `Speed A`, `Speed B`, `Fly A`, `Fly B`, `Timer A`
Combate	`NoSwing A`, `AutoClicker A`
Inventario	`FastClick A`
Mundo	`FastPlace A`, `FastBreak A`
Exploits y paquetes	`InvalidMovement A`, `PacketFlood A`

Uso recomendado al instalar

Instala el plugin y deja que genere sus archivos.
Manten testing.no-punishments: true durante los primeros dias.
Revisa alertas, evidencias y replays antes de activar acciones estrictas.
Ajusta tolerancias si tu servidor usa Bedrock, items personalizados o mecanicas especiales.

Instalacion

Descarga AxoAntiCheat desde la pagina del plugin.
Instala PacketEvents en la carpeta plugins/ si todavia no lo tienes.
Mueve el archivo AxoAntiCheat.jar a la carpeta plugins/ de tu servidor.
Inicia el servidor para generar la carpeta plugins/AxoAntiCheat/.
Configura idioma, alertas, checks, sanciones y almacenamiento segun tu servidor.
Usa /aac reload despues de editar archivos YAML.

No actives baneos automaticos al inicio. Primero usa el modo de pruebas para revisar falsos positivos y ajustar el plugin a tu servidor.

Integraciones opcionales

Plugin	Uso
PlaceholderAPI	Permite usar placeholders de AxoAntiCheat en scoreboards, hologramas, tab y otros plugins.
Geyser / Floodgate	Ayuda a identificar jugadores Bedrock y aplicar tolerancias separadas.
LiteBans / AdvancedBan	Se pueden usar mediante acciones configuradas por comando.
Discord Webhooks	Envia avisos externos de violaciones altas, exploits, sanciones y eventos importantes.

Primeros ajustes

testing:
  simulation-mode: false
  no-punishments: true
  detailed-debug: false

alerts:
  chat: true
  console: true
  actionbar: false
  bossbar: false

Con no-punishments activado, el plugin puede registrar alertas y evidencias sin ejecutar castigos configurados.

Comandos principales

Comando	Descripcion
`/aac`	Abre el panel principal o muestra informacion basica.
`/aac help`	Muestra ayuda de comandos.
`/aac alerts`	Activa o desactiva tus alertas de staff.
`/aac verbose <jugador>`	Muestra informacion detallada del jugador.
`/aac inspect <jugador>`	Abre la inspeccion del jugador.
`/aac violations <jugador>`	Muestra violaciones recientes.
`/aac evidence <jugador>`	Muestra evidencia guardada.
`/aac checks`	Lista checks disponibles.
`/aac check <check>`	Muestra detalles de un check.
`/aac enable <check>`	Activa un check.
`/aac disable <check>`	Desactiva un check.
`/aac exempt <jugador> <tipo> <duracion> [motivo]`	Crea una exencion temporal.
`/aac unexempt <jugador> <tipo>`	Quita una exencion.
`/aac setback <jugador>`	Devuelve al jugador a una posicion segura.
`/aac client <jugador>`	Muestra cliente, plataforma y marca reportada.
`/aac clients`	Lista clientes detectados.
`/aac packets <jugador>`	Muestra informacion reciente de paquetes.
`/aac watch <jugador>`	Activa vigilancia reforzada.
`/aac unwatch <jugador>`	Desactiva vigilancia reforzada.
`/aac debug <jugador>`	Muestra diagnostico para revisar comportamiento.
`/aac logs <jugador>`	Consulta registros relacionados.
`/aac status`	Muestra estado general del plugin.
`/aac profile`	Muestra perfil de rendimiento y actividad.
`/aac reload`	Recarga configuraciones, mensajes, checks, menus y webhooks.

Comandos de replay

Comando	Descripcion
`/aac replay mark <jugador>`	Marca un momento importante en el historial del jugador.
`/aac replay capture <jugador> [segundos]`	Guarda una captura reciente del jugador.
`/aac replay start <jugador\|replay-id>`	Inicia una reproduccion para el staff.
`/aac replay stop`	Sale de la reproduccion y restaura al visor.
`/aac replay pause`	Pausa la reproduccion.
`/aac replay resume`	Continua la reproduccion.
`/aac replay seek <tiempo>`	Salta a un momento de la linea de tiempo.
`/aac replay speed <0.25\|0.5\|1\|2\|4>`	Cambia la velocidad de reproduccion.
`/aac replay markers`	Muestra marcadores del replay actual.
`/aac replay export <id>`	Exporta una captura guardada.
`/aac replay delete <id>`	Elimina una captura.
`/aac replay list [jugador]`	Lista capturas guardadas.

Permisos administrativos

Permiso	Descripcion
`axoanticheat.admin`	Acceso completo de administracion.
`axoanticheat.command`	Usar el comando principal.
`axoanticheat.alerts`	Recibir alertas.
`axoanticheat.verbose`	Usar vista verbose.
`axoanticheat.inspect`	Inspeccionar jugadores.
`axoanticheat.violations`	Ver violaciones.
`axoanticheat.evidence`	Ver evidencias.
`axoanticheat.checks`	Ver checks.
`axoanticheat.checks.edit`	Activar o desactivar checks.
`axoanticheat.exempt`	Administrar exenciones.
`axoanticheat.setback`	Ejecutar setbacks.
`axoanticheat.client`	Consultar clientes detectados.
`axoanticheat.packets`	Consultar informacion de paquetes.
`axoanticheat.watch`	Administrar vigilancia reforzada.
`axoanticheat.debug`	Ver diagnostico.
`axoanticheat.logs`	Consultar logs.
`axoanticheat.reload`	Recargar el plugin.

Permisos de replay

axoanticheat.replay - acceso general.
axoanticheat.replay.view - ver replays.
axoanticheat.replay.capture - crear capturas.
axoanticheat.replay.mark - agregar marcadores.
axoanticheat.replay.export - exportar capturas.
axoanticheat.replay.delete - eliminar capturas.
axoanticheat.replay.containers - ver acciones de contenedores.
axoanticheat.replay.inventory - ver inventarios en replays.
axoanticheat.replay.entities - ver entidades capturadas.
axoanticheat.replay.admin - administracion completa de replay.

Bypass

axoanticheat.bypass - bypass general.
axoanticheat.bypass.movement - bypass de movimiento.
axoanticheat.bypass.combat - bypass de combate.
axoanticheat.bypass.inventory - bypass de inventario.

Usa bypass solo para staff, NPCs, bots administrativos o jugadores con mecanicas especiales controladas.

Como funcionan

Los placeholders internos funcionan dentro de mensajes, menus, alertas y acciones del plugin.
Los placeholders de PlaceholderAPI funcionan en otros plugins si PlaceholderAPI esta instalado.
Los valores de jugador necesitan un jugador en contexto.
Si un valor no existe, el placeholder puede mostrarse vacio o como valor neutral.

PlaceholderAPI

El identificador externo es axoanticheat. Estos placeholders se pueden usar en scoreboards, tab, hologramas y otros plugins compatibles.

Placeholder	Devuelve
`%axoanticheat_player_client%`	Cliente probable o reportado del jugador.
`%axoanticheat_player_platform%`	Plataforma del jugador: Java, Bedrock o desconocida.
`%axoanticheat_player_ping%`	Ping actual del jugador.
`%axoanticheat_player_protocol%`	Version de protocolo detectada.
`%axoanticheat_player_violations%`	Total reciente de violaciones del jugador.
`%axoanticheat_player_last_check%`	Ultimo check relacionado al jugador.
`%axoanticheat_player_confidence%`	Confianza de la ultima deteccion.
`%axoanticheat_player_watched%`	Indica si el jugador esta bajo vigilancia.
`%axoanticheat_total_flags%`	Total de flags registrados.
`%axoanticheat_online_staff%`	Staff conectado con permisos de alertas.
`%axoanticheat_status%`	Estado general del plugin.

Placeholders internos comunes

%prefix% - prefijo definido en el archivo de idioma.
%player% - nombre del jugador.
%check% - nombre del check.
%type% - tipo del check.
%vl% - nivel de violacion.
%confidence% - confianza de la deteccion.
%ping% - ping del jugador.
%platform% - plataforma del jugador.
%client% - cliente detectado o reportado.

Carpeta de menus

Todos los menus editables estan en plugins/AxoAntiCheat/menus/. Puedes cambiar titulos, materiales, slots, lore, acciones y permisos sin editar el plugin.

main.yml - menu principal.
players.yml - lista de jugadores.
player-inspection.yml - inspeccion de jugador.
violations.yml - violaciones.
evidence.yml - evidencias.
checks.yml - checks.
check-editor.yml - editor de checks.
clients.yml - clientes detectados.
settings.yml - ajustes.
replays.yml, replay-details.yml, replay-markers.yml, replay-controls.yml - sistema de replay.

Formato tipo zMenu

name o title define el titulo del inventario.
size define el tamano, normalmente 27, 36, 45 o 54.
items contiene los botones del menu.
slot acepta un slot unico.
slots acepta lista de slots o rangos como 10-16.
matrix permite colocar items por letras, estilo zMenu.
item.material, item.name y item.lore controlan el item mostrado.
player-head, glow, custom-model-data, encantamientos y flags son soportados.
actions, clicks, left-commands y right-commands definen acciones al hacer clic.

Traducciones desde lang

Si un texto empieza con lang:, el plugin busca la clave en el idioma del jugador. Esto permite traducir menus sin duplicar archivos completos.

name: "lang:menu.main.title"
size: 54
items:
  checks:
    slot: 20
    item:
      material: COMPASS
      name: "lang:menu.main.items.checks.name"
      lore:
        - "lang:menu.main.items.checks.lore.0"
    actions:
      - type: inventory
        inventory: checks

Ejemplo con formato zMenu

title: "lang:menu.players.title"
size: 54

items:
  player:
    slots:
      - "10-16"
      - "19-25"
      - "28-34"
      - "37-43"
    item:
      material: PLAYER_HEAD
      player-head: "%player%"
      name: "lang:menu.players.items.player.name"
      lore:
        - "lang:menu.players.items.player.lore.0"
        - "lang:menu.players.items.player.lore.1"
        - "lang:menu.players.items.player.lore.2"
    clicks:
      left:
        actions:
          - type: inventory
            inventory: player-inspection
      right:
        commands:
          - "aac verbose %player%"

Estructura de carpetas

plugins/AxoAntiCheat/
├── config.yml
├── checks.yml
├── punishments.yml
├── exemptions.yml
├── storage.yml
├── clients.yml
├── webhooks.yml
├── performance.yml
├── lang/
│   ├── es_ES.yml
│   └── en_US.yml
├── menus/
│   ├── main.yml
│   ├── players.yml
│   ├── player-inspection.yml
│   ├── violations.yml
│   ├── evidence.yml
│   ├── checks.yml
│   ├── check-editor.yml
│   ├── clients.yml
│   ├── settings.yml
│   ├── replays.yml
│   ├── replay-details.yml
│   ├── replay-markers.yml
│   └── replay-controls.yml
├── logs/
├── data/
└── replays/

Archivos YAML principales

config.yml - idioma, modo de pruebas, replay, alertas, plataformas e integraciones generales.
checks.yml - checks, buffers, decaimiento y thresholds.
punishments.yml - acciones por violacion y confianza.
exemptions.yml - exenciones automaticas y administrativas.
storage.yml - SQLite, MySQL o MariaDB.
clients.yml - deteccion de clientes y marcas sospechosas.
webhooks.yml - avisos externos.
performance.yml - limites de historiales, colas y cache.
lang/*.yml - mensajes, prefijo, alertas y textos de menus.
menus/*.yml - interfaces visuales editables.

Idioma por cliente

language:
  default: "es_ES"
  auto-detect-client: true
  fallback: "en_US"
  fallbacks: ["en_US"]

Si auto-detect-client esta activado, AxoAntiCheat intenta usar el idioma del jugador. Si no existe ese archivo, usa el idioma por defecto o el fallback.

Checks y sanciones

checks:
  movement:
    speed:
      A:
        enabled: true
        experimental: false
        buffer: { increase: 1.0, decay: 0.15, maximum: 30.0 }
        thresholds: { alert: 3.0, setback: 7.0, kick: 18.0, punish: 25.0 }

Los checks no deben sancionar por una sola alerta. Ajusta buffers y thresholds segun ping, modalidad, Bedrock y mecanicas del servidor.

Almacenamiento

storage:
  type: SQLITE

  sqlite:
    file: data.db

  mysql:
    host: localhost
    port: 3306
    database: axoanticheat
    username: root
    password: ""
    pool-size: 10
    ssl: false

Replay

replay:
  enabled: true
  rolling-buffer:
    enabled: true
    duration-seconds: 30
    capture-rate-ticks: 1
    maximum-memory-per-player-mb: 4
  automatic-capture:
    enabled: true
    seconds-before-trigger: 20
    seconds-after-trigger: 10

El replay guarda un historial limitado por jugador y puede capturar automaticamente momentos con confianza alta, sanciones, reportes o exploits.