discord-quest-completer README

项目的 README,来自 github.com/markterence/discord-quest-completer。合并为一个 markdown 文件:README.md。

Discord Quest Completer

GitHub Actions Workflow Status GitHub Actions Workflow Status

A quest completer for Discord. Discord Quest Completer. I don't know what to call this, but there it is.

A Windows desktop application for Discord Rich Presence and completing Discord Quest for games without needing to install the full actual games/applications. Perfect for completing Discord Quests and showing off your gaming status without the storage burden.

https://github.com/user-attachments/assets/de904123-07df-41a9-8db1-ff05cc7ccc9b


📥 Installation

Windows

You can download manually pre-built release binaries on the Releases page.

Alternatively, you can follow the development setup instructions to build the app from source.

[!IMPORTANT] Make sure you place or extract in a location where you have write or execute permissions.

The reason for this is that the app will create dummy game file in the same directory. By default, the app will not need to be run as administrator, unless if it was installed in a directory that requires elevated permissions. (e.g. C:\Program Files\, root of C:\, etc.)

[!NOTE] Webview2 is required to run the app. WebView2 comes preinstalled on Windows 11. On versions older than Windows 11 you may need to install it manually. If you don't have it installed, you can download it from here.

Uninstall

To uninstall the app, simply go to the folder where you extracted or placed the app and delete it's folder and thats it.

The content of the folder may look like this:

discord-quest-completer/
├── discord-quest-completer.exe (main app)
├── data/ 
│   ├── src-win.exe (runner dummy template)
├── games/
│    ├── <game-id>/

✨ Features

⚙️ How It Works

This app creates small executable files that mimic the actual game processes that Discord looks for when detecting a verified game to use it for it's Rich Presence activity. When launched/played, the tiny executables trigger Discord's Rich Presence/Registed Games detection. Discord checks if Game exe name is running, sometimes it needs to be a folder where the game is supposed to be, thats how mainly it detects the Games, we can clearly see this on the "Registered Games" in the settings.

The dummy game executale files used by this program are placed in a folder called games/ folder relative to the main application's exe. As of release build v2025.10.07 the dummy executable file size is around 250kb, it could be smaller but it requires the end-users to install .NET Framework Runtime (which is sometimes comes pre-installed on an up-to-date Windows 11 PC's, so for now the dummy exe using WinAPI through C++ for compatibility rather than C#)

[!TIP] After launching some games over a period of time, those files may accumulate. For a little maintenance, you can manually delete the created folders under the games/ folder if you need to.

Use Cases

:heart: Support :heart:

GitHub - Become a Sponsor on GitHub. One time support, or a recurring donation

Paypal - One-time donation via PayPal

stargazers


🖥️ Supported Platforms

🐧 Linux and 🍎 MacOS Support?

TL;DR: Linux and macOS are not supported.

Currently, only Windows is supported. I will try to add Linux support if I can. I don't have a macOS machine to test on, so macOS support is not going to happen.

The reason for not having Linux and macOS support right now is that I want to make sure the dummy game runner has a minimal size — around 100KB or less for each platform.
For Windows, for example, I used Rust and the windows crate to access the Win32 API and create a dummy window. This compiles to a small 136KB executable.
I also tried a C# .NET app, which is fantastically small — only 7KB — but it may require the end-user to install the .NET 4.7 Runtime.

For Linux, I don’t know where to start yet. I will try to explore more options to keep the runner binary small. It’s also a pain (Wine, Proton, etc. How does Discord detection even work on Linux? LMAO — same for macOS).
Additionally, if you are trying to run the windows build trough Wine in Linux, some of the dependencies such as Microsoft WebView2 somewhat problematic to install and get running.


🛠️ Tech Stack

🧑‍💻 Development Setup

📋 Requirements

🛠️ Development

Install dependencies for the Vue.js frontend using pnpm

pnpm install

Make sure to build and copy the dummy game binary from src-win and is add it on tauri application's "resources" folder.

pnpm build:runner:win && pnpm copy:runner:win

Then run the Tauri dev command to start the development server.

pnpm tauri dev

Other Thoughts

The Discord's RPC server and Rich Presence

There is also an experimental action like Discord RPC functionality along the selected game. It connects to Discord's RPC Gateway to send Activity updates for the selected game using its App ID, even if the game is not actually running. (This is Rich Presence only so Quests will not detect it)

(This may not work for some time, as Discord updates their RPC and SDK. The syntax I used in the Rust code may not be updated, as it is not one of the main focus of this app.)

Though this is functional as it uses Discord Rich Presence, what happens is it uses the App ID of some App on Discord and connects it to the RPC.
See: Discord Developer Docs – Creating an App

For example, the App ID for Overwatch is 356875221078245376, and we use it with something like discordjs/rpc.

// Set this to your Client ID.
const clientId = '356875221078245376'; // This is Overwatch's App ID on Discord, not one I created.
DiscordRPC.register(clientId);

const rpc = new DiscordRPC.Client({ transport: 'ipc' });
const startTimestamp = new Date();

// You will see "Verified Overwatch" on Discord Activity with custom details.
rpc.setActivity({
  details: `Bleet bleet`,
  state: 'in bleet bleet party',
  startTimestamp,
});

This may not be the intended use of Discord's RPC and may violate their Terms of Service.
I am not entirely sure if you can use others' App IDs other than the ones you own in the Discord Developer Dashboard for the application you are developing. Use this feature at your own risk.

Disclaimer

This tool is intended for educational purposes and personal use. Please respect Discord's terms of service, partners, game publishers and advertisers rights when using this application.

The creators and maintainers of this project are not liable for any damages, account suspensions, or other consequences that may arise from using this software. Use at your own risk.

Discord is a registered trademark of Discord Inc. It is referenced on this open-source project for descriptive and definition purposes only and does not imply any affiliation, sponsorship, or endorsement by Discord Inc in any way.


License

MIT License© Mark Terence Tiglao - 2025


discord-quest-completer (markterence/discord-quest-completer)

正在搜索数据库…

这是什么?一款 Windows 桌面应用,无需安装真正的游戏即可完成游戏的 Discord 任务,也可以将 Discord Rich Presence 设置为你选择的游戏。
我该怎么让它运行起来?从 Releases 页面下载预编译的二进制文件,将其解压到一个你有写入权限的文件夹,然后运行该应用。如果要从源代码构建,需要 Tauri、Rust、Node 20+ 和 pnpm。
运行它需要 WebView2 或 .NET 吗?需要 WebView2。Windows 11 自带该组件,但较旧的 Windows 版本可能需要手动安装。模拟游戏运行程序使用 C++ 和 WinAPI 编写,因此不需要 .NET 运行时。
它能在 Linux 或 macOS 上运行吗?不能。它仅支持 Windows,经过测试的版本是 Windows 11。Windows 10 未经测试,不支持 Linux 和 macOS。
作者为什么用 C++ 而不是 C# 来编写模拟游戏运行程序?C# 版本只需约 7KB,但用户电脑上需要 .NET Framework 运行时。作者选择 C++ 和 WinAPI,以获得更广泛的兼容性,每个发布版构建约 250kb。
不运行任务,它能在我的 Discord 状态中显示游戏吗?可以。有一个实验性的 Rich Presence 功能,它使用游戏的 App ID,即使游戏没有运行,也能将其显示为正在玩。它不会完成任务。
技术栈是什么?前端使用 Vue.js 和 pnpm,桌面外壳使用 Tauri,核心逻辑使用 Rust 编写。
应用从哪里获取游戏列表?它从 Discord 的 API 获取可检测游戏列表。开发者可以将同一份列表保存为 src/assets/gamelist.json,用于本地开发。
大小
1.8 MB
星标
1.8K
时长
1年
提交 · 90 天