Server Shader Gate & Enforcer

## Description !(https://cdn.modrinth.com/data/2PSEbUW8/images/c8f8cba25c0cabfc1798fdcf7d79c614fa273efe.png) **Server Shader Gate & Enforcer (SSGE)** – a client-side mod and server-side plugin that requires players to install a shader and use specific shader options to play on the server. Upon connecting to the server, the SSGE client mod automatically sends its configuration data about the current shader and its settings to the server plugin. The server plugin compares the received data with its own configuration. If the data matches, the player is allowed onto the server. Otherwise, the connection is refused. The mod requires (https://modrinth.com/mod/iris) and (https://modrinth.com/mod/fabric-api) to work. ## Сonfiguration The configuration file of the mod – `ssge_mod.json`; the configuration file of the plugin for the server – `ssge.yml` <details> <summary>ssge_mod.json</summary> ``` { "shaderFile": "", "shaderOptions": "", "sizeShader": 0, "sizeOptions": 0, "shaderHash": "", "enableShaders": false } ``` This configuration is generated automatically when connected to the server and depends on the Iris settings: the switch on/off shader, selected shader file and selected shader settings `shaderFile` – shaderpack file `shaderOptions` – shader settings file. If the shader uses default settings, this string will be `empty` because the file does not exist. `sizeShader` – shaderpack size in bytes. `sizeOptions` – shader settings size in bytes. If the shader uses default settings, this value is `0`. `shaderHash` - SHA-256 hash of the shader file. `enableShaders` – shaders enabled/disabled switch </details> <details> <summary>ssge.yml</summary> ``` require_enabled: true shader_file: '' shader_options: '' size_shader: 0 size_options: 0 shader_hash: "" require_shader: true require_options: true link: https://example.com/download-shader-with-config exempt_players: ``` Generated automatically and must be configured manually to work properly. `require_enabled` – shaders enabled/disabled switch. `shader_file` – shaderpack file. `shader_options` – shader settings file. If the shader uses default settings, this string will be `empty` because the file will not exist. `size_shader` – shaderpack size in bytes. `size_options` – shader settings size in bytes. If the shader uses default settings, this value is `0`. `shader_hash` – SHA-256 hash of the shader file. `require_shader` – requires a specific shaderpack. `require_options` – requires specific shader settings. `link` – your link to download the shader and specific settings. `exempt_players` - list of exempt players can play on the server without installing the SSGE client mod or using any shaders (e.g., admins or moderators). </details> Use `/ssge reload` to reload the plugin configuration. ## Sending and receiving a link If a player has the client mod installed but their configuration does not match the server’s, the plugin sends them a download link before kicking the player. The client mod receives the link, saves it to the file `ssge_link.txt` in the *`.minecraft/config`* directory, and automatically opens the file for the user. <details> <summary>ssge_link.txt</summary> ``` You received this file because you tried to join a Minecraft server that requires a specific shader (or shader settings) that you may not have installed. Download the shader from the link provided by the server administrator and follow these instructions unless otherwise noted: 1. Download the shader archive (.zip) and the shader settings (.txt) from the link below. 2. Put both files into your game directory's "shaderpacks" folder. 3. Go to the Iris menu, select and enable this shader from the list, and try logging into the server again. If the server provides a checksum (SHA-256), verify it against the downloaded shader file. If you still have any difficulties joining the server, please contact the server administration for help. !!! WARNING: External link below may be dangerous !!! Open it ONLY if you fully trust this Minecraft server and the linked website. Possible risks include: - malicious installers, viruses, or trojans that can harm your system - phishing pages designed to steal Minecraft, Discord, email or other credentials - web scripts that can collect personal or sensitive information - stealers that silently extract passwords, tokens, or browser data - drive-by or automated downloads that execute without clear consent - spoofed or tampered downloads (files different from what they claim) If unsure — do NOT open the link. https://example.com/download-shader-with-config ``` </details> #### Be careful: the server administrator may provide a malicious link to harm your system or steal your data. A