Self-hosting your own SFX converter

Note

This guide is primarily intended for GDPS owners/administrators. If you’re a regular player and SFX conversion is slow, you can ask your GDPS owner to follow this guide :)

Caution

This guide is only useful if you allow your players to upload their own SFXs via files.

This guide will show you how to self-host an SFX converter for your GDPS using either MegaSa1nt’s original JavaScript implementation or M336’s C# rewrite!

Requirements

To be able to follow the rest of this guide, you will need to make sure that:

• You have a GDPS using MegaSa1nt’s GMDprivateServer fork
• You have a device/server capable of running 24/7
• You have a domain name managed through Cloudflare
• You have a stable internet connection

Setting up the converter

Tip

On Linux, to keep your application running even after exiting your SSH session, you can use solutions such as PM2 or Screen!

Setting up MegaSa1nt’s converter

1. Download Node.js, preferably a recent LTS version.
2. Download the repository onto a device or server that can run 24/7, or clone it using the following command: git clone https://github.com/MegaSa1nt/GDPS-ConvertSFX.git.
3. Then, in its (decompressed) folder, install the dependencies by running npm install, then feel free to configure config.json according to your needs.
4. Finally, start the converter by running node . from within the repository folder!

Setting up M336’s converter

1. Download the appropriate precompiled binary for your system from the latest releases.
2. Then, in its (decompressed) folder, feel free to fill out a .env file according to your needs (check out .env.example for an example).
3. Finally, start the converter by running the binary from within the extracted folder (on Linux, you may need to make it executable first using chmod +x <binary_name>).

Making your converter accessible over the internet with Cloudflare Tunnel

Note

There are several ways to make your converter publicly accessible. This guide uses Cloudflare Tunnel because it’s one of the most convenient solutions.

Feel free to use another method if you’re familiar with it!

Caution

Please note that Cloudflare Tunnel has a 100 MB upload limit.

To let people use your converter from your GDPS dashboard, you’ll need to make it accessible over the internet.

1. Open the Cloudflare dashboard, navigate to Networking > Tunnels, and click Create Tunnel.

2. Give your tunnel a name, then follow the instructions to install cloudflared as a service on your server.

3. Once the tunnel is set up, open it, navigate to Routes, click Add route, and select Published application. Configure the route to point to the converter URL you want. Then, if you haven’t changed the converter’s port, use http://localhost:24157 as the service URL.

4. That’s it! Your converter should now be accessible over the internet.

Using your converter on your GDPS

Now, open config/dashboard.php in your GDPS installation.

Here, you can choose to:

• Use only your own converter by removing the other converters from the configuration.

• Keep the existing converters and add your own so that all of them can be used.

---

Last updated: October 24th, 2026