home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Hack-Phreak Scene Programs
/
cleanhpvac.zip
/
cleanhpvac
/
M2000PWA.ZIP
/
MATRIX.DOC
< prev
next >
Wrap
Text File
|
1994-04-11
|
23KB
|
510 lines
MATRIX 2000 v1.0ß
(C)1994, The Calculus Group
Coded by Krhyptic
For PCBoard 15.1+
───────────
· 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 ·
──────────────────────────────
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.
- 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)
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
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
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
───────────────────────
· 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.
─────────────────────
· 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!