NAME

       dMagnetic.ini — Configuration file for dMagnetic.

SHORTCUT

       Run dMagnetic -helpini to see an example.

SYNOPSIS

       The configuration for dMagnetic(1) , and the location of the game binaries is stored in a .ini file.

ELEMENTS

       The elements within the .ini files are

       Sections
           Sections are in square brackets.

           [FILE]

           [DEFAULTGUI]

       Entries
           entries have a = in them.

           rows=40

           pawnmag=/usr/local/share/games/magneticscrolls/pawn.mag

       Comments
           ;This is a comment

           Comments start with a ;

           To use a ; in an entry, it has to be preceded by a backslash \;
           Consequently, using a backslash requires preceding it with a backslash as well.  \\

SECTION [FILE]

       Like any .ini file, it is broken down into sections, each section contains entries. One section has to be
       [FILES].  It  should  contain the names of the game binaries, so that the game engine can find them.  For
       example:
       [FILES]
       pawnmag=/usr/local/share/games/magneticscrolls/pawn.mag
       pawngfx=/home/games/magneticscrolls/pawn.gfx
       ;pawnmsdos=/home/games/magneticscrolls/msdosversions/PAWN

       The .mag and .gfx packages can be downloaded from https://msmemorial.if-legends.org/memorial.php, btw. If
       you are lucky enough to have a copy of the MSDOS version stored on your harddrive, you  can  provide  the
       directory with the pawnmsdos entry.

       ;wonderlandtworsc=/games/magneticscrolls/wonderland/TWO.RSC
       ;guildtworsc=/games/magneticscrolls/MSC/GTWO.RSC
       ;corruptiontworsc=/games/magneticscrolls/MSC/CTWO.RSC
       ;fishtworsc=/games/magneticscrolls/MSC/FTWO.RSC

       "Wonderland",  and  the  "Magnetic  Scrolls  Collections"  used  a  different framework, called "Magnetic
       Windows". This framework utilized a collection of resource files. By providing the name and the  location
       of the second resource file "TWO.RSC", the names of the other ones can be computed.

       To  avoid  any  form  of misunderstanding, it is recommended to make sure that the .ini file is providing
       only one of the three methods. The other two should be commented out.

SECTION [RANDOM]

       This section configures the random number generator.

       mode=pseudo
       ;mode=real
       seed=12345

       The mode can be one of two: "pseudo" or "real". Each one of them offers  a  different  experience  whilst
       playing.  When  testing the software, or playing with scripts, the "pseudo" option should be chosen. This
       offers a certain degree of determinsm.
       Legal values for seed are in the range of 1 to 2147483647.

SECTION [DEFAULTGUI]

       This section is configuring the default output Interface.

       [DEFAULTGUI]
       rows=40
       columns=100
       ;align=left
       align=block
       ;align=right
       ;mode=none
       ;mode=monochrome
       ;mode=low_ansi
       mode=high_ansi
       ;mode=high_ansi2
       ;mode=sixel
       low_ansi_characters=\\/=|\;
       monochrome_characters= .:-=+*x#@$X
       sixel_resolution=1024x768

       Changing the numbers of rows will make pictures longer, changing the number of columns makes them  wider.
       To change the output mode, comment it in, and comment the current one out.
       The  characters  that  will  be  used  in  the  low  ansi  rendering  mode  can  be  configured  with the
       low_ansi_characters entry. Note that the backslash and semicolon need to be escaped.
       The monochrome_characters entry is a the actual shade that will be displayed.  The  leftmost  part  start
       with the lowest intensity, it goes up until the right.
       The  sixel  resolution  is setting the amount of pixels in which the images are being rendered with sixel
       mode.

EXAMPLE

       ;you can download the files from https://msmemorial.if-legends.org/magnetic.php
       [FILES]
       pawnmag=/usr/local/share/games/magneticscrolls/pawn.mag
       pawngfx=/usr/local/share/games/magneticscrolls/pawn.gfx
       ;pawnmsdos=/usr/local/share/games/magneticscrolls/msdosversions/PAWN
       guildmag=/usr/local/share/games/magneticscrolls/guild.mag
       guildgfx=/usr/local/share/games/magneticscrolls/guild.gfx
       ;guildmsdos=/usr/local/share/games/magneticscrolls/msdosversions/GUILD
       ;guildtworsc=/games/magneticscrolls/MSC/GTWO.RSC
       jinxtermag=/usr/local/share/games/magneticscrolls/jinxter.mag
       jinxtergfx=/usr/local/share/games/magneticscrolls/jinxter.gfx
       corruptionmag=/usr/local/share/games/magneticscrolls/ccorrupt.mag
       corruptiongfx=/usr/local/share/games/magneticscrolls/ccorrupt.gfx
       ;corruptiontworsc=/games/magneticscrolls/MSC/CTWO.RSC
       fishmag=/usr/local/share/games/magneticscrolls/fish.mag
       fishgfx=/usr/local/share/games/magneticscrolls/fish.gfx
       ;fishtworsc=/games/magneticscrolls/MSC/FTWO.RSC
       mythmag=/usr/local/share/games/magneticscrolls/myth.mag
       mythgfx=/usr/local/share/games/magneticscrolls/myth.gfx
       wonderlandmag=/usr/local/share/games/magneticscrolls/wonder.mag
       wonderlandgfx=/usr/local/share/games/magneticscrolls/wonder.gfx
       ;wonderlandtworsc=/games/magneticscrolls/WONDER/TWO.RSC
       [RANDOM]
       mode=pseudo
       ;mode=real
       seed=12345
       [DEFAULTGUI]
       rows=40
       columns=120
       ;align=left
       align=block
       ;align=right
       ;mode=none
       ;mode=monochrome
       ;mode=low_ansi
       mode=high_ansi
       ;mode=high_ansi2
       low_ansi_characters=Thomas
       monochrome_characters= .-=+*x#@$X

BUGS

       Report bugs to <dettus@dettus.net>.  Make sure to include DMAGNETIC somewhere in the subject.

AUTHOR

       Written by Thomas Dettbarn

SEE ALSO

       dMagnetic(1)

OpenBSD                                        February 11th, 2020                               dMagneticini(5)