v1.7: stats command, basic ranking

README

@@ -42,6 +42,7 @@ From now on, the following commands are available (case-insensitive):
 * mkt: show local planetary system market prices
 * local: list planetary systems within 7 lightyears (your max fuel capacity)
 * hold: expand your cargo bay to 35t for 400 credits (one-time upgrade only)
+* stat: show player statistics and overall rank
 * save (name): save the gamestate in the current working directory
 * load (name): load the gamestate from the current working directory
 * help: display an in-game command help screen
@@ -56,7 +57,7 @@ Fuel price is fixed at 0.2 CR/LY, you can hold 7LY of fuel at most.
 
 == Gameplay differences from the original TE 1.5 C version ==
 
-As of the current version, 1.6.3:
+As of the current version, 1.7:
 
 * multiple typos corrected in text strings
 * the "cash" and "sneak" commands were removed since v1.6
@@ -75,6 +76,7 @@ As of the current version, 1.6.3:
 * since v1.6.1, the game gives you a hint if you might have found Raxxla
 * since v1.6.3, galaxy names are also displayed with "local" command
   (the names were taken from the Archimedes version of Classic Elite)
+* since v1.7, basic ranking and statistics have been introduced
 
 To be continued. This list is expected to grow in the future.
 
@@ -115,19 +117,40 @@ set implementation bumps the version number by 0.1, indicating that it's no
 longer fully command-to-command compatible with the previous one.
 The first published awlite version was 1.5.8, meaning 8 minor improvements.
 
-- If there are no combat missions or ranks, what are the goals in awlite?
+- If there are no combat missions, what are the goals in awlite?
 
 Like the original Elite and Text Elite, awlite has no end-game goal. There are,
 however, some milestones you can achieve even now, for instance:
 
+* reaching the Elite trade rank (in v1.7+ - see below);
 * reaching a certain amount of credits;
 * collecting certain amounts of rare valuable items;
 * visiting all planets in all galaxies (2048 total);
 * finding Raxxla (v1.6.1+ will give you a hint when you might have done so).
 
-As of now, player ranking system and statistics are in the works and planned
-to be introduced in version 1.7 or 1.8. They will be loosely based upon Trade
-and Explorer ranking of Elite Dangerous but are going to be unique to awlite.
+As of now, player ranking system and statistics are in the works. The basic
+system of stats and ranks was introduced in v1.7. It is loosely based upon the
+Trade ranks of Elite Dangerous but the formula is fully unique to awlite.
+
+- How are ranks calculated in awlite v1.7 and above?
+
+To keep things simple, the formula currently only considers the current cash
+balance and overall expenses to calculate the profit margin, then taking log2
+of it. As of now, the following profit margin to rank mapping is in effect:
+
+* Under 100%: Penniless
+* 100% to 200%: Mostly Penniless
+* 200% to 400%: Peddler
+* 400% to 800%: Dealer
+* 800% to 1600%: Merchant
+* 1600% to 3200%: Broker
+* 3200% to 6400%: Entrepreneur
+* 6400% to 12800%: Tycoon
+* 12800% and above: Elite
+
+So, to reach Elite trade rank, you need to make 128 times more money than you
+spend. This system might change in future versions, as it's not clear whether
+or not this is possible at all.
 
 - I found an awesome trade route in awlite. Can I use it in other Elite games?
 
@@ -149,7 +172,7 @@ being designed.
 - How large is awlite?
 
 As of now, the entire game is contained in a single file with a little under
-500 SLOC of POSIX AWK code. Future functionality might increase the codebase
+550 SLOC of POSIX AWK code. Future functionality might increase the codebase
 size, but one of the goals is to keep it under 1000 SLOC no matter what.
 
 - Why AWK?