Eric chose option B on #72. The drop is now the GDD's launch: - A packet ship sails a seeded straight line past the island, offshore, as close in as it can while keeping 45 m of open water from any land (eight-way probes; up to 32 headings, then the four world sides). - Jump fires the lifeline mortar along the look heading. How high the player aims sets the charge (-10 to 45 degrees: 16 to 110 m/s over the ground; every shot climbs at 75 m/s). The climb can't be steered and the kite can't open until the arc tops out. Riders still aboard at the end are fired towards the middle of the island. - Drop.reach() mirrors the fall for both ways down (kite at the top, or a fall with the kite opening by itself); bots, the soak and autoplay clients and the tutorial pilot aim with Drop.aim_charge(). - Bots fire at their landing spot once abeam of it, when in easy reach at their own staggered moment, or just before the route ends, and open the kite early only when the spot is beyond the rest of a fall. - Art: VesselModels.ship() (two-masted packet, tanned square sails, a salt-white boot-top, a bowsprit and the mortar on its bed, mirrored to face the island), the figure's gull-kite (figure.py), and a lifeline cord from the muzzle to each player still climbing. - Renamed barge to ship and wing-sail to gull-kite throughout code, tests, captures, docs and the tutorial text. make match now defaults to seed 2, where the scripted player still harvests and builds. Closes #72 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
640 lines
34 KiB
GDScript
640 lines
34 KiB
GDScript
## The one table of gameplay numbers. See docs/GDD.md for what they mean.
|
|
## Using constants means a typo is a parse error instead of a silent default.
|
|
class_name Tuning
|
|
extends RefCounted
|
|
|
|
# Simulation
|
|
const TICK_RATE_HZ: int = 30
|
|
## Commands further ahead of the current tick than this are rejected.
|
|
const MAX_COMMAND_LEAD_TICKS: int = 60
|
|
## Width and depth of the playable world. Positions are clamped inside it.
|
|
const WORLD_SIZE_METRES: float = 1024.0
|
|
|
|
# Network. See docs/ARCHITECTURE.md, "Snapshot format".
|
|
## Server ticks between snapshots: 15 a second.
|
|
const NET_SNAPSHOT_INTERVAL_TICKS: int = 2
|
|
## The most bytes in one snapshot. Keeps a packet inside one UDP datagram on any
|
|
## ordinary link, and a client under 18 KB/s before packet headers.
|
|
const NET_SNAPSHOT_MAX_BYTES: int = 1200
|
|
## Shots, impacts and swings further than this from what a client watches aren't sent
|
|
## to it, unless they involve the player it watches.
|
|
const NET_FX_RADIUS_METRES: float = 250.0
|
|
## A client is sent other players and shots within this many metres on the map of the
|
|
## player it is watching: a little further than the longest weapon reaches.
|
|
const NET_INTEREST_PLAYERS_METRES: float = 380.0
|
|
## And items lying on the ground within this many.
|
|
const NET_INTEREST_PICKUPS_METRES: float = 90.0
|
|
## Snapshots the server remembers per client, to send changes against.
|
|
const NET_SNAPSHOT_HISTORY: int = 40
|
|
## When a snapshot is full, each snapshot an entity has waited counts as this many
|
|
## metres closer, so nothing far away waits for ever.
|
|
const NET_STALE_METRES_PER_SNAPSHOT: float = 6.0
|
|
## Commands a client repeats in each input packet, so a lost packet costs nothing.
|
|
const NET_INPUT_REDUNDANCY: int = 3
|
|
## Commands a client aims to have waiting at the server when each tick runs. Enough
|
|
## that ordinary jitter, or a lost packet whose commands the next one repeats, still
|
|
## gets every command there in time.
|
|
const NET_COMMAND_MARGIN_TICKS: int = 3
|
|
## How far ahead of the first snapshot's tick a client starts stamping commands, before
|
|
## the server's echo tells it how early they really arrive.
|
|
const NET_COMMAND_LEAD_START_TICKS: int = 6
|
|
## How far in the past a client draws other players, in ticks: two snapshots, so there
|
|
## is nearly always one on each side of the moment drawn.
|
|
const NET_INTERP_DELAY_TICKS: float = 4.0
|
|
## When snapshots are late or lost, others carry on along their last heading for at
|
|
## most this many ticks, then wait.
|
|
const NET_INTERP_EXTRAPOLATE_TICKS: float = 3.0
|
|
## Something that moved faster than this between two snapshots was put somewhere new,
|
|
## and is drawn there at once rather than sliding across.
|
|
const NET_INTERP_TELEPORT_METRES_PER_SECOND: float = 80.0
|
|
## A correction to the client's own predicted position is blended away at this rate
|
|
## (per second), and one larger than the snap distance is shown at once.
|
|
const NET_CORRECTION_SMOOTH_RATE: float = 10.0
|
|
const NET_CORRECTION_SNAP_METRES: float = 3.0
|
|
|
|
# Match sizes
|
|
const SOLO_PLAYERS: int = 24
|
|
const DUO_TEAMS: int = 12
|
|
const DUO_TEAM_SIZE: int = 2
|
|
## The tutorial (A12) starts its player with this weapon, its magazine full, and this
|
|
## much spare ammunition of its kind, to learn aiming and reloading on.
|
|
const TUTORIAL_KIT: Dictionary = {"weapon": "dock_carbine", "ammo": "cartridges", "spare": 60}
|
|
const REVIVE_SECONDS: float = 6.0
|
|
|
|
# Duos: downed, revive and bleed-out (M7). See Simulation.
|
|
## A player whose health runs out while a teammate is still standing goes down instead
|
|
## of out, with this much health to bleed. Hits on a downed player take it, too.
|
|
const DOWNED_HEALTH: int = 60
|
|
## A downed player loses one health this often, so bleeding out takes 30 seconds.
|
|
const DOWNED_BLEED_INTERVAL_TICKS: int = 15
|
|
## Downed players crawl: no jumping, sprinting, firing, building or using items.
|
|
const DOWNED_CRAWL_SPEED: float = 1.0
|
|
## A standing teammate holding interact within this distance (feet to feet) revives a
|
|
## downed one in REVIVE_SECONDS. Letting go or moving away starts it over.
|
|
const REVIVE_RANGE: float = 2.0
|
|
## Health a revived player gets up with.
|
|
const REVIVE_HEALTH: int = 30
|
|
|
|
# Match flow, in seconds. See Match and MatchRules, which can override each one.
|
|
## The lobby counts down once this many participants have joined.
|
|
const MATCH_MIN_PLAYERS: int = 1
|
|
## With enough players, the lobby waits this long for more before counting down.
|
|
const MATCH_LOBBY_SECONDS: float = 20.0
|
|
const MATCH_COUNTDOWN_SECONDS: float = 10.0
|
|
## Results stay up this long before the server returns to the lobby.
|
|
const MATCH_RESULTS_SECONDS: float = 15.0
|
|
|
|
# Player
|
|
const PLAYER_MAX_HEALTH: int = 100
|
|
const PLAYER_MAX_ARMOR: int = 100
|
|
const BREATH_SECONDS: float = 12.0
|
|
const INVENTORY_SLOTS: int = 5
|
|
|
|
# Movement, in metres and seconds
|
|
const WALK_SPEED: float = 4.0
|
|
const SPRINT_SPEED: float = 6.5
|
|
const WADE_SPEED: float = 2.5
|
|
const SWIM_SPEED: float = 2.0
|
|
const CROUCH_SPEED: float = 2.0
|
|
const JUMP_VELOCITY: float = 7.5
|
|
const GRAVITY: float = 20.0
|
|
## Fraction of the gap between current and wanted horizontal velocity closed per tick
|
|
## while airborne.
|
|
const AIR_CONTROL: float = 0.08
|
|
## Ledges up to this height are stepped onto without jumping.
|
|
const STEP_HEIGHT: float = 0.45
|
|
## Walking keeps the feet on ground that drops away by up to this much per tick.
|
|
const GROUND_SNAP: float = 0.35
|
|
## Steeper ground can't be walked up or stood on; players slide down it.
|
|
const MAX_SLOPE_DEGREES: float = 46.0
|
|
## Top speed sliding down ground too steep to stand on.
|
|
const SLIDE_MAX_SPEED: float = 8.0
|
|
const PLAYER_RADIUS: float = 0.4
|
|
const PLAYER_HEIGHT: float = 1.8
|
|
const CROUCH_HEIGHT: float = 1.2
|
|
## Landing from a drop of this many metres or less does no damage. Measured from impact
|
|
## speed, so sliding down a slope is gentler than falling the same height.
|
|
const FALL_DAMAGE_SAFE_METRES: float = 6.0
|
|
const FALL_DAMAGE_PER_METRE: float = 8.0
|
|
|
|
# Water, in metres and seconds. Depths are water over the floor under the player.
|
|
## The sea level a match starts at. The tide raises it from here.
|
|
const SEA_LEVEL_START: float = 0.0
|
|
## Deeper than this, walkers wade at WADE_SPEED and can't sprint.
|
|
const WADE_DEPTH: float = 0.4
|
|
## Water this deep over the floor lifts a player off it to swim.
|
|
const SWIM_DEPTH: float = 1.35
|
|
## A swimmer stands again where the water over the floor is shallower than this.
|
|
const SWIM_EXIT_DEPTH: float = 1.2
|
|
## A swimmer floats with the feet this far under the surface, head out.
|
|
const SWIM_FLOAT_DEPTH: float = 1.3
|
|
## With no stamina left a swimmer sinks until the feet are this far under: head under.
|
|
const SWIM_EXHAUSTED_DEPTH: float = 2.2
|
|
const SWIM_SPRINT_SPEED: float = 3.2
|
|
## Fraction of SWIM_SPEED left to an exhausted swimmer.
|
|
const SWIM_EXHAUSTED_FACTOR: float = 0.6
|
|
## Diving and rising speed, and how fast vertical speed changes in the water.
|
|
const SWIM_VERTICAL_SPEED: float = 2.0
|
|
const SWIM_VERTICAL_ACCEL: float = 12.0
|
|
## Fraction of downward speed kept on hitting deep water.
|
|
const WATER_ENTRY_DAMP: float = 0.25
|
|
## Seconds of paddling a full stamina bar allows. Sprint-swimming spends it faster.
|
|
const SWIM_STAMINA_SECONDS: float = 45.0
|
|
const SWIM_SPRINT_STAMINA_COST: int = 3
|
|
## Ticks of stamina and breath regained per tick out of the water or above it.
|
|
const STAMINA_RECOVERY_RATE: int = 3
|
|
const BREATH_RECOVERY_RATE: int = 4
|
|
|
|
# The drop (#72), in metres and seconds. The packet ship sails a straight seeded line
|
|
# past the island, offshore, and players fire themselves inland by lifeline mortar.
|
|
## The deck the players ride on, above the starting sea level.
|
|
const SHIP_DECK_HEIGHT: float = 4.0
|
|
const SHIP_SPEED: float = 16.0
|
|
## The route starts and ends this far inside the world's edge.
|
|
const SHIP_ROUTE_MARGIN: float = 40.0
|
|
## The route keeps this much open water between itself and the coast. The planner tries
|
|
## routes from SHIP_OFFSET_MIN to SHIP_OFFSET_MAX from the middle of the world, in
|
|
## SHIP_OFFSET_STEP steps, and takes the first that is clear, for up to SHIP_ROUTE_TRIES
|
|
## headings. Sea counts as open where the bottom is SHIP_DRAUGHT under the water.
|
|
const SHIP_COAST_CLEARANCE: float = 45.0
|
|
const SHIP_DRAUGHT: float = 1.0
|
|
const SHIP_OFFSET_MIN: float = 300.0
|
|
const SHIP_OFFSET_MAX: float = 465.0
|
|
const SHIP_OFFSET_STEP: float = 6.0
|
|
const SHIP_CLEARANCE_STEP: float = 6.0
|
|
const SHIP_ROUTE_TRIES: int = 32
|
|
## A route shorter than this (one cutting a corner of the world) isn't used.
|
|
const SHIP_MIN_ROUTE_METRES: float = 420.0
|
|
## The lifeline mortar: every shot climbs at MORTAR_RISE_SPEED; its speed over the
|
|
## ground runs from MORTAR_MIN_SPEED to MORTAR_MAX_SPEED with the charge, which comes
|
|
## from how high the player aims, from MORTAR_PITCH_LOW_DEGREES to ..._HIGH_DEGREES.
|
|
const MORTAR_RISE_SPEED: float = 75.0
|
|
const MORTAR_MIN_SPEED: float = 16.0
|
|
const MORTAR_MAX_SPEED: float = 110.0
|
|
const MORTAR_PITCH_LOW_DEGREES: float = -10.0
|
|
const MORTAR_PITCH_HIGH_DEGREES: float = 45.0
|
|
## Riders fired at the end of the route are sent this fraction of the way to the middle
|
|
## of the island, so they land inland without all landing on one spot.
|
|
const MORTAR_FORCED_REACH: float = 0.8
|
|
const FREEFALL_MAX_SPEED: float = 32.0
|
|
## Horizontal speed a falling player can steer to, before and after the kite opens.
|
|
const FREEFALL_STEER_SPEED: float = 9.0
|
|
const GLIDE_SPEED: float = 13.0
|
|
## How fast horizontal speed changes while steering a fall, in metres per second squared.
|
|
const DROP_STEER_ACCEL: float = 20.0
|
|
## Sink rate under an open gull-kite, and how hard opening it brakes the fall.
|
|
const GLIDE_FALL_SPEED: float = 5.5
|
|
const GLIDE_BRAKE: float = 60.0
|
|
## The kite opens by itself this high above the ground or water.
|
|
const KITE_AUTO_DEPLOY_HEIGHT: float = 40.0
|
|
## Within this height of the ground or water, the kite folds and the player drops the rest.
|
|
const DROP_LAND_HANDOFF: float = 1.0
|
|
|
|
# The island. Worldgen fills the whole world square; the island is about a kilometre
|
|
# across, sized for 24 players. Heights are metres above the starting sea level.
|
|
## Spacing of the terrain heightfield, in metres. The grid covers WORLD_SIZE_METRES.
|
|
const ISLAND_GRID_METRES: float = 2.0
|
|
## Mean distance from the world centre to the coast, before the coastline is warped.
|
|
const ISLAND_RADIUS_METRES: float = 400.0
|
|
const ISLAND_MIN_SUMMITS: int = 2
|
|
const ISLAND_MAX_SUMMITS: int = 4
|
|
## Summits are at least this far apart, so each one is a separate fight.
|
|
const ISLAND_SUMMIT_SPACING_METRES: float = 220.0
|
|
## The tallest summit lands between these heights. Both stay under ISLAND_MAX_HEIGHT.
|
|
const ISLAND_PEAK_MIN: float = 58.0
|
|
const ISLAND_PEAK_MAX: float = 67.0
|
|
## The open sea floor, in metres below the starting sea.
|
|
const ISLAND_SEA_DEPTH: float = 12.0
|
|
## Elevation bands, by height above the starting sea. Marsh is wet flat ground below
|
|
## ISLAND_MARSH_TOP; land from there up to ISLAND_FOREST_TOP is forest, then highland,
|
|
## and anything at or above ISLAND_SUMMIT_BAND is summit ground.
|
|
const ISLAND_BEACH_TOP: float = 2.5
|
|
const ISLAND_MARSH_TOP: float = 7.0
|
|
const ISLAND_FOREST_TOP: float = 32.0
|
|
const ISLAND_SUMMIT_BAND: float = 50.0
|
|
|
|
# Points of interest. Each kind places between its min and max on every island, and the
|
|
# total always lands between POI_MIN_TOTAL and POI_MAX_TOTAL.
|
|
const POI_KINDS: Dictionary = {
|
|
"shrine": {"min": 2, "max": 3},
|
|
"lighthouse": {"min": 1, "max": 2},
|
|
"dock": {"min": 2, "max": 3},
|
|
"salt_works": {"min": 1, "max": 2},
|
|
"quarry": {"min": 1, "max": 2},
|
|
"hamlet": {"min": 3, "max": 4},
|
|
}
|
|
const POI_MIN_TOTAL: int = 10
|
|
const POI_MAX_TOTAL: int = 16
|
|
## No two points of interest are closer than this, centre to centre.
|
|
const POI_SPACING_METRES: float = 85.0
|
|
|
|
# Props: trees, scrub, boulders, wrecks and crates scattered over the island. Each kind
|
|
# has health, the material it gives when harvested, and a collision footprint range in
|
|
# metres (`width` x `height`; wrecks are `length` long). Density is props per hectare
|
|
# in each elevation band; groves and clearings modulate it.
|
|
const PROP_KINDS: Dictionary = {
|
|
"pine": {"health": 200, "material": "driftwood", "width": [0.5, 0.7], "height": [7.0, 12.0]},
|
|
"scrub": {"health": 60, "material": "driftwood", "width": [1.1, 1.8], "height": [0.8, 1.3]},
|
|
"boulder": {"health": 400, "material": "stone", "width": [1.6, 3.4], "height": [1.0, 2.4]},
|
|
"wreck": {"health": 500, "material": "salvage_iron", "width": [2.2, 2.8], "height": [1.4, 2.0], "length": [5.5, 8.0]},
|
|
"crate": {"health": 80, "material": "driftwood", "width": [0.9, 1.2], "height": [0.9, 1.2]},
|
|
}
|
|
const PROP_DENSITY: Dictionary = {
|
|
"beach": {"wreck": 5.0, "crate": 6.0, "scrub": 2.0},
|
|
"marsh": {"scrub": 30.0, "crate": 1.0, "boulder": 1.0},
|
|
"forest": {"pine": 70.0, "scrub": 16.0, "boulder": 4.0, "crate": 0.3},
|
|
"highland": {"pine": 14.0, "boulder": 16.0, "scrub": 10.0},
|
|
"summit": {"boulder": 10.0, "scrub": 3.0},
|
|
}
|
|
## Props keep this far from any point-of-interest solid, loot marker or walking route.
|
|
const PROP_POI_CLEARANCE: float = 3.0
|
|
|
|
# The tide. `hold` and `rise` are seconds, `level` is metres above the starting sea,
|
|
# `drown_dps` is damage per second underwater once breath runs out. The last level
|
|
# must exceed ISLAND_MAX_HEIGHT, so that every match ends.
|
|
const ISLAND_MAX_HEIGHT: float = 70.0
|
|
const TIDE_PHASES: Array[Dictionary] = [
|
|
{"hold": 150.0, "rise": 60.0, "level": 6.0, "drown_dps": 2, "surge": 0},
|
|
{"hold": 130.0, "rise": 50.0, "level": 14.0, "drown_dps": 4, "surge": 40},
|
|
{"hold": 120.0, "rise": 45.0, "level": 24.0, "drown_dps": 6, "surge": 60},
|
|
{"hold": 110.0, "rise": 40.0, "level": 34.0, "drown_dps": 8, "surge": 80},
|
|
{"hold": 90.0, "rise": 35.0, "level": 46.0, "drown_dps": 12, "surge": 100},
|
|
{"hold": 60.0, "rise": 30.0, "level": 58.0, "drown_dps": 16, "surge": 120},
|
|
{"hold": 45.0, "rise": 40.0, "level": 75.0, "drown_dps": 25, "surge": 150},
|
|
]
|
|
## Each island's levels are planned from its terrain (SafeGround): a phase's level is
|
|
## lowered, if need be, to this far under the top of the largest piece of land still
|
|
## dry when it begins, but every phase still rises at least TIDE_MIN_RISE_METRES. The
|
|
## last phase always takes its table level.
|
|
const TIDE_SAFE_MARGIN_METRES: float = 2.0
|
|
const TIDE_MIN_RISE_METRES: float = 4.0
|
|
## When a phase's rise begins, a storm surge does the phase's `surge` damage once to
|
|
## every built piece whose base is below the water plus this height, where that water
|
|
## reaches it. Breakwaters take it too.
|
|
const TIDE_SURGE_HEIGHT_METRES: float = 2.0
|
|
## Sudden death begins when the last rise ends: every player still standing loses this
|
|
## much health a second, armor or not. When it has run this long, the match ends and
|
|
## the winner is decided by Match's tie-break: most health, then highest feet, then
|
|
## earliest to join. So every match ends within the tide's total time plus this.
|
|
const TIDE_SUDDEN_DEATH_SECONDS: float = 60.0
|
|
const TIDE_SUDDEN_DEATH_DPS: int = 5
|
|
## The flood grid's cells are this big, matching the building grid so breakwater edges
|
|
## line up with cell edges.
|
|
const FLOOD_CELL_METRES: float = 4.0
|
|
|
|
# Bot navigation. Bots path over a grid of terrain samples and steer along it with the
|
|
# same commands players send.
|
|
## Spacing of the navigation grid, in metres. Matches the terrain heightfield.
|
|
const BOT_NAV_CELL_METRES: float = 2.0
|
|
## Neighbouring nav points further apart in height than this are a cliff, not a slope.
|
|
const BOT_NAV_MAX_RISE: float = 1.9
|
|
## Path cost multiplier for water too deep to wade: bots swim only when they must.
|
|
const BOT_NAV_WATER_WEIGHT: float = 8.0
|
|
## Most paths the shared grid plans in one server tick; other requests wait their turn.
|
|
const BOT_NAV_PATHS_PER_TICK: int = 1
|
|
## A bot moves on to the next waypoint within this horizontal distance of it.
|
|
const BOT_WAYPOINT_RADIUS: float = 1.3
|
|
## A bot that gains less than this toward its waypoint in BOT_STUCK_TICKS jumps, and
|
|
## after BOT_STUCK_REPATHS tries it marks the waypoint blocked and plans again.
|
|
const BOT_STUCK_PROGRESS: float = 0.5
|
|
const BOT_STUCK_TICKS: int = 20
|
|
const BOT_STUCK_REPATHS: int = 3
|
|
## Each bot re-checks its remaining path against grid changes this often, in ticks.
|
|
const BOT_PATH_CHECK_TICKS: int = 15
|
|
|
|
## Duos (M7): a bot goes to revive a downed teammate this close, unless it's in a fight.
|
|
const BOT_REVIVE_METRES: float = 60.0
|
|
## Duos: a roaming bot this far from its teammate heads back to them.
|
|
const BOT_REGROUP_METRES: float = 30.0
|
|
|
|
# Bot brains. Bots loot, fight, heal and keep ahead of the tide with only what a player
|
|
# would know: what they can see, the map's points of interest, and the tide forecast.
|
|
## Per difficulty: `reaction` is seconds between first seeing an opponent and firing,
|
|
## `aim_error` the most their aim wanders off the target in degrees, `sight` how far
|
|
## they can pick an opponent out in metres, and `lead` how much of a moving target's
|
|
## travel they allow for with slow shots (0 none, 1 all of it), and `retreat` the health
|
|
## plus armor at or under which they break off a fight to heal (0 never).
|
|
const BOT_DIFFICULTIES: Array[Dictionary] = [
|
|
{"name": "easy", "reaction": 0.9, "aim_error": 9.0, "sight": 45.0, "lead": 0.0, "retreat": 0},
|
|
{"name": "normal", "reaction": 0.5, "aim_error": 5.5, "sight": 65.0, "lead": 0.5, "retreat": 35},
|
|
{"name": "hard", "reaction": 0.25, "aim_error": 3.0, "sight": 90.0, "lead": 1.0, "retreat": 50},
|
|
]
|
|
## Each bot looks around once in this many ticks.
|
|
const BOT_SENSE_TICKS: int = 6
|
|
## Bots see this far to either side of where they face, and notice anyone this close
|
|
## whichever way they face.
|
|
const BOT_VIEW_HALF_ANGLE_DEGREES: float = 100.0
|
|
const BOT_HEARING_METRES: float = 10.0
|
|
## A bot remembers an opponent it has lost sight of for this long.
|
|
const BOT_MEMORY_SECONDS: float = 4.0
|
|
## A bot's aim drifts to a new error this often, in ticks.
|
|
const BOT_AIM_WANDER_TICKS: int = 12
|
|
## Bots ease off the trigger while bloom is above this, in degrees.
|
|
const BOT_BLOOM_PAUSE_DEGREES: float = 3.0
|
|
## Bots pick out a new opponent only this close (or their `sight`, if less). Anyone who
|
|
## shoots them is fought as far off as they can see. Without it bot lobbies emptied in
|
|
## the first two minutes; see docs/BALANCE.md.
|
|
const BOT_ENGAGE_METRES: float = 30.0
|
|
## A bot breaking off a fight runs for this long towards safe ground about this far
|
|
## away from its opponent, and won't break off again until as long again has passed.
|
|
const BOT_RETREAT_SECONDS: float = 6.0
|
|
const BOT_RETREAT_METRES: float = 30.0
|
|
## A bot lands at a loot marker no further than this from the ship's line (#72: within
|
|
## the lifeline mortar's reach).
|
|
const BOT_LANDING_REACH_METRES: float = 600.0
|
|
## A bot weighs this many landing spots near the ship's line and takes the one with
|
|
## the fewest other bots' landings within BOT_LANDING_SPREAD_METRES.
|
|
const BOT_LANDING_CHOICES: int = 8
|
|
const BOT_LANDING_SPREAD_METRES: float = 60.0
|
|
## With nothing to loot, a bot roams to safe ground at most this far from where it is.
|
|
const BOT_ROAM_METRES: float = 60.0
|
|
## Having roamed there, it holds that ground this long before moving on.
|
|
const BOT_HOLD_SECONDS: float = 45.0
|
|
## Bots notice items lying within this distance.
|
|
const BOT_LOOT_SIGHT_METRES: float = 12.0
|
|
## A bot with no gun goes for an opponent in view this close with its boathook, in
|
|
## metres, and swings once its eye is this far from the opponent's body.
|
|
const BOT_BRAWL_METRES: float = 6.0
|
|
const BOT_SWING_METRES: float = 2.3
|
|
## The most weapons a bot carries; its other slots are for consumables.
|
|
const BOT_MAX_WEAPONS: int = 3
|
|
## Ground counts as safe from the next tide level when it stands this far above it.
|
|
const BOT_SAFE_MARGIN_METRES: float = 1.5
|
|
## A bot off safe ground leaves when the time to the next rise is less than its
|
|
## distance to safe ground at this speed, plus the buffer.
|
|
const BOT_FLEE_SPEED: float = 1.5
|
|
const BOT_FLEE_BUFFER_SECONDS: float = 20.0
|
|
## With less than this long before the water rises, bots only loot on safe ground.
|
|
const BOT_LOOT_TIDE_SECONDS: float = 30.0
|
|
## Bots give up on a loot spot or an item they can't get to after this long.
|
|
const BOT_LOOT_TIMEOUT_SECONDS: float = 45.0
|
|
const BOT_PICKUP_TIMEOUT_SECONDS: float = 8.0
|
|
## M6, bots that build. An armed bot with nothing more pressing gathers with the
|
|
## boathook until its best material reaches BOT_BUILD_STOCK (in the last
|
|
## BOT_STRAND_PHASES tide phases, enough for four breakwaters): from a prop within
|
|
## BOT_HARVEST_NEAR_METRES while it loots, or BOT_HARVEST_METRES once it has nothing
|
|
## left to loot. It gives up on a prop after BOT_HARVEST_SECONDS. It doesn't start
|
|
## within BOT_GATHER_QUIET_SECONDS of last seeing an opponent or being hit, or with
|
|
## health and armor under BOT_GATHER_HEALTH.
|
|
const BOT_BUILD_STOCK: int = 60
|
|
const BOT_GATHER_QUIET_SECONDS: float = 10.0
|
|
const BOT_GATHER_HEALTH: int = 60
|
|
const BOT_HARVEST_NEAR_METRES: float = 12.0
|
|
const BOT_HARVEST_METRES: float = 24.0
|
|
const BOT_HARVEST_SECONDS: float = 12.0
|
|
## Cover: a bot shot while it reloads, within a second of first seeing its shooter, or
|
|
## with health and armor down to BOT_COVER_HEALTH, puts a wall between them, and waits
|
|
## behind it at least BOT_COVER_HOLD_SECONDS and until any reload is done. Only for a
|
|
## shooter at least BOT_COVER_MIN_METRES off, and no more often than BOT_COVER_SECONDS.
|
|
const BOT_COVER_HOLD_SECONDS: float = 2.0
|
|
const BOT_COVER_HEALTH: int = 60
|
|
const BOT_COVER_MIN_METRES: float = 6.0
|
|
const BOT_COVER_SECONDS: float = 5.0
|
|
## A badly hurt bot that could break off (BOT_DIFFICULTIES "retreat") and can afford a
|
|
## wall walls itself off and heals there instead, for up to this long.
|
|
const BOT_COVER_HEAL_SECONDS: float = 7.0
|
|
## Ramps: up toward an opponent at least BOT_RAMP_RISE_METRES higher, within
|
|
## BOT_RAMP_REACH_METRES across, and up ground at least this steep (rise over run).
|
|
## At most BOT_RAMP_MAX ramps a fight; the bot walks on BOT_RAMP_WALK_SECONDS after each.
|
|
const BOT_RAMP_RISE_METRES: float = 3.0
|
|
const BOT_RAMP_REACH_METRES: float = 24.0
|
|
const BOT_RAMP_SLOPE: float = 0.5
|
|
const BOT_RAMP_MAX: int = 5
|
|
const BOT_RAMP_WALK_SECONDS: float = 1.5
|
|
## At the last stand (a tide phase that leaves no dry ground), a bot on the last high
|
|
## point rings its own cell with breakwaters once the rise is this close.
|
|
const BOT_RING_SECONDS: float = 30.0
|
|
## In the last this many tide phases, a bot running from the tide that can't reach dry
|
|
## ground before the sea reaches its feet rings its cell with breakwaters instead, if
|
|
## the coming level is one they hold back (BREAKWATER_MAX_HEAD, less a metre).
|
|
const BOT_STRAND_PHASES: int = 3
|
|
## A fight ends for the measurement (M6) once the bot has had nobody to fight this long.
|
|
const BOT_FIGHT_GAP_SECONDS: float = 4.0
|
|
|
|
# Building
|
|
const GRID_CELL_METRES: float = 4.0
|
|
## The most of each material a player can carry.
|
|
const MATERIAL_CAP: int = 500
|
|
## Material gained per boathook hit on a prop, whatever the prop.
|
|
const HARVEST_PER_HIT: int = 15
|
|
## Damage a boathook hit does to a prop or a built piece. Players take the boathook's
|
|
## `damage` instead.
|
|
const HARVEST_DAMAGE: int = 50
|
|
## A swing reaches this far past the boathook's range, from the eye, so a prop the body
|
|
## is touching is always in reach.
|
|
const HARVEST_REACH_SLACK: float = 0.4
|
|
## Props are hit if the swing passes within this distance of their box.
|
|
const HARVEST_AIM_SLACK: float = 0.25
|
|
## Material units each piece costs. Health and build time come from MATERIALS.
|
|
const BUILD_PIECES: Dictionary = {
|
|
"wall": {"cost": 10},
|
|
"floor": {"cost": 10},
|
|
"ramp": {"cost": 10},
|
|
"roof": {"cost": 10},
|
|
"breakwater": {"cost": 30},
|
|
}
|
|
const MATERIALS: Dictionary = {
|
|
"driftwood": {"health": 150, "build_seconds": 2.0},
|
|
"stone": {"health": 300, "build_seconds": 5.0},
|
|
"salvage_iron": {"health": 500, "build_seconds": 9.0},
|
|
}
|
|
## Pieces are GRID_CELL_METRES on a side and tall, and snap across to the grid. Up and
|
|
## down they snap to levels BUILD_LEVEL_METRES apart, half a cell, so a piece built on
|
|
## the ground is never more than a metre above or below the builder's feet. Level 0 is
|
|
## the starting sea level; levels run from BUILD_MIN_LEVEL to BUILD_MAX_LEVEL.
|
|
const BUILD_LEVEL_METRES: float = 2.0
|
|
const BUILD_MIN_LEVEL: int = -8
|
|
const BUILD_MAX_LEVEL: int = 63
|
|
## A piece's centre must be within this distance of the builder's eye.
|
|
const BUILD_RANGE: float = 9.5
|
|
## Ticks between placements while fire is held: 10 pieces a second.
|
|
const BUILD_INTERVAL_TICKS: int = 3
|
|
## Looking further up than this, in degrees, targets the level above.
|
|
const BUILD_LOOK_UP_DEGREES: float = 35.0
|
|
## Looking further down than this puts floors, ramps and roofs in the builder's own cell.
|
|
const BUILD_LOOK_DOWN_DEGREES: float = 40.0
|
|
const WALL_THICKNESS: float = 0.3
|
|
const BREAKWATER_THICKNESS: float = 0.6
|
|
const FLOOR_THICKNESS: float = 0.2
|
|
## Ramps are stairs of this many steps, so each riser can be stepped up.
|
|
const RAMP_STEPS: int = 10
|
|
## A new piece starts at this fraction of its material's health and reaches full health
|
|
## after the material's `build_seconds`.
|
|
const BUILD_START_HEALTH_FRACTION: float = 0.1
|
|
## Damage per second to a piece other than a breakwater whose base is under the sea.
|
|
const TIDE_STRUCTURE_DPS: int = 4
|
|
## A breakwater holds this much water above its base. Deeper, it fails at once.
|
|
const BREAKWATER_MAX_HEAD: float = 6.0
|
|
const BREAKWATER_WEAR_PER_METRE: float = 2.0
|
|
const BREACH_FLOW_METRES_PER_SECOND: float = 1.5
|
|
|
|
# Inventory and pickups
|
|
## Items picked up or dropped must be within this distance of the player's feet.
|
|
const PICKUP_RANGE: float = 2.5
|
|
## Changing the held slot takes this long before the new item can be used.
|
|
const SWAP_SECONDS: float = 0.25
|
|
## Dropped items land on a ring this far from the player's feet.
|
|
const DROP_SCATTER_METRES: float = 1.2
|
|
## Ammunition, carried apart from the five slots. `cap` is the most a player carries,
|
|
## `pickup` how much one ammunition pickup holds.
|
|
const AMMO: Dictionary = {
|
|
"birdshot": {"cap": 60, "pickup": 12},
|
|
"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`
|
|
# (a fraction of damage) at `range_max`. `spread` is the cone half-angle in degrees
|
|
# from the hip; aiming multiplies it by AIM_SPREAD_FACTOR. Each shot adds `bloom`
|
|
# 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,
|
|
"range_full": 2.5, "range_max": 2.5, "falloff_min": 1.0, "rarity": 0,
|
|
"spread": 0.0, "bloom": 0.0,
|
|
},
|
|
"fowling_piece": {
|
|
"damage": 9, "pellets": 9, "fire_rate": 1.1, "magazine": 6, "reload": 4.0,
|
|
"range_full": 6.0, "range_max": 25.0, "falloff_min": 0.2, "rarity": 1,
|
|
"spread": 5.0, "bloom": 0.0, "ammo": "birdshot", "headshot": 1.5,
|
|
},
|
|
"dock_carbine": {
|
|
"damage": 27, "fire_rate": 6.0, "magazine": 30, "reload": 2.4,
|
|
"range_full": 40.0, "range_max": 120.0, "falloff_min": 0.5, "rarity": 1,
|
|
"spread": 1.2, "bloom": 0.35, "ammo": "cartridges", "headshot": 1.75,
|
|
},
|
|
"signal_revolver": {
|
|
"damage": 38, "fire_rate": 2.2, "magazine": 6, "reload": 2.0,
|
|
"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": 15, "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,
|
|
"spread": 3.0, "bloom": 0.0, "ammo": "heavy_balls", "headshot": 2.5,
|
|
"aim_spread": 0.0, "projectile_speed": 300.0, "projectile_gravity": 9.0,
|
|
},
|
|
"line_thrower": {
|
|
"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, "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,
|
|
},
|
|
# Thrown (B8): lobbed at projectile_speed, it comes to rest where it lands and blows
|
|
# `fuse` seconds after the throw. `damage` to players and `structure_damage` to
|
|
# pieces and props at the middle of the blast, down to BLAST_EDGE_FACTOR of them at
|
|
# `blast_radius`. See Explosives.
|
|
"powder_keg": {
|
|
"damage": 80, "structure_damage": 400, "blast_radius": 6.0, "fuse": 3.0,
|
|
"fire_rate": 0.8, "magazine": 1, "reload": 0.0, "stack": 3,
|
|
"range_full": 0.0, "range_max": 30.0, "falloff_min": 1.0, "rarity": 2,
|
|
"spread": 0.0, "bloom": 0.0, "projectile_speed": 17.0, "projectile_gravity": 12.0,
|
|
},
|
|
}
|
|
## A blast does this share of its damage at the edge of its radius, rising linearly to
|
|
## all of it at the middle.
|
|
const BLAST_EDGE_FACTOR: float = 0.3
|
|
## The share of a blast's damage its own thrower takes.
|
|
const BLAST_SELF_FACTOR: float = 0.5
|
|
## A throw leaves this much above the look direction (added to its y, then normalised),
|
|
## so a level throw lobs.
|
|
const THROW_LIFT: float = 0.25
|
|
## A network client sees other players late. The server judges a hitscan shot against
|
|
## where they were when the shooter saw them, going back at most this many ticks (half
|
|
## a second). Past that the shooter has to lead the target.
|
|
const LAG_COMPENSATION_MAX_TICKS: int = 15
|
|
## Spread multiplier while aiming, unless a weapon sets its own `aim_spread`.
|
|
const AIM_SPREAD_FACTOR: float = 0.4
|
|
## Extra spread while moving, and while airborne or swimming, in degrees.
|
|
const MOVING_SPREAD_DEGREES: float = 1.5
|
|
const AIRBORNE_SPREAD_DEGREES: float = 4.0
|
|
const MAX_BLOOM_DEGREES: float = 6.0
|
|
const BLOOM_DECAY_DEGREES_PER_SECOND: float = 6.0
|
|
## Default damage multiplier for a hit on the head, unless a weapon sets `headshot`.
|
|
const HEADSHOT_MULTIPLIER: float = 1.5
|
|
## The top of a player's body this tall counts as the head.
|
|
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. 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, "heal_cap": 75, "use_seconds": 3.0, "stack": 6, "rarity": 0, "loot": 3},
|
|
"brine_tonic": {"heal": 60, "use_seconds": 8.0, "stack": 3, "rarity": 1, "loot": 1},
|
|
"cork_vest": {"armor": 50, "use_seconds": 5.0, "stack": 2, "rarity": 1, "loot": 1},
|
|
"tar_patch": {"armor": 20, "use_seconds": 2.0, "stack": 5, "rarity": 0, "loot": 2},
|
|
}
|
|
|
|
# Loot. Every loot marker at a point of interest holds either a sea chest, with chance
|
|
# `chest`, or floor loot: `rolls` rolls on the source's category weights. Washed-up
|
|
# crates (props) hold one source "crate" roll each and spill it when broken. A weapon
|
|
# rolls its tier from `tiers` (weights, lowest tier first) and comes with
|
|
# LOOT_AMMO_WITH_WEAPON pickups of its ammunition. Within a category, an item's weight
|
|
# is LOOT_RARITY_WEIGHTS[rarity]. Consumables spawn `loot` of themselves (ITEMS), thrown
|
|
# weapons LOOT_THROWN_COUNT, and ammunition one pickup amount (AMMO).
|
|
const LOOT_SOURCES: Dictionary = {
|
|
"hamlet": {"chest": 0.3, "rolls": 2, "weapon": 50, "consumable": 25, "ammo": 15, "nothing": 10, "tiers": [55, 30, 12, 3]},
|
|
"dock": {"chest": 0.4, "rolls": 2, "weapon": 45, "consumable": 25, "ammo": 20, "nothing": 10, "tiers": [50, 32, 14, 4]},
|
|
"salt_works": {"chest": 0.3, "rolls": 2, "weapon": 45, "consumable": 30, "ammo": 15, "nothing": 10, "tiers": [55, 30, 12, 3]},
|
|
"quarry": {"chest": 0.4, "rolls": 2, "weapon": 45, "consumable": 20, "ammo": 25, "nothing": 10, "tiers": [50, 32, 14, 4]},
|
|
"lighthouse": {"chest": 0.6, "rolls": 2, "weapon": 50, "consumable": 25, "ammo": 20, "nothing": 5, "tiers": [35, 35, 22, 8]},
|
|
"shrine": {"chest": 0.8, "rolls": 2, "weapon": 55, "consumable": 25, "ammo": 15, "nothing": 5, "tiers": [20, 35, 30, 15]},
|
|
"crate": {"chest": 0.0, "rolls": 1, "weapon": 35, "consumable": 30, "ammo": 25, "nothing": 10, "tiers": [65, 27, 7, 1]},
|
|
}
|
|
## A sea chest holds this many weapons and consumables, and ammunition for each weapon
|
|
## plus LOOT_CHEST_EXTRA_AMMO random ammunition pickups. Its weapons roll their tier
|
|
## LOOT_CHEST_TIER_ROLLS times and keep the best.
|
|
const LOOT_CHEST_WEAPONS: int = 1
|
|
const LOOT_CHEST_CONSUMABLES: int = 1
|
|
const LOOT_CHEST_EXTRA_AMMO: int = 1
|
|
const LOOT_CHEST_TIER_ROLLS: int = 2
|
|
## If the rolls leave fewer weapons than this on floors and in chests, extra weapon
|
|
## rolls are added to floor spots in marker order: one per player in a full lobby.
|
|
const LOOT_MIN_POI_WEAPONS: int = SOLO_PLAYERS
|
|
const LOOT_RARITY_WEIGHTS: Array[int] = [6, 3, 1]
|
|
const LOOT_AMMO_WITH_WEAPON: int = 1
|
|
const LOOT_THROWN_COUNT: int = 2
|
|
## Interact opens a closed chest whose base is within this distance of the feet.
|
|
const CHEST_RANGE: float = 2.5
|
|
## Loot from one spot lands on a ring this far from it.
|
|
const LOOT_SCATTER_METRES: float = 0.7
|
|
|
|
# Balance targets (H3), judged by `make balance` over bot-only matches; see docs/BALANCE.md.
|
|
## The pass needs at least this many matches.
|
|
const BALANCE_MIN_MATCHES: int = 200
|
|
## The median match, from the ship leaving to the last player standing, lasts this
|
|
## many minutes.
|
|
const BALANCE_MEDIAN_MINUTES_MIN: float = 12.0
|
|
const BALANCE_MEDIAN_MINUTES_MAX: float = 18.0
|
|
## No one weapon takes more than this share of the eliminations made with weapons.
|
|
const BALANCE_MAX_WEAPON_SHARE: float = 0.35
|