add doc/realism.md

doc/gamedesign.md

@@ -89,12 +89,6 @@ We are not quite there yet, but this is what I'm aiming for:
     - The author got into programming through modifying existing open source games, and wishes to help others to be able to do the same.
     - The game should only use components that don't restrict the player's ability to run the game, change it to their needs, and learn from its design.
 
-# Intentional deviations from reality
-
-- The player can survive higher g-forces than a contemporary human, though this can be explained through better equipment, drugs, and/or genetic engineering.
-- The position of the planets/moons is the one of the present real time of the player, even though the game takes place hundreds of years in the future. I could simulate the future positions, but I think it's an extra layer of awesomeness if the positions of the celestial objects in the game mirroring the ones of reality. And nobody would ever notice the discrepancy.
-    - P.S. First I have to find a way to actually calculate the current real positions of the moons...
-
 # Game systems
 
 A variety of relatively simple game systems should interact with each other to create emergent gameplay and interesting game mechanics.

doc/realism.md

@@ -0,0 +1,38 @@
+# Realism
+
+OutFly strives to be as realistic as possible. If you find anything that's not realistic, let me know and I will track it in this document so we can fix it eventually.
+
+Some deviations from reality are intentional and may be explained with futuristic technology or just accepted as wrong for the purpose of making OutFly a better game.
+
+## Cosmetic
+
+- [ ] The graphics are not photorealistic: I wish they were, and the goal is to get there, but I don't know how yet.
+- [ ] The player animation does not take forces into account, like limbs moving around when accelerating
+- [ ] The aurora on Jupiter doesn't look real
+- [ ] The mirrors don't actually light up the greenhouse, it's still dark
+- [ ] Jupiter's dust ring is a flat, textured circle. It should instead be a volumetric fog: I wish I knew how to fix this, especially without causing a huge performance overhead.
+- [ ] Jupiter's atmosphere should properly refract the sunlight and produce the proper sunset-like appearances
+- [ ] The sun lights up any planets other than Jupiter from the wrong side
+- [ ] The Rings of Uranus receive an incorrect shadow from the planet
+- [ ] The inner 4 moons of Jupiter should have a reddish tint
+
+### Augmented Reality
+
+The game features an Augmented Reality mode that overlays virtual objects on top of the player's visual field. Some of these don't look quite realistic. But they don't necessarily have to, since they are not actually real. Still, lets keep track of these cases:
+
+- [X] Clothes in Augmented Reality cast no shadows: This is intentional, they are not real.
+- [ ] Clothes are not animated
+- [ ] The thruster particles don't actually come out of the thrusters: Will be fixed after a suit redesign
+
+## Physics
+
+- [ ] Thrusters on the player model don't act on center of mass, and don't cover all directions: Will be fixed in a suit redesign
+- [X] The player can survive higher g-forces than a contemporary human: They have better equipment, drugs, and/or genetic engineering.
+- [ ] The satellite does not have heat dissipation panels
+- [ ] The greenhouse glass should be multi-layered for micrometeorite protection
+- [ ] Thebe should cast a "wave"-like pattern in the ring dust thickness
+- [ ] The player should not have infinite fuel
+- [ ] Is the space suit too small to store all the implied mechanisms for extended stays in space?
+- [ ] The player should only be able to receive objects (e.g. oxygen) from NPCs if they are close by.
+- [ ] Time should pass when being unconscious from cryofreeze for a transport by FASTravel
+- [ ] The orientation of planets and moons should reflect their actual orientation