C&N Party

<div style="text-align: center; padding: 16px 0; border-bottom: 2px solid #8b6f3a; margin-bottom: 20px;"><h1 style="margin: 0; color: #e0c88a; letter-spacing: 2px;">C&amp;N PARTY</h1> <p style="margin: 6px 0 0 0; color: #aaa; font-style: italic;">Party system &amp; MMO-style party HUD for Vintage Story</p> </div> <p style="font-size: 1.05em; line-height: 1.6;">C&amp;N Party is a standalone party system for Vintage Story. Players group up through an ImGui window or chat commands and get an always-on, MMO-style <strong>party HUD</strong> showing every member’s health and online status.</p> <h2 style="color: #e0c88a; border-bottom: 1px solid #555; padding-bottom: 4px;">Core Features</h2> <div style="display: flex; flex-wrap: wrap; gap: 12px; margin: 12px 0;"> <div style="flex: 1 1 260px; border-left: 3px solid #c9a84a; padding: 12px 14px; border-radius: 4px;"> <h3 style="margin: 0 0 8px 0; color: #e0c88a;">Party Management</h3> <p style="margin: 0 0 8px 0;">Groups of up to <strong>5</strong> players (configurable). The leader invites by name; the rest accept or decline.</p> <ul style="margin: 0; padding-left: 20px;"> <li><strong>Invite / accept / decline</strong>, with invites expiring after a configurable timeout</li> <li><strong>Leave</strong>, leader-only <strong>kick</strong> and <strong>disband</strong></li> <li><strong>Promote</strong> any member to leader, plus <strong>automatic handover</strong> when the leader leaves</li> <li>Managed from a GUI window or chat commands</li> </ul> </div> <div style="flex: 1 1 260px; border-left: 3px solid #5a8b3a; padding: 12px 14px; border-radius: 4px;"> <h3 style="margin: 0 0 8px 0; color: #e0c88a;">Party Frames HUD</h3> <p style="margin: 0 0 8px 0;">An always-on overlay listing every member, MMO style.</p> <ul style="margin: 0; padding-left: 20px;"> <li><strong>Live health bars</strong> &amp; online/offline status</li> <li><strong>Server-synced</strong>: works even when teammates are far away or in another arena</li> <li><strong>Leader marker</strong> on the party head</li> <li><strong>Movable</strong>: drag it anywhere, position is remembered</li> </ul> </div> <div style="flex: 1 1 260px; border-left: 3px solid #6a5a8b; padding: 12px 14px; border-radius: 4px;"> <h3 style="margin: 0 0 8px 0; color: #e0c88a;">Library &amp; API</h3> <p style="margin: 0 0 8px 0;">A small public API.</p> <ul style="margin: 0; padding-left: 20px;"> <li><strong>Ally / membership</strong> queries (server &amp; client)</li> <li>Party events to react to roster changes</li> <li><strong>Extensible HUD</strong>: mods add their own per-member bars (e.g. class mana/energy) without C&amp;N Party knowing about them</li> </ul> </div> </div> <h2 style="color: #e0c88a; border-bottom: 1px solid #555; padding-bottom: 4px;">Core Mechanics</h2> <ul style="line-height: 1.6;"> <li><strong>Authoritative on the server</strong>: party membership and leadership live server-side; the client is a mirror used by the GUI and HUD.</li> <li><strong>Health sync</strong>: the server pushes each member’s health fraction to the party so bars stay live regardless of distance or loaded chunks. Refresh rate is configurable.</li> <li><strong>Disconnect-safe</strong>: logging out doesn’t remove you — you show as offline to the rest and rejoin your party automatically on reconnect. If the leader logs out, leadership hands off to an online member.</li> </ul> <h2 style="color: #e0c88a; border-bottom: 1px solid #555; padding-bottom: 4px;">GUI</h2> <p>Open the party window with <strong>U</strong> <span style="color: #bbb;">(default; rebind it in Settings → Controls)</span>. From there you can create a party, invite by name, accept/decline invites, promote, kick, leave or disband.</p> <ul style="line-height: 1.6;"> <li>The <strong>party-frames HUD</strong> appears automatically while you’re in a party.</li> <li>To reposition it: tick <strong>Move HUD</strong> in the party window, drag the frames where you want, then untick it or press <strong>Esc</strong>.</li> </ul> <h2 style="color: #e0c88a; border-bottom: 1px solid #555; padding-bottom: 4px;">Commands Overview</h2> <ul style="line-height: 1.7; font-family: monospace; list-style: none; padding-left: 0;"> <li><strong style="color: #c9a84a;">/canparty create</strong> &nbsp;(alias <strong style="color: #c9a84a;">new</strong>): start a new party</li> <li><strong style="color: #c9a84a;">/canparty invite &lt;name&gt;</strong>: invite a player (leader only)</li> <li><strong style="color: #c9a84a;">/canparty accept &lt;name&gt;</strong> &nbsp;/&nbsp; <strong style="color: #c9a84a;">decline &lt;name&gt;</strong>: answer a pending invite</li> <li><strong style="color: #c9a84a;">/canparty leave</strong>: leave your current party</li> <li><strong style="color: #c9a84a;">/canparty kick &lt;name&gt;</strong>: remove a member (leader only)</li> <li><strong style="color: #c9a84a;">/canparty remove</strong> &nbsp;(alias <strong style="color: #c9a84a;">delete</strong>): disband the party (leader only)</li> <li><strong style="color: #c9a84a;">/canparty list</strong>: show members and pending invites</li> </ul> <p style="font-size: 0.95em; color: #bbb;"><em>The whole command is also reachable via the alias <strong>/cy</strong>. Promoting a leader is done from the party window.</em></p> <h2 style="color: #e0c88a; border-bottom: 1px solid #555; padding-bottom: 4px;">Configuration</h2> <p>Server config at <code>ModConfig/canparty.json</code> (created on first launch):</p> <pre style="border-left: 3px solid #8b6f3a; padding: 10px 14px; overflow-x: auto;"><code>{ "MaxPartySize": 5, "InviteTtlSeconds": 60, "PartyUpdateIntervalMs": 1000 }</code></pre> <ul style="line-height: 1.6;"> <li><code>MaxPartySize</code> - maximum players in a party, including the leader (minimum 1).</li> <li><code>InviteTtlSeconds</code> - how long a pending invite stays valid before it expires.</li> <li><code>PartyUpdateIntervalMs</code> - how often (in milliseconds) the server refreshes member health on t