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)