                                          ___
                             ,----.     ,--.'|_
                            /   /  \-.  |  | :,'   __  ,-.
                 ,--,  ,--,|   :    :|  :  : ' : ,' ,'/ /|
                 |'. \/ .`||   | .\  ..;__,'  /  '  | |' |
                 '  \/  / ;.   ; |:  ||  |   |   |  |   ,'
                  \  \.' / '   .  \  |:__,'| :   '  :  /
                   \  ;  ;  \   `.   |  '  : |__ |  | '
                  / \  \  \  `--'""| |  |  | '.'|;  : |
                ./__;   ;  \   |   | |  ;  :    ;|  , ;
                |   :/\  \ ;   |   | :  |  ,   /  ---'
                `---'  `--`    `---'.|   ---`-'
                                 `---`                                 08/2017
------------------------------------------------------------------------------

                                   AmiCaller                                   
                                 First Release                                 
                             For Mystic BBS 1.12+

Software --------------------------------------------------------------------
       [ ] PCB PPe      [ ] OBV          [ ] VGA         [ ] OTHER___________
       [ ] Renegade     [ ] Iiniquity    [ ] ASCII       [ ] HTML/CGI/WWW
       [x] Mystic       [ ] WWVI         [ ] Telegard    [x] MPL
       [ ] ANSI         [ ] TEXT
OS --------------------------------------------------------------------------
    [ ] dos  [ ] os/2  [ ] windows [x] Win32 [x] *nix [x] RPI Linux
Type ------------------------------------------------------------------------
                infoform [ ]   utility [ ]  misc [x]  door [ ]

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
                  ____  _           __      _
                 / __ \(_)_________/ /___ _(_)___ ___  ___  _____
                / / / / / ___/ ___/ / __ `/ / __ `__ \/ _ \/ ___/
               / /_/ / (__  ) /__/ / /_/ / / / / / / /  __/ /
              /_____/_/____/\___/_/\__,_/_/_/ /_/ /_/\___/_/

   The author has taken every precaution to insure that no harm or damage
will occur on computer systems operating this util.  Never the less, the
author will NOT be held liable for whatever may happen on your computer
system or to any computer systems which connects to your own as a result of
operating this util.  The user assumes full responsibility for the correct
operation of this software package, whether harm or damage results from
software error, hardware malfunction, or operator error.  NO warranties are
offered, expressly stated or implied, including without limitation or
restriction any warranties of operation for a particular purpose and/or
merchant ability.  If you do not agree with this then do NOT use this
program.


-------------------------------------------------------------------------------
                ____                      _       __  _
               / __ \___  _______________(_)___  / /_(_)___  ____
              / / / / _ \/ ___/ ___/ ___/ / __ \/ __/ / __ \/ __ \
             / /_/ /  __(__  ) /__/ /  / / /_/ / /_/ / /_/ / / / /
            /_____/\___/____/\___/_/  /_/ .___/\__/_/\____/_/ /_/
                                       /_/

  This is a simple (or not ;) ) last callers script, wanted from Zero Reader
of Alcoholiday BBS. It imitates the use and feel of an old script from the
era of the Amiga BBSes.

Features:
 - Display Last Callers (obviously...)
 - Track Online Time of Users
 - Track Upload/Donwload traffic of user
 - Display if a user is new
 - Total stats for Today/Yesterday (calls,
   posts, Upload/Download traffic, total users)
 - Flags. Track users movement inside the BBS,
   if they downloaded any files, if they made a
   post end more.
 - Make your own custom flags.

  The script is compatible with Linux/RPi and tested. Works also in Windows, but
its not tested.

-------------------------------------------------------------------------------
                ____           __        ____      __  _
               /  _/___  _____/ /_____ _/ / /___ _/ /_(_)___  ____
               / // __ \/ ___/ __/ __ `/ / / __ `/ __/ / __ \/ __ \
             _/ // / / (__  ) /_/ /_/ / / / /_/ / /_/ / /_/ / / / /
            /___/_/ /_/____/\__/\__,_/_/_/\__,_/\__/_/\____/_/ /_/

.oO Unzip the archive inside Mystics Scripts folder. Everything needed is inside
the package.

.oO Compile the two scripts with mplc:

    ./mplc amicaller.mps
            &
    ./mplc xq-lcflags.mps

  The main script is amicallers.mps. xq-lcflags is needed for amicaller to
work. It saves user data to callers.dat file and sets the flags.

  Read "Usage" for more information on how to use it.

-------------------------------------------------------------------------------
           ______            _____                        __  _
          / ____/___  ____  / __(_)___ ___  ___________ _/ /_(_)___  ____
         / /   / __ \/ __ \/ /_/ / __ `/ / / / ___/ __ `/ __/ / __ \/ __ \
        / /___/ /_/ / / / / __/ / /_/ / /_/ / /  / /_/ / /_/ / /_/ / / / /
        \____/\____/_/ /_/_/ /_/\__, /\__,_/_/   \__,_/\__/_/\____/_/ /_/
                               /____/

  Just edit the files (ANS, MPS) to get the script to your preferences.
  For basic stuff, changing the constants on top of the file will do and edit
  the ansi file.

-------------------------------------------------------------------------------
                           __  __
                          / / / /________ _____ ____
                         / / / / ___/ __ `/ __ `/ _ \
                        / /_/ (__  ) /_/ / /_/ /  __/
                        \____/____/\__,_/\__, /\___/
                                        /____/

.oO0( AMICALLER.MPS )0Oo.

  Insert a command inside your menu, with Mystic Configuration, like this:

  Usage           : amicaller

  No options are needed.

  Example:

          Command | (GX) Execute MPL program
             Data | amicaller
           Access |
          Execute | Select

.oO0( XQ-LCFLAGS.MPS )0Oo.

  This script must be executed multiple times for the amicaller.mps to work
properly. The script itself has three options to use:

  Usage           : xq-lcflags <options>

  Options        

           logoff : Apply this option when user logs off the BBS
            login : Apply this option when user logs in
   <slot> <value> : With this syntax you can make/apply custom flags to be
                    displayed in the amicaller screen.


  1. In your login sequence enter/insert this command once: xq-lcflags login
  2. In your logout menu, insert this command: xq-lcflags logout, right
     before the BBS closes the connection.


 ___ _
| __| |__ _ __ _ ___
| _|| / _` / _` (_-<
|_| |_\__,_\__, /__/
           |___/    

  If you want to keep track where the logged in users go, inside your BBS,
you can set custom flags. Lets see an example. We want to know and raise a
flag when users go to play DOOR games or even a particular one.

  In the command that executed the DOOR game or displays the DOORs menu,
insert a command like this: xq-lcflags 5 1. This will set the value 1 in slot
no 5. You have about 30 slots to use from 1 to 30 and their values can be
1-255.

  OK... now we set a flag, but we want to display it when the amicaller
script executes. For that, you have to edit the amicaller script and about
line 250 you will see something like this:

 If OneUser.Reserved[2] = 1 Then Str := Str + 'C' Else Str := Str + '-';

  Copy and paste this line once and changed it like this:

 If OneUser.Reserved[5] = 1 Then Str := Str + 'D' Else Str := Str + '-';

  Got it? Inside the brackets [] we entered our slot number (5) from above
and told the script, that when the value of this slot is 1, display a D, else
display a dash. Compile and test the script to watch what it does. If you
done all right, then if you played that exactly DOOR game, it will show up in
the last callers ANSI screen.

  You can make all sorts of flags... when a users executed a specific script,
enters an area, plays a game, browses the message/file areas etc.

-------------------------------------------------------------------------------
                                _______ __
                               / ____(_) /__  _____
                              / /_  / / / _ \/ ___/
                             / __/ / / /  __(__  )
                            /_/   /_/_/\___/____/


+-- file_id.diz
+-- sysop.txt
+-- amicaller
|   +-- lastcaller.ans          // ANSI Screen
+-- amicaller.mps               // Mystic Script
+-- xq-lcflags.mps              // Mystic Script


------------------------------------------------------------------------------
            _______                   ____  ___      __
           / ____(_)  _____  _____  _/_/ / / (_)____/ /_____  _______  __
          / /_  / / |/_/ _ \/ ___/_/_// /_/ / / ___/ __/ __ \/ ___/ / / /
         / __/ / />  </  __(__  )/_/ / __  / (__  ) /_/ /_/ / /  / /_/ /
        /_/   /_/_/|_|\___/____/_/  /_/ /_/_/____/\__/\____/_/   \__, /
                                                                /____/


.oO First Release...  08/2017

-------------------------------------------------------------------------------
                       ______            __             __
                      / ____/___  ____  / /_____ ______/ /_
                     / /   / __ \/ __ \/ __/ __ `/ ___/ __/
                    / /___/ /_/ / / / / /_/ /_/ / /__/ /_
                    \____/\____/_/ /_/\__/\__,_/\___/\__/

Liked this script? Want more? Make a visit at my BBS and think of living a
donation to my Paypal account. :) [paypal.me/xqtr]

   _            _   _              ___          _    _
  /_\  _ _  ___| |_| |_  ___ _ _  |   \ _ _ ___(_)__| |               8888
 / _ \| ' \/ _ \  _| ' \/ -_) '_| | |) | '_/ _ \ / _` |            8 888888 8
/_/ \_\_||_\___/\__|_||_\___|_|   |___/|_| \___/_\__,_|            8888888888
                                                                   8888888888
         DoNt Be aNoTHeR DrOiD fOR tHe SySteM                      88 8888 88
                                                                   8888888888
    .o HaM RaDiO    .o ANSi ARt!       .o MySTiC MoDS              "88||||88"
    .o NeWS         .o WeATheR         .o FiLEs                     ""8888""
    .o GaMeS        .o TeXtFiLeS       .o PrEPardNeSS                  88
    .o TuTors       .o bOOkS/PdFs      .o SuRVaViLiSM          8 8 88888888888
    .o FsxNet       .o SurvNet         .o More...            888 8888][][][888
                                                               8 888888##88888
   TeLNeT : andr01d.zapto.org:9999 [UTC 11:00 - 20:00]         8 8888.####.888
   SySoP  : xqtr                   eMAiL: xqtr.xqtr@gmail.com  8 8888##88##888
------------------------------------------------------------------------------

