drummyfish/Licar
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Adjust GUI to different resolutions

Browse source
This commit is contained in:
Miloslav Ciz 2025-03-07 16:18:25 +01:00
parent 9b2fc5f14c
commit 50ceea3f0a
4 changed files with 64 additions and 41 deletions
Download patch file Download diff file Expand all files Collapse all files

49
media/manual.txt
View file

@ -7,13 +7,14 @@ by drummyfish, released under CC0 1.0, public domain
~~~ GENERAL ~~~
Licar is a relatively simple 3D stunt racing game inspired by other popular
games of this genre. Unlike most games in existence, Licar is completely free
as in freedom (meaning its source code is available for any use), gratis, and
its focus lies on being well programmed by employing minimalism and rejecting
harmful "modern" programming practice. The game aims to seflessly bring
happiness to all people, even those who have no money, own only very old and
weak computers etc. It is not a commercial product and has been made purely out
of love by a single man.
games of this genre. Unlike most games in existence, Licar is completely libre,
free as in freedom (meaning its source code is available for any use whatsoever),
gratis (free of cost), and its focus lies on being well programmed by employing
minimalism and rejecting harmful "modern" programming practice. The game aims to
seflessly bring happiness to all people who might enjoy it, even those who have
no money, own only very old and weak computers etc. It is not a commercial
product and has been made purely out of love by a single man. It is also more
than a game, for example it can be used for educational purposes.
The game runs on many platforms and comes in different versions depending on
what the platforms allow. Some versions may have more features or visual
@ -71,7 +72,7 @@ speed, times at checkpoints etc.
Controls are extremely simple. The car is only controlled by 4 directional
keys: up (accelerate), down (deccelerate, reverse), left (steer left) and
right (steer right). There are two additional keys, A and B (depending on your
platform these may be e.g. the K and L letter or RETURN and SPACE keys), for
platform these may be e.g. the K and L letter or RETURN and ESCAPE keys), for
restarting runs and handling menu.
PRO TIP: pressing brake while in air stops the car's horizontal rotation!
@ -96,15 +97,16 @@ replay data. For example a map named "mymap" will start with "Mmymap;".
~~~ CONFIGURATION ~~~
The game offers a very high level of configuration and customization. Very basic
settings (such as turning the music off or switching between windowed and
fullscreen mode) are accessible either in the game menu, or as a commandline
flag (run the game with -h flag to see the options). All other settings,
however, are kept at the source code level and so changing them requires
recompiling the whole game from source code (which is nonetheless very simple).
All user settings, along with their descriptions, are located in the settings.h
source file. The game also comes in several precompiled versions with different
settings.
The game offers a very high level of configuration and customization, and those
with at least basic programming skill will be able to implement any changes
imaginable. Very basic settings (such as turning the music off or switching
between windowed and fullscreen mode) are accessible either in the game menu,
or as a commandline flag (run the game with -h flag to see the options). All
other settings, however, are kept at the source code level and so changing them
requires recompiling the whole game from source code (which is nonetheless very
simple). All user settings, along with their descriptions, are located in the
settings.h source file. The game also comes in several precompiled versions with
different settings.
~~~ REPLAYS ~~~
@ -141,7 +143,7 @@ and/or flipped. Additionally each block also has a material (concrete, grass,
...). The finish, checkpoints and car start position can also be seen as block.
The format of the map data string is described in the map.h file, refer to it
for details. In short: TODO
for details. In short: TODO (also small example)
Under the asset directory there is a helper file for Blender (a FOSS 3D editor)
with which a map layout can be comfortably created. But Blender is not required
@ -150,12 +152,12 @@ or -- for simpler maps -- it may be possible to just imagine them in one's head.
The "workflow" for making maps is roughly the following:
1. Drawing the map (in Blender, on paper, ...).
1. Drawing the map (in Blender, on paper, with Lego, ...).
2. Rewriting this to the map text format in the data file. The edited map should
be the very last item in the data file so that it can be quickly loaded with
the -M command line argument.
3. Testing the map in game. This is easily done by running the game with -M
argument (and possibly also other arguments, e.g. to start with free camera)
argument (and possibly also other ones, e.g. -c3 to start with free camera)
to instantly load the edited map. If something needs changing, we return to
1. or 2.
@ -170,3 +172,10 @@ most difficult tasks to create a flawless physics engine. We apologize for any
frustration but unless you want to fix this yourself, you'll have to just accept
it, the game is meant to be a simple entertainment. In other words this is a
feature :)
Q: I have some other question.
A: My email is currently drummyfish@disroot.org, feel free to ask me anything,
but please remember I am not very social and don't enjoy too much engaging in
smalltalk or lengthy discussions about worldviews etcetc.