WOLFRAT 2.1.1

Setup Guide • Joint Operations Server Admin Tool

Windows 10/11 • ~49 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, !map / !skip voting
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

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

🎮 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, kill limits, friendly fire, voting, time of day, passwords, and the full weapons matrix. Changes apply immediately.

💬 Chat Tab

Send messages to the server as admin. Supports player-triggered commands like !map, !skip, !list, and !switch. Includes auto-moderation with configurable bad word filters.

📨 Messages Tab

Set up recurring server messages, welcome messages for new players, and the killing spree announcer. Messages rotate on a timer you control.

👥 Mods Tab

Add trusted players as moderators. Mods can use chat commands (!warn, !kick, !ban, !swap, !map, !skip) without needing WolfRAT open.

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
Play the disconnect sound and show the red status
Automatically try to reconnect every 15 seconds
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 Messages 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. 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.

10. Building from Source (Optional)

If you want to modify WolfRAT or build it yourself:

Install Python 3.10+ from python.org
Open PowerShell in the source_code folder
Run .\build.bat
The executable will be in dist\WolfRAT2.exe

💡 Tip: The build script automatically installs PyQt6 and pyinstaller if they're missing.