GunGame Arena

A companion plugin for Kodeman's GunGame. Sosigs stop ignoring each other: they fight you and each other in Free For All or Team Deathmatch, with an in-map panel to tune it all and a floating Arsenal-style leaderboard on top. Works on every GunGame map and with GunGame Progressions.

Media

▶ Watch a Free For All round (video)

Modes

• Free For All — every sosig for itself, including against you. Sosigs hold grudges against a handful of rivals at a time instead of brawling in one blob, and a share of them are periodically sent hunting for you.
• Team Deathmatch — blue (you plus allies) versus red, optionally green and yellow. First team to a points target wins. Points come from kills, counted for every contestant on a team, you included. The weapon rotation loops instead of ending the round, and GunGame's "Number of weapons" controls are disabled while Teams is active since the round no longer ends on the last weapon. Friendly fire is off by default, so your shots never hurt your own team. Teammates get a blue tint and a floating name tag above their head so you can pick them out at a glance. A "<TEAM> TEAM WINS" banner shows for 5 seconds when a team hits the points target, then the round ends normally.
• Off — original GunGame behaviour; sosigs only fight you.

Match flow

• Spread-out spawns — new sosigs spawn at the point farthest from everyone else, not randomly, so fights don't all start in the same corner.
• Grudges — in Free For All, each sosig is hostile to only a few rivals at a time (picked from nearby contestants, you included) instead of every other sosig, and re-rolls those rivals periodically or whenever one dies.
• Hunters — every so often, a share of hostile sosigs are sent straight at you instead of wandering GunGame's usual random waypoints, so an FFA round doesn't ignore you.
• Skill tiers — every sosig rolls a skill level at spawn: Rookie, Regular, Veteran, or Elite, shown on its leaderboard card as chevrons (Rookie ^ up to Elite ^^^^). Higher tiers aim tighter and react faster — nobody gets aimbot, rookies just miss more.

Leaderboard HUD

A floating panel of cards in front of you: portrait, kill count, name, and a crown for the leader. Sosig portraits are captured from the sosig's own head; your card uses your Steam avatar. Crowns follow the mode — one crown for the top kill count in Free For All, or one crown per team on that team's best contestant in Team Deathmatch (only once a contestant or team has a kill). In Team Deathmatch the header also shows each team's running score and a subtitle naming the points target, and the victory banner rides on this HUD.

In-map Arena panel

A settings panel appears on every GunGame map, standing beside GunGame's own "More options" board, so you never have to leave VR to change how the round plays. Point and click with the same laser pointer GunGame's own buttons use.

Every change saves straight to the config file, so it survives a restart. Rows marked "applies at the next Start Game" take effect the next time you start a GunGame round; everything else applies immediately.

Config

Settings live in BepInEx/config/zgames.GunGameArena.cfg after the first launch. The panel above covers the values you'll actually want to touch mid-session; the rest (rival radius, skill-tier multipliers, HUD placement, name seed, and so on) are config-file only by design, to keep the panel simple.

Compatibility

• Requires BepInEx pack for H3VR (5.4.1700) and Kodeman's GunGame Thunderstore package 1.0.2 or newer (its plugin reports version 1.0.4 internally — that's expected).
• Works on every GunGame map, and with HLin_Mods-GunGame_Progressions. You need at least one GunGame map installed to play (for example localpcnerd-NuketownGunGame or GEnigma-SandpitGunGame); this plugin adds no map of its own.
• Sosig count is GunGame's own setting on its in-map panel, not this plugin's.
• Not H3MP-aware; built and tested for single-player.

Credits & source

Published by ZGames. Kodeman for GunGame, which this plugin extends without forking. Built with BepInEx and Harmony. Source: https://github.com/shahar015/GunGameArena. MIT licensed.

Changelog

1.0.2

• Mod page: added screenshots of the in-map Arena panel (Free For All and Team Deathmatch). No gameplay changes.

1.0.1

Plugin id is now zgames.GunGameArena; settings file renamed to BepInEx/config/zgames.GunGameArena.cfg. Existing shaha.GunGameArena.cfg files are copied over automatically on first launch, so nothing is lost.

1.0.0

Initial public release.

Modes

• Free For All: every sosig fights every other sosig and the player.
• Team Deathmatch: blue (player + allies) vs. red/green/yellow, won by team points (PointsToWin, panel-adjustable); weapon rotation loops instead of ending the round; GunGame's "Number of weapons" controls are disabled while Teams is active; friendly fire off by default; blue team tint and floating name tags on teammates; "<TEAM> TEAM WINS" victory banner on the leaderboard HUD.
• Off: original GunGame behaviour, unchanged.

Match flow

• Spread-out spawns (farthest-point placement instead of random).
• Grudges: FFA sosigs target a handful of rivals at a time instead of everyone at once.
• Hunters: a share of hostile sosigs are periodically sent after the player.
• Skill tiers: Rookie/Regular/Veteran/Elite aim and reaction rolls per sosig, shown as chevrons on the leaderboard card.

Leaderboard

• Floating Arsenal-style HUD: sosig head portraits, generated usernames, kill counts, crowns, team colours; player card uses the Steam avatar.
• Team Deathmatch header shows live team scores and a points-to-win subtitle.

In-map Arena panel

• Settings panel built at runtime beside GunGame's own "More options" board on every GunGame map; edits Mode, Teams, Allies, Points to win, Friendly fire, Leaderboard, Spread spawns, Grudges, Hunters, Hunter pressure, and Skill tiers with the VR laser pointer; every change saves straight to the config file.

Fixes found during testing

• Sodalite's spawn API randomises any requested IFF ≥ 5; the spawn postfix now re-applies the intended team IFF after every spawn.
• Team tint now applies via MaterialPropertyBlock instead of mutating renderer materials, so shared materials aren't instanced or altered for other sosigs.
• Friendly-fire blocking moved to SosigLink.Damage (where health/limb damage is actually applied), not just Sosig.ProcessDamage, so it reliably stops teammate damage.
• Weapon-count buttons are made inert by disabling their colliders, not just their pointable component, since the hand's raycast still finds a disabled FVRPointable.
• Teammate name tags stay alive out of tag range (hidden via canvas, not destroyed) and are torn down cleanly on round end or a mode switch away from Teams.
• Diagnostic logging (panel hierarchy, tag status, tint counts) is gated behind Debug.Verbose so normal runs stay quiet; errors and warnings are always logged.