ONI RCON is an admin console for Project Reclaimer Halo 3 dedicated servers. Every server you run is on one screen: players, a live feed of chat and kills, kicks and bans, map and mode control, ReclaimerForge browsing and publishing, and a setup screen that can host a server for you. This thread is where its patch notes live, and where questions go.
1.6.0 is a desktop app release (Windows, macOS on Apple Silicon, Linux). The terminal console isn't part of it and stays at 0.9.0.
What's new
Server frame rate: see which servers are lagging
A Halo 3 server aims for 60 frames a second and writes a line to its log for every minute it spent under 54. ONI RCON now reads those lines and shows them in four places:
- F7 HEALTH has a FRAME RATE table. For each server: FPS now, the 5-minute average, the worst reading, the longest single frame, how many players were on, and when it last fell behind.
- FRAME TIME chart. The last 30 minutes of the selected server, one column a minute, with the 60 fps line dashed across it. A column taller than the line is lag. The amber tick on each column is that minute's longest frame. Next to it, WHAT'S HAPPENING and WHAT TO DO say what's going on in plain words, including the smallest crowd the server has fallen behind with.
- The station card in the left-hand list shows the rate (for example
38fps), but only while the server is falling behind.
- F3 OPERATIONS has a SERVER FPS line in the sitrep.
The feed (F2) says so once when a server drops under 40 fps and once when it has kept up for 3 minutes. These are quiet notes: no banner, no chime.
docs/SERVER-PERFORMANCE.md in the repo is a plain guide to reading all of this. It also explains why more CPU cores rarely help a single lobby.
To see it without a server, choose Try the demo on the setup screen. The last demo server is the laggy one.
Find a player on any server (Ctrl+F)
Ctrl+F, or "Find a player" in the command palette (Ctrl+P), searches the players on every connected server at once.
- Type a name. A typo still finds them once you've typed 4 characters or more, and exact matches are listed first.
- Narrow it with
@tag, clan:, team:, id:, server:, node: or port:. Put "quotes" around a phrase.
- Every word has to match the same player.
- Enter opens that player's server with them selected on F1.
Ctrl+R refreshes the rosters.
Example: mantis team:red finds Mantis on the red team, and mantiz still finds Mantis.
RESTART SERVER works for a server on your own Windows PC
RESTART SERVER (F3) was greyed out for a local Windows server unless HOST ONE HERE had added it fresh. A server added by hand, or by an older build, had no restart command. The console now fills it in when the server's own folder lists that port, so the button works without editing your config.
Now GPL-3.0-or-later
Using the app is unchanged. The code is now under GPL-3.0-or-later instead of MIT, which is what lets work from RifleJock's GPL fork (ibigsnet/oni-rcon, ibigs, LLC) come across. The frame rate and player search features above are ported from it, and the repo's NOTICE file credits it. Earlier releases stay available under MIT.
Updating
At start the app checks GitHub for a newer desktop release and asks before installing. The download is verified against the signing key built into the app, installed, and the console restarts. The Linux .deb and .rpm can't update in place, so they get a link instead. ONI_RCON_NO_UPDATE=1 turns the check off. If you're on a build older than 1.2.0, install this one by hand from the releases page once.
Your config file, keys and saved servers carry over unchanged. Nothing new needs setting up to get the player search. Frame rate needs one thing, below.
Q&A
The frame rate says "Not measured yet", or F7 shows nothing. Why?
Frame rate comes from the server's log, read through your health_cmd, so health_cmd has to print the log (for Docker, docker logs --timestamps --since {since} <container>). FIND SERVERS ON IT sets this up when every server it finds is in a Docker container. Servers added by hand, and a server hosted on Windows with HOST ONE HERE (it runs in a window of its own), have no health_cmd until you write one. If your server writes its log to a file, point health_cmd at it. The README's Health watch section has a working Docker example.
If your health_cmd filters the log with grep, keep the lines containing falling behind and Network upload over the last. The second one tells the console it is reading the whole log, so a minute with no lag line counts as 60.
Is the number exact?
Close, and it errs on the kind side. The server only logs minutes that dipped under 54. The console counts every other minute as 60, and a "fine" second can really be 55. It can under-report a dip, but it never invents one.
Will it slow my server down?
No. It only reads the log the server already writes.
My server is red. What do I do?
Lower the player limit, or move the server to a machine with faster cores. The game does almost all its work on one processor core, so an 88-core box with slow cores can still lag. A heavy map or mod in the rotation, or low host memory (HOST on F7), can cause it too. WHAT TO DO on F7 says the same in the app.
Does it show the game thread or Wine load?
Not in this release. Those readings need RifleJock's fleet agent, which isn't part of this app.
What does Find a player search? Does it search IP addresses?
Player name, service tag, clan, team, player ID, and the server's name, node and port. It does not search players' IP addresses. NODE is the server's host, and it is hidden like other addresses until you press x. It looks only at servers that are connected, and lists the first 200 matches. Tags and IDs are never fuzzy, only names.
Why does restarting one of my Windows servers restart all of them?
HOST ONE HERE runs every server in the folder from one process, so one restart takes them all down and brings them back. Everyone on them is dropped, and the console reconnects when they're up.
Does the GPL change what I can do with it?
Running it is the same. If you pass on a modified copy, the GPL says it has to stay under the GPL with its source. NOTICE and LICENSE in the repo have the details.
Where do I report a bug or ask for something?
Reply here, or open an issue on GitHub. If something reads as "—" where your server sends data, include the raw JSON from the dossier on F1.