_________________ _____________ ___ .______________ _____________._____:_ . \ _____, / / _____, ' ^\ _____, ^\ / / : / ____)_/ __/_/ ____)_/ / ____)_/ / \_ __/ ,_____/ |/ ^\ ' ^\ \ \/ / \ / // /_\______^\: / / / / / / / / // // /| \_________/________/_______/___/ /\________/__/ / \____/ \________/ | `----------------------------- \___/ -->f!/opx<- \___/ -------------------' ÚÄÍÍÄÍÄÍÍÍÄÍÄÍÍÍÄÍÍÄÍÍÍÄÄÄÄÄ ³ SCRIPT 1.0 FOR PCB 15.21+ ÀÄÍÄÍÍÄÍÍÍÄÍÄÍÍÍÄÍÄÍÍÍÄÍÍÄÄÄÄ ÚÄÍÍÄÍÍÄÄÄ ³FEATURES ÀÄÍÍÍÄÄÄÄ Featured in this PPE is þ Easy setup þ Online viewing of answers (good for remote sysops) þ High configurability ÚÄÍÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄÄ ³SUPER QUICK INSTALLATION ÀÄÍÄÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄ In your CMD.LST put S 0 0 C:\PATH\SCRIPT.PPE SCRIPT ³ ³ ³ ³ command ³ charge ³ ³ ³ security path and program If you are serious about your board... continue reading... ÚÄÍÍÄÍÍÄÍÍÍÄÍÍÄÄ ³INSTALLATION ÀÄÍÄÍÄÍÍÄÍÍÄ 1. Replace the S command in your CMD.LST with SCRIPT.PPE. The parameter for SCRIPT.PPE, is which menu config file you will use. The config file supplied is SCRIPT.CFG Example 1: C:\PATH\SCRIPT.PPE SCRIPT This will use SCRIPT.CFG (for the menu) and will display the file SCRIPT.PCB (for the menu). As it so happens, SCRIPT.CFG is the one that you should use, since it is already set up with all the included scripts. Example 2: C:\PATH\SCRIPT.PPE APPLY This will use APPLY.CFG (for the menu) and will display the file APPLY.PCB (for the menu). 2. If neccessary, (and it should be), change the security levels in SCRIPT.CFG. ÚÄÍÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄÍÍÄÄÄÄÄÄÄ ³FORMAT FOR THE MENU CONFIG FILE ÀÄÍÄÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄ Every script consists of 4 lines. Line 1: MIN_SEC MAX_SEC Line 2: X Y SEC2SEE SCRIPTNAME Line 3: HIGHLIGHTED Line 4: NOTLIGHTED Explanation... MIN_SEC = Minimum security to see this script MAX_SEC = Maximum security to see this script X = X position to display Line 3 and Line 4 Y = Y position to display Line 3 and Line 4 SEC2SEE = Minimum security to [V]iew the answers SCRIPTNAME = The name of the script you want to run HIGHLIGHTED = Line to display when script is highlighted NOTLIGHTED = Line to display when script is not highlighted ÚÄÍÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄÍÍÄÄÄÄÄÄÄ ³FORMAT FOR THE SCRIPT CONFIG FILE ÀÄÍÄÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄ A script consists, mainly, of questions. These questions are stored in the display file, with a quick reference in their script config file. First, the config file begins with 3 lines, Line 1: DISPLAY_FILE Line 2: ANSWER_FILE Line 3: FORCEALL DISPLAY_FILE = Which file (in the current directory) scripter should display ANSWER_FILE = In which file (in the current directory) should the answers be appended to? FORCEALL = Must the user answer the questions? If NO, then he can abort out of the questionnaire. If YES, then he must answer all those questions which must be answered. Next, come the questions, and their configs... Each question consists of 2 lines. Line ?: QUICK_REF Line ?+1: X Y LEN COL [YES] QUICK_REF = A quick reference to the question on the screen. I mean, whichever the current question is on the screen, it should be written down here. X = At which X should the answer be written? Y = At which Y should the answer be written? LEN = Maximum length of the answer COL = @X color code of the answer [YES] = An optional parameter, specifying if you want to force the user to answer this question. YES will force him to answer the question. NO or anything else that isn't YES, will be NO. ÚÄÍÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄÍÍÄÄÄÄÄÄÄ ³INSTALLING A NEWUSER SCRIPT ÀÄÍÄÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄ If you want to run a script, without the menu, then, say we are about to install a newuser script, then you should... 1. Put SCRIPTER.PPE in you newuser logon script. As the parameter for scripter, the script name must be used. Example 1 !C:\PATH\SCRIPTER.PPE NEWUSER This will call the scripter program, the one that runs the scripts, not the menu, and it will use NEWUSER.CFG as the config file. From within that file, it will get all the info about the display file and stuff. Example 2 !C:\PATH\SCRIPTER.PPE INFO2ME This will call the scripter program, the one that runs the scripts, not the menu, and it will use INFO2ME.CFG as the config file. From within that file, it will get all the info about the display file and stuff. This script could ask the user about himself, so you can read it and have fun ... or something. ÚÄÍÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄÍÍÄÄÄÄÄÄÄ ³EXAMPLES FOR THE MENU CONFIG FILE ÀÄÍÄÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄ Example 1 20 255 10 15 20 HATE @X4F WHO DO YOU HATE? @X07 @X0F WHO DO YOU HATE? @X07 In this example, a script called HATE, will be displayed at 10x,15y if the user has more than security 19 and less than security 256. Users with a minimum security of 20 will be able to view this script. When highlighted, it will display "WHO DO YOU HATE?" in white on a red background, otherwise white on black. Example 2 50 255 10 15 110 CODER @X1F CoDeR aPPLiCaTioN @X07 @X0F CODER APPLICATION @X07 In this example, a script called CODER, will be displayed at 10x,15y if the user has more than security 49 and less than security 256. Users with a minimum security of 110 will be able to view this script. When highlighted, it will display "CoDeR aPPLiCaTioN" in white on a blue background, otherwise white on black. ÚÄÍÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÍÍÄÍÍÄÄÄÄÄÄÄ ³EXAMPLES FOR THE SCRIPT CONFIG FILE ÀÄÍÄÍÄÍÍÄÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄ Example NEWUSER.PCB NEWUSER.APP YES Your name 10 15 40 @X0F yes Your address 10 16 40 @X0B ... ... In this small config file, it will display the file NEWUSER.PCB. The answers it will append to NEWUSER.APP It will force the user to answer all those questions that you want answered. The first question is... Your name. (actually you can write a lot more in the display file and yet only have to write something short, like Address , in the config file) The first answer, shall be typed in at 10x,15y with a length of 40 characters max, in bright white (0F) and the user must answer it. The second question is... Your Address. (again, you can write a lot more in the display file and just write something to remind you what the question is in the config file). The second answer, shall be typed in at 10x,16y with a maximum length of 40 characters. It shall be in bright cyan.0B The question does not have to be answered. ÚÄÍÍÍÄÄÄ ³FILES ÀÍÍÍÄÍÄ The only files that should be in this archive should be SCRIPT.PPE - The menu system SCRIPT.PCB - Display file for the menu program SCRIPT.DOC - This DOC file SCRIPT.CFG - Display file for the menu program SCRIPTER.PPE - The script runner VIEWER.PCB - Answer viewer display file APP-FORM.ELT - You want to join ELT? ELEMENTS.NFO - The Elements info file FILE_ID.DIZ - I love these files... ***---SCRIPTS---*** BUG (.PCB + .CFG) - Bug report NEWUSER (.PCB + .CFG) - A sample newuser script HATE (.PCB + .CFG) - Who do you hate? BBSLIST (.PCB + .CFG) - BBS list CUSTOM (.PCB + .CFG) - Want a custom program? ÚÄÍÍÍÄÄÄ ³SCRIPTS ÀÍÍÍÄÍÄ Why not make script packets and distribute them? ÚÍÍÄÍÍÍÄÄÄ ³PROBLEMS ÀÍÄÍÍÄÄÄÄ If u set it up properly u won't have probbz. Although if u still have problems... Contact me on PowerHouse. //Let's start a RiOT