Skip to content
Dispresso logo
Sign in

Widgets

Arma widget guide

Arma 3 and Reforger query ports, adding the server, and a live card for your website.

Arma servers answer a Steam query, but the query port is not the port players join on, and it differs between Arma 3 and Arma Reforger. Give Dispresso the query port and the rest is automatic.

What you need#

  • Your server's public IP or hostname and its query port.
  • Access to server.cfg (Arma 3) or config.json (Reforger).
  • Manage Server in a Discord that has Dispresso, or a Dispresso login.

1. Get the server ready#

Arma 3: the Steam query port is your game port plus one (2303 when players join on 2302). Reforger: turn on the A2S block in config.json and use its port (17777 in the usual example). Your host panel often labels it "Query port"; copy that number.

Ports and settings at a glance#

SettingWhere it livesWhat to use
Arma 3 game portLaunch options2302 by default. Players join here.
Arma 3 query portGame port plus one2303 by default. This is the one for Dispresso.
Reforger query porta2s section of config.json17777 is the usual value, UDP
Server namehostname (Arma 3) or game.name (Reforger)Where the ownership code goes

Firewall and host: Allow UDP on the query port as well as the game port. Arma 3 uses a small range above the game port, so forward 2302 to 2306 UDP if you can. On Reforger, allow the A2S port you set.

2. Add it to Dispresso#

Easiest is Discord. In a server where Dispresso is, with Manage Server:

  1. 1
    Run /gameserver setup.
  2. 2
    Pick Arma from the list.
  3. 3
    Type the IP and the query port, for example 203.0.113.10:2303.
  4. 4
    Copy the code Dispresso gives you (step 3 below) and press Check when it is in place.
What you type
203.0.113.10
Port: 2303

Prefer the site? Sign in, open /dashboard/servers/games, pick the Arma chip, search for your server and press Claim. If it is genuinely missing, use the collapsed option "Server not on the list? Add it" underneath.

3. Prove it is yours#

Put the code in hostname in server.cfg (Arma 3), or in the server name in config.json (Reforger). Restart, press Check within ten minutes, then remove it.

4. Put the widget on your website#

The widget needs your listing id. Open your server's page on /servers/games and look at the address bar:

Address of a listing page
https://dispresso.co/servers/games/GAME/12345

The number on the end (12345 here) is the id. That is the value for data-server. You can also pin a live card in Discord, which finds the server by name or address for you (last step below).

Arma widget
<!-- One server: replace YOUR_LISTING_ID with the number from your listing's address -->
<div data-dispresso-game-server data-server="YOUR_LISTING_ID"></div>

<!-- Or the busiest arma servers, top 5 -->
<div data-dispresso-game-server data-game="arma" data-limit="5"></div>

<script src="https://dispresso.co/widgets/game-server.js?v=3" async></script>

Paste it where the card should appear. It shows the name, the map when the server has one, players out of the maximum, an Online or Offline pill and when it was last checked. It follows the visitor's light or dark theme; add data-theme="dark" or "light" to force one. How to paste it into WordPress, Wix, Squarespace, Carrd and plain HTML is in Put a widget on any website.

5. Show it in Discord too#

Want the same live numbers in a channel? In the Discord where Dispresso is, with Manage Server, run:

In Discord
/gameserver pin server:Your Server channel:#server-status

Search by the Arma server's name, its IP, IP:port or the listing id. Dispresso posts one card with players, map, status, address and a Join button, and keeps it up to date on its own, even after the bot restarts. /gameserver create does the same thing, /gameserver list shows the cards this server has and /gameserver remove takes one down. The message version works too: !gameserver pin. The card is only for a server that is already listed, so finish the steps above first.

Troubleshooting#

What you seeUsually becauseFix
Unknown foreverThe game port was given instead of the query portArma 3: use game port plus one. Reforger: use the A2S port from config.json.
It works and then goes Offline at nightThe server restarts on a schedule and the refresh caught it downThat is honest data. It returns Online on the next refresh.
The widget says the server is not listed right nowThe id is wrong, the listing is still Pending review, it was removed, or it is marked 18+Open the listing page and copy the number from its address. Approved and not 18+ is the rule for every public widget.
Players never change and it says Checked hours agoThe status query cannot get through, so the last numbers are kept instead of blankedFix the query port or the firewall below. The card catches up on the next refresh.

Still stuck? Open your listing on the site and look at the card there. The widget shows exactly what that page shows, so if the page says Offline or Unknown the problem is the listing, not the embed.

Questions people ask#

Does it cover Arma 2 or older?#

Any Arma server that answers a standard Steam query can be read. Reforger and Arma 3 are the ones this guide is written for.

Can I ask other communities for players?#

Yes, once listed you can turn seeding on for it.

Related#