B7: Weapon roster and consumables

Eight slot weapons: the six from the design plus the rivet repeater (fast,
short-range automatic) and the harpoon gun (slow heavy bolt, 2.5x damage to
built pieces). Four quality tiers, Rusted to Captain's, scale damage and reload
time. The line thrower now yanks the shooter towards where its line lands,
through a data field (pull_speed) any weapon can use.

Four consumables: sailcloth bandage (heals to 75), brine tonic, cork vest and
the new tar patch. Fire with one held starts using it if it would help; it
takes effect after its use time. Changing slot, dropping, sprinting, swimming
or elimination interrupts it and uses nothing up. All checks run on the server.

A data-validation test covers every weapon, tier, consumable and ammunition
type, including unknown stat keys, name format and that every ammo type is
used. The GDD's weapons section lists the roster.

Closes #21

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-11 17:26:04 -05:00
co-authored by Claude Opus 5.5
parent ed46b6e19f
commit 5d2a2bbc31
12 changed files with 434 additions and 22 deletions
+32 -5
View File
@@ -246,6 +246,7 @@ const AMMO: Dictionary = {
"cartridges": {"cap": 300, "pickup": 30},
"heavy_balls": {"cap": 30, "pickup": 6},
"lines": {"cap": 12, "pickup": 3},
"harpoons": {"cap": 10, "pickup": 3},
}
# Weapons. Falloff is linear from full damage at `range_full` to `falloff_min`
@@ -254,6 +255,8 @@ const AMMO: Dictionary = {
# degrees, which decays at BLOOM_DECAY_DEGREES_PER_SECOND while the weapon is ready. `projectile_speed` 0 means
# hitscan; otherwise shots fly at that speed under `projectile_gravity`. `ammo` names
# an AMMO type; a weapon with `stack` above 1 is thrown and is its own ammunition.
# `pull_speed` yanks the shooter towards where the shot lands, at that speed.
# `structure_factor` scales damage to built pieces and props (default 1).
const WEAPONS: Dictionary = {
"boathook": {
"damage": 20, "fire_rate": 1.5, "magazine": 0, "reload": 0.0,
@@ -275,6 +278,11 @@ const WEAPONS: Dictionary = {
"range_full": 30.0, "range_max": 80.0, "falloff_min": 0.5, "rarity": 0,
"spread": 0.8, "bloom": 0.6, "ammo": "cartridges", "headshot": 2.0,
},
"rivet_repeater": {
"damage": 17, "fire_rate": 11.0, "magazine": 35, "reload": 2.0,
"range_full": 12.0, "range_max": 45.0, "falloff_min": 0.4, "rarity": 0,
"spread": 2.4, "bloom": 0.25, "ammo": "cartridges", "headshot": 1.5,
},
"whalers_longgun": {
"damage": 105, "fire_rate": 0.5, "magazine": 1, "reload": 2.6,
"range_full": 120.0, "range_max": 350.0, "falloff_min": 0.7, "rarity": 2,
@@ -285,7 +293,13 @@ const WEAPONS: Dictionary = {
"damage": 0, "fire_rate": 0.6, "magazine": 3, "reload": 3.0,
"range_full": 45.0, "range_max": 45.0, "falloff_min": 1.0, "rarity": 2,
"spread": 0.0, "bloom": 0.0, "ammo": "lines",
"projectile_speed": 90.0, "projectile_gravity": 4.0,
"projectile_speed": 90.0, "projectile_gravity": 4.0, "pull_speed": 18.0,
},
"harpoon_gun": {
"damage": 70, "fire_rate": 0.9, "magazine": 1, "reload": 1.8,
"range_full": 25.0, "range_max": 70.0, "falloff_min": 0.6, "rarity": 1,
"spread": 0.6, "bloom": 0.0, "ammo": "harpoons", "headshot": 1.5,
"projectile_speed": 120.0, "projectile_gravity": 6.0, "structure_factor": 2.5,
},
"powder_keg": {
"damage": 80, "structure_damage": 400, "blast_radius": 6.0, "fuse": 3.0,
@@ -307,10 +321,23 @@ const HEADSHOT_MULTIPLIER: float = 1.5
const HEAD_HEIGHT: float = 0.35
## Shots against built pieces and props do this fraction of their player damage.
const WEAPON_STRUCTURE_FACTOR: float = 1.0
## Quality tiers, lowest first. Loot rolls a tier for each weapon it spawns. `damage`
## multiplies every hit and `reload` multiplies the reload time.
const WEAPON_TIERS: Array[Dictionary] = [
{"name": "rusted", "damage": 1.0, "reload": 1.0},
{"name": "seaworthy", "damage": 1.08, "reload": 0.95},
{"name": "brass_fitted", "damage": 1.16, "reload": 0.9},
{"name": "captains", "damage": 1.25, "reload": 0.85},
]
## A line pull also lifts the puller this fast, so it clears the ground.
const LINE_PULL_LIFT: float = 4.0
# Consumables
# Consumables. Fire with one held starts using it; it takes effect after `use_seconds`
# unless interrupted. `heal` restores health up to `heal_cap` (default full), `armor`
# adds armor up to PLAYER_MAX_ARMOR. An item that would do nothing can't be started.
const ITEMS: Dictionary = {
"sailcloth_bandage": {"heal": 25, "use_seconds": 3.0, "stack": 6},
"brine_tonic": {"heal": 60, "use_seconds": 8.0, "stack": 3},
"cork_vest": {"armor": 50, "use_seconds": 5.0, "stack": 2},
"sailcloth_bandage": {"heal": 25, "heal_cap": 75, "use_seconds": 3.0, "stack": 6, "rarity": 0},
"brine_tonic": {"heal": 60, "use_seconds": 8.0, "stack": 3, "rarity": 1},
"cork_vest": {"armor": 50, "use_seconds": 5.0, "stack": 2, "rarity": 1},
"tar_patch": {"armor": 20, "use_seconds": 2.0, "stack": 5, "rarity": 0},
}