Customization Guide
Make Seam Street your own game: your own numbers, fashion pieces, sewing stations, collections, texts, music, logo and colors. Every part below is a short list of steps and says exactly which file to open. You do not need to know how to program: you change numbers, texts between quotes and picture files. All pictures on this page are real screenshots of the game in this package.
1. Before you start
Free tools you need:
- A code text editor: Visual Studio Code (Windows, Mac, Linux) or Notepad++ (Windows). Do not use Word or WordPad: they break the files.
- An image editor: Photopea (in the browser), GIMP or Krita. Pieces, stations, customers and interface pictures are PNG with a transparent background; sceneries are JPG.
-
To see the game on your computer, a browser and one of these: the local server included in
source/(npm run serve, needs Node.js, see the main guide), or any local web server you already use (for example XAMPP, WAMP or MAMP). Openingindex.htmlwith a double click does not work: browsers block the game files when the page comes from the disk.
game/ folder (or source/) to a
safe place before you change anything. If something breaks, put the backup back.
Which folder do I edit? The simplest way: edit the files inside game/ and upload
that folder. If you also use the developer tools, edit source/ instead and run
npm run build, which copies everything to source/dist/ (the same as
game/). Both folders have the same file names, so every step below works in either one.
Starting a new game while you test: the game saves progress in the browser. Open the pause menu
and choose Start over to see a change from the first minute. On your own computer (address
localhost) you can also open a collection directly with ?debug&bairro=1 at the end
of the address (0 is the first collection); this shortcut does nothing on a public website.
2. Where everything is
Each number on the screenshot matches a line of the table under it, with the exact file to change. Interface
texts are in src/locales.js (English and Portuguese) and in src/locales/ (one file for
each of the other 12 languages); the table gives the key of each text. <line> is one of the 7
fashion lines. Their internal names were kept from the engine and do not match what the player sees:
grill = Hats, steam = Dresses, tea = Handbags, sweet =
Shoes, sea = Summer Wear, noodle = Autumn Knits and warm = Winter Coats.
A station uses the same 7 names. <id> is a collection: market = Boutique Avenue
(its pictures are in assets/ui/), porto = Riviera Promenade, lotus =
Maple Avenue and neve = Winter Gala. In the same way, flame.png is the spool of
thread, lid.png the closed hatbox, dish.png the shopping bag of a delivery,
btn-lantern.png the mannequin button, planter-on.png and
planter-off.png the dressed and bare mannequins, lamp2-on.png the hangers of the
panels and barraca-*.png the boutique front of wide screens; in src/config.js,
STEPS and STEP_COST are the mannequins of a place and NIGHT_REWARD the
prize of each year.
Title screen
1
2
3
| # | What you see | File to change |
|---|---|---|
| 1 | Logo | assets/ui/logo.png, 900×388 pixels, transparent background (step G). |
| 2 | Play button |
Text: key ui.play (step E). Button picture: assets/ui/btn-gold-l.png,
btn-gold-m.png and btn-gold-r.png (step H).
|
| 3 | Title background |
assets/ui/splash-land.jpg on wide screens (1672×941) and
assets/ui/splash.jpg on phones held upright (941×1672), step G.
|
The counter
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| # | What you see | File to change |
|---|---|---|
| 1 | Level |
Star: assets/ui/star.png. The bar fills with the stars of the mannequins:
STEP_STARS and STARS_PER_LEVEL in src/config.js (step A).
|
| 2 | Spools of thread (energy) |
Icon: assets/ui/flame.png (the spool keeps the internal name). Size of the basket and
speed: ENERGY in src/config.js (step A).
|
| 3 | Coins | Icon: assets/ui/coin.png. |
| 4 | Customer |
assets/ui/who-1.png to who-6.png in the first collection; the same names
inside assets/bairros/<id>/ in the others (step C).
|
| 5 | Order and its pay |
What customers ask for and how much they pay: ORDERS in src/config.js (step
A). Pictures on wide screens: assets/ui/barraca-balao.png and
barraca-fita.png; on phones: assets/ui/tag.png.
|
| 6 | Ready button | assets/ui/btn-check.png. It appears when the pieces of the order are on the counter. |
| 7 | Boutique front around the customers |
Wide screens only (internal names kept): assets/ui/barraca-fundo.png,
barraca-prateleira.png, barraca-placa.png,
barraca-placa-p.png and barraca-corda.png.
|
| 8 | Counter squares |
assets/ui/tile-l.png (wide screens) and assets/ui/tile-p.png (phones); frame:
assets/ui/frame.png. The tint of each collection is in style-more.css (step
H).
|
| 9 | Sewing station |
assets/items/gen-<line>-1.png to -5.png, one picture per station level
(step B). Name: key gen.<line>.
|
| 10 | Fashion piece |
assets/items/<line>-1.png to -8.png (step B). Names: the list
item.<line>.
|
| 11 | Hatbox with a number |
assets/ui/lid.png (the closed hatbox keeps the internal name). The level that opens each
square is the list UNLOCK in src/config.js.
|
| 12 | Name of the selected piece |
Texts: item.<line>, ui.lv, ui.next (step E). Panel picture:
assets/ui/panel-plain.png.
|
| 13 | Sell button |
assets/ui/btn-orange.png (it turns into Deliver with btn-green.png). Text:
ui.sell. Price: SELL in src/config.js.
|
| 14 | Lookbook button |
assets/ui/icon-9.png. Reward of a complete page: BOOK_REWARD in
src/config.js.
|
| 15 | Shelf |
assets/ui/shelf-land.png (wide screens), shelf-port.png and
slot-port.png (phones).
|
| 16 | Gift box | assets/ui/btn-gift.png; the red dot is dot.png. |
| 17 | Street button (mannequin) | assets/ui/btn-lantern.png (internal name kept). |
| 18 | Pause button | assets/ui/btn-pause.png. |
| 19 | Scenery behind the counter |
scene-land.jpg (wide screens, 1672×941) and scene.jpg (phones, 1914×822), in
assets/ui/ for the first collection and in assets/bairros/<id>/ for the
others (step C).
|
The street
1
2
3
4
5
6
7
8
9
| # | What you see | File to change |
|---|---|---|
| 1 | Collection name | Text: key bairro.<id> (steps D and E). |
| 2 | Map of the collections |
Drawn by the code from the list DISTRICTS: one medallion per collection,
assets/ui/season-1.png to season-4.png; padlock:
assets/ui/lock.png.
|
| 3 | Picture of the place |
area-1.png, area-2.png, area-3.png (533×534) of the collection
(step C).
|
| 4 | Name of the place |
Text: key area.<place>; the three places of a collection are listed in
DISTRICTS.
|
| 5 | Mannequins |
assets/ui/planter-on.png (dressed) and planter-off.png (bare), internal names
kept. There are 6 per place (STEPS).
|
| 6 | Price of the next mannequin | STEP_COST and DISTRICT_COST in src/config.js (step A). |
| 7 | Locked place |
assets/ui/plate-lock.png and lock.png. In the first collection the places open
at the levels of AREAS; in the others, one after the other.
|
| 8 | Back to the atelier | Text: key ui.kitchen. |
| 9 | Street background |
street-dark.jpg (empty shop windows) and street.jpg (dressed), both 941×1672,
on phones; on wide screens scene-land-dark.jpg and scene-land.jpg (1672×941),
step C.
|
A card (new level)
1
2
3
4
5
6
| # | What you see | File to change |
|---|---|---|
| 1 | Medal | assets/ui/medal.png. |
| 2 | Title of the card |
Texts: ui.levelUp and ui.levelUpSub. Plate picture:
assets/ui/plate.png.
|
| 3 | Hanger with a dress | assets/ui/lamp2-on.png (internal name kept). |
| 4 | Prizes of the level |
assets/ui/prize-flame.png (spools), steamer-open.png (open hatbox: more
counter) and prize-gift.png.
|
| 5 | Button of the card | Text: key ui.ok. Picture: the three btn-gold-*.png files. |
| 6 | Card |
assets/ui/panel-plain.png, the border greca.png, the fireworks
fogos-1.png and fogos-2.png.
|
3. More screens of the game
GEN_DROPS in
src/config.js).
area-1.png) and its new station.
NIGHT_REWARD) and the next year.
street.jpg upright).
4. Step A: change the numbers of the game
Every number is in one file, src/config.js. Open it in the code editor, change
only the number, keep the commas and save. Each line has a short comment (in Portuguese) next to it.
| What | Name in src/config.js |
As shipped |
|---|---|---|
| Size of the basket of spools | ENERGY.max |
100 |
| Time to get 1 spool back | ENERGY.regenMs (thousandths of a second) |
2000 = 2 seconds |
| Spools given back by a delivery | ENERGY.refund (part of the cost of the order) |
0.5 |
| Price of the mannequins |
STEP_COST: the first number is the price of the first mannequin, the second makes each next
one dearer
|
40 and 10 (40, 50, 75, 112 … coins) |
| How much dearer each collection is | DISTRICT_COST |
0.35 (35% more per collection) |
| Stars per mannequin, stars per level | STEP_STARS, STARS_PER_LEVEL |
2 and 3 |
| Customers at the same time | ORDERS.slots (at levels 1, 2 and 3 or more) |
1, 2, 3 |
| Pieces in one order | ORDERS.maxItems (at levels 1, 2, 3 and 4 or more) |
1, 2, 2, 3 |
| Pay of an order | ORDERS.pay |
2 |
| Free change of an order | ORDERS.swapMs |
120000 = 2 minutes |
| Special customer |
ORDERS.vipChance (0 to 1), ORDERS.vipPay, ORDERS.vipFrom (level)
|
0.12, 3, 3 |
| Rush hour |
ORDERS.rushEvery (deliveries), ORDERS.rushMs, ORDERS.rushPay,
ORDERS.rushFrom (level)
|
12, 60000 = 60 seconds, 2, 3 |
| Prize of the year | NIGHT_REWARD (multiplied by the number of the year) |
500 |
| Prize of a page of the Lookbook | BOOK_REWARD |
80 |
| Level at which the Dress and Shoe stations arrive | at in GENS |
4 and 7 |
-
Texts that repeat a number. If you change
rushPay, also change the textui.rush("Rush hour! Double coins"). If you changevipPay, change the textsui.vipandtip.vip("pays triple") and the sealcontent: '×3'instyle-more.css(search for.who.vip::before). -
To switch something off:
vipChance: 0removes the special customer; a very largerushEvery(for example 999999) removes the rush hour. WithvipChance: 0the test of the source complains that the special customer never came (the line withvipsintest/sim.test.mjs); the game is not affected. -
The robot test. If you use
source/,npm testplays whole games with a robot and checks the pace of the game as shipped. When we tried these changes one at a time, the test still passed with a bigger basket (150), faster spools (1000), dearer mannequins (50 and 12), another prize of the year (900), another Lookbook prize, a shorter or more frequent rush hour and a special customer chance of 0.2. It failed, saying that level 5 came too early, with cheaper mannequins (20 and 5),pay: 3,vipPay: 5andrushPay: 3. That is the test doing its job: if you make the game faster on purpose, the game itself still works, and the limits to adjust are near the end oftest/sim.test.mjs(the lines with the minutes allowed to reach each level).
5. Step B: change the picture of a piece or a station
-
Pieces and stations are in
assets/items/. A piece is<line>-1.pngto<line>-8.png(for exampletea-1.png…tea-8.pngare the 8 handbags). A station isgen-<line>-1.pngtogen-<line>-5.png. - Draw your picture as a square PNG of 256×256 pixels with a transparent background, with the object filling most of the square. A bigger square also works (we tried 512×512: the game draws it in the same space), it only makes the download heavier.
- Save it with exactly the same name as the picture you replace and copy it over the old file.
-
Change the name of the piece in the list
item.<line>(8 names, in order) and the name of the station ingen.<line>, in every language you use (step E). The name of the fashion line on the Lookbook ischain.<line>.
6. Step C: change the scenery and the customers of a collection
The first collection (Boutique Avenue) keeps its pictures in assets/ui/. The others have one folder
each: assets/bairros/porto/ (Riviera Promenade), assets/bairros/lotus/ (Maple Avenue)
and assets/bairros/neve/ (Winter Gala). Every collection uses the same
14 file names:
| File | Size as shipped | Where it appears |
|---|---|---|
scene.jpg |
1914×822 | Scenery above the counter on phones held upright |
scene-land.jpg |
1672×941 | Scenery behind the counter on wide screens, and the street on wide screens once its mannequins are dressed |
scene-land-dark.jpg |
1672×941 | The same wide scenery with the shop windows still empty (the street on wide screens) |
street.jpg |
941×1672 | The street on phones with the shop windows dressed; also the picture of the collection on the win card |
street-dark.jpg |
941×1672 | The same street with the shop windows empty (the dressed one fades in over it) |
area-1.png, area-2.png, area-3.png |
533×534 |
The three places of the street; area-1.png is also the picture of the collection on its
new-collection card
|
who-1.png … who-6.png |
about 300×285, transparent background | The six customers, from the waist up |
- Prepare your pictures in the same sizes and proportions.
- Give them the same names and copy them over the old files of that collection.
-
street.jpgandstreet-dark.jpgmust be the same drawing, one with the shop windows dressed and one with them empty; the same forscene-land.jpgandscene-land-dark.jpg. -
The names of the collection and of its places are texts:
bairro.<id>andarea.<place>(step E).
7. Step D: add a collection
We tried these steps with a fifth collection called silk: the street, the map of the collections
and the win card showed the 5 collections on a phone and on a wide screen.
-
Choose a short name with no spaces or accents, for example
silk, and three names for its places, for examplelobby,salonandrunway. -
Open
src/config.js, findDISTRICTSand add a line at the end of the list, before the];:export const DISTRICTS = [ { id: 'market', areas: ['gate', 'alley', 'plaza'] }, { id: 'porto', areas: ['harbor', 'pier', 'lighthouse'] }, { id: 'lotus', areas: ['roundgate', 'bridge', 'pavilion'] }, { id: 'neve', areas: ['icegate', 'hotrow', 'icegarden'] }, { id: 'silk', areas: ['lobby', 'salon', 'runway'] }, ]; -
Create the folder
assets/bairros/silk/with the 14 pictures of step C. To start, copy the folder of another collection and replace the pictures one by one. - Add the music
assets/music/silk.mp3(step F). Without this file the collection is silent. -
Add its medallion for the map of the collections:
assets/ui/season-5.png(the four shipped ones areseason-1.pngtoseason-4.png; copyseason-4.pngto start). Without it the map shows an empty circle. -
Open
src/locales.jsand add the four texts to the English block, next to the otherbairro.lines, and to the Portuguese block (the test of the source checks that Portuguese has every English text; the other languages show the English text until you translate it):'bairro.silk': 'Silk Week', 'area.lobby': 'Silk Lobby', 'area.salon': 'Silk Salon', 'area.runway': 'Silk Runway', -
Optional, the color of the counter: in
style-more.css, copy the blockbody[data-bairro="porto"](the last one in the file with that name), changeportotosilkand choose the two colors. Without it the collection uses the color of the first one. -
Save, start the game and, on your computer, open
?debug&bairro=4to see the new collection (the count starts at 0).
GENS (dist: 1, 2, 3) and a new
fashion line needs a programmer (see What needs a programmer). Do not remove a collection
or change the order in a game that is already online: players' saves keep the number of the collection.
8. Step E: change texts and languages
-
English and Portuguese are in
src/locales.js(the blocksen:andpt:, and a few more lines added below them). Each of the other 12 languages has its own file insrc/locales/:es.js,fr.js,de.js,it.js,nl.js,pl.js,tr.js,ru.js,id.js,ja.js,ko.js,zh.js. -
Each line is
'key': 'text',. Change only the text between the quotes. Keep the key, the quotes and the comma. Keep words in braces such as{n}and{x}: the game puts a number or a name there. If your text has an apostrophe, write the text between double quotes, as in"Let's go!". -
Useful keys:
ui.play(title button),tut.0totut.8(the tutorial),tip.gift,tip.shelf,tip.swap,tip.book,tip.vip(tips),bairro.*andarea.*(collections and places),item.*(lists of 8 piece names),gen.*(stations),chain.*(fashion lines),ui.book(the Lookbook),ui.rush,ui.vip,ui.winandui.winSub(win card). - A key missing in a language shows the English text.
-
To add a language (tried with a 15th language): copy a file of
src/locales/, for examplees.jstoca.js, and translate it. Insrc/locales-more.jsadd the lineimport ca from './locales/ca.js';and addcato the list in the last line (export const MORE = { … zh, ca };). Insrc/locales.jsadd['ca', 'Català'],toLANGS. The language then appears in the pause menu and?lang=caworks. -
If you use
source/, runnpm test: it checks keys and braces in every language. After adding a language, change the number in the lineassert.equal(LANGS.length, 14);oftest/locales.test.mjsto the new count, or that test fails.
The bundled font has Latin letters only: Russian, Japanese, Korean and Chinese texts are drawn with a font of the player's device (step H).
9. Step F: replace or remove the music
-
There are 4 MP3 files in
assets/music/, one per collection, played in a loop:feira.mp3(Boutique Avenue, internal name kept),porto.mp3(Riviera Promenade),lotus.mp3(Maple Avenue) andneve.mp3(Winter Gala). - Replace: copy your MP3 over a file, keeping the name. A track that loops without a gap at its end sounds best. The shipped tracks have about the same loudness; a much louder file will sound louder than the effects.
- Remove: delete a file (or the four). The game stays silent in that collection and everything else works; the browser only notes the missing file in its console.
-
The music starts after the first touch (browsers require it) and players set its volume in the pause menu. The
volumes a new player starts with are
volume: 0.7, music: 0.4near the top ofsrc/game.js(0 to 1). -
Sound effects (pops, chimes, fanfares) are made by the code in
src/fx.js, so there are no effect files to replace. - Use only music you have the right to publish.
10. Step G: change the logo, the title screen and the icon
-
Logo: replace
assets/ui/logo.png(900×388 pixels, transparent background). It is shown on the title screen. -
Title background:
assets/ui/splash.jpg(phones held upright, 941×1672) andassets/ui/splash-land.jpg(wide screens, 1672×941). Leave room for the logo at the top and for the Play button. -
Name in the browser tab: open
index.htmland change the text inside<title>. The same file has the logo description inalt="Seam Street". -
Name of the installed web app:
nameandshort_nameinmanifest.webmanifest. -
Icons:
favicon.ico(browser tab),assets/icon-180.png(180×180),assets/icon-192.png(192×192) andassets/icon-512.png(512×512), square, without transparency. Replace them keeping the names. -
The stylist of the tutorial is
assets/ui/guide.png(268×300, transparent) and the pointing hand isassets/ui/hand.png.
11. Step H: change colors and the font
-
Main colors: the first lines of
style.css:--gold(gold details),--ink(light text) and--brown(text on the cream panels). -
Color of the counter in each collection: the blocks
body[data-bairro="porto"],"lotus"and"neve"instyle-more.css, with two colors each (--tAand--tB, the two squares of the checkerboard). When a name appears twice in the file, the last block is the one that counts. -
Color of the browser bar on phones:
theme-colorinindex.htmlandtheme_color/background_colorinmanifest.webmanifest. -
Buttons: the gold button is made of three pictures, the left end
(
btn-gold-l.png), the middle that stretches (btn-gold-m.png) and the right end (btn-gold-r.png). Keep the same height in the three. Panels usepanel-plain.pngand the number platespill.png. -
Sizes in the style sheets are written with
--u, the size of one pixel of the original drawing on the player's screen, so everything is scaled up and down together. -
Font: Fredoka, in
assets/fonts/(four.woff2files and the license), declared by the four@font-faceblocks at the top ofstyle.css. It has Latin and Latin Extended letters; Russian, Japanese, Korean and Chinese use a font of the device, listed after Fredoka in thefont-familyline ofbody. To use another font, add its.woff2files toassets/fonts/, change the file names in the@font-faceblocks and the nameFredokathere and inbody. Check that its license allows use in games and keep the license file with it.
12. What needs a programmer
These parts are built into the code and the layout. Changing only a number or a file is not enough:
-
A new fashion line or a new station. Besides
CHAINSandGENS, 13 pictures and the texts, the Lookbook tabs insrc/game.jsand the robot test need changes. -
The size of the counter (
COLS,ROWS,UNLOCK) and the number of shelf places (SHELF): the screens are drawn for 7×9 squares and 6 places. -
More or fewer than 3 places per collection or 6 mannequins per place (
AREAS,STEPS): the street is drawn for 3 cards of 6 mannequins. - More than 3 customers at the same time, or more than 6 customer pictures per collection.
-
More than 8 pieces per fashion line or 5 levels per station (
MAX_LV,GEN_MAX). - The steps of the tutorial (their texts can be changed, their order and what they point at cannot) and the sound effects, which are made by code.
- Ads, a store, accounts, cloud saves or a ranking: this edition has none of them.
For custom work, write to willian@polargames.com.br.
13. Check and publish your changes
- Play the parts you changed on your computer (see Before you start), in a wide window and in a narrow one (F12, then Ctrl+Shift+M shows phone sizes).
-
If you edited
source/: in a terminal insidesource/, run the commands below. The first checks the rules, the pace and the texts; the second copies the game tosource/dist/.
npm test
npm run build
-
Upload everything inside
game/(orsource/dist/, if you built it) to your web hosting, replacing the old files. - Open your game address and press Ctrl+F5. If you still see the old version, read the section about updates and cache in the main buyer guide.
14. If something goes wrong
-
The game does not open after you edit a file: a comma, quote or brace is missing in a
.jsfile. Press F12 and open the Console: it shows the file name and the line with the error. Compare that line with your backup. -
A picture does not appear: the file name is different from the original (names are case
sensitive:
Tea-1.PNGis nottea-1.png), or the picture is in another folder. - Nothing changed: the browser is showing the old file. Press Ctrl+F5, or open the game in a private window.
- The numbers did not change in a game already started: prices and orders already on the screen were made with the old numbers. Choose Start over in the pause menu.
- Still stuck? Restore your backup and change one thing at a time. Support: willian@polargames.com.br (include the game version, what you changed and a screenshot).