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:

Tip: Always use the latest version to access the newest modding features!

🧰 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
  }
}