@v12-engine/create 0.0.0-stage → 0.1.1

package/starters/melee/src/melee/items.ts

@@ -0,0 +1,362 @@
+import { type AbilityDef, defineEffect, type EffectKind, type ItemDef } from '@v12-engine/engine'
+
+// the game's own effects, each with the fields it reads (`EffectTypes`)
+declare module '@v12-engine/engine' {
+	interface EffectTypes {
+		/** Heals the carrier `perSecond` of its health a second, once it has gone `unhurtFor` seconds without being hurt */
+		mend: { perSecond: number; unhurtFor: number }
+	}
+}
+
+/** What using an item does. Abilities like any other, only that nobody has them without the item */
+export const itemAbilities: AbilityDef[] = [
+	{
+		id: 'revealArea',
+		name: 'Reveal',
+		description: 'Lifts the fog over an area anywhere for 5 seconds. Enemies can see it happen',
+		target: 'point',
+		range: 1000,
+		cooldown: 10,
+		effects: [{ type: 'reveal', radius: 9, duration: 5 }]
+	},
+	{
+		id: 'plantWard',
+		name: 'Plant',
+		description: 'Puts down a ward that sees around it for 60 seconds. Enemies see it for the first 2 seconds, then only with an oracle',
+		target: 'point',
+		range: 6,
+		cooldown: 1,
+		effects: [{ type: 'spawn', unit: 'ward' }]
+	},
+	{
+		id: 'sweep',
+		name: 'Sweep',
+		description: 'Sends out a pulse that finds enemy wards around the hero. They can be seen, and struck down, for 8 seconds',
+		target: 'none',
+		cooldown: 25,
+		effects: [{ type: 'detect', radius: 14, duration: 8 }]
+	},
+	{
+		id: 'drinkHealing',
+		name: 'Drink',
+		description: 'Restores 250 health',
+		target: 'none',
+		cooldown: 20,
+		effects: [{ type: 'heal', amount: 250, on: 'caster' }]
+	},
+	{
+		id: 'drinkMana',
+		name: 'Drink',
+		description: 'Restores 150 mana',
+		target: 'none',
+		cooldown: 20,
+		effects: [{ type: 'mana', amount: 150, on: 'caster' }]
+	},
+	{
+		id: 'readHealing',
+		name: 'Read',
+		description: 'Heals friendly units around the reader for 150',
+		target: 'none',
+		cooldown: 30,
+		effects: [{ type: 'heal', amount: 150, radius: 6 }]
+	},
+	{
+		id: 'intervention',
+		name: 'Intervention',
+		description: 'Calls down a beam on a spot far away: after 2.5 seconds friends there regain 150 to 350 health, more with every level',
+		target: 'point',
+		range: 68,
+		cooldown: 90,
+		aim: { shape: 'circle', radius: 6.9 },
+		effects: [{ type: 'after', delay: 2.5, effects: [{ type: 'heal', amount: 150, scaling: { level: 11.8 }, radius: 6.9 }] }]
+	},
+	{
+		id: 'mendingHeart',
+		name: 'Mending Heart',
+		description: 'Regains 3% of its health every second after 8 seconds without being hurt',
+		target: 'passive',
+		effects: [{ type: 'mend', perSecond: 0.03, unhurtFor: 8 }]
+	}
+]
+
+/** What the items do that the effects of the engine do not cover */
+export const itemEffects: EffectKind[] = [
+	/** Kept up all the time: a part of its health back every second, once `delay` seconds have passed without being hurt */
+	defineEffect('mend', ({ world, caster, interval = 0 }, effect) => {
+		if (world.time - caster.hurtAt >= effect.unhurtFor) world.heal(caster, caster.maxHp * effect.perSecond * interval)
+	})
+]
+
+/** Shops never run out of what is built to last. What is used up comes a few at a time */
+const few = (max: number, restock: number) => ({ max, restock })
+
+export const items: ItemDef[] = [
+	// ---- used up
+	{
+		id: 'healingPotion',
+		name: 'Health Potion',
+		description: 'Restores 250 health when drunk',
+		tier: 'consumable',
+		cost: { gold: 150 },
+		charges: 1,
+		ability: 'drinkHealing',
+		stock: few(3, 60)
+	},
+	{
+		id: 'manaPotion',
+		name: 'Mana Potion',
+		description: 'Restores 150 mana when drunk',
+		tier: 'consumable',
+		cost: { gold: 200 },
+		charges: 1,
+		ability: 'drinkMana',
+		stock: few(2, 60)
+	},
+	{
+		id: 'scrollOfHealing',
+		name: 'Scroll of Healing',
+		description: 'Heals friendly units around the reader for 150',
+		tier: 'consumable',
+		cost: { gold: 250 },
+		charges: 1,
+		ability: 'readHealing',
+		stock: few(1, 120)
+	},
+	{
+		id: 'revealingDust',
+		name: 'Revealing Dust',
+		description: 'Lifts the fog over an area anywhere on the map for 5 seconds. Enemies can see it happen',
+		tier: 'consumable',
+		cost: { gold: 50 },
+		charges: 2,
+		ability: 'revealArea',
+		stock: few(3, 45)
+	},
+	{
+		id: 'sentryWard',
+		name: 'Sentry Ward',
+		description: 'Puts down a ward that sees around it for 60 seconds. Enemies see it for 2 seconds, then only with an oracle. Goes down in 3 hits',
+		tier: 'consumable',
+		cost: { gold: 75 },
+		charges: 2,
+		ability: 'plantWard',
+		stock: few(2, 60)
+	},
+	{
+		id: 'oracle',
+		name: "Oracle's Eye",
+		description: 'Sends out a pulse that finds enemy wards around the hero, for 8 seconds. Every 25 seconds',
+		tier: 'consumable',
+		cost: { gold: 150 },
+		ability: 'sweep',
+		stock: few(1, 90)
+	},
+
+	// ---- to start with
+	{
+		id: 'squiresBlade',
+		name: "Squire's Blade",
+		description: '+10 attack damage, +80 health, and 2.5% of all damage dealt comes back as health',
+		tier: 'starter',
+		cost: { gold: 225 },
+		bonus: { stats: { attackDamage: 10, health: 80, omnivamp: 0.025 } }
+	},
+	{
+		id: 'squiresShield',
+		name: "Squire's Shield",
+		description: '+110 health, and 0.8 more health regained per second',
+		tier: 'starter',
+		cost: { gold: 225 },
+		bonus: { stats: { health: 110, healthRegen: 0.8 } }
+	},
+	{
+		id: 'squiresRing',
+		name: "Squire's Ring",
+		description: '+18 ability power, +90 health, and 1 more mana regained per second',
+		tier: 'starter',
+		cost: { gold: 200 },
+		bonus: { stats: { abilityPower: 18, health: 90, manaRegen: 1 } }
+	},
+
+	// ---- basic
+	{
+		id: 'longSword',
+		name: 'Long Sword',
+		description: '+10 attack damage',
+		tier: 'basic',
+		cost: { gold: 175 },
+		bonus: { stats: { attackDamage: 10 } }
+	},
+	{ id: 'dagger', name: 'Dagger', description: 'Attacks 10% faster', tier: 'basic', cost: { gold: 125 }, bonus: { percent: { attackSpeed: 0.1 } } },
+	{ id: 'clothArmor', name: 'Cloth Armor', description: '+15 armor', tier: 'basic', cost: { gold: 150 }, bonus: { stats: { armor: 15 } } },
+	{
+		id: 'wardingMantle',
+		name: 'Warding Mantle',
+		description: '+20 magic resist',
+		tier: 'basic',
+		cost: { gold: 200 },
+		bonus: { stats: { magicResist: 20 } }
+	},
+	{ id: 'bloodGem', name: 'Blood Gem', description: '+150 health', tier: 'basic', cost: { gold: 200 }, bonus: { stats: { health: 150 } } },
+	{
+		id: 'apprenticeTome',
+		name: "Apprentice's Tome",
+		description: '+20 ability power',
+		tier: 'basic',
+		cost: { gold: 200 },
+		bonus: { stats: { abilityPower: 20 } }
+	},
+	{
+		id: 'manaCharm',
+		name: 'Mana Charm',
+		description: 'Mana comes back 50% faster',
+		tier: 'basic',
+		cost: { gold: 100 },
+		bonus: { percent: { manaRegen: 0.5 } }
+	},
+	{ id: 'boots', name: 'Boots', description: '+25 move speed', tier: 'basic', cost: { gold: 150 }, bonus: { stats: { moveSpeed: 0.3125 } } },
+	{
+		id: 'duelistsCloak',
+		name: "Duelist's Cloak",
+		description: '15% chance to strike critically',
+		tier: 'basic',
+		cost: { gold: 300 },
+		bonus: { stats: { critChance: 0.15 } }
+	},
+	{ id: 'pickaxe', name: 'Pickaxe', description: '+25 attack damage', tier: 'basic', cost: { gold: 440 }, bonus: { stats: { attackDamage: 25 } } },
+	{
+		id: 'greatsword',
+		name: 'Greatsword',
+		description: '+40 attack damage',
+		tier: 'basic',
+		cost: { gold: 650 },
+		bonus: { stats: { attackDamage: 40 } }
+	},
+
+	// ---- built from the basic ones
+	{
+		id: 'leechingRod',
+		name: 'Leeching Rod',
+		description: '+15 attack damage, and 7% of the damage of attacks comes back as health',
+		tier: 'epic',
+		cost: { gold: 450 },
+		from: ['longSword'],
+		bonus: { stats: { attackDamage: 15, lifeSteal: 0.07 } }
+	},
+	{
+		id: 'jaggedKnife',
+		name: 'Jagged Knife',
+		description: '+20 attack damage, ignores 10 armor',
+		tier: 'epic',
+		cost: { gold: 500 },
+		from: ['longSword', 'longSword'],
+		bonus: { stats: { attackDamage: 20, lethality: 10 } }
+	},
+	{
+		id: 'hexCodex',
+		name: 'Hex Codex',
+		description: '+25 ability power, 10 ability haste',
+		tier: 'epic',
+		cost: { gold: 425 },
+		from: ['apprenticeTome'],
+		bonus: { stats: { abilityPower: 25, abilityHaste: 10 } }
+	},
+	{
+		id: 'piercingJewel',
+		name: 'Piercing Jewel',
+		description: '+25 ability power, ignores 13% of magic resist',
+		tier: 'epic',
+		cost: { gold: 550 },
+		from: ['apprenticeTome'],
+		bonus: { stats: { abilityPower: 25, magicPenetrationPercent: 0.13 } }
+	},
+	{
+		id: 'mendersIdol',
+		name: "Mender's Idol",
+		description: 'Heals and shields are 8% stronger, mana comes back 50% faster',
+		tier: 'epic',
+		cost: { gold: 300 },
+		from: ['manaCharm'],
+		bonus: { stats: { healShieldPower: 0.08 }, percent: { manaRegen: 0.5 } }
+	},
+	{
+		id: 'ogreBelt',
+		name: 'Ogre Belt',
+		description: '+350 health',
+		tier: 'epic',
+		cost: { gold: 450 },
+		from: ['bloodGem'],
+		bonus: { stats: { health: 350 } }
+	},
+	{
+		id: 'stoneBracer',
+		name: 'Stone Bracer',
+		description: '+200 health, and health comes back twice as fast',
+		tier: 'epic',
+		cost: { gold: 400 },
+		from: ['bloodGem'],
+		bonus: { stats: { health: 200 }, percent: { healthRegen: 1 } }
+	},
+	{
+		id: 'chainVest',
+		name: 'Chain Vest',
+		description: '+40 armor',
+		tier: 'epic',
+		cost: { gold: 400 },
+		from: ['clothArmor'],
+		bonus: { stats: { armor: 40 } }
+	},
+	{
+		id: 'swiftGreaves',
+		name: 'Swift Greaves',
+		description: '+45 move speed, attacks 30% faster',
+		tier: 'epic',
+		cost: { gold: 550 },
+		from: ['boots', 'dagger', 'dagger'],
+		bonus: { stats: { moveSpeed: 0.5625 }, percent: { attackSpeed: 0.3 } }
+	},
+	{
+		id: 'steadfastTreads',
+		name: 'Steadfast Treads',
+		description: '+45 move speed, +20 magic resist, stuns and slows last 30% shorter',
+		tier: 'epic',
+		cost: { gold: 625 },
+		from: ['boots', 'wardingMantle'],
+		bonus: { stats: { moveSpeed: 0.5625, magicResist: 20, tenacity: 0.3 } }
+	},
+
+	// ---- what it all leads to
+	{
+		id: 'keenEdge',
+		name: 'Keen Edge',
+		description: '+75 attack damage, 25% chance to strike critically, and critical strikes deal 30% more',
+		tier: 'legendary',
+		cost: { gold: 1750 },
+		from: ['greatsword', 'pickaxe', 'duelistsCloak'],
+		bonus: { stats: { attackDamage: 75, critChance: 0.25, critDamage: 0.3 } }
+	},
+	{
+		id: 'mendingPlate',
+		name: 'Mending Plate',
+		description: '+1000 health, health comes back twice as fast. After 8 seconds without being hurt, 3% of its health comes back every second',
+		tier: 'legendary',
+		cost: { gold: 1550 },
+		from: ['ogreBelt', 'ogreBelt', 'stoneBracer'],
+		bonus: { stats: { health: 1000 }, percent: { healthRegen: 1 } },
+		passive: 'mendingHeart'
+	},
+	{
+		id: 'reprieve',
+		name: 'Reprieve',
+		description:
+			'+30 ability power, 15 ability haste, heals and shields are 10% stronger, mana comes back twice as fast. Used: a beam on a spot far away heals friends there for 150 to 350 after 2.5 seconds. Every 90 seconds',
+		tier: 'legendary',
+		cost: { gold: 1150 },
+		from: ['hexCodex', 'mendersIdol'],
+		bonus: { stats: { abilityPower: 30, abilityHaste: 15, healShieldPower: 0.1 }, percent: { manaRegen: 1 } },
+		ability: 'intervention'
+	}
+]
+
+/** Everything there is to buy, the way a shop lays it out */
+export const catalogue = items.map((item) => item.id)

package/starters/melee/src/melee/languages/he.json

@@ -0,0 +1,96 @@
+{
+	"dir": "rtl",
+	"messages": {
+		"notEnough": "אין מספיק {resource, resource}",
+		"supplyBlocked": "אין מספיק מזון, בנו עוד חוות",
+		"race.undead.supplyBlocked": "אין מספיק מזון, בנו עוד צריחי עצם",
+		"queueFull": "התור מלא",
+		"requires": "נדרש: {units, unit}",
+		"researchDone": "המחקר הושלם: {upgrade, upgrade}",
+		"heroLevel": "{unit, unit} עלה לרמה {level}",
+		"defeated": "הובסת",
+		"cannotBuildThere": "אי אפשר לבנות שם",
+		"notEnoughMana": "אין מספיק מאנה",
+		"notReady": "עוד לא מוכן",
+		"gatherHint": "איסוף: לחצו על מכרה זהב או על עץ",
+		"night": "לילה: היחידות רואות פחות רחוק, והיצורים ישנים עד שתוקפים אותם",
+		"day": "יום",
+		"objectiveNew": "משימה חדשה: {text}",
+		"objectiveDone": "המשימה הושלמה: {text}",
+		"moveHint": "תנועה: לחצו על יעד",
+		"attackHint": "התקפה: לחצו על אויב, או על הקרקע כדי לנוע ולתקוף",
+		"placeHint": "הצבת {unit, unit}: לחצו כדי לבנות, Esc לביטול",
+		"card.move": "תנועה",
+		"card.stop": "עצירה",
+		"card.hold": "החזקה",
+		"card.attack": "התקפה",
+		"card.patrol": "סיור",
+		"card.harvest": "איסוף",
+		"card.build-menu": "בנייה",
+		"card.cancel": "ביטול",
+		"card.rally": "נקודת כינוס",
+		"card.build.about": "בניית {unit, unit}",
+		"card.train.about": "אימון {unit, unit}",
+		"card.skills-menu": "כישורים ({points})",
+		"groups.members": "{count, plural, one {{unit, unit}} two {שני {unit, unit}} other {# {unit, unit}}}",
+		"hud.idle": "ממתין",
+		"hud.fighting": "תוקף",
+		"hud.sleeping": "ישן",
+		"hud.underConstruction": "בבנייה",
+		"hud.training": "מאמן {item}",
+		"hud.researching": "חוקר {item}",
+		"hud.gathering": "אוסף {resource}",
+		"hud.returning": "מחזיר {resource}",
+		"hud.orders.move": "נע",
+		"hud.orders.attack": "תוקף",
+		"hud.orders.patrol": "מסייר",
+		"hud.orders.hold": "מחזיק עמדה",
+		"hud.orders.harvest": "אוסף",
+		"hud.orders.build": "בונה",
+		"ui.back": "חזרה",
+		"ui.close": "סגירה",
+		"ui.menu.title": "תפריט",
+		"ui.menu.resume": "המשך",
+		"ui.menu.settings": "הגדרות",
+		"ui.menu.keys": "מקשים",
+		"ui.menu.saves": "שמירה וטעינה",
+		"ui.menu.score": "ניקוד",
+		"ui.menu.restart": "התחלה מחדש",
+		"ui.menu.surrender": "כניעה",
+		"ui.menu.waits": "המשחק ממתין",
+		"ui.settings.reset": "החזרת הכול לברירת המחדל",
+		"setting.section.game": "משחק",
+		"setting.section.view": "תצוגה",
+		"setting.section.sound": "קול",
+		"setting.section.interface": "ממשק",
+		"setting.language": "שפה",
+		"setting.language.hint": "השפה שבה המשחק מדבר",
+		"setting.blood": "דם",
+		"setting.masterVolume": "עוצמת קול",
+		"setting.musicVolume": "מוזיקה",
+		"setting.hints": "רמזים"
+	},
+	"names": {
+		"unit.peasant": "איכר",
+		"unit.footman": "רגלי",
+		"unit.rifleman": "רובאי",
+		"unit.catapult": "בליסטרה",
+		"unit.gryphon": "רוכב גריפון",
+		"unit.priest": "כוהן",
+		"unit.sorceress": "מכשפה",
+		"unit.paladin": "פלדין",
+		"unit.archmage": "ארכי־קוסם",
+		"unit.townhall": "בית העירייה",
+		"unit.keep": "מבצר",
+		"unit.castle": "טירה",
+		"unit.farm": "חווה",
+		"unit.barracks": "מגורי חיילים",
+		"unit.tower": "מגדל שמירה",
+		"unit.blacksmith": "נפח",
+		"unit.lumbermill": "מנסרה",
+		"unit.goldmine": "מכרה זהב",
+		"unit.tree": "עץ",
+		"resource.gold": "זהב",
+		"resource.lumber": "עץ"
+	}
+}

package/starters/melee/src/melee/looks.json

@@ -0,0 +1 @@
+{}

package/starters/melee/src/melee/maps.ts

@@ -0,0 +1,53 @@
+import { presetTiles, type GameMap, type MapEditorDef, type MapPlayer, type MapProblem, type TileDef, type Vec2 } from '@v12-engine/engine'
+
+/**
+ * What the ground of a melee map can be painted with: the engine's tiles of an RTS (grass, dark grass, dirt, road,
+ * sand, rock, snow), drawn with the client's `TILE_LOOKS`. In this order, the order maps of format 1 had them in
+ */
+export const tiles: TileDef[] = [...presetTiles]
+
+/** A place at a map: a player with a town hall, and where that stands */
+export interface Seat {
+	player: MapPlayer
+	base: Vec2
+}
+
+/** What a hall is, of either race, at whatever stage it has been built up to */
+export const HALLS = new Set(['townhall', 'keep', 'castle', 'gravehold', 'hallOfBones', 'duskCitadel'])
+
+/**
+ * The players of a map who have a town hall on it, in the order of the map. One that was put down for them counts,
+ * and so does a start location for a player with nothing on the map yet: that is who the game builds a base for
+ */
+export function seatsOf(map: GameMap): Seat[] {
+	const seats: Seat[] = []
+	for (const player of map.players) {
+		const own = map.objects.filter((object) => object.owner === player.id)
+		const hall = own.find((object) => HALLS.has(object.type))
+		const base = hall ? { x: hall.x, z: hall.z } : own.length === 0 ? player.start : undefined
+		if (base) seats.push({ player, base })
+	}
+	return seats
+}
+
+/**
+ * What a melee map needs: someone with a town hall to play, which is an error without, and someone on another
+ * team with one to play against, which is a warning without
+ */
+export function checkMeleeMap(map: GameMap): MapProblem[] {
+	const seats = seatsOf(map)
+	if (!seats.length) {
+		return [{ message: `"${map.name}" has no town hall for anyone: give a player a start location, or put a town hall down for one`, error: true }]
+	}
+	if (!seats.some((seat) => seat.player.team !== seats[0].player.team)) {
+		return [{ message: `"${map.name}" has no second team with a town hall: there is nobody to play against here`, at: seats[0].base }]
+	}
+	return []
+}
+
+/** What melee brings to the map editor */
+export const meleeEditor: MapEditorDef = {
+	check: checkMeleeMap,
+	playersNote:
+		'The first player is you, the others are played by the computer. Whoever has a start but nothing on the map gets a town hall and five workers.'
+}

package/starters/melee/src/melee/pings.json

@@ -0,0 +1,16 @@
+{
+	"order": [
+		"look",
+		"danger",
+		"assist",
+		"onMyWay",
+		"missing",
+		"retreat"
+	],
+	"wheel": {
+		"slots": 6,
+		"radius": 92,
+		"itemSize": 46,
+		"labels": "always"
+	}
+}

package/starters/melee/src/melee/pings.ts

@@ -0,0 +1,34 @@
+import { defineGameFile, type Registry } from '@v12-engine/engine'
+import pingsData from './pings.json'
+
+/**
+ * The pings on melee's wheel (Ctrl and the left button), as a hero arena game has them: look, danger, need help, on
+ * my way, enemy missing, fall back. A ring of six, in this order round from the top (`pings.json` says six slots)
+ */
+export const WHEEL_PINGS = ['look', 'danger', 'assist', 'onMyWay', 'missing', 'retreat'] as const
+
+/**
+ * The pings melee has besides the wheel's: sent from code and heard by a computer ally (push attacks, hold defends:
+ * `GameRules.talk.pings.meanings`), off the wheel (`wheel: { hidden: true }` in the view)
+ */
+export const OFF_WHEEL_PINGS = ['hold', 'push', 'question'] as const
+
+/**
+ * The kinds of ping melee has, kept in one place: what the view draws and puts on the wheel (`playerPings:
+ * withPingsFile(presetPings(PINGS), pings.json)`)
+ */
+export const PINGS = [...WHEEL_PINGS, ...OFF_WHEEL_PINGS] as const
+
+/**
+ * The kinds the editor's Pings fold added in `pings.json`, its keys: a file of the game's own (`GameModule.files`), read
+ * without the client (the module runs where the simulation runs), and read again as the fold writes it
+ */
+export const pingsFile = defineGameFile('pings.json', pingsData, (data) =>
+	Object.keys((data as { kinds?: Record<string, unknown> } | null)?.kinds ?? {})
+)
+
+/**
+ * What the rules let go (`rules.talk.pings.kinds`): the kinds above and those of `pings.json` as the game plays it, so a
+ * kind added in the editor's Pings fold is let go at once
+ */
+export const PING_KINDS = (registry: Registry): string[] => [...new Set([...PINGS, ...registry.file(pingsFile)])]

package/starters/melee/src/melee/quality.json

@@ -0,0 +1 @@
+{}

package/starters/melee/src/melee/saves.ts

@@ -0,0 +1,12 @@
+import type { SaveRules } from '@v12-engine/engine'
+
+/*
+ * How melee's saves outlive its patches (`GameModule.saves`): the version of what it keeps in a save, and the step
+ * from each version to the next, for a save made before a patch that changed what a save holds. Declared, a save made
+ * before a change of the rules loads all the same (without it, only a save of the very same rules does).
+ */
+
+export const meleeSaves: SaveRules = {
+	version: 1,
+	migrate: {}
+}

package/starters/melee/src/melee/sounds.json

@@ -0,0 +1 @@
+{}