WOLFRAT 2.5.9

Setup Guide • Joint Operations Server Admin Tool

Windows 10/11 • ~50 MB zip • No install required

1. What Is WolfRAT?

WolfRAT is a remote admin tool for Joint Operations: Typhoon Rising dedicated servers. It connects to your server's admin port and gives you a full Windows GUI to manage players, maps, settings, and chat.

It replaces the original WolfRAT v0.95 from 2005, which was built for Windows XP and doesn't run well on modern systems.

Features at a glance:

Player management - warn, kick, ban, swap teams, kill, zero score
Map rotation editor - add, remove, reorder, set next map, load presets
Live server settings - game mode, kill limits, timers, weapons config
Chat bot - auto-moderation, bad word filters, player !vote / !skip / !list commands
Killing spree announcer - broadcasts streaks at 3, 5, 7, 10 kills
Recurring messages - auto-rotate server messages every 5-60 minutes
Welcome messages - greet first-time joiners automatically
Team balancing - one-click balance or shuffle teams
Auto-reconnect - reconnects automatically if the server drops
End-of-match map voting - players pick the next map with !1 to !5 before the round ends
Web Admin - token-protected mobile dashboard for admin from your phone
Mod commands - trusted players can !warn, !kick, !ban, !map and more from in-game chat
Weapons editor - the full weapon loadout matrix, applied live

2. Requirements

Windows 10 or 11
A running Joint Operations: Typhoon Rising dedicated server
Admin access to that server (username and password)
Network access to the server's admin port (local or via port forwarding)

💡 Tip: WolfRAT works on the same network as your server (LAN) or over the internet, as long as the server's admin port is accessible. If you can connect to the server in-game, WolfRAT can usually connect too.

3. Installation

Download the zip file using the button above
Extract the zip to any folder on your PC (e.g. C:\WolfRAT\)
Double-click WolfRAT2.exe to launch

That's it. No installer, no dependencies, no Python required.

4. Connecting to Your Server

Step 1: Find your server's admin settings

Open your server's game.cfg file (in your JO server folder). Look for these lines:

AdminPort [your port]
AdminName [your username]
AdminPassword [your password]

Write these down - you'll need them in a moment.

💡 Tip: If you don't see these lines, your server admin might not be enabled. Add them to your game.cfg and restart the server.

Step 2: Enter your details in WolfRAT

On the Server tab, fill in:

Field	What to enter
Server Address	Your server's IP address. Use `127.0.0.1` if it's on the same PC, or the server's local/internet IP if it's remote.
Port	The admin port from your `game.cfg` (the `AdminPort` value)
Username	The admin username from your `game.cfg` (the `AdminName` value)
Password	The admin password from your `game.cfg` (the `AdminPassword` value)

Step 3: Click Connect

Hit the Connect button. If everything is correct, the status bar at the bottom will turn green and say "Connected". You'll see the server name, game mode, and player count populate automatically.

⚠️ Can't connect? Make sure:

The server is actually running
The admin port is correct (check game.cfg)
Your firewall isn't blocking the connection
If connecting over the internet, the admin port is forwarded on the server's router

5. Saving Your Server

Once connected, click Save Current to store your server details. Next time you open WolfRAT, just double-click your saved server in the list to load all the fields instantly.

You can save multiple servers if you admin more than one.

6. The Tabs

🖥️ Server Tab

Connection details, saved server profiles, live status (name, mode, player count) and the connection log.

👥 Console Tab

A raw admin console. Type any server command and watch the send/receive log. Handy for anything the other tabs don't cover.

🎮 Players Tab

See everyone connected to your server. Select a player and use the action buttons on the right to warn, kick, ban, swap teams, kill, or zero their score. You can also mix or shuffle teams with one click.

🗺️ Missions Tab

Manage your map rotation. The left column shows all available maps on the server. The right column shows the current rotation. Drag maps from available into rotation, reorder them, set play counts (1x or 2x), and save presets for quick loading.

⚙️ Settings Tab

Adjust server settings live: game mode, friendly fire, auto-rebalance, kill and time limits, vote kick percent, time of day, passwords and server title. Changes apply immediately.

🔫 Weapons Tab

The weapons matrix. Choose which weapons and loadouts are allowed on the server and the change is applied straight away.

💬 Chat Bot Tab

Live chat monitor and admin chat. Players can type !vote <map> to call a map vote, !skip to vote the current map off, !yes to agree, !list to see the rotation and !kd for their stats. Includes auto-moderation with configurable bad word filters and an auto team-swap trigger word.

📢 Messages Tab

Set up recurring server messages on a timer you control, and welcome messages for players joining for the first time.

🔥 Sprees Tab

The killing spree announcer (see section 8) and its per-streak messages.

🛡️ Mods Tab

Add trusted players as moderators. Mods can run admin commands from in-game chat without needing WolfRAT open: !warn, !kick, !ban, !swap, !kill, !map, !add, !remove, !next, !startvote, !mixteams, !balanceteams, !time and !gametime. Map names can be partial, e.g. !map treasure. Mod commands are tracked in the tab.

🌐 Map Voting Tab

End-of-match automatic map voting. See section 9.

🌐 Web Admin Tab

Turn on the built-in mobile dashboard and manage its port, username and access token. See section 10.

7. Auto-Reconnect

WolfRAT has a built-in auto-reconnect feature. If the server goes down (crash, restart, network blip), WolfRAT will:

Detect the drop within 60 seconds (stale poll watchdog)
Play the disconnect sound and show the red status
Automatically try to reconnect with exponential backoff (30s, 60s, 120s)
Restore the green "Connected" status when the server comes back

The Auto-Reconnect checkbox is on by default. Uncheck it if you want manual control.

8. Killing Spree Announcer

Found in the Sprees tab. When enabled, WolfRAT tracks every player's kills and deaths. When a player goes on a streak without dying, it announces it to the server:

Kills	Announcement
3	>>> [Player] is on a KILLING SPREE! <<<
5	>>> [Player] is on a RAMPAGE! <<<
7	>>> [Player] is UNSTOPPABLE! <<<
10	>>> [Player] is GODLIKE! <<<

Streaks reset when the player dies.

9. End-of-Match Map Voting

Found in the Map Voting tab. When enabled, WolfRAT starts a vote automatically a few minutes before each match ends, so the players choose what comes next instead of the rotation deciding for them.

Tick Enable End-of-Match Auto Voting
Set Match Duration to match your server's time limit
Choose how many minutes before the end the vote should start, and how long it runs
Pick how many maps to offer (2 to 5)

WolfRAT announces the choices in chat and players vote by typing !1, !2, !3 and so on. When time is up the winner is queued as the next map. Ties are broken at random.

Maps that have just been played are blacklisted from the next few votes so you don't get the same map over and over. The Reset Pool At slider controls how much of the rotation has to be played before the blacklist clears. Mods can force a vote early with !startvote, and the Start Vote Now button does the same from WolfRAT.

10. Web Admin (Admin from Your Phone)

WolfRAT includes a mobile-friendly web dashboard so you can keep an eye on the server from your phone or tablet. It is off by default.

Open the Web Admin tab and tick Enable Web Admin
Leave the port at 8070 unless it clashes with something else
Click Copy Token. The username (default admin) and this token are the login
On your phone, browse to http://<IP of the PC running WolfRAT>:8070 and log in

The dashboard shows live server status, the player list with swap, kill, zero score, kick and ban actions, recent chat with the ability to send messages, the mission rotation and quick actions like Next Map. Every command goes through the same path as the desktop UI.

⚠️ Security: when enabled, the web server listens on your network. Keep it on your LAN or behind a VPN rather than forwarding the port to the internet, and use Regenerate Token if you think the token has leaked. The Login IP History list shows who has connected.

11. Troubleshooting

"Connection refused"

The server isn't running, or the admin port is wrong. Double-check your game.cfg.

"Connection timed out"

WolfRAT can reach the server's IP but the port isn't responding. Check firewall rules and port forwarding.

"Login rejected"

The username or password is wrong. Note: the original JO:RAT accepted any password, but some server mods enforce real authentication.

Available maps list is empty

Click the Refresh button on the Missions tab. The server needs a moment to send the map list after connecting.

WolfRAT looks frozen

If the server drops without warning, WolfRAT might be waiting on a response. It will auto-disconnect after 60 seconds. If it doesn't, close and reopen it - all settings are saved.

12. Building from Source (Optional)

WolfRAT is open source. The zip only contains the executable; the code lives on GitHub:

Install Python 3.11+ from python.org
Clone github.com/opennova-net/WolfRAT2
Open PowerShell in the cloned folder and run .\build.bat
The executable will be in dist\WolfRAT2.exe

💡 Tip: The build script installs the dependencies (PyQt6, aiohttp, PyInstaller) itself.