Greenlight

Greenlight

Greenlight is a library mod. It does not add a menu, a feature toggle, or any visible gameplay change by itself.

Install it when another mod says it supports or requires Greenlight.

What Greenlight is for

Some client-side features are harmless cosmetics. Others can affect gameplay, like removing fog, changing darkness, or revealing information the server normally expects players not to have.

Greenlight gives servers and client mods a shared way to handle that:

• The server says which features are allowed.
• The client mod checks that permission before enabling the feature.
• The player can still keep their own local settings.
• The server can set limits, and the client mod clamps to those limits.

The goal is simple: compatible mods should stay vanilla-safe by default, then opt in only when the server allows it.

How servers allow features

A server can publish Greenlight policy through its server resource pack.

No server-side Greenlight mod is required. No Paper, Fabric, NeoForge, or Bukkit plugin is required just to send policy files. If your server can send a resource pack, it can publish Greenlight policies.

Greenlight only trusts policy from resource packs Minecraft marks as coming from the current server. A local resource pack with the same files does nothing.

The server pack can be required or optional. If the player declines, removes, or disables an optional server pack, Greenlight sees no trusted policy and compatible features stay denied.

When you leave the server, the permissions go away.

What Greenlight does not do

Greenlight is not anti-cheat.

A modified client can ignore client-side rules. Greenlight is for honest clients, modpacks, and server communities that want a clean, shared permission system instead of every mod inventing its own handshake.

Greenlight also does not force features on. It only tells compatible mods what the server allows.

For players

You only need Greenlight if a mod you use supports or requires it.

Installing Greenlight alone will not change the game.

If a server does not provide a policy for a feature, compatible mods should treat that feature as denied on multiplayer.

For server owners

Add one JSON policy file per feature to your server resource pack.

Start here:

https://github.com/FlashyReese/greenlight/wiki/Server-Owner-Guide

Policy file format:

https://github.com/FlashyReese/greenlight/wiki/Policy-Files

For mod developers

Greenlight provides one small API for Fabric and NeoForge mods.

You can either:

• Require the full Greenlight runtime.
• Support Greenlight optionally by bundling the API and failing closed when the runtime is missing.

Developer guide:

https://github.com/FlashyReese/greenlight/wiki/Mod-Developer-Guide

License

LGPL-3.0-or-later