Add an Environment field to the API to identify client-side and server-side mod compatibility

I would like to suggest adding an Environment / Side Compatibility field to the CurseForge API for Minecraft mods.

Currently, the API provides useful information such as Minecraft versions, mod loaders, files, dependencies, categories, and descriptions, but there is no reliable structured field that tells API users whether a mod supports the client, server, or both environments.

This makes it difficult for server management tools, launchers, modpack managers, and automated installers to determine whether a mod should be installed on a dedicated Minecraft server.

It would be very useful if mod authors could specify the supported environment for their projects or individual files.

For example:

{
"environment": {
"client": "required",
"server": "required"
}
}

Possible values could include:

  • required

  • optional

  • unsupported

  • unknown

This would allow the API to represent common situations such as:

Client-only mod

{
"client": "required",
"server": "unsupported"
}

Server-only mod

{
"client": "unsupported",
"server": "required"
}

Required on both client and server

{
"client": "required",
"server": "required"
}

Server supported, but optional on the client

{
"client": "optional",
"server": "required"
}

Ideally, this information would be available through the CurseForge API on the project level and/or file level, because environment requirements may differ between versions or files.

This feature would greatly benefit:

  • Minecraft server management panels

  • Launchers

  • Modpack installers

  • Dedicated server installers

  • Automated mod compatibility analysis

Without a structured environment field, third-party applications currently have to infer server compatibility from descriptions, filenames, external databases, or manual user verification, which is often inaccurate.

Adding this information to the API would make automated Minecraft mod and server management significantly more reliable.

  • Guest
  • Aug 10 2026
  • Future consideration
  • Attach files

Hold on!

Before you post your idea…

This board is being moderated, if you wish for your idea(s) to go public, please consider the following:

  1. Search for existing ideas

    If your idea already exists, vote for it, this will increase the chances for the idea to become reality. Duplicate ideas only split and lower votes

  2. No tech-support

    This board is for new ideas and feature suggestions, for technical issues or bug reports, visit/contact CurseForge Support

  3. English only

    This ensures that the idea is accessible to a wider audience and makes it easier for others to understand and vote for the idea

  4. No profanity

    Any ideas posted with foul language will not be published and get deleted

  5. Stay on point

    Avoid posting 'lists' of different ideas, we won't be able to address them with a proper status and they will get less votes from others, each idea should have its own post