Getting Started - Opera GX Mods

A step-by-step guide on how to begin modding Opera GX and creating your first mod.

Welcome to GX Modding! ๐ŸŽจ๐ŸŽต This guide will help you set up your environment, create your first mod, and preview it inside Opera GX.

๐Ÿš€ Install Opera GX

First, make sure you have Opera GX installed:

๐Ÿงฐ Set Up Your Environment

  • Launch Opera GX.
  • Go to Settings (โš™๏ธ): opera://settings.
  • then navigate to GX Mods:opera://configure/mods.
  • now explore Create Mod: https://dev.gx.games/mods.

This is where youโ€™ll manage your mods.

๐Ÿ“‚ Prepare Your Mod Files

Create a folder structure to organize your modโ€™s assets:

my-first-mod
  • icon-512.png
  • license.txt
  • music/
  • manifest.json
  • sounds/
  • shaders/
  • wallpapers/
    • wallpaper-dark.jpg
    • wallpaper-light.jpg
  • other/

This setup keeps your wallpapers, sounds, and shaders neatly organized.

๐Ÿ“ Create a manifest.json File

The manifest.json file is the blueprint of your mod. Hereโ€™s a basic example:

manifest.json
{
  "name": "My First Mod",
  "version": "1.0.0",
  "description": "This is my first Opera GX Mod!",
  "developer": {
    "name": "Your Name"
  },
  "manifest_version": 3,
  "mod": {
    "license": "license.txt",
    "payload": {
      "wallpaper": [
        {
          "id": "0",
          "name": "Custom Wallpaper",
          "dark": {
            "image": "wallpapers/wallpaper-dark.jpg"
          },
          "light": {
            "image": "wallpapers/wallpaper-light.jpg"
          }
        }
      ]
    },
    "schema_version": 2
  }
}

namestring
true
The title of your mod.
versionrequirednumber
Your modโ€™s version number.
payloadrequiredstring
Defines the modโ€™s contents (wallpapers, sounds, themes, etc.).
schema_versionrequirednumber
The version of the modding system.

๐Ÿ–ฅ๏ธ Load & Preview Your Mod

Once your files are ready:

  1. Open Opera GX Extensions: opera://extensions.
  2. Enable Developer mode.
  3. Click Load unpacked and select your mod folder.
  4. Your mod is now active! Test it inside Opera GX.

๐ŸŽ‰ Congratulations!

Youโ€™ve successfully created your first Opera GX mod! ๐Ÿš€ Keep experimenting and level up your modding skills!

๐Ÿ“š Next Steps: