@v12-engine/engine 0.1.0 → 0.4.0

package/dist/camps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camps.js","names":["campReturnedEvent","campClearedEvent"],"sources":["../src/camps.ts"],"sourcesContent":["/**\n * Creep camps: groups of neutral hostile creeps that guard a spot. They go for whoever comes close or attacks one of\n * them, all of them at once, keep a list of who hurt them (`Camp.aggro`) and fight it out to the end of their leash,\n * give up a chase that brings no blow (`CampSettings.chaseTime`), go home a while after the last blow (`resetAfter`), heal\n * on the way back, and sleep at night. A feature a game turns on by taking `campHooks` and `campListeners` (the heroes\n * pack has them); the engine itself knows only the player the creeps belong to. Without it, creeps are units like any\n * other, that stand where they are put and fight back. See docs/creeps.md\n */\nimport { campCleared as campClearedEvent, campReturned as campReturnedEvent, damaged } from '#engine/engineEvents'\nimport { engagedLike, engageWith, isBlocked, isShunned, roomFor, shun } from './engagement'\nimport { defineComponent } from './components'\nimport { at, declaredAt, lowerChain } from './defs'\nimport { edgeDistance, type Entity, type EntityId, type PlayerId, moving, fighting } from './entity'\nimport { defineListener, type ListenerDef } from './events'\nimport { defineHook, type HookDef, type TargetScore } from './hooks'\nimport { dist, type Vec2 } from './math'\nimport { createOrder, giveOrder } from './orders/queue'\nimport { freeToHelp } from './orders/idle'\nimport { acquireTarget, canAttack, canSee, disengage, engage } from './systems/combat'\nimport { halt, moveTo } from './systems/movement'\nimport type { System } from './registry'\nimport type { World } from './world'\nimport { cos, sin } from './exactMath'\nimport type { SessionView } from './replication'\nimport type { CampInfo } from './session/protocol'\n\n/**\n * Someone a camp is fighting, on its list (`Camp.aggro`)\n *\n * @beta\n */\nexport interface CampAggro {\n\t/** Who it is */\n\tid: EntityId\n\t/** The damage it has done the camp's creeps: the most is gone for first, then the nearest (`campTarget`) */\n\tthreat: number\n\t/** When it last hit one of the camp's creeps or was hit by one, in seconds of the game */\n\tlastHitAt: number\n}\n\n/**\n * A group of creeps guarding a spot\n *\n * @beta\n */\nexport interface Camp {\n\t/** The camp's number: its place in the world's camps, plus one */\n\tid: number\n\t/** Where the middle of the camp is, east-west in cells */\n\tx: number\n\t/** Where the middle of the camp is, north-south in cells */\n\tz: number\n\t/** Levels of its creeps added up, as it was set up */\n\tlevel: number\n\t/** How far from the camp's centre its creeps fight: what goes past it is let go of (`CampSettings.leash`) */\n\tleash: number\n\t/** The entity ids of its creeps */\n\tmembers: EntityId[]\n\t/**\n\t * Who the camp is fighting, as its creeps pick (`campTarget`): fed by every hit on one of them (the damage done, as\n\t * threat) and by their own hits, rid of the dead and of what is past the leash, emptied as the camp goes home\n\t */\n\taggro: CampAggro[]\n\t/** The last it went for: what wakes one of them wakes the rest */\n\talarm: EntityId\n\t/** When one of its creeps last hit or was hit, in seconds of the game: it goes home `resetAfter` after. None at peace */\n\tfoughtAt?: number\n\t/** Seconds a creep of it chases what it neither hits nor is hit by before it lets it go: the rules' `chaseTime` when left out */\n\tchaseTime?: number\n\t/** Seconds without a blow before it goes home: the rules' `resetAfter` when left out */\n\tresetAfter?: number\n\t/** Whether all of it answers a hit at once: the rules' `helpAtOnce` when left out */\n\thelpAtOnce?: boolean\n\t/** The name it was given on the map, for the rules to find it by (`campNamed`) */\n\tname?: string\n\t/** Who its creeps are, and of what types, for it to come back the same (see `respawn`). None in saves of before */\n\towner?: PlayerId\n\t/** The unit type ids of its creeps, kept for it to come back the same after `respawn` */\n\ttypes?: string[]\n\t/**\n\t * Seconds after it was cleared that it comes back, its creeps where they stood, as a hero arena game's jungle camps\n\t * do. Never when left out, as in classic RTS games. Set it from code as the game goes (`campsOf`) to change it\n\t */\n\trespawn?: number\n\t/** When it was found empty, in seconds of the game: it comes back `respawn` seconds after */\n\tclearedAt?: number\n}\n\n/**\n * Ties a creep to the camp it guards\n *\n * @beta\n */\nexport interface CampMember {\n\t/** The number of the camp the creep guards */\n\tcamp: number\n\t/** Where the creep returns to when the camp gives up the fight */\n\thome: Vec2\n\t/** On its way back after the camp gave up the fight. Deaf to everything but a hit, and to that for `RETURN_GRACE` */\n\treturning: boolean\n\t/** When it turned for home, in seconds of the game */\n\treturningAt?: number\n\t/** Where it was attacked from by something it could not see, and is going to look */\n\tsearching: Vec2 | null\n\t/** When it last traded a blow with what it goes for, or took it up: a chase with none for `chaseTime` is given up */\n\tblowAt?: number\n}\n\n/**\n * Seconds a creep on its way home is deaf even to a hit: so that one led to the end of its leash does not turn on the\n * first arrow in its back and come straight back out\n *\n * @beta\n */\nexport const RETURN_GRACE = 1.5\n\n/** How far past the leash a creep may itself stand, fighting what is just inside it */\nconst LEASH_SLACK = 2\n\n/**\n * On a creep: the camp it belongs to\n *\n * @beta\n */\nexport const campMember = defineComponent<CampMember>({ id: 'core.camp' })\n\n/**\n * The camps of a world, by id less one\n *\n * @beta\n */\nexport const camps = defineComponent<Camp[]>({ id: 'core.camps', default: () => [] })\n\n/**\n * Gives the camps of a world, the list `camps` holds\n *\n * @internal\n */\nexport const campsOf = (world: World): Camp[] => world.state(camps)\n\n/**\n * The camp of this name, as it was given one on the map. It is there for as long as the game, with or without its creeps\n *\n * @beta\n */\nexport const campNamed = (world: World, name: string): Camp | undefined => campsOf(world).find((camp) => camp.name === name)\n\n/**\n * Where the creeps of a camp stand: the first one in the middle, the rest in a ring around it, facing out\n *\n * @beta\n */\nexport function campLayout(point: Vec2, count: number): { x: number; z: number; facing: number }[] {\n\treturn Array.from({ length: count }, (_, i) => {\n\t\tconst angle = (i / Math.max(count - 1, 1)) * Math.PI * 2\n\t\tconst spread = i === 0 ? 0 : 1.6\n\t\treturn { x: point.x + sin(angle) * spread, z: point.z + cos(angle) * spread, facing: angle }\n\t})\n}\n\n/**\n * Puts a camp of creeps on the map. The creeps stand around the point and come back to it\n *\n * @beta\n */\nexport function spawnCamp(world: World, owner: PlayerId, point: Vec2, types: string[], leash = world.settings.camps.leash): Camp {\n\tconst all = campsOf(world)\n\tconst level = types.reduce((sum, type) => sum + (world.registry.unit(type).level ?? 1), 0)\n\tconst camp: Camp = { id: all.length + 1, x: point.x, z: point.z, level, leash, members: [], aggro: [], alarm: 0, owner, types: [...types] }\n\tconst { respawn } = world.settings.camps\n\tif (respawn !== undefined) camp.respawn = respawn\n\tall.push(camp)\n\tpopulate(world, camp, owner, types)\n\treturn camp\n}\n\n/** Puts a camp's creeps where they stand, as its members */\nfunction populate(world: World, camp: Camp, owner: PlayerId, types: string[]): void {\n\tconst layout = campLayout(camp, types.length)\n\tcamp.members = []\n\ttypes.forEach((type, i) => {\n\t\tconst { x, z, facing } = layout[i]\n\t\tconst creep = world.spawn(type, owner, { x, z }, { facing })\n\t\tcreep.set(campMember, { camp: camp.id, home: { x: creep.pos.x, z: creep.pos.z }, returning: false, searching: null })\n\t\tcamp.members.push(creep.id)\n\t})\n}\n\n/**\n * Brings a cleared camp back now, the same creeps where they stood (`campReturned`): from code, or when its time comes\n *\n * @beta\n */\nexport function respawnCamp(world: World, camp: Camp): void {\n\tif (!camp.types?.length || camp.owner === undefined) return\n\tpopulate(world, camp, camp.owner, camp.types)\n\tcamp.alarm = 0\n\tcamp.aggro = []\n\tcamp.foughtAt = undefined\n\tcamp.clearedAt = undefined\n\tworld.events.emit(campReturnedEvent, { camp })\n}\n\n/** Whether every creep of a camp is gone */\nconst emptied = (world: World, camp: Camp) => camp.members.every((id) => !world.get(id)?.alive)\n\n/**\n * Camps that come back (`Camp.respawn`): told when one is found empty (`campCleared`), and brought back once its time is\n * up, when nobody but its own kind stands in it. Once a second, at the rate of 30 ticks\n *\n * @internal\n */\nexport const campRespawnSystem: System = {\n\tname: 'campRespawn',\n\tphase: 'cleanup',\n\tevery: 30,\n\tupdate(world: World): void {\n\t\tfor (const camp of campsOf(world)) {\n\t\t\tif (!emptied(world, camp)) continue\n\t\t\tif (camp.clearedAt === undefined) {\n\t\t\t\tcamp.clearedAt = world.time\n\t\t\t\tworld.events.emit(campClearedEvent, { camp })\n\t\t\t}\n\t\t\tif (camp.respawn === undefined || world.time - camp.clearedAt < camp.respawn) continue\n\t\t\t// not on top of whoever stands there: it waits for them to go\n\t\t\tconst there = world.spatial.query(camp.x, camp.z, 3, found)\n\t\t\tif (there.some((entity) => entity.alive && entity.isUnit && entity.owner !== camp.owner)) continue\n\t\t\trespawnCamp(world, camp)\n\t\t}\n\t}\n}\n\n/** Part of their health creeps regain per second on the way home */\nconst RETREAT_HEALING = 0.1\nconst found: Entity[] = []\n\n/** Uses an ability that hits what is around the creep, when that is worth it */\nfunction lashOut(world: World, entity: Entity): boolean {\n\tfor (const state of entity.abilities) {\n\t\tif (state.level < 1 || state.cooldown > 0) continue\n\t\tconst ability = world.registry.ability(state.id)\n\t\tif (ability.target !== 'none' || at(ability.manaCost, state.level) > entity.mana) continue\n\t\tconst radius = lowerChain(ability.effects).reduce(\n\t\t\t(max, effect) => Math.max(max, effect.type === 'damage' ? declaredAt(effect.radius, state.level) : 0),\n\t\t\t0\n\t\t)\n\t\tif (!radius) continue\n\t\tlet caught = 0\n\t\tfor (const other of world.spatial.query(entity.pos.x, entity.pos.z, radius, found)) {\n\t\t\tif (other.isUnit && canAttack(world, entity, other) && edgeDistance(entity, other) <= radius) caught++\n\t\t}\n\t\tif (caught < 2) continue\n\t\tgiveOrder(world, entity, createOrder(world, { type: 'cast', ability: ability.id }))\n\t\treturn true\n\t}\n\treturn false\n}\n\n/** The camp's own `chaseTime`, or the rules' */\nconst chaseTimeOf = (world: World, camp: Camp) => camp.chaseTime ?? world.settings.camps.chaseTime\n/** The camp's own `resetAfter`, or the rules' */\nconst resetAfterOf = (world: World, camp: Camp) => camp.resetAfter ?? world.settings.camps.resetAfter\n/** The camp's own `helpAtOnce`, or the rules' */\nconst helpsAtOnce = (world: World, camp: Camp) => camp.helpAtOnce ?? world.settings.camps.helpAtOnce\n\n/** Whether the creep may go for it: an enemy it sees, inside the camp's leash, and not one it leaves alone for now (`shun`) */\nfunction mayChase(world: World, entity: Entity, camp: Camp, other: Entity | undefined): other is Entity {\n\treturn (\n\t\t!!other &&\n\t\tother.alive &&\n\t\tcanAttack(world, entity, other) &&\n\t\tcanSee(world, entity, other) &&\n\t\tdist(other.pos, camp) <= camp.leash &&\n\t\t!isShunned(world, entity, other)\n\t)\n}\n\n/** The camp's list rid of the dead, the gone and what stands past the leash */\nfunction prune(world: World, camp: Camp): void {\n\tlet kept = 0\n\tfor (const entry of camp.aggro) {\n\t\tconst other = world.get(entry.id)\n\t\tif (other?.alive && dist(other.pos, camp) <= camp.leash) camp.aggro[kept++] = entry\n\t}\n\tcamp.aggro.length = kept\n}\n\n/** What the `targetScore` hook is asked with for each on a camp's list: one, used again */\nconst scoring: TargetScore = { attacker: undefined!, target: undefined!, distance: 0, engaged: 0, room: 0, score: 0 }\n\n/**\n * What a creep of the camp goes for of the camp's list (`Camp.aggro`): the most threat, then the nearest, the\n * `targetScore` hook having the last word; nothing it leaves alone for now (`shun`: it could not get at it, or chased it\n * too long), cannot see or attack, or that stands past the leash. None when the list has nothing for it\n *\n * @beta\n */\nexport function campTarget(world: World, entity: Entity, camp: Camp): Entity | undefined {\n\tprune(world, camp)\n\tconst hooked = world.hooks.has('targetScore')\n\tlet best: Entity | undefined\n\tlet bestScore = -Infinity\n\tfor (const entry of camp.aggro) {\n\t\tconst other = world.get(entry.id)\n\t\tif (!mayChase(world, entity, camp, other)) continue\n\t\tconst distance = edgeDistance(entity, other)\n\t\tlet score = entry.threat * 1000 - distance\n\t\tif (hooked) {\n\t\t\tscoring.attacker = entity\n\t\t\tscoring.target = other\n\t\t\tscoring.distance = distance\n\t\t\tscoring.engaged = engagedLike(world, other, entity)\n\t\t\tscoring.room = roomFor(world, other, entity)\n\t\t\tscoring.score = score\n\t\t\tscore = world.hooks.run('targetScore', scoring).score\n\t\t}\n\t\tif (score > bestScore) {\n\t\t\tbestScore = score\n\t\t\tbest = other\n\t\t}\n\t}\n\treturn best\n}\n\n/** Its entry on the camp's list, put on it with no threat if it was not */\nfunction entryOf(world: World, camp: Camp, other: Entity): CampAggro {\n\tlet entry = camp.aggro.find((each) => each.id === other.id)\n\tif (!entry) camp.aggro.push((entry = { id: other.id, threat: 0, lastHitAt: world.time }))\n\treturn entry\n}\n\n/** The creep goes for it now: put on the camp's list, the camp's alarm, the chase timed from now */\nfunction take(world: World, entity: Entity, member: CampMember, camp: Camp, target: Entity): void {\n\tengageWith(world, entity, target)\n\tentity.get(fighting)!.autoTarget = target.id\n\tmember.searching = null\n\tmember.blowAt = world.time\n\tcamp.alarm = target.id\n\tentryOf(world, camp, target)\n}\n\n/** Whether a creep of the camp on its way home takes a fight again: once it has been on the way `RETURN_GRACE` seconds */\nconst pastGrace = (world: World, member: CampMember) => world.time - (member.returningAt ?? -Infinity) >= RETURN_GRACE\n\n/**\n * Every creep of the camp free to fight goes for the best of the camp's list now, not at its next look round: those\n * asleep woken, those fighting left to it, those on their way home only past `RETURN_GRACE`, those with an order of their\n * player's (a hold) or standing down (`CombatState.passive`) not at all\n */\nfunction rally(world: World, camp: Camp): void {\n\tfor (const id of camp.members) {\n\t\tconst creep = world.get(id)\n\t\tconst member = creep?.get(campMember)\n\t\tif (!creep?.alive || !member || !freeToHelp(creep)) continue\n\t\tif (member.returning && !pastGrace(world, member)) continue\n\t\tconst combat = creep.get(fighting)!\n\t\tif (combat.autoTarget && world.get(combat.autoTarget)?.alive) continue\n\t\tconst next = campTarget(world, creep, camp)\n\t\tif (!next) continue\n\t\tcreep.asleep = false\n\t\tmember.returning = false\n\t\ttake(world, creep, member, camp, next)\n\t}\n}\n\n/**\n * Puts someone on a camp's list as if it had done the camp `threat` damage (`Camp.aggro`): a taunt, or a game's own\n * reason for the creeps to come. The camp comes at once, as for a hit, where it helps at once (`CampSettings.helpAtOnce`)\n *\n * @beta\n */\nexport function aggroCamp(world: World, camp: Camp, entity: Entity, threat = 0): void {\n\tconst entry = entryOf(world, camp, entity)\n\tentry.threat += threat\n\tentry.lastHitAt = world.time\n\tcamp.foughtAt = world.time\n\tif (!world.get(camp.alarm)) camp.alarm = entity.id\n\tif (helpsAtOnce(world, camp)) rally(world, camp)\n}\n\n/**\n * The camp gives up the fight now, as it does `resetAfter` after the last blow: its list emptied, every creep of it on\n * the way home\n *\n * @beta\n */\nexport function resetCamp(world: World, camp: Camp): void {\n\tcamp.aggro.length = 0\n\tcamp.foughtAt = undefined\n\tcamp.alarm = 0\n\tfor (const id of camp.members) {\n\t\tconst creep = world.get(id)\n\t\tconst member = creep?.get(campMember)\n\t\tif (creep?.alive && member && !member.returning) goHome(world, creep, member)\n\t}\n}\n\n/** A creep of the camp lets go of what it fought and walks home, healing as it goes */\nfunction goHome(world: World, entity: Entity, member: CampMember): void {\n\tconst combat = entity.get(fighting)\n\tif (combat) combat.autoTarget = 0\n\tdisengage(world, entity)\n\tmember.searching = null\n\tif (entity.get(moving) && dist(entity.pos, member.home) > 1.5) {\n\t\tmember.returning = true\n\t\tmember.returningAt = world.time\n\t\tmoveTo(world, entity, member.home)\n\t}\n}\n\n/**\n * A hit on a creep of a camp, or by one: the camp's list fed (the damage done, as threat), its fight kept up, a chase of\n * the one hit or hitting timed anew, and the camp brought at once (`helpAtOnce`). A creep on its way home turns when hit\n * past `RETURN_GRACE`\n */\nfunction hit(world: World, target: Entity, source: Entity | undefined, amount: number): void {\n\tif (!source || !world.areEnemies(source.owner, target.owner)) return\n\tconst struck = target.get(campMember)\n\tconst camp = struck && campsOf(world)[struck.camp - 1]\n\tif (struck && camp) {\n\t\tconst entry = entryOf(world, camp, source)\n\t\tentry.threat += amount\n\t\tentry.lastHitAt = world.time\n\t\tcamp.foughtAt = world.time\n\t\tif (!world.get(camp.alarm)) camp.alarm = source.id\n\t\tif (target.get(fighting)?.autoTarget === source.id) struck.blowAt = world.time\n\t\tif (target.alive && struck.returning && pastGrace(world, struck)) struck.returning = false\n\t\tif (helpsAtOnce(world, camp)) rally(world, camp)\n\t}\n\tconst striker = source.get(campMember)\n\tconst own = striker && campsOf(world)[striker.camp - 1]\n\tif (striker && own) {\n\t\tentryOf(world, own, target).lastHitAt = world.time\n\t\town.foughtAt = world.time\n\t\tif (source.get(fighting)?.autoTarget === target.id) striker.blowAt = world.time\n\t}\n}\n\n/**\n * What creeps do: guard their camp. They go for whoever comes close or attacks one of them, the most threat on the\n * camp's list first; give up a chase that brings no blow for `chaseTime`, and what goes past the leash from the camp's\n * centre; wait where they stand while the camp's fight is on, and go home `resetAfter` after its last blow, healing on\n * the way. At night they sleep at home\n */\nfunction guardCamp(world: World, entity: Entity, dt: number): void {\n\tconst member = entity.get(campMember)!\n\tconst combat = entity.get(fighting)!\n\tconst camp = campsOf(world)[member.camp - 1]\n\tconst m = entity.get(moving)\n\n\tif (entity.asleep) {\n\t\t// what wakes one of them sounds the alarm for the rest\n\t\tif (world.night && !combat.lastAttacker && !world.get(camp.alarm)) return\n\t\tentity.asleep = false\n\t}\n\n\tif (member.returning) {\n\t\tentity.health = Math.min(entity.health + entity.maxHealth * RETREAT_HEALING * dt, entity.maxHealth)\n\t\tif (m && m.status === 'moving') return\n\t\tif (m && dist(entity.pos, member.home) > 1.5 && m.status !== 'failed') {\n\t\t\tmoveTo(world, entity, member.home)\n\t\t\treturn\n\t\t}\n\t\tmember.returning = false\n\t\tmember.returningAt = undefined\n\t\tcombat.lastAttacker = 0\n\t\tif (camp.alarm && !world.get(camp.alarm)) camp.alarm = 0\n\t\treturn\n\t}\n\n\tlet dropped = false\n\tif (combat.autoTarget) {\n\t\tconst target = world.get(combat.autoTarget)\n\t\t// what went past the leash from the camp's centre, or led this one past it\n\t\tconst tooFar = !target || dist(target.pos, camp) > camp.leash || dist(entity.pos, camp) > camp.leash + LEASH_SLACK\n\t\tif (!tooFar && lashOut(world, entity)) return\n\t\tlet result = tooFar ? 'invalid' : engage(world, entity, target, dt, !!m)\n\t\t// held up on the way, or after it too long without a blow either way: the next of the list then\n\t\tconst stale = world.time - (member.blowAt ?? world.time) > chaseTimeOf(world, camp)\n\t\tif (result === 'chasing' && target && (stale || isBlocked(world, entity, target))) {\n\t\t\tshun(world, entity, target)\n\t\t\tresult = 'invalid'\n\t\t}\n\t\tif (result === 'attacking' || result === 'chasing') return\n\t\tcombat.autoTarget = 0\n\t\tdisengage(world, entity)\n\t\tdropped = true\n\t}\n\n\t// the next at once when it let one go, else at its look round, every fourth tick\n\tif (!dropped && (world.tick + entity.id) % 4 !== 0) return\n\tlet next = campTarget(world, entity, camp)\n\tif (!next) {\n\t\tconst seen = acquireTarget(world, entity)\n\t\tif (mayChase(world, entity, camp, seen)) next = seen\n\t}\n\tconst hitter = world.get(combat.lastAttacker)\n\tif (!next && mayChase(world, entity, camp, hitter)) next = hitter\n\tconst alarm = world.get(camp.alarm)\n\tif (!next && mayChase(world, entity, camp, alarm)) next = alarm\n\t// hit by something it cannot see: go and look where that came from\n\tif (!next && m && hitter && canAttack(world, entity, hitter) && !isShunned(world, entity, hitter) && dist(hitter.pos, camp) <= camp.leash) {\n\t\tmember.searching = { x: hitter.pos.x, z: hitter.pos.z }\n\t\tmoveTo(world, entity, member.searching)\n\t}\n\tcombat.lastAttacker = 0\n\tif (next) {\n\t\ttake(world, entity, member, camp, next)\n\t\treturn\n\t}\n\tif (member.searching && m?.status === 'moving' && dist(entity.pos, camp) <= camp.leash) return\n\tmember.searching = null\n\t// the camp's fight is on while one of it trades blows: it waits where it stands, for what comes next\n\tif (camp.foughtAt !== undefined && world.time - camp.foughtAt < resetAfterOf(world, camp)) {\n\t\tif (m?.status === 'moving') halt(world, entity)\n\t\treturn\n\t}\n\tif (camp.foughtAt !== undefined || camp.aggro.length) {\n\t\tcamp.aggro.length = 0\n\t\tcamp.foughtAt = undefined\n\t}\n\tconst intruder = world.get(camp.alarm)\n\tif (camp.alarm && (!intruder || dist(intruder.pos, camp) > camp.leash)) camp.alarm = 0\n\tgoHome(world, entity, member)\n\tif (world.night && world.settings.camps.sleep && !member.returning && !camp.alarm) entity.asleep = true\n}\n\n/**\n * What turns camps on: creeps of a camp guard it instead of doing what idle units do\n *\n * @internal\n */\nexport const campHooks: HookDef[] = [\n\tdefineHook({\n\t\thook: 'idle',\n\t\tid: 'guardCamp',\n\t\trun(world, event) {\n\t\t\tif (event.handled || !event.fights || !event.entity.has(campMember)) return\n\t\t\tguardCamp(world, event.entity, event.dt)\n\t\t\tevent.handled = true\n\t\t}\n\t})\n]\n\n/**\n * What feeds the camps' lists (`Camp.aggro`): every hit on a creep of a camp, or by one, as it is told (`damaged`). The\n * heroes pack's, with `campHooks`\n *\n * @internal\n */\nexport const campListeners: ListenerDef[] = [\n\tdefineListener({\n\t\tevent: damaged,\n\t\tid: 'campAggro',\n\t\trun: (world, { target, source, amount }) => hit(world, target, source, amount)\n\t})\n]\n\n/** What a seat says of the camps, kept up to date once a tick (`campsFor`) */\nconst CAMPS = {}\n\n/**\n * The camps as a seat's player knows them (`GameSession.camps`): where they are and how strong, and which their team\n * has seen empty. Worked out once a tick, as the minimap asks every frame: the same list and objects every time, kept\n * up to date, so it is to read, not to keep\n *\n * @beta\n */\nexport function campsFor(view: SessionView): readonly CampInfo[] {\n\tconst kept = view.keep(CAMPS, () => ({ at: -1, infos: [] as CampInfo[] }))\n\tconst { world } = view\n\tif (kept.at === world.tick) return kept.infos\n\tkept.at = world.tick\n\tconst all = campsOf(world)\n\tconst { cleared } = view.memory\n\tconst occupied = (members: readonly number[]) => members.some((id) => !!world.get(id))\n\tfor (let i = 0; i < all.length; i++) {\n\t\tconst camp = all[i]\n\t\tconst known = cleared.indexOf(camp.id)\n\t\t// an empty camp is only known to be empty once someone has looked\n\t\tif (known < 0 && view.sees(camp.x, camp.z) && !occupied(camp.members)) cleared.push(camp.id)\n\t\telse if (known >= 0 && view.sees(camp.x, camp.z) && occupied(camp.members)) {\n\t\t\t// back, as camps that come back do: known once someone looks again\n\t\t\tcleared.splice(known, 1)\n\t\t}\n\t\tconst info = (kept.infos[i] ??= { id: camp.id, x: camp.x, z: camp.z, level: camp.level, cleared: false })\n\t\tinfo.cleared = cleared.includes(camp.id)\n\t}\n\tkept.infos.length = all.length\n\treturn kept.infos\n}\n"],"mappings":"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"}

package/dist/capture.d.ts

@@ -11,14 +11,16 @@ import type { World } from './world';
  */
 export type Contested = 'pause' | 'reset' | 'majority';
 /**
- * A capture point given in code (`withCapture`'s `points`); one placed on the map says the same with its fields
+ * A capture point given in code (`capturePack`'s `points`); one placed on the map says the same with its fields
  *
  * @beta
  */
 export interface CapturePoint {
     /** Unique among the game's points: what the events name it by, and `capturePoint` */
     id: string;
+    /** What the point is called to the players; nothing when left out */
     name?: string;
+    /** Where the middle of the point is, in cells */
     at: Vec2;
     /** How far around its middle counts, in cells: 4 when left out */
     radius?: number;
@@ -36,15 +38,25 @@ export interface CapturePoint {
  * @beta
  */
 export interface CaptureState {
+    /** The point's id, which the events name it by */
     id: string;
+    /** What the point is called to the players, where it has a name */
     name?: string;
+    /** Where the middle of the point is, east-west in cells */
     x: number;
+    /** Where the middle of the point is, north-south in cells */
     z: number;
+    /** How far around its middle counts as in it, in cells */
     radius: number;
+    /** Seconds a side alone in it takes to make it its own */
     time: number;
+    /** What the point does while two sides stand in it */
     contested: Contested;
+    /** The player it belongs to; null while nobody holds it */
     owner: PlayerId | null;
+    /** The team taking it now; null while nobody is */
     by: number | null;
+    /** How far the taker has got, 0..1 */
     progress: number;
 }
 /**
@@ -107,7 +119,7 @@ export declare const captureOf: (world: World, id: string) => CaptureState | und
  */
 export declare function capturePoint(world: World, id: string, owner: PlayerId | null): boolean;
 /**
- * What a game turns capture points on with (`withCapture`)
+ * What a game turns capture points on with (`capturePack`)
  *
  * @beta
  */
@@ -128,4 +140,4 @@ export interface CaptureOptions {
  *
  * @beta
  */
-export declare function withCapture(options?: CaptureOptions): GamePack;
+export declare function capturePack(options?: CaptureOptions): GamePack;

package/dist/capture.js

@@ -0,0 +1,304 @@
+import { defineComponent } from "./components.js";
+import { defineEngineEvent } from "./events.js";
+//#region src/capture.ts
+/**
+* The kind of thing on the map a capture point is placed as (the editor's `captureKind`)
+*
+* @beta
+*/
+var CAPTURE_KIND = "capture";
+/**
+* The fields of a capture point on the map, as the editor's kind offers them and the rules read them: its reach, its
+* time, what it does contested, and whose it is at the start
+*
+* @beta
+*/
+var CAPTURE_FIELDS = [
+	{
+		id: "radius",
+		name: "Reach",
+		kind: "number",
+		default: 4,
+		min: 1,
+		max: 24,
+		step: .5,
+		hint: "How far around its middle counts, in cells"
+	},
+	{
+		id: "time",
+		name: "Seconds to take",
+		kind: "number",
+		default: 10,
+		min: 1,
+		max: 300,
+		step: 1,
+		hint: "Seconds a side alone in it takes to make it its own"
+	},
+	{
+		id: "contested",
+		name: "While contested",
+		kind: "choice",
+		default: "pause",
+		options: [
+			{
+				value: "pause",
+				label: "Nothing moves"
+			},
+			{
+				value: "reset",
+				label: "What was gained is lost"
+			},
+			{
+				value: "majority",
+				label: "The larger side takes it"
+			}
+		],
+		hint: "What it does while two sides stand in it"
+	},
+	{
+		id: "owner",
+		name: "Whose at the start",
+		kind: "player",
+		hint: "Nobody’s when left out"
+	}
+];
+/**
+* The capture points of the world, by id: whose each is and who is taking it. Kept in a save; in the game's report
+* as `captures` (a list), for the HUD and the computer
+*
+* @beta
+*/
+var captures = defineComponent({
+	id: "core.captures",
+	default: () => ({})
+});
+/** Whether the points were set up from the code's list and the map: once a world, kept in a save */
+var ready = defineComponent({
+	id: "core.capturesReady",
+	default: () => false
+});
+/**
+* A point changed hands: whose it is now (nobody's for one let go by code), and whose it was
+*
+* @beta
+*/
+var captured = defineEngineEvent({
+	id: "core.captured",
+	replicate: "everyone"
+});
+/**
+* A side (a team) began taking a point, or none is any more
+*
+* @beta
+*/
+var capturing = defineEngineEvent({
+	id: "core.capturing",
+	replicate: "everyone"
+});
+/**
+* The area of a point, as the rules watch it (`world.areas`)
+*
+* @internal
+*/
+var captureAreaOf = (id) => `core.capture.${id}`;
+/**
+* The capture points of a world, as they stand
+*
+* @beta
+*/
+var capturesOf = (world) => Object.values(world.state(captures));
+/**
+* A point by id, or nothing for an id the world has not got
+*
+* @beta
+*/
+var captureOf = (world, id) => world.state(captures)[id];
+/**
+* Gives a point to a player, or to nobody, from the rules: its progress forgotten, and `captured` said
+*
+* @beta
+*/
+function capturePoint(world, id, owner) {
+	const point = world.state(captures)[id];
+	if (!point) return false;
+	const from = point.owner;
+	point.owner = owner;
+	point.by = null;
+	point.progress = 0;
+	world.events.emit(captured, {
+		id,
+		owner,
+		from
+	});
+	return true;
+}
+/** A thing of the map as a point: named as the thing is, else by its number */
+function pointOfThing(thing) {
+	const data = thing.data;
+	const owner = typeof data.owner === "number" && data.owner > 0 ? data.owner : void 0;
+	return {
+		id: thing.name ?? `capture-${thing.id}`,
+		name: thing.name,
+		at: {
+			x: thing.x,
+			z: thing.z
+		},
+		radius: data.radius,
+		time: data.time,
+		contested: data.contested,
+		owner
+	};
+}
+/** Puts the points of the code and the map in the world: once, as the first count comes (a loaded one has them) */
+function setUp(world, options) {
+	const state = world.state(captures);
+	const things = world.map.things(options.kind ?? "capture", CAPTURE_FIELDS).map(pointOfThing);
+	for (const point of [...options.points ?? [], ...things]) state[point.id] ??= {
+		id: point.id,
+		...point.name && { name: point.name },
+		x: point.at.x,
+		z: point.at.z,
+		radius: point.radius ?? 4,
+		time: Math.max(point.time ?? 10, .1),
+		contested: point.contested ?? "pause",
+		owner: point.owner ?? null,
+		by: null,
+		progress: 0
+	};
+	world.setState(ready, true);
+}
+/** The area of a point, as the rules watch it: added as the first count comes (a loaded world brings its own back) */
+function areaOf(world, point) {
+	const id = captureAreaOf(point.id);
+	if (!world.areas.has(id)) {
+		const area = {
+			id,
+			shape: {
+				kind: "circle",
+				x: point.x,
+				z: point.z,
+				radius: point.radius
+			}
+		};
+		world.areas.add(area);
+	}
+	return id;
+}
+/** Who stands in a point, by team: how many, and one of them to own it */
+var standing = /* @__PURE__ */ new Map();
+/** A count of who stands in each point, and what follows: progress, a side let go of, a point changed hands */
+function count(world, dt) {
+	for (const point of Object.values(world.state(captures))) {
+		standing.clear();
+		for (const entity of world.areas.inside(areaOf(world, point))) {
+			if (!entity.alive || entity.hidden || entity.def.kind !== "unit") continue;
+			const player = world.player(entity.owner);
+			if (player.neutral) continue;
+			const seen = standing.get(player.team);
+			if (seen) seen.count++;
+			else standing.set(player.team, {
+				count: 1,
+				player: entity.owner
+			});
+		}
+		if (!standing.size) continue;
+		let actor;
+		if (standing.size === 1) {
+			const [team, each] = [...standing][0];
+			actor = {
+				team,
+				player: each.player
+			};
+		} else if (point.contested === "reset") {
+			if (point.progress > 0 || point.by !== null) {
+				point.progress = 0;
+				point.by = null;
+				world.events.emit(capturing, {
+					id: point.id,
+					by: null
+				});
+			}
+			continue;
+		} else if (point.contested === "majority") {
+			let best;
+			let tie = false;
+			for (const entry of standing) if (!best || entry[1].count > best[1].count) {
+				best = entry;
+				tie = false;
+			} else if (entry[1].count === best[1].count) tie = true;
+			if (!best || tie) continue;
+			actor = {
+				team: best[0],
+				player: best[1].player
+			};
+		} else continue;
+		const step = dt / point.time;
+		const ownerTeam = point.owner === null ? null : world.player(point.owner).team;
+		if (actor.team === ownerTeam) {
+			if (point.progress > 0) point.progress = Math.max(0, point.progress - step);
+			if (point.progress === 0 && point.by !== null) {
+				point.by = null;
+				world.events.emit(capturing, {
+					id: point.id,
+					by: null
+				});
+			}
+			continue;
+		}
+		if (point.by !== null && point.by !== actor.team) {
+			point.progress = Math.max(0, point.progress - step);
+			if (point.progress === 0) point.by = null;
+			continue;
+		}
+		if (point.by === null) {
+			point.by = actor.team;
+			world.events.emit(capturing, {
+				id: point.id,
+				by: actor.team
+			});
+		}
+		point.progress = Math.min(1, point.progress + step);
+		if (point.progress < 1) continue;
+		const from = point.owner;
+		point.owner = actor.player;
+		point.by = null;
+		point.progress = 0;
+		world.events.emit(captured, {
+			id: point.id,
+			owner: actor.player,
+			from
+		});
+	}
+}
+/**
+* A game with capture points: the points of `options.points` and of the map (things of the `capture` kind, which the
+* editor places with the client's `captureKind`), each an area, counted every few ticks; whose each is and who is
+* taking it in the world (`captures`, `capturesOf`) and in the game's report (`captures`); `captured` and
+* `capturing` as they change; `capturePoint` for the rules' own say. Units count, alive and in sight of nobody in
+* particular; buildings, scenery and the neutral player's do not
+*
+* @beta
+*/
+function capturePack(options = {}) {
+	const every = Math.max(1, Math.round(options.every ?? 3));
+	return {
+		id: "capture",
+		options,
+		components: [captures, ready],
+		events: [captured, capturing],
+		systems: [{
+			name: "core.capture",
+			phase: "cleanup",
+			every,
+			update(world) {
+				if (!world.state(ready)) setUp(world, options);
+				count(world, every / world.tickRate);
+			}
+		}],
+		report: (world) => ({ captures: capturesOf(world) })
+	};
+}
+//#endregion
+export { CAPTURE_FIELDS, CAPTURE_KIND, captureAreaOf, captureOf, capturePack, capturePoint, captured, captures, capturesOf, capturing, ready };
+
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","names":[],"sources":["../src/capture.ts"],"sourcesContent":["import type { AreaDef } from './areas'\nimport type { GamePack } from './packs/pack'\nimport { defineComponent } from './components'\nimport type { PlayerId } from './entity'\nimport { defineEngineEvent } from './events'\nimport type { MapFieldDef, MapThing } from './mapFields'\nimport type { Vec2 } from './math'\nimport type { System } from './registry'\nimport type { World } from './world'\n\n/*\n * Capture points (master plan FI2): places on the map a side takes by standing in them, as a king of the hill or a\n * control point is. A pack a game turns on (`capturePack`): the points come from code (`CapturePoint`) and from the\n * map, as things of the `capture` kind the editor places (the client's `captureKind`); each is an area the rules\n * watch, with its owner and how far a side has got toward taking it kept in the world (`captures`, in a save and in\n * the game's report, which the HUD and the computer read). A system counts who stands in each every few ticks, and\n * says when one changes hands (`captured`) and when a side starts taking it (`capturing`)\n */\n\n/**\n * What a point does while two sides stand in it: nothing moves (`pause`), what was gained is lost (`reset`), or the\n * larger side takes it as if alone (`majority`; a tie pauses)\n *\n * @beta\n */\nexport type Contested = 'pause' | 'reset' | 'majority'\n\n/**\n * A capture point given in code (`capturePack`'s `points`); one placed on the map says the same with its fields\n *\n * @beta\n */\nexport interface CapturePoint {\n\t/** Unique among the game's points: what the events name it by, and `capturePoint` */\n\tid: string\n\t/** What the point is called to the players; nothing when left out */\n\tname?: string\n\t/** Where the middle of the point is, in cells */\n\tat: Vec2\n\t/** How far around its middle counts, in cells: 4 when left out */\n\tradius?: number\n\t/** Seconds a side alone in it takes to make it its own: 10 when left out */\n\ttime?: number\n\t/** What it does while two sides stand in it: `pause` when left out */\n\tcontested?: Contested\n\t/** Whose it is as the game starts: nobody's when left out */\n\towner?: PlayerId\n}\n\n/**\n * A capture point as the world keeps it: where it is, how it is taken, whose it is, and who is taking it now (a team)\n * and how far they have got (0 to 1)\n *\n * @beta\n */\nexport interface CaptureState {\n\t/** The point's id, which the events name it by */\n\tid: string\n\t/** What the point is called to the players, where it has a name */\n\tname?: string\n\t/** Where the middle of the point is, east-west in cells */\n\tx: number\n\t/** Where the middle of the point is, north-south in cells */\n\tz: number\n\t/** How far around its middle counts as in it, in cells */\n\tradius: number\n\t/** Seconds a side alone in it takes to make it its own */\n\ttime: number\n\t/** What the point does while two sides stand in it */\n\tcontested: Contested\n\t/** The player it belongs to; null while nobody holds it */\n\towner: PlayerId | null\n\t/** The team taking it now; null while nobody is */\n\tby: number | null\n\t/** How far the taker has got, 0..1 */\n\tprogress: number\n}\n\n/**\n * The kind of thing on the map a capture point is placed as (the editor's `captureKind`)\n *\n * @beta\n */\nexport const CAPTURE_KIND = 'capture'\n\n/**\n * The fields of a capture point on the map, as the editor's kind offers them and the rules read them: its reach, its\n * time, what it does contested, and whose it is at the start\n *\n * @beta\n */\nexport const CAPTURE_FIELDS: readonly Omit<MapFieldDef, 'for'>[] = [\n\t{ id: 'radius', name: 'Reach', kind: 'number', default: 4, min: 1, max: 24, step: 0.5, hint: 'How far around its middle counts, in cells' },\n\t{\n\t\tid: 'time',\n\t\tname: 'Seconds to take',\n\t\tkind: 'number',\n\t\tdefault: 10,\n\t\tmin: 1,\n\t\tmax: 300,\n\t\tstep: 1,\n\t\thint: 'Seconds a side alone in it takes to make it its own'\n\t},\n\t{\n\t\tid: 'contested',\n\t\tname: 'While contested',\n\t\tkind: 'choice',\n\t\tdefault: 'pause',\n\t\toptions: [\n\t\t\t{ value: 'pause', label: 'Nothing moves' },\n\t\t\t{ value: 'reset', label: 'What was gained is lost' },\n\t\t\t{ value: 'majority', label: 'The larger side takes it' }\n\t\t],\n\t\thint: 'What it does while two sides stand in it'\n\t},\n\t{ id: 'owner', name: 'Whose at the start', kind: 'player', hint: 'Nobody’s when left out' }\n]\n\n/**\n * The capture points of the world, by id: whose each is and who is taking it. Kept in a save; in the game's report\n * as `captures` (a list), for the HUD and the computer\n *\n * @beta\n */\nexport const captures = defineComponent<Record<string, CaptureState>>({ id: 'core.captures', default: () => ({}) })\n\n/** Whether the points were set up from the code's list and the map: once a world, kept in a save */\nexport const ready = defineComponent<boolean>({ id: 'core.capturesReady', default: () => false })\n\n/**\n * A point changed hands: whose it is now (nobody's for one let go by code), and whose it was\n *\n * @beta\n */\nexport const captured = defineEngineEvent<{ id: string; owner: PlayerId | null; from: PlayerId | null }>({\n\tid: 'core.captured',\n\treplicate: 'everyone'\n})\n\n/**\n * A side (a team) began taking a point, or none is any more\n *\n * @beta\n */\nexport const capturing = defineEngineEvent<{ id: string; by: number | null }>({ id: 'core.capturing', replicate: 'everyone' })\n\n/**\n * The area of a point, as the rules watch it (`world.areas`)\n *\n * @internal\n */\nexport const captureAreaOf = (id: string): string => `core.capture.${id}`\n\n/**\n * The capture points of a world, as they stand\n *\n * @beta\n */\nexport const capturesOf = (world: World): CaptureState[] => Object.values(world.state(captures))\n\n/**\n * A point by id, or nothing for an id the world has not got\n *\n * @beta\n */\nexport const captureOf = (world: World, id: string): CaptureState | undefined => world.state(captures)[id]\n\n/**\n * Gives a point to a player, or to nobody, from the rules: its progress forgotten, and `captured` said\n *\n * @beta\n */\nexport function capturePoint(world: World, id: string, owner: PlayerId | null): boolean {\n\tconst point = world.state(captures)[id]\n\tif (!point) return false\n\tconst from = point.owner\n\tpoint.owner = owner\n\tpoint.by = null\n\tpoint.progress = 0\n\tworld.events.emit(captured, { id, owner, from })\n\treturn true\n}\n\n/**\n * What a game turns capture points on with (`capturePack`)\n *\n * @beta\n */\nexport interface CaptureOptions {\n\t/** Points given in code, beside what the map places */\n\tpoints?: readonly CapturePoint[]\n\t/** Ticks between two counts of who stands where: 3 when left out */\n\tevery?: number\n\t/** The kind of thing on the map a point is placed as: `capture` when left out */\n\tkind?: string\n}\n\n/** A thing of the map as a point: named as the thing is, else by its number */\nfunction pointOfThing(thing: MapThing): CapturePoint {\n\tconst data = thing.data as { radius?: number; time?: number; contested?: Contested; owner?: unknown }\n\tconst owner = typeof data.owner === 'number' && data.owner > 0 ? data.owner : undefined\n\treturn {\n\t\tid: thing.name ?? `capture-${thing.id}`,\n\t\tname: thing.name,\n\t\tat: { x: thing.x, z: thing.z },\n\t\tradius: data.radius,\n\t\ttime: data.time,\n\t\tcontested: data.contested,\n\t\towner\n\t}\n}\n\n/** Puts the points of the code and the map in the world: once, as the first count comes (a loaded one has them) */\nfunction setUp(world: World, options: CaptureOptions): void {\n\tconst state = world.state(captures)\n\tconst things = world.map.things(options.kind ?? CAPTURE_KIND, CAPTURE_FIELDS).map(pointOfThing)\n\tfor (const point of [...(options.points ?? []), ...things]) {\n\t\tstate[point.id] ??= {\n\t\t\tid: point.id,\n\t\t\t...(point.name && { name: point.name }),\n\t\t\tx: point.at.x,\n\t\t\tz: point.at.z,\n\t\t\tradius: point.radius ?? 4,\n\t\t\ttime: Math.max(point.time ?? 10, 0.1),\n\t\t\tcontested: point.contested ?? 'pause',\n\t\t\towner: point.owner ?? null,\n\t\t\tby: null,\n\t\t\tprogress: 0\n\t\t}\n\t}\n\tworld.setState(ready, true)\n}\n\n/** The area of a point, as the rules watch it: added as the first count comes (a loaded world brings its own back) */\nfunction areaOf(world: World, point: CaptureState): string {\n\tconst id = captureAreaOf(point.id)\n\tif (!world.areas.has(id)) {\n\t\tconst area: AreaDef = { id, shape: { kind: 'circle', x: point.x, z: point.z, radius: point.radius } }\n\t\tworld.areas.add(area)\n\t}\n\treturn id\n}\n\n/** Who stands in a point, by team: how many, and one of them to own it */\nconst standing = new Map<number, { count: number; player: PlayerId }>()\n\n/** A count of who stands in each point, and what follows: progress, a side let go of, a point changed hands */\nfunction count(world: World, dt: number): void {\n\tfor (const point of Object.values(world.state(captures))) {\n\t\tstanding.clear()\n\t\tfor (const entity of world.areas.inside(areaOf(world, point))) {\n\t\t\tif (!entity.alive || entity.hidden || entity.def.kind !== 'unit') continue\n\t\t\tconst player = world.player(entity.owner)\n\t\t\tif (player.neutral) continue\n\t\t\tconst seen = standing.get(player.team)\n\t\t\tif (seen) seen.count++\n\t\t\telse standing.set(player.team, { count: 1, player: entity.owner })\n\t\t}\n\t\t// nobody: as it was\n\t\tif (!standing.size) continue\n\t\tlet actor: { team: number; player: PlayerId } | undefined\n\t\tif (standing.size === 1) {\n\t\t\tconst [team, each] = [...standing][0]\n\t\t\tactor = { team, player: each.player }\n\t\t} else if (point.contested === 'reset') {\n\t\t\tif (point.progress > 0 || point.by !== null) {\n\t\t\t\tpoint.progress = 0\n\t\t\t\tpoint.by = null\n\t\t\t\tworld.events.emit(capturing, { id: point.id, by: null })\n\t\t\t}\n\t\t\tcontinue\n\t\t} else if (point.contested === 'majority') {\n\t\t\tlet best: [number, { count: number; player: PlayerId }] | undefined\n\t\t\tlet tie = false\n\t\t\tfor (const entry of standing) {\n\t\t\t\tif (!best || entry[1].count > best[1].count) {\n\t\t\t\t\tbest = entry\n\t\t\t\t\ttie = false\n\t\t\t\t} else if (entry[1].count === best[1].count) tie = true\n\t\t\t}\n\t\t\tif (!best || tie) continue\n\t\t\tactor = { team: best[0], player: best[1].player }\n\t\t} else continue\n\t\tconst step = dt / point.time\n\t\tconst ownerTeam = point.owner === null ? null : world.player(point.owner).team\n\t\t// its owner's own in it: whatever another side gained fades\n\t\tif (actor.team === ownerTeam) {\n\t\t\tif (point.progress > 0) point.progress = Math.max(0, point.progress - step)\n\t\t\tif (point.progress === 0 && point.by !== null) {\n\t\t\t\tpoint.by = null\n\t\t\t\tworld.events.emit(capturing, { id: point.id, by: null })\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\t// another side's gains fade before this one's begin\n\t\tif (point.by !== null && point.by !== actor.team) {\n\t\t\tpoint.progress = Math.max(0, point.progress - step)\n\t\t\tif (point.progress === 0) point.by = null\n\t\t\tcontinue\n\t\t}\n\t\tif (point.by === null) {\n\t\t\tpoint.by = actor.team\n\t\t\tworld.events.emit(capturing, { id: point.id, by: actor.team })\n\t\t}\n\t\tpoint.progress = Math.min(1, point.progress + step)\n\t\tif (point.progress < 1) continue\n\t\tconst from = point.owner\n\t\tpoint.owner = actor.player\n\t\tpoint.by = null\n\t\tpoint.progress = 0\n\t\tworld.events.emit(captured, { id: point.id, owner: actor.player, from })\n\t}\n}\n\n/**\n * A game with capture points: the points of `options.points` and of the map (things of the `capture` kind, which the\n * editor places with the client's `captureKind`), each an area, counted every few ticks; whose each is and who is\n * taking it in the world (`captures`, `capturesOf`) and in the game's report (`captures`); `captured` and\n * `capturing` as they change; `capturePoint` for the rules' own say. Units count, alive and in sight of nobody in\n * particular; buildings, scenery and the neutral player's do not\n *\n * @beta\n */\nexport function capturePack(options: CaptureOptions = {}): GamePack {\n\tconst every = Math.max(1, Math.round(options.every ?? 3))\n\t// the points are set up as the first count comes, a tick in: the map is in the world by then (a loaded one has them)\n\tconst system: System = {\n\t\tname: 'core.capture',\n\t\tphase: 'cleanup',\n\t\tevery,\n\t\tupdate(world) {\n\t\t\tif (!world.state(ready)) setUp(world, options)\n\t\t\tcount(world, every / world.tickRate)\n\t\t}\n\t}\n\treturn {\n\t\tid: 'capture',\n\t\toptions,\n\t\tcomponents: [captures, ready],\n\t\tevents: [captured, capturing],\n\t\tsystems: [system],\n\t\t// what each point ended as, beside the game's own report\n\t\treport: (world) => ({ captures: capturesOf(world) })\n\t}\n}\n"],"mappings":"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"}

package/dist/cellLayers.d.ts

@@ -1,13 +1,14 @@
 import { type AreaShape } from './areas';
 import type { Terrain } from './terrain';
 import type { World } from './world';
+import { type FoliageStyleDef } from './foliage';
 /**
  * A layer of cells a game paints its maps with, for its rules to read: where the bushes are, what burns, where a
  * lane runs. A value per cell (0 to 255, 0 being none), kept with the map (`GameMap.cells`), in the world's ground
  * (`Terrain.cells`, read with `terrain.cellAt`), its saves and what each player is sent. The rules change it while
  * the game runs with `world.setCells`: the players who see a cell are told at once, the others as it comes into their
  * sight (`TeamMemory.cells`), so a change in the dark is not given away. The editor paints the layers a game lists
- * (`GameModule.cellLayers`), with the values it names
+ * (`Rules.cellLayers`), with the values it names
  *
  * @beta
  */
@@ -22,13 +23,9 @@ export interface CellLayerDef {
     color?: [number, number, number];
     /**
      * The values the editor paints with, named: `[{ value: 1, name: 'Bush' }]`. One value, 1, named after the layer when
-     * left out: a layer of cells that are or are not
+     * left out: a layer of cells that are or are not. Of a layer of grass or bushes, its styles (`CellLayerValue.foliage`)
      */
-    values?: {
-        value: number;
-        name: string;
-        color?: [number, number, number];
-    }[];
+    values?: CellLayerValue[];
     /**
      * How fast one on foot goes over a cell of the layer that is not 0, as a multiplier of its speed: a swamp at 0.5. 1
      * when left out; a cell of several such layers is slowed by each (`groundSpeedOfCell`)
@@ -36,17 +33,71 @@ export interface CellLayerDef {
     speed?: number;
 }
 /**
- * Typed help for writing a layer of cells
+ * A value a layer of cells is painted with (`CellLayerDef.values`): its number in the cells, what the editor calls it,
+ * and, of a layer of grass or bushes, the style it is to the rules
+ *
+ * @beta
+ */
+export interface CellLayerValue {
+    /** The value in the cells, 1 to 255 */
+    value: number;
+    /** What the editor calls it */
+    name: string;
+    /** The colour the editor shows it in, 0 to 1 each: the layer's when left out */
+    color?: [number, number, number];
+    /**
+     * Of a layer of grass or bushes (`foliagePack`): what this style is to the rules (`FoliageStyleDef`), whether it
+     * hides, burns, slows. Over the layer's own (`FoliageLayerOptions.style`)
+     */
+    foliage?: FoliageStyleDef;
+}
+/**
+ * What a `data.json`, or a map's definitions, says of a value of a layer of cells (`DataCellLayer.values`): its name,
+ * colour and style, any of them, over the game's value of the same number; one the game has not is a value of its own
+ *
+ * @beta
+ */
+export type DataCellLayerValue = Partial<Omit<CellLayerValue, 'value'>>;
+/**
+ * What a `data.json` (`GameData.cellLayers`, every map) or a map's definitions (`GameMap.definitions`, that map alone)
+ * says of one of the game's layers of cells: its values, by their number, each over the code's (`DataCellLayerValue`),
+ * or `false` to take one of the game's out. What the editor writes of a style made or changed there:
+ * `{ "grass": { "values": { "3": { "name": "Dry field", "foliage": { "flammable": 1 } } } } }`
+ *
+ * @beta
+ */
+export interface DataCellLayer {
+    /** The layer's values, by number (1 to 255): each over the game's of that number, a new one, or `false` for none */
+    values?: Record<number, DataCellLayerValue | false>;
+}
+/**
+ * Why what a `data.json` says of the game's layers of cells (`GameData.cellLayers`) is not right, where it first is
+ * not: nothing when it is
  *
  * @beta
  */
+export declare function dataCellLayersProblem(said: unknown): string | undefined;
+/**
+ * A game's layers of cells with what its data says of them laid over (`DataCellLayer`): each value over the layer's of
+ * the same number, field by field (its `foliage` style too), one the layer has not added (named `Style <n>` where it
+ * says no name), one said `false` taken out; in the order of their numbers. A layer that lists no values has its one
+ * value, 1, first. A layer the game has not is left out. The layers given are not changed
+ *
+ * @beta
+ */
+export declare function layCellLayerData(layers: readonly CellLayerDef[], said: Readonly<Record<string, DataCellLayer>>): CellLayerDef[];
+/**
+ * Typed help for writing a layer of cells
+ *
+ * @public
+ */
 export declare const defineCellLayer: (def: CellLayerDef) => CellLayerDef;
 /**
  * The values a layer is painted with, as the editor offers them: its own, or 1, named after the layer
  *
  * @beta
  */
-export declare const cellLayerValues: (def: CellLayerDef) => NonNullable<CellLayerDef['values']>;
+export declare const cellLayerValues: (def: CellLayerDef) => CellLayerValue[];
 /**
  * The cells of a terrain in a shape, as indices into its layers: the cells whose middle is in it
  *
@@ -55,15 +106,26 @@ export declare const cellLayerValues: (def: CellLayerDef) => NonNullable<CellLay
 export declare function cellsIn(terrain: Pick<Terrain, 'width' | 'depth'>, shape: AreaShape): number[];
 /**
  * Cells of a layer the rules set (`world.setCells`), each with what it was: what each team that does not see a cell
- * keeps of it as it last knew it (`TeamMemory.cells`), to be told when it comes into sight. A cell set back to what the
- * team knows is nothing to tell; one the team sees is told now
+ * keeps of it as it last knew it (`TeamMemory.cells`, a `CellMemory` a layer), to be told when it comes into sight. A
+ * cell set back to what the team knows is nothing to tell; one the team sees is told now. A fire changes cells every
+ * tick: each team's sight is read as its grid, and nothing is made but a layer's memory the first time
  */
 export declare function rememberUnseenCells(world: World, layer: string, cells: readonly number[], was: readonly number[], value: number): void;
 /**
  * The cells changed out of a team's sight that are in it now (`TeamMemory.cells`), told to the team as they are now
- * (`cellsSeen`) and forgotten: after the fog is worked out again (`fogSystem`)
+ * (`cellsSeen`, in order of the cells) and forgotten: after the fog is worked out again (`fogSystem`). A layer's
+ * memory is gone through a word of 32 cells at a time, those it remembers none of passed over, each held against what
+ * the team sees of those 32 as bits (`FogOfWar.sightBits`) where the fog has them, else cell by cell
  */
 export declare function tellCellsInSight(world: World): void;
+/**
+ * What a team remembers of cells the rules changed out of its sight (`TeamMemory.cells`), as a save keeps it: by
+ * layer, the value it last knew by cell, a copy. `undefined` where it remembers none; a layer it remembered and has
+ * forgotten all of may stay, empty, until the team's next look
+ *
+ * @beta
+ */
+export declare function rememberedCells(world: World, team: number): Record<string, Record<number, number>> | undefined;
 /**
  * The world's ground as a team knows it: its layers' cells as the team last saw those changed out of its sight
  * (`TeamMemory.cells`). The ground itself where the team knows all of it, or for an observer (no team)
@@ -71,5 +133,8 @@ export declare function tellCellsInSight(world: World): void;
 export declare function groundKnownTo(world: World, team: number | undefined): Terrain;
 /** A layer's cells changed (`world.setCells`): to those who see them. The others are told as they come into sight (`toldCellsSeen`) */
 export declare const toldCells: import("./replication").ReplicatedEvent;
-/** Cells changed out of a team's sight came into it (`tellCellsInSight`): to the team, as they are now. An observer was told already */
+/**
+ * Cells changed out of a team's sight came into it (`tellCellsInSight`): to the team, as they are now, said to be seen
+ * so (`seen`: a screen does not show them changing now). An observer was told already
+ */
 export declare const toldCellsSeen: import("./replication").ReplicatedEvent;