# Vision

This page explains every configurable option available in the Vision module for Nemesis.


# Overview

The Vision module handles all world-protection systems that hide or block unfair visual advantages such as X-ray, freecam, and illegal structure visibility.
It is the core anti-visual-cheat system in Nemesis and should remain enabled for full protection.


# Configuration Options

# enabled

  • Description: Toggles the Vision module on or off globally.
  • Default: true
  • Recommended: Keep enabled unless troubleshooting.

# anti-xray

  • Description: Blocks players from seeing hidden ores or blocks through X-ray or resource pack modifications.
  • Default: true
  • Sub-settings:
    • engine-mode: The algorithm used to hide ores.
      • 1 → Performance mode (fastest, slightly less secure).
      • 2 → Full protection mode (stronger, higher CPU usage).
    • max-depth: The number of blocks below the surface affected by anti-xray.
      • Default: 64

# anti-freecam

  • Description: Prevents players from viewing or interacting with entities, chests, or structures through walls using client-side freecam.
  • Default: true
  • Sub-settings:
    • range-check: Maximum distance before interaction is blocked.
      • Default: 6.0
    • block-interact: Blocks interaction attempts while in freecam.
      • Default: true

# structure-hiding

  • Description: Dynamically hides strongholds, mineshafts, and other structures from unauthorized players.
  • Default: true
  • Sub-settings:
    • update-interval: How often structure visibility updates for nearby players.
      • Default: 40 ticks
    • ignored-players: List of permission-based players exempt from structure hiding.
      • Default: ["nemesis.admin", "nemesis.builder"]

# cache

  • Description: Stores previously hidden chunks in a lightweight cache to improve performance.
  • Default: true
  • Sub-settings:
    • size-limit: Maximum number of cached chunks.
      • Default: 5000
    • expire-after: Time (in seconds) before old cache entries are cleared.
      • Default: 120

# Permissions

Permission Node Description
nemesis.vision.bypass Allows a player to bypass all vision checks.
nemesis.vision.debug Enables extra debug messages for testing.
nemesis.vision.admin Grants full access to all vision commands.

# Debug Options

# debug

  • Description: Logs detailed Vision module data to the console. Use this for testing only.
  • Default: false

# Notes

  • Disabling Anti-Xray or Structure Hiding can significantly reduce protection levels.
  • High engine-mode values may increase CPU usage but give better concealment.
  • Always restart the server after changing Vision-related options.