MATRIX 2000 v1.1 (C)1994, The Calculus Group Coded by Krhyptic For PCBoard 15.1+ Unregistered Version 컴컴컴컴컴� � History � 컴컴컴컴컴� This is the first version of Matrix 2000! It began when.... I discovered that all of the Matrix's for PCBoard were very limited and not configurable. Thats when I got the idea to develop the most configurable Matrix around. Configurablility, Lots of Options, Many Features of the Matrix make this Matrix the best in the west! This Matrix is very complex and requires time to setup. If you want to use all of its features, you can't expect to set it up in 5 mintues! 컴컴컴컴컴� � Options � 컴컴컴컴컴� This Matrix has the following Options: � Configurable LightBar / Menu Locations / Colors � Configurable Sysop Options � Sysop Definable Logon Screen, New User Screen, Infoforms � New User Voting PPE � Custom / Color Schemes � Paging / Comment Options � Text Configuration File � Optional Ansi / PCB Color Screens � Setup Program for easy Installation 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 � Installation of Matrix PPE � 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 First Time Installation: 1. Unzip MATRIX 2000 Zip file into a seperate Matrix Directory 2. Go into that directory 3. Run MATSETUP and press ESC 4. When it asks you if you want to update the PCBTEXT file press Y 5. Put in the Location of your PCBTEXT file 6. * MATSETUP will update the PCBTEXT file, create a NUV directory within the Matrix Directory, and backup your old PCBTEXT file * If you run MATSETUP.EXE for the first time, it will ask you when you exit if you want to update the PCBTEXT file. If you press Y for yes, you must have MKPCBTXT in your PATH and you must know the directory where PCBTEXT file is being stored. Usually this file is located in x:\PCB\GEN. When this operation has been completed, a file named PCBTEXT.DON is created in the Matrix directory. LEAVE this file as is. DO NOT delete it. Also, to have MATSETUP insert the proper directories in the PCBTEXT file, you must be running MATSETUP from the directory that Matrix 2000 is located. This PPE uses the PCBTEXT program along with your selected configuration file for that program to operate. You must insert the following data into the the PCBTEXT configuration file in order for the PPE to operate. These fields are required for the operation of the Matrix: - Insert "!C:\PCB\MATRIX\MATRIX.PPE" into: 'Enter your First Name' option (#259) - Insert "_" into: 'Enter your Last Name' option (#260) - Insert "_" into: 'Password (dots echo)' option (#148) - Insert "!C:\PCB\MATRIX\NEWUSER.PPE" into: 'Thanks @FIRST@, your registration info has been saved' option (#123) If you are going to be using the New User Voting System included, you must insert "!C:\PCB\MATRIX\NUV.PPE" into a screen whatever you want it. It may be best used in the logon screens after the user has been entered into the system. You must have all of these fields inputed. Substitute "C:\PCB\MATRIX" in the examples for your Matrix Directory. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � Configuration of Matrix PPE � 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� The PPE Uses a File Called 'MATRIX.CFG' which is located in the directory which the PPE is run from. For Example, if you run the PPE from within the directory 'C:\PCB\MATRIX' then the configuration file would be located in the 'C:\PCB\MATRIX' directory. It is VERY important that this file remain intact and in working condition as it is required for every task that the Matrix does. The configuration process will be explained in expliced detail, and it is important that it be followed in that manner. To execute the Setup, run the program MATSETUP.EXE which is included in the Matrix 2000 package. The following is a list of what each line means if in the file 'MATRIX.CFG' for reference for manual editing. (NOTE: X - Vertical Y - Horizontal) ****************************** NOTE ******************************* * THE LINE NUMBERS LISTED HERE ARE NOT THE OPTION NUMBERS FOR * * MATSETUP.EXE. THESE ARE THE LINE NUMBERS FOR MATRIX.CFG. THE * * MATRIX SETUP HAS SCRAMBLED LINE NUMBERS. * ******************************************************************* 1 - Color of Non-Highlighted Matrix bar for MATRIX.SCR 2 - Color of Highlighted Matrix bar for MATRIX.SCR 3 - Logon to BBS String Name for MATRIX.SCR 4 - X Position for #3 on MATRIX.SCR 5 - Y Position for #3 on MATRIX.SCR 6 - Apply for Access String Name for MATRIX.SCR 7 - X Position for #6 on MATRIX.SCR 8 - Y Position for #6 on MATRIX.SCR 9 - Check for Access String Name for MATRIX.SCR 10 - X Position for #9 on MATRIX.SCR 11 - Y Position for #9 on MATRIX.SCR 12 - Page the Sysop String Name for MATRIX.SCR 13 - X Position for #12 on MATRIX.SCR 14 - Y Position for #12 on MATRIX.SCR 15 - Feedback to the Sysop String Name for MATRIX.SCR 16 - X Position for #15 on MATRIX.SCR 17 - Y Position for #15 on MATRIX.SCR 18 - Logoff the Matrix String Name for MATRIX.SCR 19 - X Position for #18 on MATRIX.SCR 20 - Y Position for #18 on MATRIX.SCR 21 - Maximum Lines for Feedback for MATRIX.SCR 22 - Color Scheme for Feedback 23 - Message Subject for Feedback (1 for User Prompt) 24 - Conference # of Feedback Message 25 - Sysop Name for Feedback 26 - Ammount of Time Added for Message Entering 27 - Total Message Allowed to Enter Online 28 - Total Pages Allowed to Execute Online 29 - Page Time in Seconds 30 - Line for Error / Prompting Messages in MATRIX.SCR 31 - Confirm Logoff (1 for Yes / 0 for No) 32 - System Access Password (0 for None) 33 - Ammount of Time Added at Matrix Execution 34 - Total Tries on Logon to BBS before Logoff 35 - X Position for User Name on LOGON.SCR 36 - Y Position for User Name on LOGON.SCR 37 - X Position for User Password on LOGON.SCR 38 - Y Position for User Password on LOGON.SCR 39 - X Position for User Name on NEWUSER.SCR 40 - Y Position for User Name on NEWUSER.SCR 41 - Length of User Name on NEWUSER.SCR 42 - X Position for Password on NEWUSER.SCR 43 - Y Position for Password on NEWUSER.SCR 44 - Length of Password on NEWUSER.SCR 45 - X Position for Verify Password on NEWUSER.SCR 46 - Y Position for Verify Password on NEWUSER.SCR 47 - Length of Verify Password on NEWUSER.SCR 48 - X Position for City & State on NEWUSER.SCR 49 - Y Position for City & State on NEWUSER.SCR 50 - Length of City & State on NEWUSER.SCR 51 - X Position for Business Phone on NEWUSER.SCR 52 - Y Position for Business Phone on NEWUSER.SCR 53 - Length of Business Phone on NEWUSER.SCR 54 - X Position for Home Phone on NEWUSER.SCR 55 - Y Position for Home Phone on NEWUSER.SCR 56 - Length of Home Phone on NEWUSER.SCR 57 - X Position for CPU Type on NEWUSER.SCR 58 - Y Position for CPU Type on NEWUSER.SCR 59 - Length of CPU Type on NEWUSER.SCR 60 - X Position for Message Clear Screen on NEWUSER.SCR 61 - Y Position for Message Clear Screen on NEWUSER.SCR 62 - X Position for User Comment on NEWUSER.SCR 63 - Y Position for User Comment on NEWUSER.SCR 64 - Length of User Comment on NEWUSER.SCR 65 - Minimum Password Length 66 - Entry Tries for Applying before Logoff 67 - Line # for Error Messages on NEWUSER.SCR 68 - String to Stuff to Keyboard on Hangup 69 - Enter New User Message (1 for Yes / 0 for No) 70 - Color of Non-Highlighted Matrix bar for FORM.SCR 71 - Color of Highlighted Matrix bar for FORM.SCR 72 - Form #1 Name for FORM.SCR 73 - X Position for Form #1 on FORM.SCR 74 - Y Position for Form #1 on FORM.SCR 75 - Form #1 Active? (1 for Yes / 0 for No) 76 - Form #2 Name for FORM.SCR 77 - X Position for Form #2 on FORM.SCR 78 - Y Position for Form #2 on FORM.SCR 79 - Form #2 Active? (1 for Yes / 0 for No) 80 - Form #3 Name for FORM.SCR 81 - X Position for Form #3 on FORM.SCR 82 - Y Position for Form #3 on FORM.SCR 83 - Form #3 Active? (1 for Yes / 0 for No) 84 - Form #4 Name for FORM.SCR 85 - X Position for Form #4 on FORM.SCR 86 - Y Position for Form #4 on FORM.SCR 87 - Form #4 Active? (1 for Yes / 0 for No) 88 - Form #5 Name for FORM.SCR 89 - X Position for Form #5 on FORM.SCR 90 - Y Position for Form #5 on FORM.SCR 91 - Form #5 Active? (1 for Yes / 0 for No) 92 - Use Infoforms? (1 for Yes / 0 for No) 93 - Minimum New User Voting Level 94 - Maximum New User Voting Level 95 - # of Yes Votes for Validation 96 - # of No Votes for Access Denied 97 - Access Level if Validated 98 - Access Level if Not Validated 99 - Do Votes Require Sysop Vote? 100 - X Position for User Name on VOTING.SCR 101 - Y Position for User Name on VOTING.SCR 102 - Color for User Name on VOTING.SCR 103 - X Position for # of Yes Votes on VOTING.SCR 104 - Y Position for # of Yes Votes on VOTING.SCR 105 - Color for # of Yes Votes on VOTING.SCR 106 - X Position for # of No Votes on VOTING.SCR 107 - Y Position for # of No Votes on VOTING.SCR 108 - Color for # of No Votes on VOTING.SCR 109 - X Position for # of Abstain Votes on VOTING.SCR 110 - Y Position for # of Abstain Votes on VOTING.SCR 111 - Color for # of Abstain Votes on VOTING.SCR 112 - X Position for Beginning Comments on VOTING.SCR 113 - Y Position for Beginning Comments on VOTING.SCR 114 - Maximum # of Comments to be Displayed on VOTING.SCR 115 - Color for Comments on VOTING.SCR 116 - Maximum Length of Comments on VOTING.SCR and User Input 117 - Yes Option Name on VOTING.SCR (Menu) 118 - X Position for Yes Option on VOTING.SCR 119 - Y Position for Yes Option on VOTING.SCR 120 - No Option Name on VOTING.SCR (Menu) 121 - X Position for No Option on VOTING.SCR 122 - Y Position for No Option on VOTING.SCR 123 - Abstain Option Name on VOTING.SCR (Menu) 124 - X Position for Abstain Option on VOTING.SCR 125 - Y Position for Abstain Option on VOTING.SCR 126 - View Infoform Option Name on VOTING.SCR (Menu) 127 - X Position for View Infoform Option on VOTING.SCR 128 - Y Position for View Infoform Option on VOTING.SCR 129 - Color of Non-Highlighted Matrix bar for VOTING.SCR 130 - Color of Highlighted Matrix bar for VOTING.SCR 131 - Bullet Color for Comments on VOTING.SCR 132 - Bullet ASCII Character for Comments on VOTING.SCR 133 - Line for 'Press Enter' Message on FORM.5 134 - Show Infoform #5 Answers in What Color 135 - Line for Comments 136 - New User Password (Enter 1 to Disable NUP) 137 - Error Message Line for LOGON.SCR 138 - Security Level of User to Give Password on Check for Access 139 - Does User Have to Exist for Feedback / Page on Matrix 140 - Sysop Voting Name if Option #99 is Enabled 141 - *** Registration Name *** 142 - *** Registration Code *** 143 - *** Registration Verify Code *** 144 - If Logged on local - when hangup was selected, hangup and recycle PCBoard or Just Quit Matrix. (0 for hangup / 1 for quit matrix) * For Testing purposes. NOT IN MATSETUP.EXE! * 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 � Configuration of Text File � 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Along with the Configuration File, a file called TEXT.CFG will you to define Input Messages, Error Messages, and Display Screens in the PCBoard @X format. The Following is a list of Definable Options for Text Output: The Options with the * sign beside them will allow a File to be displayed or just the Text that is in the Field. If you wish for a file to be shown instead of the Text, you put the percentage sign (%) in front of the File Name: ex. %SCREEN.SCR Line Example / # Description ---- -------------------------------------------------------------------- 1 User Feedback � [*] Displayed when User Goes to Feedback 2 To: � Displayed when User Enters a Message 3 From: � Displayed when User is Asked for Name 4 Subject: � Displayed when User is Asked for Subject 5 Aborting Message... � Displayed when User Aborts Entering a Message 6 Saving Message... � Displayed when User Saves a Message 7 Page Sysop � [*] Displayed when User Goes to Page Sysop 8 Reason: � Displayed when User is Asked for Reason of Page 9 User Name: � Displayed when User is Asked for Paging Name 10 Paging Sysop � Displayed when Actual Paging is Taking Place 11 ... � Echo Dots for Paging Seconds.. Ex. Paging Sysop............ 12 Sysop must be out to lunch! � Displayed when Sysop has not answered Chat 13 Goodbye � [*] Displayed when the User Logs Off the Matrix 14-16 Welcome Screens � [*] Screens that you wish to be displayed when user passes System Password (These files don't have to have the % sign in front of them!) 17 System Logon � [*] Displayed when User tries to Logon to bbs. Displayed prior to User Input of System Password 18 System Password: � Displayed when User is Asked for System Password 19 Incorrect Password... � Displayed when User has entered an Incorrect Password 20 Too many tries... Logging Off... � Displayed when User Exceeds Tries for Inputing 21 Applying for Access � [*] Displayed after user has Entered the NUP Sucessfully 22 You are on the Systems Blacklist, Get Lost! � [*] Displayed when User Name is found in BLACKLST.SCR 23 Password must be at least 4 characters long! � Displayed when User has inputed a Password which has a length less than required and should be changed to coincide with your minimum in PCBSetup 24 Too many Tries! � Displayed when User has gone over the limit of tries for entering his / her name, Subject on Page / Feedback 25 You may only Leave 3 Comments to the Sysop per Call � Displayed when user has exceeded Maximum # of comments 26 You may only Page the Sysop 3 Times per Call � Displayed when user has exceeded Maximum # of Pages 27 Call back in 48 Hours to see if you were Validated � Displayed when User has finished entering all New User Information and is about to be logged off 28 Press [SPACEBAR] to Answer Page � Displayed ONLY on Sysops End. Can not contain any PCBoard @X Codes. Displayed when User is Paging Sysop 29 Please Wait while all Data is Entered � Displayed before All data is entered into PCBoards User Config File 30 Are you sure you want to Logoff? � Displayed if User is being inputed to Logoff and User has tried to logoff 31 New User Password � [*] Displayed prior to the user being asked to input the New User Password 32 New User Password: � Displayed when User is being Asked to enter the New User Password 33 Sorry, That User Already Exists! � Displayed when User already exists 34 Sorry, That User Does Not Exist! � Displayed when User Does Not exist 35 You have been Validated! � Displayed when User has been Validated 36 You have not been Validated! � Displayed when User had not been Validated 37 Leave Comment? � Displayed when User is Asked if he / she wants to enter a Comment for other voters about the user being voted on 38 Comment: � Displayed when User is Asked for the Comment if YES for #37 39 New User Message � [*] Displayed prior to the user being prompted for the New User Message 40 Press [ESC] to Abort Page � This Message is displayed to the user when they are paging the Sysop. It tells them that they can press enter to abort Page. NOTE: Escape Aborts Paging 41 Yes Votes � This is displayed when the user goes to 'Check for Access' and is shown the # of YES Votes 42 No Votes � This is displayed when the user goes to 'Check for Access' and is shown the # of NO Votes 컴컴컴컴컴컴컴컴컴컴컴� � Text / Config Files � 컴컴컴컴컴컴컴컴컴컴컴� * NOTE * The Files with the * beside them are essential in the operation of Matrix 2000 and should not be modified! All other files listed can be modified to Sysops preference. The Files with the ! beside them indicate that if these file do not exist, the Matrix will not execute. Many Files can be used to help enhance the appearence or quality of the Matrix. Here is a list of Files that are available for use: NOTE: * - Do not modify file ! - Needed for operation File Name Description -------------- -------------------------------------------------------------- MATRIX.PPE * This is the Main Matrix File. If this file does not exist, then you are Missing the Main Part! NEWUSER.PPE * This is a File Used to aid the New User Procedure. If this File does not exist, then the Matrix will not execute! ANSI.PPE * This is an option file. It forces ANSI and should be used since the Matrix requires Graphics to be enabled. MATRIX.CFG ! This is the Main Configuration File for the Matrix. If this File does not exist, the PPE will not execute! TEXT.CFG ! This is the Main Text Configuration File for the Matrix. If This File does not exist, the PPE will not execute! MATRIX.SCR ! This is the Main ANSI/Graphical File for the Matrix. This is the File displayed at the beginning and should include the following Options in this Order: - Logon to BBS - Apply for Access - Check for Access - Page the Sysop - Leave Feedback - Logoff the Matrix LOGON.SCR This is the ANSI/Graphical File for The Logon Procedure. This Picture should contain a place for the User to Input his / her Name and Password. This File is required for the Matrix's operation NEWUSER.SCR This is the ANSI/Graphical File for The New User Procedure. This Picture should contain the following fields: - User Name/Alias [Default Len: 25] - Password [Default Len: 13] - Password Verify [Default Len: 13] - City & State [Default Len: 25] - Business Phone # [Default Len: 13] - Home Phone # [Default Len: 13] - CPU Type [Default Len: 14] - Message Clear Screen? - User Comment [Default Len: 40] BLACKLST.SCR This is a file that is a list of Users that will not be allowed access to the system when applying. If the user is detected in this File, The Text or File displayed can be set in the TEXT.CFG file in Line #22 VOTING.SCR This is the ANSI/Graphical File Used for the New User Voting Screen by NUV.PPE. This file is needed. It should include fields for the Following Information: - User Name - # of Yes Votes - # of No Votes - # of Abstain Votes - Comments This ANSI/Graphical File should also contain a place for a lightbar menu which should include the following options: - Yes - No - Abstain - View Infoform FORM.1-5 This is the Graphical Infoform File(s). The Form # is indicated by the extension on the file. 1,2,3,4, or 5. CONFIG.1-5 This is the Config file used for the same FORM screen with the same extension. This file contains the following information in the following order: - # of Questions in Infoform / - Type of Input / � Enter '1' for All ASCII Characters / � Enter '2' for Only Numbers / � Enter '3' for Only Letters Repeat for/ � Enter '4' for Numbers + Letters # of questions \ � Enter '0' and other Characters in Infoform \ ex. 0ABCDEF123 (allowed: A,B,C,D,E,F,1,2,3) \ - Maximum Length of Answer \ - X Position of Question \ - Y Position of Question EXAMPLE ------- 19 <--- 19 Questions 3 <--- Letters Only \ 10 <--- 10 Chars Max \ Option 1 / 19 - 10 <--- X Pos - 10 / Repeat 19 Times 5 <--- Y Pos - 5 / COMMENT.TMP * This is a temperary file used to enter messages. This file must not be tampered with! MATRIX.TMP * This is a temperary file used for storing information when passing the Matrix on to other PPE's. This file must not be tampered with! USERS.VOT * This is a file used for storing User Voting Information. This File must not be tampered with! PCBTEXT.DON * This file is created by MATSETUP.EXE after you have completed inserting all information into the PCBTEXT file. This is a 0 byte file. DO NOT DELETE! \NUV * This directory will be created when you first run MATSETUP and insert all the data into the PCBTEXT. DO NOT REMOVE THIS DIRECTORY. 컴컴컴컴컴컴컴컴컴� General Matrix Use 컴컴컴컴컴컴컴컴컴� 1. Navigation around the Matrix's lightbar menu system can be done with the following Keys: A or UP ARROW - Move Lightbar Up Z or DOWN ARROW - Move Lightbar Down SPACEBAR - Move Lightbar Through All Options 2. The New User Voting System's use of natigating Keys are as follows: A or LEFT ARROW or UP ARROW - Move Lightbar Up / Left Z or RIGHT ARROW or DOWN ARROW - Move Lightbar down / Right SPACEBAR - Move Lightbar Through All Options NOTE: The Lightbar Menu in the NUV system can be Horizontal or Vertical. That is why both Arrow keys work to navigate. To Exit the User Infoform Selection Screen, Press ESCAPE or Q NOTE: The Sysop can abort voting by pressing ESCAPE in the NUV Matrix 3. When the User is Paging the Sysop and the Sysop Answers the Page by pressing [SPACEBAR], the PPE calls the normal CHAT which is whatever Chat program / PCBChat you are using. 컴컴컴컴컴컴컴컴컴컴� � Errors � Problems � 컴컴컴컴컴컴컴컴컴컴� Several problems may occur in the operation of the Matrix. For example, you may get an error message that says: 'Configuration File Missing... (Filename.ext). Please report this to the sysop.' These errors can be corrected by following the guide above and reviewing your files and checking to see if there are there or not. Any error's or �ugs encountered should be reported to the Author via the following addresses/bbs's listed at the end of the document. 컴컴컴컴컴컴컴컴 � Registration � 컴컴컴컴컴컴컴컴 Support shareware!! This software is only $10 to register. When registered, you will recieve a Infoform Maker which will assist you in producing Infoforms. You will also recieve extra utils. Only $10US To get an address to send $10 and recieve registration codes. To contact Krhyptic (author): 1. H.A.U. [Help All Users] / Calculus WHQ Area Code: 403 Sysop: Dream WEaver OR 2. AttitudeNet at address 76:400/108! OR 3. PPL Net