HBBS: | +-@{"BBSGlobal" link HBBS:Docs/Configuration/BBSGlobal.guide/MAIN} Main System configuration file | +-Docs | | | +-<.guide files> Documentation for HBBS | | | +-Doors | | | +-Doors.Guide Index to all Door documentation | | | +-.guide | +-Nodes | | | +-@{"NodeList" link HBBS:Docs/Configuration/NodeList.guide/MAIN} Details of nodes | | | +-@{"NodeGlobal" link HBBS:Docs/Configuration/NodeGlobal.guide/MAIN} Each nodes settings default to the settings | | in the file and then are overridden by the ones | | in the node's @{"NodeLocal" link HBBS:Docs/Configuration/NodeLocal.guide/MAIN} file | | | +-@{"Node" link NodeX} (location must be as specified in @{"NodeList" link HBBS:Docs/Configuration/NodeList.guide/MAIN}) | | | +-@{"NodeLocal" link HBBS:Docs/Configuration/NodeLocal.guide/MAIN} Settings for the node | | | +-@{"Device" link HBBS:Docs/Configuration/Device.Guide/MAIN} Serial/Modem settings details | | | +-BBSColours.CFG Ansi menu and prompt colors config file | | | +-BBSStrings.CFG Custom Prompt/Message config file | | | +-Logs | | | | | +-Callers.log Callers log file for node | | | (location can be changed via @{"NodeLocal" link HBBS:Docs/Configuration/NodeLocal.guide/MAIN}) | | | | | +-Node.log Node log file for node | | (location can be changed via @{"NodeLocal" link HBBS:Docs/Configuration/NodeLocal.guide/MAIN}) | | | +-@{"PlayPen" Link PlayPenDir} Files uploaded to the bbs go here. | | | (location can be changed via @{"NodeLocal" link HBBS:Docs/Configuration/NodeLocal.guide/MAIN}) | | | | | +- | | | +-@{"Work" Link WorkDir} Temporary Files go in this directory. | | | LOCATION CANNOT BE CHANGED | | | | | +- | | | +-Storage | | | Place unused configs etc in here if you want | | +- | | | +-Access | | | | | +-Level_ Node access settings files | | | +-Commands | | | | | +-System System commands | | | | | +-Level_Global Commands for all users | | | | | +-Level_ Commands for users with this access level. | | overrides settings in Level_Global | | | +-Screens | | | +-Special | | | | | +- Special Screen Files go in here. | | Files in here override those in | | HBBS:Screens/Special | +-Storage | | | +- Place unused node related screens here. | +-@{"Doors" link HBBS:Docs/Doors/DOORIndex.guide/MAIN} | | | +-System | | | | | +-Node The NODE executable itself | | | | | +-Storage | | | | | | | +- Place old/unused door directories here. | | | | | +- | | | | | +- | | | | | +- | | | | | +- | | | +-User | | | +-Storage | | | | | +- Place old/unused door directories here. | | | +- | | | +- | | | +- | | | +- | +-Commands | | | +-System System commands | | | +-Level_Global Commands for all users | | | +-Level_ Commands for users with this access level. | +-@{"Conferences" link Conferences} | | | +-ConfList List of all conferences | | | +- As specified in ConfList | | | +-ConfConfig Conference Settings details | | | +-BBSColours.CFG Ansi menu and prompt colors config file | | | +-BBSStrings.CFG Custom Prompt/Message config file | | | +-BadFiles (Location can be changed via ConfConfig) | | | | | +- Uploads to this conf that are corrupt | | | +-Hold (Location can be changed via ConfConfig) | | | | | +- Uploads for the sysop. | | | +-LostFiles | | | | | +- If a file could not be moved etc it may | | be found in here. Check logs for matching | | filenames to find out why it is in here. | | | +-PartUpload | | | | | +-@ If a file is canceled or carrier lost | | during transfer it is kept here and the | | users' id is added to the filename | | | +-Screens Conference related ansi/ascii screens | | | | | +-Special | | | | | +- Screens in here override those in | | /Screens/Special | | | +-Access | | | | | +-Level_ Conference access settings files | | | +-FileLists | | | | | +- (Location may be changed via ConfConfig) | | | +-Mail | | | | | +- See the current mail system docs for details | | | +-Commands | | | +-System System commands | | | +-Level_Global Commands for all users | | | +-Level_ Commands for users with this access level. | +-Access | | | +-Levels | | | | | +-Level_List List of access levels | | | | | +-Level_Global Global access settings | | | | | +-Level_ BBS access settings files | | | +-@{"Users" link ACSUsersDir} | | | +- User access settings files | If you have a file with the same name as | the users handle it will override all the | conference, node and system access ettings | +-System | | | +-Protocols Transfer protocol definitions | | | +-FCheck Config for checking/testing uploaded files | | | +-@{"FileID" Link HBBS:Docs/Configuration/FileID.Guide/MAIN} Config for adding/extracting file_id.diz's | | | +-Amiga | | | | | +-CLI | | | | | +-Libs This is added to you libs: assign | | | | so you can put HBBS and it's utilities' | | | | shared amiga .library files in here | | | +- | | | | | | | +-HBBSCommon.library | | | | | | | +-HBBSNode.library | | | | | | | +-xpr | | | | | | | +- Unused xpr#?.library files | | | | | +-Fonts This is added to the Fonts: assign so you | | | | can place all hbbs and related fonts here | | | |- | | | | | | | +-HBBS.font | | | | | | | +-HBBS | | | | | | | | | +-8 | | | | | | | +-HBBS_IBM.font | | | | | | | +-HBBS_IBM | | | | | | | +-8 | | +-Devs This is added to the Devs: assign so you | | | can place all hbbs and related devices here | | +- | | | +-Data | | | +-BBSColours.CFG Ansi menu and prompt colors config file | | | +-BBSStrings.CFG Custom Prompt/Message config file | | | +-Calls.CFG Created by the system, resets at first user | | login after midnight | | | +-PrivateData Created by the system, NEVER EDIT THIS! | | | +-user.data User data file | | (Location may be changed via BBSGlobal) | | | +-CtrlScrPrefs.CFG Screenmode prefs file, created by the system | | | +-Users | | | | | +- Each user has their own special directory | | | into which door codes can save users | | | personal preferences in. | | | | | | Note: each directory's comment it | | | set to the users handle. Try using "C:List" | | +- | | | | | +-TaggedFiles.CFG Created by the system. | | If you trash your upload download dirs it | | might be an idea to remove all these.. | +-ConfAcs | | | +-.CFG Filename defined in Level_List | These files determine what confs the users | can join or see. | You can set individual users confacs files | for each user. | +-Utils | | | +- See elsewhere for a list of supplied utils. | +-Screens | | | +-Special System related ansi/ascii screens | | | | | +- See screens.guide | | | +-Storage | | | +- Unused screen files | +-Storage | | | +- | +-Scripts Script files | | | +-Logoff_Global.script Always called even if LogOff.script exists | | | +-Logoff.script | +-Mail | | | +- See the mail system door docs for details | +-LostFiles | | | +- If a file could not be moved etc it may | be found in here. Check logs for matching | filenames to find out why it is in here. +-Logs | | | +-Error.log Check this file for errors ever so often. | | | +- Other log files created by doors etc. | +-Startup | +- Like WBStartup but for HBBS! (not implemented as of 31/July/1997) *C* Uploaded files are not stored in the HBBS: directory structure as the sysop may have other devices that may be setup in a particular way, below is how we recommend you organize your file direcotories as it is a more structured way of doing it. Files: | +- | +-Private | +-BadFiles | +-Files @EndNode @Node Conferences "Conferences" HBBS:Conferences ================ The HBBS:Conferences directory holds all the conference subdirectories. A Conference is the /X and HBBS term for FILE AREA! (Just in case you didn't already know) BUT Conferences can have their own mail as well as files or just one or the other. (by settings different access levels or command settings) So say you are running a normal warez bbs, you'd probably want the following conferences NewUsers Amiga Warez PC Warez Console Warez CD-ROM! Group Members Sysop Area Requests BBS Adds Test Conference Most of those conferences would want to have to have files and messages. But you could also want a Help conference or Game Tips or suggestions conference, these conferences might not require files but would require mail. @EndNode @Node NodeX "Node" HBBS:Nodes/Node ======================== For each node on your system you should create a directory called Node where is replaced by the node number. This of course is the default and STRONGLY recommended settings. If you like you may change the location of the node directory by changing the option @{"NodeLocation_XX" link HBBS:Docs/Configuration/NodeList.guide/NodeLocation_XX} in the file HBBS:Nodes/NodeList The node directory contains a few other files which are used to configure the node, there is also a screens directory for storing node specefic screens. Also there is a commands directory so that you can configure the bbs so that some commands can only be run from a certain node. Then there's a access directory, this is so you can set your bbs up so that users don't or do have specific access rights for each node. @EndNode @Node WorkDir "Work" HBBS:Nodes/Node/Work ============================= A directory called "Work" MUST be created in each Node directory you have, the bbs stores temporary files in this directory. Any files in this directory are DELETED when the node is reset. @EndNode @Node PlaypenDir "Playpen" HBBS:Nodes/Node/PlayPen ================================ The location can be changed via @{"NodeLocal" link HBBS:Docs/Configuration/NodeLocal.guide/MAIN} Uploads are placed in the directory while a user is transferring If files are found in this directory when a node is restarted (or after a system reboot/crash) then the last caller is found, the files are then checked (for FileID, Corruption, Duplicate..) and if all is ok they are moved into the current conferences upload directory and are added to the filelist. If they have no description they will be moved into the current conference's LostFiles direcotory and the FileLists/LostList will be updated with the users name, account number and filename. @EndNode @Node ACSUsersDir "Levels" Users ===== This directory MUST be present, but you don't need to have any files in it. in here you should store files with the same name as a users handle, then when the access settings are loaded for the current online user, the bbs checks to see if there is a file in here with the same name as the users handle then the normal access settings are overridden with the settings in the files in here! e.g. say all your users had access to internet mail, but one user was abusing it, you could create a file with the same name as the user's handle then set the option AllowInternetMail=FALSE in the file. @EndNode @Node ConfigDef "Config File Definition" Config File Definition ====================== Rules ===== Please Adhere to the following rules when creating/modifiying your config files. * You may use YES/NO, TRUE/FALSE or ON/OFF for boolean options. * /'s will be added to paths if required, all paths MUST be have a volume name or assign name in them. e.g. HBBS:Screens/ is ok, but Screens isn't * Space's are NOT permitted in filenames. * ;'s are used for comment lines, they may be after an option or on seperate lines, note: comments are not allowed in some config files as ;'s are use in some ANSI escape sequences. BBSColours.CFG is one such file. * Blank lines are allowed (they aid readability and structure) * All optionnames MUST start on the first character of the line * Options take the following format: Optionname[_XX]=