1 files changed, 165 insertions, 0 deletions
diff --git a/design_doc/mechanics.text b/design_doc/mechanics.text
new file mode 100644
index 0000000..ae7bcad
--- /dev/null
+++ b/design_doc/mechanics.text
@@ -0,0 +1,165 @@
+10000 Copies of Windows 10
+(2017 Edition)
+Mechanics
+
+
+* City & Money
+
+Upon arriving in a new city, the player has to choose among these options:
+ - just hawking on the streets
+   - gains a base cpd of 1
+   - risks being caught by urban mgmt police (1-urbanmgmtlaziness everyday)
+   - local reputation starts at -1
+ - working for a computer store
+   - requires max(reputation)>5
+   - salary per day=CPI*60
+   - extra ¥10 for each copy of Windows 10 selled
+   - local reputation starts at 0
+   - halves success rate of persuading older Windows user
+     (unless S/N giveaway to computer dealers is done)
+   - doubles success rate of presuading mac user
+   - can be fired if cpd<32 (0.48-cpd/200*3 everyday)
+     - falls back to hawking if fired
+     - gets ¥600 when fired
+   - starts with 75% of your max stamina everyday.
+ - start a microsoft store
+   - costs ¥50000+CPI*10000
+   - gains ¥500+CPI*400 per day
+   - gains a base cpd of 10, increasing itself by 1 everyday
+   - local reputation starts at 5
+   - persuading activities are disabled
+   - starts with 50% of max stamina everyday unless local reputation > 15
+
+The player can change jobs every 10 days (on day 10, 20, 30 etc.)
+Unless the player has a microsoft store in that city, the player can choose
+the job again on arrival if the city has been visited. Returning to a city
+with a microsoft store gains you 1% more cpd per 1 celebrity.
+
+Minimum living: -CPI*12 per day. Actual spending varies with in *(12,24).
+
+Salary from Microsoft arrives every 30 days (on day 30 and day 60).
+Salary from Microsoft=3000+(copies of Windows 10 selled in that time span*40)
+If the player failed to keep the sales data, "copies of Windows 10 selled in
+that time span" would equals to -50.
+
+If caught by urban mgmt, you'll be put into detention (which differs from
+being jailed for bribing):
+  - no activity can be performed
+  - max stamina does not grow
+The duration is rand(1,3).
+
+City attributes are listed below:
+CPI (1~10)
+population (10k~1m)
+customers per day
+number of fanboys
+urban mgmt laziness (0.5~0.9)
+
+Starting city has fixed attributes: CPI=8, population=200k, urbanmgmtlaziness 0.6
+
+Initial stats:
+¥5000
+Reputation {0}
+Celebrity 0
+
+* Customers per day (cpd)
+cpd is added to sells at the end of each day.
+cpd can be negative.
+sells earned by cpd in a city cannot exceed 10% of its population
+
+* Reputation
+Reputation modifies the difficulty of the game. Reputation is per-city based.
+There's a global reputation though, which equals to the average reputation among
+all cities.
+
+Reputation modifies the game in the following way:
+global rep<-31: ends the game immediately
+global rep<-16: unable to travel among cities anymore
+<-9: fanboys effect will cease (losing all fanboys)
+<-5: cannot hold promotions anymore
+<-2: fanboys effect reduced to 50%
+<-1: persuading older windows users to migrate becomes tricky (halves success rate)
+< 0: persuading mac users to migrate becomes tricky (halves success rate)
+> 2: persuading older windows users becomes easier (80% success rate)
+> 4: persuading mac users becomes easier (60% success rate)
+< 4: persuading free operating system users is tricky (halves success rate)
+> 8: fanboys effect increased to 150%, persuading older windows users becomes automatic
+> 10: persuading free operating system users becomes easier (50% success rate)
+> 12: fanboys effect increased to 200%, persuading mac users becomes automatic
+
+* Persuading
+Persuaing is somehow RNG-based. The player interacts with the persuaded person and modifies
+the RNG range of the final test. If the final generated number is greater than the success
+threshold, the persuade succeeds.
+
+The interaction script is randomly selected from a preset. See the persuading section in
+script.text for details.
+
+* Chatting
+  -w/ workmate Charlie
+    This workmate is set to working in the same position as the protagonist. However he knows
+    a lot: the sales data of the protagonist (and whether the player is keeping it correctly),
+    where the protagonist is traveling to and the stats of that city. He sometimes gives
+    hints to the player.
+
+  -w/ workmate Donald
+    This workmate is also working in the same position as the protagonist. He's got a lot of
+    money but he seems to be playing the fool all the time, asking the player for some secret
+    combination so that he will give the protagonist ¥10000 (or ¥100000 if the player already
+    reached ¥10000).
+    
+    The player can give any combination, but if it is incorrect, Donald will take double the
+    money away from you without asking (which may result in negative money savings)!
+    
+    The correct combination is obtained by ██████████████ and █████████████████████.
+
+  -w/ boss
+    The boss knows nothing about your real sales data -- until you reached day 90.
+    If you got ransomed by his WannaBigCry worm, you'd better send lots of bigcrys instead
+    of ¥6666 worth of Windows 10 product keys to him.
+    
+    By the way if you are aware of his old friend, Ulysses' current status, he might be delighted
+    to hear about it.
+
+  -w/ potential users
+    only when local reputation >5 or global reputation >7. Basically same as persuading but
+    the success rate is always 80%.
+
+  Chatting script is found in script.text.
+
+* Moving
+The protagonist can move to another city. Moves cost money, and always span a whole day.
+If the player has no microsoft store in the original city, all cpd in that city will be lost.
+Otherwise, 60% of the cpd will be kept. Fanboys will be capped at fanboys*(celebrity/50).
+
+The city map is generated at the start of a new game, completely randomly.
+
+
+* Fanboys
+The player can raise Windows 10 fanboys. A user successfully persuaded manually to migrate to
+Windows 10 has an additional 20% chance to become a fanboy. For each fanboy the player has, it:
+ - increases the persuading success rate by 1% (capped at 20%, which will not be doubled or halved)
+ - adds 5% more cpd (capped at 100%)
+ - increases success rate of many activities. See activities.text for details.
+ - having more than 50 fanboys in a city will earn you 10 celebrity immediately.
+ - for every 10 fanboys, you get an additional ¥50 per day.
+
+
+* Celebrity
+Celebrity can help the protagonist even more.
+  - starting reputation for a new city increased by floor(celebrity/10)
+  - for every 100 copies of Windows 10 sold, getting 1 fanboy in every visited city per 20
+    celebrity
+  - reduces fanboys loss when moving away from a city (see the moving section)
+  - having > 50 celebrity eliminates the risk of being caught by urban mgmt police.
+  - having > 40 celebrity halves stamina cost of persuading activities and promotion activities.
+
+* Stamina
+The player's stamina resets everyday to its maximum value, which is initially 100.
+The player cannot do anything costing more than its current stamina.
+Hitting gym increases the maximum stamina.
+
+See the activities section for stamina costs.
+
+* Activities
+See activities.text for defails.