
                      Ŀ
                      ͵
                                 Studs!           
                      ͵
                      *  (C)2004 - BBSFiles.com    *
                      *                            *
                      *         original           *
                        (c)1992,93 T&J Software   
                      


                    Ŀ
                      VERSION 1.50     March 28, 1993 
                    

                                    By

                             Tom & Jane Wildoner


Ŀ
LATEST VERSION


Please visit http://BBSFiles.com for the latest version of this program.

Ŀ
LEGALITIES


THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
DISTRIBUTION OF THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.

Ŀ
DISTRIBUTION


You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author.

Ŀ
PROGRAM DESCRIPTION


Studs! is an adult door game. With Studs!, your object is to become the
ALLTIME stud on the board! The program is sysop configurable for number
of women per day and number of times the user may enter the door per day
and the amount of time allowed in the door and some other options!

MAIN MENU:


V- View the ALLTIME High Score (the best stud to date).
B- Buy condoms. Once you get to the BUY CONDOMS screen, you will have
   three options: B- Buy a box of 10 condoms, U- Buy a box of 10 used
   condoms or L- to leave (back to the main menu).
Q- QUIT the game.
R- Redraw the screen (in case of line garbage, etc.).
H- Will bring up the help screens.
D- Will take you to the DOCTOR screen.
P- Pick up girls! This is where you earn your keep! After selecting P,
   a listing of four bar names will appear. Select the bar that you
   wish to goto and try to pick up girls.
S- Buy a Lotto Ticket. Tickets cost $10 each and the user has the
   possibility of winning the jackpot or three extra girls!
T- View the current TOP TEN listing.
M- Message area to leave others messages.

THE DOCTORS MENU:


Once you get to the doctor's menu, the nurse will inform you how much it
will cost you to see the doctor. Just select S if you want to see him or
F to leave.

Once your with the doctor you have the following options:

1- Perform a test for Syphilis -- yep, you can get diseases in this game!
   Keep an eye on your HEALTH!
2- Perform a test for Gonorrhea.
3- General Health Exam. The Doc will let you know how you are doing.
4- Penis Enlargement Operation. It's costly, but you'll do better in the
   long run. There is always a chance that it will not work!
5- Increase Staying Power Operation. This is also costly, but the user
   will be able to "last" longer if it is successful.
6- Leave the office.

Your health will be the main indicator if you have contracted a disease!
Some of the costs will vary depending on how much money the user has.

PICKING UP GIRLS:


After selecting a bar, you will have two options, L- Look for a girl or
Q- to QUIT back to the main menu. When you look for a girl, one will
approach you -- you will be told her name, what she looks like and
her approximate age. From here you may elect to T- Take her home or
P- to pass on her. If you select T, you will go to the bedroom menu,
if you select P, you will go back to the bar menu and lose one pick
for the day.

NOTE: Not all women will be interested in you! If your KNOWN score is
less than zero, there is a percent chance SHE will pass on you!


IN THE BEDROOM:


T- You can talk to the girl. If she doesn't want to talk the user will
   lose some "known" points.
D- You can offer her a drink. If she accepts, it won't take as much to
   satisfy her once you start screwing. Here again, if the woman doesn't
   want a drink, the user will lose some "known" points.
F- You may "feel her up". Women aren't always what they appear! Enough
   said here. She could be several different things icluding an
   undercover police officer!
P- You may put a condom on. Not all woman want a man to use a condom.
   She'll let you know what she wants. If you wear a condom, you won't
   contract any disease. You'll get paid less if you wear one and she
   doesn't want you to.
S- Start screwing. You'll be presented with another screen for this!

Once you start screwing, you'll be shown your power left, how much power
it will take to satisfy her and the percentage of satisfaction you have
accomplished.

If your power is greater than what she needs you won't have to much to
worry about. Just keep hitting the P key until she reaches 100%. However,
if your power goes below zero and she isn't 100% satisfied, that means
that you have cum early! You will only get partial payment and you will
be "less known".

If your power is less than what she needs hit the S key before you run
out of power. Get her percentage up as high as possible!

You are paid based upon how well you do! The better "known" you are
will also increase the amount of payment! If you completely satisfy her,
you will get full payment and your "known" field will increase!

If your health drops too low, girls won't have anything to do with you.

There is a chance that the user could end up with a hopeless character.
In such a case, the user will be allowed to regenerate themselves the
next time they play.

Ŀ
NOTE


The STUDS!.KEY file that is distributed with this door does NOT expire!
This is simply here so the door has a KEY to read. When you register,
you will receive a new STUDS!.KEY file.

Your users are only allowed THREE girls and can only enter the door
ONE time per day until registered. Also, the user will be limited to
THREE lotto tickets until registered.

Player statistics are saved everytime they goto the main menu. So,
just in case they aren't doing very well and they drop carrier, their
stats will have been saved.

Ŀ
FEATURES

           --- Desqview Aware.
           --- COM0-15 support and non-standard IRQ's.
           --- Colorful ANSI screens.
           --- Chat function.
           --- NO BRUN module needed for play.
           --- BETA tested on six different boards.
           --- Will return to BBS on dropped carrier.
           --- Will TIMEOUT a player after 5 minutes of no activity.
           --- Use of HOT KEYS while in the door.
           --- Support BBS available.
           --- TOP TEN bulletins.
           --- SysOp configurable.
           --- Blanking of local screen.
           --- Fossil driver support.

Ŀ
INSTALLATION


Run the STUDUTIL program for easy installation!!

Next, RESET the DOOR!! Select number 2 from the UTILITY program! This
will reset everything from scratch.

Next, select number 3, set the STUDS!.CFG file -- answer all the
questions here.

Next, select number 4, set the SYSOP.CFG file. This will ask you
how many girls per day per player, path to your color bulletin, path
to your ASCII bulletin, how many times they can enter the door per
day, how many lotto tickets can be purchased today and how much time
they get per play.

If you set the number of girls to 15 and the number of times the may
enter the door to 3, it means they get 15 girls for the entire DAY!
If they use 10 girls during their first entry to the game, the second
time they enter the door they will only have 5 left.

Ŀ
CONFIGURATION: (Your STUDS!.CFG file)


Example configuration file for PCBOARD.SYS
------------------------------------------

C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for USERS.SYS
----------------------------------------

C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for DOOR.SYS
---------------------------------------

C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for USERINFO.DAT
-------------------------------------------

C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)
NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT

Example configuration file for CALLINFO.BBS
-------------------------------------------

C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for DORINFOx.DEF
-------------------------------------------

C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
                          where 'x' is the BBS Node number.
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for SFDOORS.DAT
------------------------------------------

C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for CHAIN.TXT
----------------------------------------

C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for GTUSER.BBS
-----------------------------------------

C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)
1                   <=-  (COM port number - defaults to 1)
1                   <=-  (Node number - defaults to 1)

Ŀ
Example Batch File


   ECHO OFF
   CD\DOORS\STUDS           <=- Switch to the door's Directory.
   STUDS! STUDS!.CFG        <=- Execute the door program and pass the
                                configuration filename to the program.
   CD\PCB                   <=- Go back to PCB DIR when user exits door.
   BOARD                    <=- Restart BBS.

This Door is multi-node  compatible so you may run more than 1 node from
the same .CFG file provided the path to your system file (DORINFOx.DEF,
CALLINFO.BBS, etc) is exactly the same unless you are using environment
variables, (q.v.)

Please see your BBS documentation on setting up doors.

Ŀ
Environment Variables


PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
variables. Non-PCBoard systems may also use these variables by including
the following in either your BBS batch or AUTOEXEC.BAT
  SET PCBDRIVE=C:               <- Drive letter of your BBS files
  SET PCBDIR=\BBSDIR            <- Path to your BBS files
Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CFG file for multi-node operation!

To specify a non-standard IRQ, put the IRQ number after the .CFG on the
command line.  For example:

     STUDS! STUDS!.CFG /5
or using the PCBDRIVE procedure:   SET IRQ=5   and use
     STUDS! STUDS!.CFG /%IRQ%

This tells the program to use IRQ 5 instead of the standard IRQ.

  Had reports of conflicts when using non-standard IRQ's on Novell/Netware
 systems. Seems Novell also uses the / character so something went screwy
 somewhere. So I added the * (asterisk) which may be used instead of the /
 in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
 and are interchangeable.

When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
 PCBoard: 
   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS

 Wildcat!:
   USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%

Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
 SET PCBDRIVE=C:
 SET PCBDIR=\BBSDIR
 SET PCBNODE=1

Ŀ
Fossil Driver Support


DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
     MYDOOR MYDOOR.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, DoorFrame will print a message to that effect and exit
the door gracefully.

Ŀ
Sysop Keys


F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
         written to DOOR.SYS and USERS.SYS
F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F8    -  Returns the caller involuntarily to the BBS.
F9    -  Toggles the local display On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F10   -  Activates SysOp CHAT mode within the DOOR.
ESC   -  Deactivates CHAT mode.  DOOR is resumed.
UP    -  Give the caller extra time while in the DOOR.  
DN    -  Subtract time from the caller while in the DOOR. 
HOME  -  HELP key for Status Line options.
ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
ALT-X -  PCBoard will exit after current caller logs off. Value is
         passed to PCBoard. Not available on non-PCBoard systems.

Ŀ
SYSOP.CFG FILE


Here is a breakdown of the SysOp configuration options which will be
foudn in the SYSOP.CFG file. Remember, you can setup this file easily
with the STUDS! UTILITY program!

20
C:\WC30\BULL\BULL99.SCR
C:\WC30\BULL\BULL99.BBS
3
10
45
The T&J Software BBS Lounge!
The Orange Dragon Bar.
McDougell's Bar & Grill
The Whatever You Want to Call it Bar.
N
N
Y

LINE 1: How many girls the player gets per day.
LINE 2: Complete path to your color bulletin file.
LINE 3: Complete path to your ASCII bulletin file.
LINE 4: How many times they can enter the door per day.
LINE 5: How many lotto tickets they can purchase per day.
LINE 6: Their time limit per play (set this to 999 to use whatever
        time they have left on the BBS).
LINE 7: The name of Bar #1.
LINE 8: The name of Bar #2.
LINE 9: The name of Bar #3.
LINE 10: The name of Bar #4.
LINE 11: 'Y' if you want to use the Player Access option, 'N' if you
         do not want to use it. See PLAYER ACCESS below for more
         details on this option.
LINE 12: This not used currently, leave it set as 'N'.
LINE 13: 'Y' if you want the local display ON during play or 'N'
         if you want it turned OFF.

Ŀ
MAINTENANCE


After the initial setup, no maintenance will be required unless you
want to reset the door from scratch. The door will reset with the
first player of a new month.

Ŀ
PLAYER EDITOR


A player editor was included with the UTILITY program (STUDUTIL.EXE).
Simply enter the players REAL NAME and his statistics will come up.
You may now changes any of the options listed. This is done by running
STUDUTIL program with and selecting number 5 (the player editor).

DISEASE NOTE: In the player editor, the disease listing of the player
will either be "N" for no disease, "S" for Syphilis, or "G" for
Gonorrhea.

Ŀ
PLAYING LOCALLY


Just type STUDS! LOCAL

You may play locally using different logon names if you wish!

Ŀ
PLAYER ACCESS


One new feature that was added to v1.1 is the ability to control player
access to the door. If line 11 of the SYSOP.CFG file is flagged 'Y'
then this option will be in effect. If it is flagged to 'N' then
anybody may play the door.

If flagged to 'Y', the players name must be found in the PACCESS.DAT
file or they will be told to leave a note to the sysop to get access
to the door. This is a good option if you want to keep the kids out
of the door without having to setup special door access's and everything
else in your BBS package.

To add a player to PACCESS.DAT you can use your favorite text editor
and just add the name (case is not important -- see how the current
names are listed in the file). Or, you can use the STUDS! UTILITY
program (Option #7) to add a player!

Ŀ
ADDING PHRASES


You may add your own phrases to what the girls say in the bedroom! Here
is a listing of the files you may add to (watch the format!!).

DRINK.DAT      ===> What she says when she wants a drink.
DRINKNO.DAT    ===> What she says when she doesn't want a drink.
FEEL.DAT       ===> What she says when you feel her.
FEELC.DAT      ===> What she says when you feel her and she's a cop.
FEELT.DAT      ===> What "she" says when "she's" a transvestite.
TALK.DAT       ===> What she says when she wants to talk.
TALKNO.DAT     ===> What she says when she doesn't want to talk.

The file formats are like this:
FILE: DRINK.DAT

7
Sure, a nice bottle of red wine would be great!
I always have more fun with a few drinks in me!
What the hell, sounds good to me.
That would help loosen me up.
Ok, how about a beer.
Sounds good to me!
Alright -- let's have a drink before we get started.

Line 1 is how many phrases are contained in this file. If you add a
phrase, add it after the last phrase listed and then increase line
1 by 1. If line 1 is greater than the number of phrases the door will
CRASH! with an INPUT PAST END error.


Ŀ
COMMENTS & QUESTIONS


Q: I have problems keeping the kids out of the door -- could you make
   an age checker and build it into the door?

A: Some BBS packages have no information of player birthdates in the
   caller information data. So, it's not possible to simply check their
   birthdate and see if they are old enough. We have added a PLAYER
   ACCESS option to take care of this. (see above).


Q: When they are in the bedroom, it shows how much the screw points
   are, but when the get to the screwing screen, there is a different
   screw points value listed --- why?

A: When the get to the screwing screen, each women has a "dick
   preference" -- if the player is smaller than what she wants, screw
   points are subtracted, if larger than she needs, screw points are
   added. Next time you get to the screwing screen, look at the bottom
   of the screen to see what she says. We've also added a phrase in
   the upper left part of the screen which tells what the extra
   points are for.


Q: I run my BBS on a network and have problems -- what's the deal?

A: That problem is corrected in v1.1 and higher -- all files are now
   opened in SHARED mode.


Q: There appears to be writing on the screen -- like files are being
   copied -- is this normal?

A: Very normal! Your users will not see this on the remote side.

Ŀ
PROBLEMS


If any internal errors do occur, check for a file called DFRAME.ERR
and let me know what the error code says.

Several people have been having problems with their Trident SVGA
cards and the ANSI screens not showing up correctly. To fix this,
check you utility disk that came with your Trident card for a program
called TANSI.SYS or something similar. Replace your old ANSI.SYS
with this version of it. This will correct the problems.

Please feel free to contact me if you have any problems at all.
Normally a quick phone call will fix the problem!


                            QuickBasic Error codes
                       Studs! uses the QB error codes.
 ---------------------------------------------------------------------------

 2   Syntax Error                       61   Disk full
 5   Ilegal Function Call               62   Input past end of File
 6   Overflow                           63   Bad record number
 7   Out of memory                      64   Bad filename
11   Division by Zero                   67   Too many files
13   type mismatch                      68   Device unavailable
24   Device Timeout                     69   Comm-buffer overflow
25   Device fault                       70   Permission denied
52   Bad filename or number             71   Disk not ready
53   File Not Found                     72   Disk media error
55   File Already open                  74   Rename across disk
57   Device I/O error                   75   Path/File access error
58   File already exists                76   Path not found
59   Bad Record length

     The most common error that you will see is #62.  This is usually caused
by the CFG file not having enough lines.  I have included this list so
that you may be able to fix a problem that occurs with a T&J Software
door.

Ŀ
VERSION HISTORY


See the HISTORY.TXT file for information on the history of the game
and the new options in the new versions!

Ŀ
REGISTERING


visit http://BBSFiles.com to purchase a "vanity" key