Fake Night Vision 1.0.0

Features

• Supports multiple presets that you tie to separate permissions, so different player groups can see completely different “night-vision” skies.
• Per-preset control over the hour of day, fog, rain, clouds, and wind allows you to create exactly the ambience you want without affecting the server's actual environment for everyone else.
• Gives a dedicated HUD button players can click to toggle night-vision.
• Shows a small red status icon while night-vision is active, so players always know when the effect is locked.
• Optionally auto-activates night-vision the moment a player joins the server, based on their assigned preset.
• Built-in scheduler can turn night-vision on and off at specific in-game hours you choose.
• Per-player cooldown stops spam-toggling.
• Each preset can automatically turn off after a set number of seconds, making it ideal for temporary effects or time-limited perks.
• Admin-only console command lets you apply a custom sky to any online player, with optional timer and full control over weather settings.
• All client changes are sent with EnvSync packets only to targeted players; the world time and weather stay untouched for everyone else.

Permissions

• fakenightvision.<suffix> - Grants access to a specific night vision preset. The <suffix> matches the Permission Suffix defined in that preset (e.g. default, vip, premium, etc).

Commands

• /fakenv - Chat command for players to toggle their night vision mode, if their preset allows manual toggling.
• fakenv.set <playerNameOrId> <time> <duration> [fog] [rain] [clouds] [wind]- Console command for admins to force night vision for a target player with full control over time and weather parameters.
  • playerNameOrId - The name or SteamID of the target player.
  • time - The in-game time to simulate (e.g., 1.5 for 1:30 AM).
  • duration - How long the fake environment should remain (in seconds). 0 means permanent until manually toggled off.
  • fog - (Optional) Fog level to apply (0–1).
  • rain - (Optional) Rain level to apply (0–1).
  • clouds - (Optional) Cloud level to apply (0–1).
  • wind - (Optional) Wind level to apply (0–1).

Configuration

{
  "Version": "1.0.0",
  "Chat Command": "fakenv",
  "Date Used For EnvSync (m/d/yyyy)": "1/1/2025",
  "Presets": [
    {
      "Permission Suffix": "default",
      "Player Can Toggle": true,
      "Toggle Cooldown Seconds": 90.0,
      "Auto Enable On Connect": false,
      "Auto On At Hour (-1 = never)": -1.0,
      "Auto Off At Hour (-1 = never)": -1.0,
      "Unlock After Seconds (0 = permanent)": 0.0,
      "Time (0-24)": 2.0,
      "Fog (0-1)": 0.0,
      "Rain (0-1)": 0.0,
      "Clouds (0-1)": 0.05,
      "Wind (0-1)": 0.05
    },
    {
      "Permission Suffix": "vip",
      "Player Can Toggle": true,
      "Toggle Cooldown Seconds": 90.0,
      "Auto Enable On Connect": true,
      "Auto On At Hour (-1 = never)": 19.0,
      "Auto Off At Hour (-1 = never)": 6.0,
      "Unlock After Seconds (0 = permanent)": 0.0,
      "Time (0-24)": 1.5,
      "Fog (0-1)": 0.1,
      "Rain (0-1)": 0.0,
      "Clouds (0-1)": 0.15,
      "Wind (0-1)": 0.1
    }
  ]
}

• Chat Command - The chat command players can use to toggle their night vision effect.
• Date Used For EnvSync - Base calendar date used internally to calculate time for syncing the fake environment.
• Presets - A list of night-vision configurations, each with its own permission suffix and weather settings.

• Permission Suffix - The suffix used to generate the permission string required for accessing this preset (e.g., fakenv.vip).
• Player Can Toggle - Whether players are allowed to manually toggle the night vision effect.
• Toggle Cooldown Seconds - Time a player must wait before toggling night vision again.
• Auto Enable On Connect - If true, night vision is automatically enabled when the player joins the server.
• Auto On At Hour - Specific in-game hour to auto-enable the effect (-1 disables auto-on).
• Auto Off At Hour - Specific in-game hour to auto-disable the effect (-1 disables auto-off).
• Unlock After Seconds - How long the night vision stays active before disabling automatically (0 = never disables).
• Time - The in-game time to simulate for this preset (e.g., 2 = 2 AM).
• Fog - The level of fog to apply with the preset (0 = no fog, 1 = max fog).
• Rain - The level of rain intensity to simulate (0 = no rain, 1 = heavy rain).
• Clouds - Cloud coverage level (0 = clear skies, 1 = overcast).
• Wind - Wind strength simulated for the effect (0 = no wind, 1 = max wind)

Localization

{
  "Error.NoPermission": "You do not have permission to perform this action.",
  "Error.AdminOnly": "Admin privileges required.",
  "Error.ToggleDisabled": "You do not have permission to switch Night-Vision on or off.",
  "Error.InvalidTime": "Invalid time (expected 0 – 24).",
  "Error.InvalidDuration": "Invalid duration (seconds).",
  "Error.PlayerNotFound": "Player '{0}' not found or not online.",
  "Info.CooldownRemaining": "Please wait {0} before enabling again.",
  "Info.NvEnabled": "Night-vision mode enabled (time {0}).",
  "Info.NvDisabled": "Night-vision mode disabled.",
  "Help.SetUsage": "Usage: fakenv.set <playerNameOrId> <time> <duration> [fog] [rain] [clouds] [wind]",
  "Log.SetSuccess.Admin": "Applied Night-Vision to {0} (time {1}, {2}).",
  "Notify.SetSuccess.Player": "Night-vision mode enabled (time {0}{1})."
}