TRADING GAME

GAME DESIGN DOCUMENT

TABLE OF CONTENT

CHANGELOGS..............................................................................................................................................1
PLATFORM...................................................................................................................................................1
GENRE..........................................................................................................................................................1
CAMERA.......................................................................................................................................................1
GRAPHIC STYLE............................................................................................................................................2
ORIENTATION..............................................................................................................................................2
NETWORK....................................................................................................................................................2
TECHNOLOGY..............................................................................................................................................2
HIGH CONCEPT............................................................................................................................................2
CORE LOOP..................................................................................................................................................2
LOGIN..........................................................................................................................................................2
SIGN-IN USING PHONE NUMBER.............................................................................................................3
FACEBOOK LOGIN....................................................................................................................................3
GMAIL LOGIN...........................................................................................................................................3
APPLE LOGIN............................................................................................................................................4
Decide IGN (In-Game Name).......................................................................................................................4
GAMEPLAY...................................................................................................................................................4
JOINING A TOWN.........................................................................................................................................4
RANDOMLY PLACED IN TOWN.................................................................................................................5
JOIN USING TOWN CODE.........................................................................................................................5
CHANGING THE TOWN................................................................................................................................6
SELECT RESOURCE.......................................................................................................................................6
CHANGING RESOURCE.................................................................................................................................7
RESOURCE PRODUCERS...............................................................................................................................7
TOWN MARKET............................................................................................................................................8
BUILDINGS...................................................................................................................................................9
MAIN HALL...............................................................................................................................................9
MAYOR...............................................................................................................................................10
HARBOR (Building Details).....................................................................................................................11
EXPEDITION (Yet to be decided)........................................................................................................12
OPEN MARKET...................................................................................................................................13
WAREHOUSE..........................................................................................................................................14
WALL......................................................................................................................................................15
DISASTERS..................................................................................................................................................16
CURRENCY (ECONOMY).............................................................................................................................17
LEADERBOARD...........................................................................................................................................17
TUORIAL.....................................................................................................................................................17
REPORTING A PLAYER................................................................................................................................18
TOWN CHAT...............................................................................................................................................18
ACHIVEMENTS...........................................................................................................................................18
AUDIO........................................................................................................................................................18
PLAYER PROFILE.........................................................................................................................................18
SETTINGS...................................................................................................................................................19
GAME ANALYTICS......................................................................................................................................20
FREE VESRION............................................................................................................................................20
Paid Version...............................................................................................................................................20
ADMIN PANEL............................................................................................................................................20
CHANGELOGS
DATE VERSION CHANGES
17-04-2023 0.1 Initial Game Design Document
17-05-2023 0.2 Did updates according to the
Wireframe feedbacks by the
client

PLATFORM
 Android
 iOS

GENRE
 Strategy
 Trading

CAMERA
 Isometric

GRAPHIC STYLE
 3D Cartoonish (Medieval)

ORIENTATION
 Landscape

NETWORK
 Online

TECHNOLOGY
 TBD

HIGH CONCEPT
 This is a resource management game that allows players to earn gold by managing shops,
producing resources, and trading.
 Gold can be converted to real money (Only if the player has purchased the paid version of the
game)
  The player joins a town where they can generate and trade resources with other players or
NPCs for gold.
 The player can invest the generated resources in town buildings to upgrade them

CORE LOOP


 These will be the main activities that the player will be performing in the game

LOGIN
 The player can log in to the game using any-1 of the log in options available in the game
 The player can log in to the account only on 1 device at a time, if the player tries to log in from
other device using the same account a popup will be shown with the text and 2 buttons
o Text: This account has already logged in to another device, please logout to continue
o Button 1 (Logout): Will logout the account from other device and the account will be
logged in to the current device
o Button 2(Cancel): Will close the popup and stay on the login options page

Note: Once the user logs into the account, players do not need to enter the credentials whenever they
return to the game.

SIGN-IN USING PHONE NUMBER

 The player will be able to use his/her phone number to login to the game
 The player will have to enter a phone number to login to the game
 If it is a valid number then,
o The user will receive an OTP as a text message and the user will have to enter the OTP
to complete the login
o Re-send OTP option will also be available
o If the OTP is correct, then the user will be logged in to the game successfully
o Incorrect OTP won’t allow the user to login to the game
 If it is an invalid number then,
 o A red font message will be displayed “Invalid number”
 By logging in via Mobile number, players will be able to:
o Save the progress of the game to the particular account
 Note: This login will have same flow, even if the player logs out and then login to the game
again.

FACEBOOK LOGIN
 If the player has Facebook opened and logged in on his/her phone already then while signing up
they don’t need to re-enter their login information again
 To sign in using Facebook, the players must use their Facebook id and password.
 A sign in button for Facebook will be present on the landing page of the game.
 The following information will be fetched from the users Facebook account.
o Name
o User’s Email ID
 By logging in via Facebook, the player can
o Save the progress of the game to the particular account

GOOGLE PLAY SERVICE LOGIN (For Android Devices)

 To sign in using Google play service
 If the Gmail account is already logged in to the device, then the list of accounts will be displayed
 The player will have to select any one account and login through it to the game.
 A sign in button for Google play service will be present on the landing page of the game.
 The following information will be fetched from the user's Google account.
o Name
o User’s Email ID
 By logging in via Google play service, the player can
o Save the progress of the game to the particular account

APPLE LOGIN (For Apple devices)

 To sign in using Apple login, the players must use their existing Apple id and password.
 A sign in button for Apple will be present on the landing page of the game.
 When the player clicks on the Apple login button, a popup for the games will open and it will
have the list of Apple accounts that are there in the devices.
 The player will have to select any one account and login through it to the game.
 The following information will be fetched from the user's Apple account.
o Name
o User’s Email ID
 By logging in via Apple id, the player can
o Save the progress of the game to the particular account

Decide IGN (In-Game Name)

 Once the player has logged in successfully to the game, then the next step will be to provide an
In-game name of the player
 The in-game name can contain 15 characters.
  The in-game name can contain
o Alphabets (both upper and lower case)
o Numbers
 In-game name of the player cannot be duplicated
 In-game name can be changed using gold in future (From player’s profile)
o Cost to change In-game name will be mentioned in the metric sheet

GAMEPLAY
 In this game, players start as members of a town and can engage in various activities such as
o Producing/collecting resources
o Contributing for upgrading structures
o Contributing for preventing disasters
o Trading with NPCs and other players
o Participating in expeditions.
 Players can produce tier-1, tier-2 and tier-3 resources from resource producers.
 They can trade with NPCs or with other players for gold.
 There is an open market where players can trade resources with other towns (this type of trade
will cost extra fees).
 The player who contributes the most to the town becomes the mayor of the town.
 The mayor of town can manipulate town policies.
o Details will be mentioned in their respective sections.

JOINING A TOWN
 Player can join a town using 3 ways
o Randomly placed in town
o Using town code
o Recommend a town

RANDOMLY PLACED IN TOWN

 When the player logs into the game for the first time the player will be asked to join a town.
 The player will have an option to “join town randomly” which places the player in random town.
 The player will be placed into the town using following criteria
o Lowest Number of Players:
 The system will first search for all the towns that have slots available for players
to join. If there are multiple towns with available slots, the system will identify
the town with the lowest number of players and place the player in that town.
 For example, if there are two towns with available slots
 Town-1 has 3 slots
 Town-2 has 4 slots
 Then the player will be placed in the town 1
o Newest Town:
 If all the available towns have the same number of slots remaining, the system
will then look at the creation date of the town.
  The town that was created most recently will be given priority, and the player
will be placed in that town.
 NOTE: If towns are full, it will generate a new town.

JOIN USING TOWN CODE

 Town code can be used to join the specific town
 Each town will have unique town code
 The town code can be found by tapping on Main Hall
o Share button will be available beside the town code
o The player can share town code via native sharing using Share button
 The town code will consist of 4 digits which will be auto generated on creating a new town.

o The town code cannot be duplicated

 When the player logs into the game for the first time the player will be asked to join a town.
 The player will have an option to “join using town code”.
 Upon selecting this option there will be a text input field where players need to paste or type
the town code shared by their friend to join the town.
 If the town which player wants to join using town code is already full the player will receive a
popup showing
o Text: “The Town you want to join is already full!”

RECOMMENDED TOWN
 Player will be recommended town on joining screen which will display
o Number of players in town
o Main hall level of town
o Town description
 Player can select any one recommended town among the town shown to join
o Tapping on the town will popup join button
o Tapping on the join button will join town.
 Note: Only open towns will be listed here
 The player can refresh the list of towns by tapping on the “Refresh” button

o There will be text “Town list refreshed”

INTERACTING WITH THE TOWN
 The player will be able to interact with the town using touch controls
o Reference: Clash of Clans
 Zoom in/out: Use 2 fingers to zoom in/out on the town
 Sliding the finger on the town will move the camera on the town
 A single tap on the specific building will open its respective popup

CHANGING THE TOWN

 Players can change the town from their existing town to a new town anytime.
 The player can only carry their resources present in personal inventory and cannot carry the
resources they kept in warehouse.
o IF the player needs the resources kept in the warehouse, then the player will have to
retrieve them before leaving the town
o Retrieved resources can be found in player’s inventory
 If the player forgot to retrieve the resource from the warehouse before leaving
the town, then that resource will be contributed to the upgrade of lowest level
of the building
 If 2 or more buildings are of same level, then the resource will be contributed
for any 1 building (randomly)
 Leaving the town
o The player can leave their current town by following the below-mentioned steps
 Tap on resource producer building (that player owns)
 Tap on “Leave town” button
 There will be a popup with the text and 2 buttons
 Text: “Are you sure, you want to leave the town? The resource stored in
the warehouse will be lost
 Button 1 (Leave): The player will leave the town
 Button 2 (Cancel): The popup will be closed

SELECT RESOURCE
 When the player joins a new town, the player will get a screen to choose resource with its icon
and summary of the resources which the player must tap and select.
 There will be total of 12 types of resources segregated in three different tiers
o Tier 1
 Grain
 Ore
 Logs
 Rocks
 Note: No requirements will be the for producing Tier 1 resource
o Tier 2
 Flour
  Iron
 Lumber
 Stone
 Note: To produce tier 2 resource tier 1 resources will be required
o Tier 3
 Bread
 Steel
 Planks
 Cement
 Note: To produce tier 3 resource tier 2 resources will be required
 Players can select any of one resource to produce among the 12 resources they want
respectively.
 Resource producer of the player will start producing the selected resource after selection If the
required resource to produce is available
 If the player selects resource that is available to produce, then a dialogue box with text and
buttons will appear
o Text: Are you sure you want to continue with <Selected resource> ?
o Button 1: Continue

o Button2: Select Other

o The number of required resources available will also be displayed
 If the player selects resource that is NOT available to produce, then a dialogue box with text and
buttons will appear
o Text: To produce this resource <Resource Name> is required
o Button 1: OK

CHANGING RESOURCE
 Players can switch resources at any point of time in the game.
 On tapping resource producer building a balloon popup will open which will have a button
“change resource”.
 Tapping on the change resource button, the resource selection screen will open.
 Player can select any 1 resource listed from the resource selection screen.
 Changing the resource, the player will have a cooldown time of 24-hours for resource producer.
 o Once the resource is changed by the player, the resource producer will not produce any
resource for 24 hours
o After 24 hours, the resource producer will start the production for the selected resource

RESOURCE PRODUCERS
 Resource producer is a predefined building in town which will produce the resource selected by
player.
 1 resource producer will be assigned to each player of the town
 Resource producers cannot be upgraded.
 If the player has selected T1 resource, it will automatically start generating resources.
 If the player has selected T2/T3 resource player will need to purchase/produce T1/T2 resource
to start production.
o Count of T1/T2 resources required to produce T2/T3 resources will be defined in metric
sheet
 Note: Current resource in production can be seen on the top-right of the screen
 If the above production requirement is met for T2/T3 resource the production will automatically
start.
 The resource building will have a max capacity limit depending on how much it can store.
o Once the capacity of the resource producer building has reached its full capacity, then it
will stop generating the resources
o Values to be mentioned in metric sheet
 Once the limit is reached the player must
o Manually shift resources from resource producer to warehouse
o OR
o Invest in upgrading other town buildings to start resource production again.
o OR
o Sell the resources
o Note: If the player shifts the resources to a warehouse or sell them then the resource
producer will continue its production
 Resource Generation Rate
o The range of resources produced in a day will 1800-2700 (per day) based on efficiency.
 o 1800/day will be starting rate at 1% efficiency
o The efficiency of resources will be increased by 1% each day if the player logins daily or
if the player fails to log in for a day the efficiency will be decreased by –1%.
 Note: The efficiency cannot be less than 0
o Mayor can change the policy for degrading the efficiency for inactive players.
o NOTE: Resource generation rate will be same for all tier resources

TOWN MARKET
 Town market is a marketplace which is used for trading resources inside the town.
 Players of the town can put the resource on sale on town market
 Players of the town can buy the resources from the town market kept for sale by other town
players
 Town market won't cost any extra fees for trading resources inside the town market.
 The player can access the town market from the resource producer building, when a player taps
on the resource producer building it will open a balloon popup which will have a button “Town
Market”.
 Tapping on “Town Market” button will open Town Market place.
 To sell resource in marketplace the player must
o Go to town market
o Tap on sell button
o Tapping on sell button will open player’s inventory which will show the player’s
resources
o Tapping on resource will open a sell resource window, where the player will have to
 Enter resource price
 Or
 Add all resource: This will add all the resource
 Enter resource quantity
 Tap on “Sell” button
o Above procedure will list the resource on the marketplace
 Till the resource is in the marketplace, the user will not be able to
o Contribute the specific resource which is listed for sale
o Sell the specific resource which is listed for sale
 The resource, which is on sale in the marketplace, will be greyed out in the inventory with the
text on it “in town marketplace”
 To remove the resource from the marketplace and take it in the inventory, the player will have
to
o Tap on resource producer building
o Go to Town Market
o Tap on Listings
o Tap on the resource listed
o Tap on “Remove”
o A confirmation popup will be displayed with text and 2 buttons
 Text: Are you sure you want to stop selling the resource on the marketplace?
  Button 1 (Yes): Will take back resource to the inventory and the popup will be
closed
 Button 2 (no): Resource will remain in the marketplace and the popup will be
closed
 If the Resource is sold successfully, then a push notification will be given to the player
o Notification text: “Resource_name” is sold successfully to the “player_name” on the
town marketplace
 To buy resource from marketplace
o Tap on resource listed on marketplace will open a popup to buy resource
o Clicking on buy will open a confirmation popup with text input field text and 2 buttons
 Text: Are you sure you want to buy this item?
 Button 1 (Yes): The item will be bought and seen in your inventory.
 Button 2 (No): player will return to Town market window.
 If the Resource is bought successfully, then a popup will be shown item bought successfully.
 If the player inventory is full the resource bought will be sent to temporary inbox, where later
player can retrieve the resource brought.
 The temporary inbox will have limited space and the item bought can't be expired in temporary
inbox.
 If there is some item in the temporary inventory, the player will not be able to buy anything

NPC MERCHANT INSIDE TOWN

 An NPC merchant will be available inside the town.
 An NPC merchant will be a 3D character roaming around the town
o There will be 2 animations on the NPC merchant
 Walking
 Idle
 Players can sell their resources to NPC merchants at fixed price based on the tier of resource.
o Prices will be mentioned in metric sheet and the prices will be pre-defined
o The prices displayed here will be for “10 resources”
 NPC merchant in town will buy resource based on the upgradation of the town
o For example: If the main hall is upgraded to level 1 then then NPC will only buy tier 1
resources, if the main hall upgraded to level 2 then it will buy tier 2 resources and if the
main hall is upgraded to level3 then only it will by tier 3 resources. (Can be changed)
 The factor to decide when the NPC will T1, T2 and T3 resources will be mentioned in metric
sheet
 Player can sell their resources to NPC merchant by tapping on it and
o Tapping on NPC will open a balloon pop with sell button
o Tapping on sell button will open player's inventory
o The player must select the resources they want to sell and must enter
 Amount of resources
 OR
 Sell all: Will add all the available resources for sale
  Prices will be displayed below (based on the price of the resource) [This cannot
be edited by the player]
o A sell option will be available below tapping on it will sell resource to the NPC Merchant
inside town.

BUILDINGS
MAIN HALL
 The Main Hall is handled by the mayor and serves as the central gathering point for players in
the town.
 If the mayor is not assigned for the town at the start of town there will be general rules
applicable
o Player cannot kick any other town player
o Cannot control the town policies
 Players can access the main hall and see the contribution made by players and their last seen in
the town.
o Tapping on main hall will open a floating bubble popup
o Tapping on town members, will show their contribution for each player
 The current mayor’s profile name and profile picture will be seen inside the main hall’s menu

 Main hall can be upgraded till level 3

 Main hall will require below resources to upgrade
o T1-T4 resources

o Requirements will be mentioned in metric sheet

 If the requirement to upgrade is met upgradation will automatically start.
o There will be visual change when the main hall is upgraded
o The time to upgrade main hall will be mentioned in the metric sheet
 Players can contribute to upgrade main hall
o Tapping on main hall will open a balloon popup
o Tapping on upgrade main hall button
o All the resource required will be listed here
o The player can tap on “Contribute” (if the resource is available)
o Add number of resources you want to contribute (This will be only possible if the
resource is available)
o OR
o Use add all option
o Tap on contribute: will contribute the resources.

o Total resource contributed till now can be seen here as well

 

MAYOR
 Becoming a mayor
o The player will automatically become mayor if they have made the highest contribution
towards the town in 1 week.
o Push notification will be sent to the player if the player has been elected as the mayor of
the town
 Text for push notification: Yay! You have been elected as the mayor of your
town.
o A player's contribution towards upgrading buildings will also calculate the player's
contribution towards being mayor.
o The mayor's status will be valid for one week, and the same player can be elected as the
mayor for consecutive weeks if he has the highest contribution than other town
members.
 Timer for next mayor will be displayed
o Mayor will only be created once the town the town reaches its full capacity (8-players)
o If there aren't enough players in the town, then the player whose contribution in more
in the first 3 days after the town has been created will become mayor
 Values will be defined in metric sheet
 Responsibilities of mayor
o Amend town policies:
 The mayor has the authority to make changes to existing policies or introduce
new ones, shaping the town's growth and development.
 The mayor can set a policy for not degrading the efficiency of resource producer
according to level of main hall, if the player is inactive for
 Level1 Main hall -Max 3 days
 Level2 Main hall -Max 5Days
 Level3 Main hall- Max 7 Days
o Remove players from the town:
 The mayor can expel players who violate rules or negatively impact the
community.
 To remove player from town
 Mayor must tap on Main Hall
 Tapping on it will open balloon popup with “Town Members”
 Tapping on town members will open a popup containing list of all town
members
  Tapping any of the town member's name will open a popup with Kick
player.
 Tapping on kick player will open a conformation popup with text and 2
buttons
o Text: Are you sure you want to Kick the player?
o Button 1 (Yes): The player will be kicked, and the player will be
informed
o Button 2 (No): player will remain in the town

 The resources stored in the warehouse of player kicked are temporarily

maintained in the warehouse after being kicked and they will be forced to join a
new town before they can do anything else.
 If the warehouse of their new town is not high enough to accommodate
the quantity of resources, it will be lost.
 Note: this for resources which is stored in old town warehouse
 The resource which the player has in its own inventory will also be carried to the
new town.
o Control town accessibility:
 The mayor can open or close the town, affecting its visibility and accessibility to
new players.
 To open or close town
 Mayor must tap on main hall
 Tapping on main hall will open a balloon popup with “town settings”
button
 Tapping on town setting button will open popup containing town setting
with Town open/close toggle button
 Tapping on town open/close toggle button will open or close the town
for joining new players
 If the town has reached its member limit the option will be greyed out.
 The mayor will also accept the request sent to join the town by other
players.
o Town Description
 Town description will be displayed in the town details popup
 The mayor can only change this town description
 All the players of the town can see this message
 This message will also be displayed when the player tries to join via
recommended town section

HARBOR (Building Details)

 The Harbor is a facility in the town, serving as the primary location for
o Expeditions
o Resource trading (Open market)
 Tier-4 resources can be obtained via the harbor
 Harbour’s building will be available on the seashore of the island
  Players can participate in time-limited trading events, send ships for trading rare resources, and
engage in the open market for trading with other towns.
 Players will be able to earn T4 resources from expeditions or events by participating in it.
 Trading via harbor can cost extra gold
 Harbor can be upgraded till level 3
 Upgrading harbor will require below mentioned resources
o T1-T4 Resources
o Requirements will be mentioned in metric sheet
 Upgrading harbor will increase
o Trade capacity
o Trade limits
o Upgrade values to be mentioned in metric sheet
 If the requirement to upgrade is met upgradation will automatically start.
o There will be visual change when the harbor is upgraded
o Time to upgrade harbor will be mentioned in the metric sheet
 Players can contribute to upgrade harbor
o Tapping on harbor will open a balloon popup with contribute button
o Tapping on contribute button will open player's inventory
o The player must select the resource from inventory and tap on it.
o Tapping on it will open a popup, where player will have to
 Enter resource quantity
 Tap on contribute
o Tapping on contribute will contribute the resources.
o Resource contributed by other players can be seen here as well

EXPEDITION
 Players can trade/earn tier-4 (luxury resources) in expeditions for a limited time event.
 Players can trade tier-4 (luxury resources) for gold.
 Below-mentioned are the Tier-4 resources
o Oil
o Sugar
o Salt
o Spice
o Silk
o Black powder
o Jewels
 T4 Resources can be bought and sold both to NPCs and on the market.
 To buy high quantity of T-4 resource, the player will have to sell T1,2,3 resource
 The player can start an expedition without taking any resources on the boat but will be
able to buy T-4 resources in very less quantity
 Player can access expedition and buy item in expedition in limited time event
o By tapping on harbor which will open a balloon popup consisting of Expedition button
o Tapping on expedition button will open expedition window
o Players will see an option to “send boat to expedition” and “Load Resource”.
o The players first will have to Load resources by tapping on load resource button will
open players inventory and boat inventory side by side player must drag and drop the
resources from his inventory to boat inventory to load boat.
 Loading Resource
 Drag resource from inventory to Boat goods section
 After dragging and dropping the player will have to enter the number of
resources they want to load
 Tapping on load all, will load all the available specific resource (which is
dragged)
 Unloading resources
 Drag resource from boat goods section to inventory
 After dragging and dropping the player will have to enter the number of
resources, they want to unload
 Tapping on unload all, will unload all the specific resources
o Then the player must then tap on Send Boat to expedition which will send the boat to
NPC town
 Time required for boat to reach NPC town will be mentioned in metrics sheet
o Selling the resource on expedition
 Player can sell the resources they caried to NPC in NPC town for fixed rate
 Note: This NPC town will be for expeditions only and only available for
limited time (Till the expedition is available)
 Resource rates to be mentioned in metric sheet
 Players can sell any tier resource to the Lady-NPC present in NPC town.
 In this town, the player can see the timer, on when the expedition ends
 Player can sell their resources to NPC by tapping onher
 Tapping on NPC will open a balloon pop with sell button
 Tapping on sell button will open the resources window which player
bought on expedition
 The player must select the resources they want to sell and must enter
o Amount of resources
 A sell button will be available below tapping on it will sell resource to
the NPC.
o Buying the resource on expedition
 Players can buy resources on this island from the shop (building) available on
the island
  Only T-4 resources will be available to buy here
 An NPC shop will also be generated based on resources sold to NPC in the NPC
Town, which will sell a random T4 Resource in limited quantity.
 Quantity and resource will be mentioned in metric sheet
 Players can see Tier-4 (luxury resource) listed there with the prices on
tapping Shop at NPC town
 Tapping on any one of the resources will open a popup to buy resources
 Clicking on buy will open a confirmation popup with text and 2 buttons
 Text: Are you sure you want to buy this item?
 Button 1 (Yes): The item will be bought and seen in your inventory.
 Button 2 (No): player will return to expedition window.
 If the Resource is bought successfully, then a push notification will be given to the player
o Notification text: “Resource_name” is bought successfully from “player_name” through
expedition
 If the player inventory is full the resource bought will be sent to temporary inbox, where player
later can retrieve the resource brought.
 The temporary inbox will have limited space and the item bought can't be expired in the
temporary inbox.
 If there is some item in the temporary inventory, then the player will not be able to buy
anything from the market
 If there is no expedition event happening and the player enter expedition window it will show
the player when will the next expedition event happening or will have text displayed
o Text: Currently, no expedition event is happening. Please come back later.

OPEN MARKET
 An open market is a marketplace which is used for trading resources outside the town.
 It is trading between towns for resources.
 Open market will have extra trading fees (in gold) for trading resources
o Trading fees will be mentioned in the metric sheet
 The player can access an open market from harbor, when a player taps on harbor it will open a
balloon popup which will have a button “Open Market”.

 Tapping on “Open Market” button will open the Market place window.
 2 options will be available in the open market
o Buy resources
o Sell resources
 To sell resource in marketplace the player must
o Tap on sell button
o Tapping on sell button will open player inventory which will show the player resources
o Tapping on resource will open a sell resource window, where the player will have to
 Enter resource price
 Enter resource quantity
 OR
 Add All: This will add all the available resource
  Tap on “Sell” button
o Above procedure will list the resource on the marketplace
 Till the resource is in the marketplace, the user will not be able to
o Contribute the resource
o Sell the resource (town Market)
 The resource, which is on sale in the marketplace, will be greyed out in the inventory with the
text on it “in open marketplace”
 To remove the resource from the marketplace and take it in the inventory, the player will have
to
o Tap on harbor will open balloon popup with open market button
o Tap on open market
o Tap on Listings
o Tap on any one of the resources listed
o Tap on “Remove”
o A confirmation popup will be displayed with text and 2 buttons
 Text: Are you sure you want to stop selling the resource on the marketplace?
 Button 1 (Yes): Will take back resource to the inventory and the popup will be
closed
 Button 2 (no): Resource will remain in the marketplace and the popup will be
closed
 If the Resource is sold successfully, then a push notification will be given to the player
o Notification text: “Resource_name” is sold successfully to the “player_name” on the
open marketplace
 To buy resource from open marketplace
o Tap on resource listed on marketplace will open a popup to buy resource
o Clicking on buy will open a confirmation popup with text and 2 buttons
 Text: Are you sure you want to buy this item?
 Button 1 (Yes): The item will be bought and seen in your inventory.
 Button 2 (No): player will return to open market window.
 If the Resource is bought successfully, then a popup will be shown item bought successfully.
 If the player inventory is full the resource bought will be sent to temporary inbox, where player
later can retrieve the resource brought.
 If there is some item in the temporary inventory, then the player will not be able to buy
anything from the market
 The temporary inbox will have limited space and the item bought can't be expired in temporary
inbox.
 

WAREHOUSE
 The warehouse is used to store resources by the players.
 If the Warehouse gets downgrade, the highest quantity resource gets destroyed first.
o The warehouse can be downgraded if it gets hits by the disaster
 Warehouse can be upgraded till level 3
 Warehouse will require below mentioned resources to upgrade
o T1-T4 Resource
o Requirements will be mentioned in the metric sheet
 Upgrading warehouse will increase
o Capacity to store resources
o Values to be mentioned in metric sheet
 If the requirement to upgrade is met upgradation will automatically start.
o There will be visual change when the warehouse is upgraded
o Time to upgrade warehouse will be mentioned in the metric sheet


 To put resources in warehouse
o Players need to tap on warehouse which will open a balloon popup with storage button.
o Tapping on storage button will open both inventory side by side (players inventory and
warehouse inventory)
o Storing the resource to warehouse
 Player needs to tap and drag the resources from player inventory to warehouse
inventory to store the resource
 After dragging and dropping the player will have to
o Enter quantity for the resource
o OR
o Add all resource
o Tap on Store
o Retrieving the resource from warehouse
  Drag and drop from warehouse inventory to player’s inventory
 After dragging, the player will have to
o Enter quantity for the resource
o OR
o Add all resource
o Tap on retrieve
o After managing the inventory, the player can tap on confirm
 Players can contribute to upgrade Warehouse

o Tapping on warehouse will open a balloon popup with contribute button

o Tapping on contribute button will open player inventory
o The player must select the resource from inventory and tap on it.
o Tapping on it will open a popup, where player will have to
 Enter resource quantity
 Tap on contribute
o Tapping on contribute will contribute the resources.


WALL
 The player needs to upgrade the wall to upgrade other buildings in town.
  No building can exceed the level of Wall
 Wall can be upgraded till level 3
 Wall will require below mentioned resources to upgrade
o T1-T4 Resource
o Requirements will be mentioned in the metric sheet


 If the requirement to upgrade is met upgradation will automatically start.
o There will be visual change when the wall is upgraded
o Time to upgrade wall will be mentioned in the metric sheet
 Players can contribute to upgrade wall
o Tapping on wall will open a balloon popup with contribute button
o Tapping on contribute button will open player inventory
o The player must select the resource from inventory and tap on it.
o Tapping on it will open a popup, where player will have to
 Enter resource quantity
 Tap on contribute
o Tapping on contribute will contribute the resources.

DISASTERS
 In-game disasters act as challenging events that can negatively affect cities by lowering building
levels.
 The game features an "X-Days" warning before disaster strikes, giving players plenty of time to
prepare and strategize.
 When disaster is imminent, all cities in the game face the same threat at the same time,
creating a sense of urgency and camaraderie among players.
 To combat this, temporary disaster a building will appear in the game.
o This building will allow players to invest resources in preventing of disaster
 Resource which are contributed by the players in the disaster building can be considered
o As the contributions towards the town
o Protect the city from the incoming disaster
 Players can contribute to disaster

o Tapping on disaster management building will open a balloon popup with contribute
button
o Tapping on contribute button will open player inventory
o The player must select the resource from inventory and tap on it.
o Tapping on it will open a popup, where player will have to
  Enter resource quantity
 Tap on contribute
o Tapping on contribute will contribute the resource in disaster management building.

CURRENCY (ECONOMY)
 Gold (soft currency)
o Source
 Automatically Generated or mined.
 2700 gold per day. (Guaranteed)
 Can be gained by selling resources in market
o Sink
 Can be used for trade with other resources.
 Can be used in marketplace
 Can be Exchanged for Real Money (10M Gold = 0.01 USD) [can be changed]
 Exchange for real money only applicable in paid version of the game

LEADERBOARD
 The game will have total 2 leaderboards
o Lifetime
o Monthly
 Leaderboard will be based on the total amount of gold earned by the player in the game
o The gold earned by trading will only be calculated and not the gold
earned by idling in the game
 Top-10 players will be listed on the leaderboard.
 Below-mentioned stats of the players will be displayed on the leaderboard
o Rank
o Name
o Amount of gold earned
 

TUORIAL
 Building information will be shown to the player
 To see building information
o Tapping on any building in town will open balloon popup with information button.
o Tapping on the information button will show the information about the building to the
player.
 Tutorial will be played, when the player logs in to the game for the first time

REPORTING A PLAYER
 Player can report another player in a town
 To report a player
o Player must tap on the resource producer building of that player which will open a
balloon popup having “player profile” button
o Pressing player profile button will open player profile which will have report player
button
o Pressing on report player will ask player for 2 options with checker box Infront of it
 Option 1: Report for cheating
 Option 2: Report for offensive comment.
o Tap on check box to select the option and then pressing the report button below will
report the player with a text.
 Text: Player_name successfully reported.

TOWN CHAT
 All the members of the Town will have a common chat section
 The chat section will be available in the Game scene screen at bottom left of the screen.
 Single message can consist maximum 30 characters
 All the emotes available in the keyboard can be used
 Player’s own message will be in the white bubble, with player’s name on it
 Other town member’s message will be with orange bubble, with player’s name on it
 All the old messages will be deleted after 72 hours (about 3 days)
ACHIVEMENTS
 There will be total of 10 achievements implemented in game
o List of achievements will be mentioned in metric sheet
 Completing achievements will reward the player with
o Badges/Titles: Will be displayed in the player profile

AUDIO
 There will be SFX and Background music in the game which can be toggled ON/OFF.
 Audio and SFX will be mentioned in metric sheet

PLAYER PROFILE
 Player profile will consist of
o Player Name
 Player names should be unique and cannot be repeated.
 Popup stating “Username already exists” will appear if name is being
duplicated.
 Player name can be changed from here by spending gold
 Gold quantity to be decided by metric team
 Player names can have a maximum of 15 characters and special characters can
be included
o Profile picture (Avatar)
 Player profile picture will be displayed here
 2 default player’s avatar will be available
 Players can set their profile picture by selecting “+” in profile section which will
open popup containing predefined avatars.
 Player can change the profile picture whenever they wish
 By tapping over profile picture will open popup with change avatar
 Tapping on change avatar will open a popup with predefined avatars.


o Badges/Title earned

 Badges/Title earned by completing achievements will be displayed here.

o Players last online (For other player’s profile)
 The last time the player was online will be displayed.
o Gold Counter
 Total gold available with the player will be shown.
 Tapping on other player resources producer building will have player profile.
SETTINGS
 Settings will consist of
o Music – ON/OFF toggle
o SFX – ON/OFF toggle
o Delete Account
 Players can delete their account permanently
 While performing this action a popup with text and 2 button appear
 Text: Deleting your account means that your game account and all the
game progress will be de-identified permanently. This is an irreversible
process.
 Button1 (Delete My Account): This will delete account
 Button2 (Cancel): This will cancel the process done.
o Privacy Policies
 Redirect to respective page
o Help
 Redirect to respective page
o Sign out
 Players can sign out from their current account

GAME ANALYTICS
 10 unique in-game analytics will be traced and implemented in the game
 The list of analytics to be traced will be mentioned in the metric sheet

FREE VESRION
 Players can play full version of game in free version but cannot cash out gold coins for real
money.
 There will be a separate server for the free version of the game.

Paid Version
 The paid version will have a full version of the game and the player can cash out gold coins for
real money.
 There will be a separate server for the paid version of the game.

ADMIN PANEL
 User management
o Admin can
 Block the player access to game
 Admin can unblock blocked players
 Delete
 View and Edit Players Data
 Edit username
 View
  Player’s stats
 Member since
 Transaction history of Player
 Checking Reports
o Admin can review the reports received from player