VRChat Radar

VRChat Radar

Announce world changes, joins, leaves and screenshots as they happen.

VRChat Radar reads VRChat's own log file and turns what it finds into chatbox events — the world you entered, who joined, who left, when you took a photo. It is the most event-driven integration in MagicChatbox, and the one that makes your chatbox feel alive rather than static.

_{The VRChat radar section in Options.}

See the rest of this section

---

What do I need?

1. VRChat, with logging enabled (it is by default).
2. The 📡 VRChat Log Reader permission, which MagicChatbox asks for when you enable the integration.

Important

This integration needs the 📡 VRChat Log Reader permission, because it reads VRChat's log files. Decline it and the integration switches itself back off. You can grant it later under Options → Privacy.

Note

Everything here comes from a local log file that VRChat writes itself. There is no VRChat API involved, no account connection, and nothing is sent anywhere.

---

Display mode

• Radar produces bursts of events, so how they are shown matters more than for most integrations.

  1. Event overlay — events appear briefly over your normal output, then it returns. This is the default.
  2. Always show — keep radar information up permanently.
  3. Transient only — show events for a moment and nothing in between.
  4. Join/leave only — restrict output to who is coming and going.
  5. Compact info — a condensed form.

---

What to announce

1. Joins — on by default.
2. Leaves — on by default.
3. Screenshots — on by default.
4. World download — show progress while a world loads. On by default.
5. Instance type and Region — include these in the world announcement. Both on by default.
6. Session stats — a periodic summary of your session.
7. Avatar blocked warning — tell you when the performance shield blocks an avatar. On by default.

---

Event templates

• Every announcement is a template you can rewrite.

Event	Default template
World	{master}🌎 {world} | 👥 {count} | {type} {region}
Join	👋 {user} joined!
Leave	🏃 {user} left
Screenshot	📸 *Click!* Just took a picture!
Download	⏳ Loading world... {size}MB @ {speed}MB/s
Seen again	👀 {user} is here again!
Session stats	📊 {worlds} worlds | {players} players met | Peak: {peak_session}
Avatar blocked	⚠️ Avatar blocked by performance shield

• Available placeholders are {user}, {world}, {count}, {type}, {region}, {owner}, {master}, {size}, {speed}, {worlds}, {players}, {peak_session}, {peak}, {session_time}, {app_session} and {offline}. Use \n for a line break.

• The Where I am line also has a preset picker with ten ready-made templates: Detailed, With Owner, Compact, Full Stats, Session, Multi-line, Minimal, World Host, Host Stats and Event Host.

• Master icon — shown by {master} when you are the instance master. Default 👑 .

---

How long each event stays up

• Each event type has its own duration in seconds.

  1. Join / leave — 4
  2. Screenshot — 4
  3. World download — 8
  4. Seen again — 5
  5. Session stats — 15
  6. Avatar blocked — 6

---

Seen again

• Radar can recognise someone you were just in an instance with and call it out.

  1. Detect seen again — off by default.
  2. Seen again window — how many minutes count as "just now". Default 5.
  3. Show notification — also raise an in-app notification. On by default.

---

Encounters

• Radar keeps a record of who you have run into.

  1. Show encounter table — display the record in the app.
  2. Min encounter count — only list people seen at least this many times, to filter out one-offs. Default 2.

---

Session handling

1. Use window detection — confirm VRChat is actually running rather than relying on the log alone. On by default.
2. Session timeout — how many minutes of inactivity end a session. Default 15.

---

Camera flash over OSC

• Radar can fire an avatar parameter when you take a screenshot, so your avatar can react with a flash effect.

  1. Send camera flash OSC — off by default.
  2. Parameter — default /avatar/parameters/CameraFlash.

---

Going easy on your PC

• How much of the old log to read at startup (MB) — between 1 and 200. Default 10. This decides how much history the radar knows about when you launch it part-way through a session.

Tip

Raise it if you start MagicChatbox after VRChat and want the worlds and people from earlier in the evening counted. Lower it if startup feels slow.

Note

There used to be a second setting here, How many log lines to keep in memory. It never did anything — the radar reads the log as a stream and keeps no line buffer — so it has been removed.

Note

Backfill is what lets Radar know which world you are already in when you start MagicChatbox mid-session, instead of waiting for you to change worlds.

---

How do I get help?

• You can find help in our Discord Server by creating a ticket.

---