Návod

Zdrojový kód tower defense: vlny, věže a vyvážení v TypeScriptu

Barricade Z drží svých 30 vln, 12 úrovní věží a ekonomiku ve třech datových souborech. Co to znamená pro kupujícího.

Grafika Barricade Z: kreslený zombie přeskakuje dřevěnou barikádu za soumraku, zatímco žlutá věž pálí na hordu za ním.

Ve zdrojovém kódu tower defense žije herní design v datech: jak silná je každá věž, co která vlna posílá, jak rychle přicházejí mince. Pokud jsou tato data rozptýlena po kódu vykreslování, přeladění jediné vlny znamená číst celý projekt. Barricade Z, naše merge tower defense šablona, drží věže, vlny a vyvážení ve třech souborech v TypeScriptu, a tento průvodce ukazuje, kde jsou a jak je měnit bezpečně.

V tomto balíčku existují dvě úrovně změn. Pro titulek stránky a název uložení stačí textový editor. Všechno ostatní, od věží po zombie vlny, prochází zdrojovým kódem v TypeScriptu a novým sestavením. Když víte, která změna je která, před koupí se vyhnete překvapení.

Každý název souboru níže pochází z ilustrovaného průvodce kupujícího, který je součástí hry a je k dispozici ve stejných 14 jazycích jako rozhraní.

Co obsahuje tento zdrojový kód tower defense

Barricade Z je obranná hra se slučováním. Hráči vyrábějí věže v zásobníku (reserve), přetahují dvě stejné úrovně k sobě, aby vznikla další, až do úrovně 12, a nejsilnější přesouvají na pět pozic barikád. Kampaň o 30 vlnách probíhá třemi prostředími s bossy ve vlnách 10, 20 a 30. Granáty se odemknou ve vlně 3 a Overdrive ve vlně 7, a Workshop prodává vylepšení. Denní výzvy a Endless mode (nekonečný režim) se otevírají s postupem hráče.

  • game/: hratelné sestavení připravené k nahrání, s Phaser 3.90 v lib/phaser.js a písmy Bungee a Barlow Condensed.
  • game/barricade-z.config.js: dvě nastavení, která lze změnit bez nového sestavení.
  • source/: čitelný projekt v TypeScriptu, pouze pro vývojáře.
  • documentation/index.html a DOCUMENTATION.html v kořeni: průvodce kupujícího, který se otevře i offline.
  • THIRD-PARTY-LICENSES/: oznámení pro engine a písma.

Rozhraní je k dispozici ve 14 jazycích, s rozloženími na výšku i na šířku pro dotyk i myš. Hlasatel je nahraný jen v angličtině a nastavení jazyka mění text rozhraní, ne hlas.

Podívejte se na Barricade Z: demo, průvodce a cenu

Tři soubory, které drží herní design

Nejdřív otevřete source/src/data/. Tyto tři soubory jsou důvod, proč vůbec kupovat edici se zdrojovým kódem, protože tady se tower defense hra skutečně navrhuje.

  • towers.ts: 12 úrovní věží, jejich atributy zbraní a data ústí hlavně.
  • waves.ts: 30 vln kampaně a místa, kde se objevují bossové.
  • balance.ts: vyladění ekonomiky, zdraví, poškození a postupu.

Kolem nich source/src/i18n/ drží slovníky pro 14 jazyků, source/src/ui/ obsahuje menu, HUD, panel nástrojů, panely a tutoriál a source/src/audio/ řídí směrování zvuku a hlasatele. Sestavený kód v game/assets/ má hashované názvy souborů; neupravujte je ručně, raději sestavte znovu.

Co lze změnit textovým editorem

Otevřete game/barricade-z.config.js, změňte hodnotu, uložte a znovu načtěte stránku. Nové sestavení není potřeba. Jsou tu jen dvě nastavení.

  • title: titulek záložky prohlížeče. Nenahrazuje ilustrované logo.
  • storagePrefix: jmenný prostor pro uložená data. Změna spustí samostatné uložení a staré klíče zůstanou na místě. Používejte jen písmena, čísla, tečky, podtržítka a pomlčky, až 64 znaků.

storagePrefix je užitečnější, než se zdá. Dvě kopie hry na stejné doméně sdílejí uložení, i kdyby byly v různých podsložkách. Pokud agentura hostuje jednu kopii pro každého klienta na jedné doméně, dejte každé kopii vlastní prefix, aby se postup hráčů nepomíchal.

Cokoli nad tyto dvě hodnoty, včetně loga, ikon, grafiky, pravidel, věží, vln a textu, vyžaduje edici se zdrojovým kódem a nové sestavení.

Sestavení po skutečné změně

Složka game/ už obsahuje hratelné sestavení, takže hostování nevyžaduje Node.js. Instalujete ho jen tehdy, když měníte samotnou hru.

  1. Nainstalujte Node.js 20.19 nebo novější.
  2. Uvnitř source/ spusťte npm ci. Otestované verze nástrojů jsou připnuté v package-lock.json.
  3. Proveďte změnu, poté spusťte npm run typecheck a npm test.
  4. Spusťte npm run build. Výstup půjde do source/dist/.
  5. Nahrajte obsah source/dist/ tak, aby nahradil hostovanou hru, stejně jako u game/.

Tři volitelné příkazy pomáhají: npm run dev spustí lokální vývojový server, npm run preview servíruje sestavení ke kontrole a npm run balance spustí z příkazové řádky simulaci celé kampaně, což se hodí po zásahu do balance.ts.

Co kupující obvykle mění jako první

  1. Titulek záložky a prefix uložení v konfiguračním souboru, aby byla kopie vaše už od prvního nahrání.
  2. Logo a grafiku ve zdrojovém kódu. Při výměně vizuálů držte původní proporce, jak žádá průvodce.
  3. Text rozhraní ve slovnících i18n, ve všech jazycích, která plánujete dodat.
  4. Obtížnost: složení vln v waves.ts, poté tok mincí v balance.ts.
  5. Věže nakonec, v towers.ts, protože každá vlna byla vyladěna podle nich.

Pokud prodáváte nebo provozujete několik merge her, stejná myšlenka zásobníku a slučování se objevuje ve dvou dalších našich šablonách, každá s vlastním tématem a pravidly.

Deepforge: slučování krumpáčů a jejich vysílání do dolu řízeného fyzikou

Plop: fyzikální puzzle se slučováním ovoce s 11 úrovněmi

Hosting, aktualizace a uložení

Nahrajte jen obsah složky game/ do prázdné složky, například public_html/moje-hra/, a otevřete adresu v aktuálním Chrome, Edge, Firefoxu nebo Safari. Není potřeba npm, PHP, databáze ani účet, a doporučuje se HTTPS. Dvojklik na index.html na počítači nefunguje. Váš hosting musí servírovat .js jako JavaScript, .css jako CSS a písma i .mp3 s jejich obvyklými typy, a názvy souborů jsou na mnoha hostingech citlivé na velikost písmen.

Uložená data žijí v prohlížeči hráče pod názvy barricadez.save (kampaň a kontrolní bod) a barricadez.settings (jazyk, zvuk, tutoriál, odemčené položky, rekordy), s výchozím prefixem. Není tu účet ani cloudová synchronizace. Po znovunačtení se aktuální vlna spustí znovu od svého kontrolního bodu.

  • Aktualizace: zálohujte game/ a upravený konfigurační soubor, nahrajte nový game/ přes starý, ponechte storagePrefix beze změny a stránku znovu načtěte.
  • Pokud se ukazuje stará verze, vymažte mezipaměť obrázků a souborů nebo stiskněte Ctrl+F5. Nemažte data webu: smažou se tím uložené hry.
  • Hra obsahuje manifest.webmanifest, ale průvodce jasně říká, že nejde o aplikaci pro instalaci a offline použití.

Projekty nativních aplikací nejsou zahrnuty. Pokud chcete hru v obchodě s aplikacemi, obal a výpis v obchodě jsou samostatná práce, kterou můžeme nabídnout.

Co není zahrnuto a licence

Edice nemá reklamní SDK, analytiku, platebního poskytovatele, online multiplayer, vzdálený žebříček ani cloudová uložení, a nezahrnuje nativní aplikace, hosting ani zakázkový vývoj. Přidání čehokoli z toho je vývojářská práce s vašimi vlastními účty.

Barricade Z stojí 39 USD za katalogovou cenu, nebo 33,15 USD během akce Black Friday, která trvá do 30. listopadu 2026; dvě nebo více šablon v jedné objednávce také získají slevu za balíček 5 % až 20 %. Licence je trvalá a nevýhradní, pro jeden koncový produkt, váš nebo jednoho vašeho klienta. Kód, grafiku a zvuk můžete měnit, nahradit naši značku vaší a hru nabízet zdarma nebo s reklamami. Samotnou šablonu ani její kód nelze dál prodávat. Šest měsíců podpory je v ceně, nebo dvanáct s rozšířením; nové funkce a integrace nejprve nabízíme podle nabídky.

Přečtěte si podmínky tržiště

Často kladené otázky

Který engine používá zdrojový kód tower defense?

Phaser 3.90 s TypeScriptem. Engine je přibalený v game/lib/phaser.js pod licencí MIT, takže se nic nenačítá z CDN.

Mohu měnit vlny a věže bez Node.js?

Ne. Konfigurační soubor nastavuje jen titulek záložky a prefix uložení. Vlny, věže a vyvážení jsou ve zdrojovém kódu a vyžadují Node.js 20.19 nebo novější a nové sestavení.

Je hlasatel přeložen?

Ne. Těchto 14 jazyků pokrývá rozhraní. Nahrávky hlasatele jsou v angličtině a ostatní jazyky nemají vyprávění.

Funguje to na telefonech?

Ano. Rozložení na výšku i na šířku funguje s dotykem i myší. Výkon závisí na zařízení, takže otestujte na telefonech, které používá vaše publikum.

Mohou dvě kopie na jedné doméně mít oddělená uložení?

Ano, pokud každá kopie má vlastní storagePrefix v barricade-z.config.js. Samotná jiná podsložka je neoddělí.

Komu se koupě hodí

Barricade Z se hodí portálu, který chce hotovou hru o obraně proti zombie, freelancerovi nebo studiu připravujícímu značkovou hru pro jednoho klienta a vývojáři, který chce číst, jak TypeScriptová a Phaserová tower defense drží design v datech. Pokud ji potřebujete jen hostovat pod svým jménem, konfigurační soubor a logo pokryjí většinu práce. Pokud plánujete novou kampaň, tři datové soubory a npm run balance jsou místo, kde strávíte nejvíc času.

Vyzkoušejte demo Barricade Z a koupte licenci

Vlastní vlny, reskin nebo objednávka pro agenturu? Vyžádejte si nabídku