Skip to content

docs: add the kneel length and health rules for roleplay - #19

Merged
Kheartz merged 2 commits into
mainfrom
rp-health-rules
Oct 24, 2026
Merged

Kheartz merged 2 commits into
mainfrom
rp-health-rules

Conversation

@Kheartz

@Kheartz Kheartz commented Oct 19, 2026

Copy link
Copy Markdown
Member

Documents the roleplay health rules merged to mod main in 8cbbac4d (a server owner's request).

Blocked until a contract with these APIs is published. The testing contract is still 1.9.2 without them, so docs:check fails here until the next mod contract publish. Re-run CI then and mark this ready.

  • Health recovery: removes the line saying a respawn or map trip turns recovery back on. player.setHealthRecovery(false) now holds through both.
  • Kneel length: new kneelSeconds rule (default 4; 0 holds the kneel) and player.endKneel(), with a medic /revive sample. Covers standing up at full health (set less in playerDownedEnd) and the game refusing a new kneel for about 0.6 s after a stand-up. Adds a kneelSeconds row to the rules table in Rules and relations.
  • Health over map loads: player.setKeepHealthOnTravel / getKeepHealthOnTravel. A respawn after a death still starts full.

Checked locally against a contract built from mod main with services-cli 0.10.0: docs:check (180 samples), build, docs:links and git diff --check pass.

Pvp kneelSeconds and player.endKneel, player.setKeepHealthOnTravel, and
setHealthRecovery(false) now holding over respawns and map loads.
@Kheartz
Kheartz marked this pull request as ready for review October 24, 2026 21:41
@Kheartz
Kheartz merged commit 454f04f into main Oct 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant