## Description<\/p>\n
\n**Server Shader Gate & Enforcer (SSGE)** \u2013 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.<\/p>\n
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.<\/p>\n
The mod requires Iris and Fabric API to work.<\/p>\n
## \u0421onfiguration<\/p>\n
The configuration file of the mod \u2013 `ssge_mod.json`; “` 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 <\/p>\n `shaderFile` \u2013 shaderpack file<\/p>\n `shaderOptions` \u2013 shader settings file. If the shader uses default settings, this string will be `empty` because the file does not exist.<\/p>\n `sizeShader` \u2013 shaderpack size in bytes.<\/p>\n `sizeOptions` \u2013 shader settings size in bytes. If the shader uses default settings, this value is `0`.<\/p>\n `shaderHash` – SHA-256 hash of the shader file.<\/p>\n `enableShaders` \u2013 shaders enabled\/disabled switch<\/p>\n<\/details>\n “` Generated automatically and must be configured manually to work properly.<\/p>\n `require_enabled` \u2013 shaders enabled\/disabled switch.<\/p>\n `shader_file` \u2013 shaderpack file.<\/p>\n `shader_options` \u2013 shader settings file. If the shader uses default settings, this string will be `empty` because the file will not exist.<\/p>\n `size_shader` \u2013 shaderpack size in bytes.<\/p>\n `size_options` \u2013 shader settings size in bytes. If the shader uses default settings, this value is `0`.<\/p>\n `shader_hash` \u2013 SHA-256 hash of the shader file.<\/p>\n `require_shader` \u2013 requires a specific shaderpack.<\/p>\n `require_options` \u2013 requires specific shader settings.<\/p>\n `link` \u2013 your link to download the shader and specific settings.<\/p>\n `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).<\/p>\n<\/details>\n Use `\/ssge reload` to reload the plugin configuration.<\/p>\n ## Sending and receiving a link<\/p>\n If a player has the client mod installed but their configuration does not match the server\u2019s, the plugin sends them a download link before kicking the player.<\/p>\n 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.<\/p>\n “` Download the shader from the link provided by the server administrator and follow If the server provides a checksum (SHA-256), verify it against the downloaded shader file. !!! WARNING: External link below may be dangerous !!! Possible risks include: If unsure \u2014 do NOT open the link.<\/p>\n https:\/\/example.com\/download-shader-with-config<\/p>\n “`<\/p>\n<\/details>\n #### Be careful: the server administrator may provide a malicious link to harm your system or steal your data. Always check the link using online scanners and do not open it if it looks suspicious. If you detect a threat, report the server on the hosting platform or listing website.<\/p>\n When placing a link in the plugin configuration, follow these guidelines:<\/p>\n – The link should not be excessively short or long.<\/p>\n – The link should be readable and not contain random strings.<\/p>\n – Avoid shortened URLs or redirects to third-party resources.<\/p>\n – The link must not lead to websites containing malware, scripts, or suspicious content.<\/p>\n – If the link leads to a file-sharing service, it should point directly to a `.zip` file or a `folder` containing the shader and settings.<\/p>\n – If your Minecraft server has its own website, it\u2019s better to create a dedicated download page.<\/p>\n – The link should not point to any installer files (`.exe`, `.msi`, `.jar`, etc.).<\/p>\n – The website should not require registration, phone numbers, email, or other personal data.<\/p>\n ## For example<\/p>\n Let’s say we want all players on our server to play using thejinxedartist’s MC VHS shader.<\/p>\n Then the plugin configuration can be like this:<\/p>\n “` Requires players to use a shader on the server (Iris)<\/p>\n","protected":false},"featured_media":137460,"template":"","meta":{"_minecraft_slug":"server-shader-gate-enforcer","_minecraft_project_id":"2PSEbUW8","_minecraft_author":"VolfLife","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":4104,"_minecraft_follows":11,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"server-shader-gate-enforcer.zip","_minecraft_size_bytes":360257,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T04:16:19.641682Z","_minecraft_date_created":"2025-09-03T03:58:05.560652Z","_minecraft_date_modified":"2025-10-10T12:38:30.928378Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/server-shader-gate-enforcer","_minecraft_icon_attachment_id":137460,"_minecraft_imported_at":"2026-06-08T03:01:35+00:00","_minecraft_import_hash":"51979b497dc535e6eaafc721f61ca5ee","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,97,125,89,127,129,92,985],"mod_loader":[99],"minecraft_version":[40,79,80,81,82],"class_list":["post-137459","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-fabric","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nthe configuration file of the plugin for the server \u2013 `ssge.yml`<\/p>\nssge_mod.json<\/summary>\n
\n{
\n “shaderFile”: “”,
\n “shaderOptions”: “”,
\n “sizeShader”: 0,
\n “sizeOptions”: 0,
\n “shaderHash”: “”,
\n “enableShaders”: false
\n}
\n“`<\/p>\nssge.yml<\/summary>\n
\nrequire_enabled: true
\nshader_file: ”
\nshader_options: ”
\nsize_shader: 0
\nsize_options: 0
\nshader_hash: “”
\nrequire_shader: true
\nrequire_options: true
\nlink: https:\/\/example.com\/download-shader-with-config
\nexempt_players: []
\n“`<\/p>\nssge_link.txt<\/summary>\n
\nYou received this file because you tried to join a Minecraft server that requires
\na specific shader (or shader settings) that you may not have installed.<\/p>\n
\nthese instructions unless otherwise noted:
\n1. Download the shader archive (.zip) and the shader settings (.txt) from the link below.
\n2. Put both files into your game directory’s “shaderpacks” folder.
\n3. Go to the Iris menu, select and enable this shader from the list, and try logging into the server again.<\/p>\n
\nIf you still have any difficulties joining the server, please contact the server administration for help.<\/p>\n
\nOpen it ONLY if you fully trust this Minecraft server and the linked website.<\/p>\n
\n – malicious installers, viruses, or trojans that can harm your system
\n – phishing pages designed to steal Minecraft, Discord, email or other credentials
\n – web scripts that can collect personal or sensitive information
\n – stealers that silently extract passwords, tokens, or browser data
\n – drive-by or automated downloads that execute without clear consent
\n – spoofed or tampered downloads (files different from what they claim)<\/p>\n
\nrequire_enabled: true <\u2013\u2013\nshader_file: 'MCVHSV2.zip' <\u2013\u2013 Required \nshader_options: 'MCVHSV2.zip.txt' <\u2013\u2013 values\nsize_shader: 275232 <\u2013\u2013\nsize_options: 79 <\u2013\u2013\nshader_hash: \"e59a3d139...\" <\u2013\u2013\nrequire_shader: true\nrequire_options: true\nlink: https:\/\/modrinth.com\/shader\/mc-vhs\nexempt_players: [\"Admin\", \"You\"]\n```\n\nThe mod configuration must match the plugin configuration and be like this:\n\n```\n{\n \"shaderFile\": \"MCVHSV2.zip\",\n \"shaderOptions\": \"MCVHSV2.zip.txt\",\n \"sizeShader\": 275232,\n \"sizeOptions\": 79,\n \"shaderHash\": \"e59a3d139...\",\n \"enableShaders\": true\n}\n```\n\nIf the player has a different configuration, the server will kick him.\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"