Media Share 9

home *** CD-ROM | disk | FTP | other *** search

/ Media Share 9 / MEDIASHARE_09.ISO / bbs / kalwrk27.zip / KALSYSOP.DOC < prev next >

Wrap

Text File | 1993-06-05 | 22KB | 497 lines

. . . . * * . . . . . . . * . . * . . K a l W o r k s . = = = = = = = = = = = =.= = = = = = = = = . S y s o p D o c u m e n t a t i o n . . * . . . . KalWorks can seriousely affect the way TW2002 is being played at your BBS. For example.. Perhaps you'd better . first read the user's documentation. * * . . . . . * . . . . . . . . : . . . . . . . . Kalworks is Copyright (C) 1992, 1993 by Jeroen J. van Drie. It is a Shareware TW2002 supporting program, for extended play of the TW2002 game at Bulletin Board Systems. Registration is set at a _minimum_ fee of $6, f10,- (dutch gulders) or 10DM. Details for payment will be given towards the end of this document. Please read the user documentation of this program, KALUSER.DOC, and MAKE IT AVAILABLE. Also make the values in your configuration file available. DON'T put the KALUSER.DOC in an ARJ, do it in an ARC and every computer can unpack it. Description: Kalworks gives you several options, defined in a configuration file, that you can edit to make your TW2002 universe ... different. Users can now, for a fee, rename planets, ports and nebulae; they can order aliens to work and ferrengi to ambush; they can transfer products inbetween planets (with a taxation you define). Kal Durak will be a player in the universe, in a ship or on his own either localised or moving planet, leaving tollfighters (if, when and how many you like) in his wake. Kal sees to it the Galactic Bank pays it's clients a decent interest (you decide what is decent), also sees to it the Galactic Bank provides funding for it's client's enterprises, also at a rate you decide on. Installation: First thing you do now is log into your TW locally, and create an account for a user called Kal Durak. Give him the ship and attributes you want, and then consult the game's log (twgame.log). You will see there Kal Durak(9) or something. Take that last number and put it into the configuration after the keyword "rec". KalWorks will then know where to find Kal Durak. Please put Kal in sector 10 with some 25 fighters so he won't be thrown out. If Kal is killed you'll have to play him again to revive him, this program will not (yet) do that. Remember that the value of the "rec" keyword determines who Kal is, not his name. If you call Kal by any other name (like Fedman or Al Durak), TELL YOUR USERS. Do NOT "make Kal invisible", he needs to get messages from your users so he should be listed in the rankings and so on. In time, Kal's planet (if defined) will become a valuable asset for conquest. If Kal looses his planet transfers will continue to be added to it until you reset the prec option in the confi- guration file. You will also have to create and assign Kal's planet if you want one, if not, put a ; in front of the prec and the move keyword of kalworks.cfg. Alternati- vely you could use ferrengal as Kal's planet, thereby strenghtening it and making it more valuable. Configuration: kalworks.cfg: rec 9 ;recordnumber for Kal prec 7 ;planetnumber of Kal's planet. (; if none) move ;should planet move 1 sect/day? (; if not) leave 40 ;chance kal leaves tollftrs behind (if move) lmin 10 ;min. number of tollftrs to leave (if move) lmax 100 ;max. number of tollftrs to leave (if move) tax 5 ;tax derived on intertrade intr 217 ;interest at gal. bank; 217 = 2.17% loan 347 ;loan interest at gal. bank: 347 = 3.47% fuel 14 ;kal's price per hold in credits plant -2 ;repos. planets to: -1=ferr, -2=rogue merc. repp 20 ;chance kal writes to conv. in bar (0=off) repn 100 ;minimum number of ferrengi to be rep'td org 70 ; " " " " " in credits equ 140 ; " " " " " in credits col 150 ; " " " " " in credits shld 130 ; " " " " " in credits fght 180 ; " " " " " in credits plan 50000 ;cost to rename planet port 45000 ;costs to rename a port nebu 30000 ;costs to (re)name a sector's nebula rent 125000 ;cost to rent-an-alien hire 150000 ;cost to hire a ferrengi So, renaming a planet will cost 50000/180 = 277 fighters, or 50000/70 = 714 holds/org or 50000 credits. If you say for example: nebu 0 then renaming nebula's is free. Don't put a zero behind commodities such as fuel, org, equ, shld and fgth. Values can best be adjusted according to the age of the game and the experience of your players. Things like renaming a planet and especially hiring a ferrengi or renting an alien should be _Expensive_. Transferring products or people from planet to planet shouldn't be free, so kalworks up to ver. 2.0 derived a 5% transfer cost tax from the amount transferred in an intertrade (IT) command. New in ver. 2.1 is that you can define this amount yourself. This amount should not exceed 50, any taxation higher than 50 will be put to 50. In conjunction with your experience on the use of intertrade by your users you should know best what amount works in your universe. What bank other than a piggy bank does not pay interest? The TW2002 galactic bank at stardock. But Kalworks now includes the option of defining the daily interest rate of this bank, up to two decimals. A value of 217 as given in the distribution KALWORKS.CFG will pay 2.17% interest over the accounts each day (each time maintenance runs). If you don't want the bank to pay interest, make the value after the intr-configuration statement 0. Interest can cause the account to hold over 100000 credits but this does not cause trouble in the game. What bank other than a piggy bank does not lend money? The TW2002 galactic bank at stardock. That was, until on the 9th of may, 2005, very early in the morning, Mr. Durak and the Galactic Bank reached an agreement on loans. Before this date, the bank had no means of forcing traders to pay back their loans, but Durak signed a contract, guaranteeing the bank payback of debts under the following terms: * Debtors will receive warnings ten days after having loaned money. * Debtors will be wanted and a price will be put on their head, fifteen days after having loaned money. This bounty will be 5% of their outstanding payment, to be incremented each day. * Debtors will be attacked by rogue mercenaries, twenty days after having loaned money. The attack force will be financed by 10% of the outstanding debt. * After twenty-five days, reposession of the debtor's assets will take place: items on their planets will be taken, appropriate to the fulfillment of the debt. If the debtor has no private planets, the debt cannot be fulfilled and he or she will be hunted by rogue mercenaries. Loans will be put on the Galactic banking account, but can only be payed back from the bank at the citadel on one of the client's private planets. Sysops who don't want to have the lending option should set the loan- option in the configuration file to 0, do not comment (;) the option. Be conscious of consequences when you fill in the configuration file. Don't be excessive with the tax, intr- and loan percentages. Also remember that if the loan-percentage is lower than the intr-rate, lending money from the bank will be very interesting. I suggest leaving all keywords from tax down to hire as they are if you can't make much sense of their interdependance. Kal's price per hold for commercial products, fighters and shields, is defined because users can pay with such assets. repp & repn configuration file statements: Kal now writes to CONVO.DAT, reporting on ferrengi fighter fleets around the universe. He will report each maintenance at a chance of the percentage behind the repp-keyword. Any fleet with less fighters than specified behind repn will not be considered worthwile to report. If you don't want reporting specify repp 0. Command line options: Debug - some extended maint information on screen. Maint - daily maintenance routines. It's best to run KALWORKS without any commandline options every time AFTER a player played, especially if you play Kal yourself, since if you read commandmail to Kal, the program will no longer process it. Players can enter the universe, give commands, back off, and re-enter the game again, finding the command worked on or finding a message describing what went wrong and what Kal thinks of this player now. Kalworks maint SHOULD be run EVERY NIGHT AFTER EXTERN. EXE. In a maint, ferrengi and alien tasks will be worked on; killed ferrengi and aliens who have been assigned will be reset to their usual unassigned operation, and interest will be accounted at the galactic bank. TALK.COM TRADER.DAT is the answer file to queries to the trader in the bar, containing 87 free records in TW2002 version 1.03. Seven of these will be filled with KalWorks informations. Copy your current TRADER.DAT to a backup disk or directory and run TALK; after running it your TRADER.DAT file is updated for a game with KALWORKS. Kalworks' entries into TRADER.DAT: RENAME PLANET RENAME RENAME PORT RENAME RENAME NEBULA RENAME INTERTRADE INTER INFORMATIONS IN ALIEN RENT FERRENGI HIRE KALWORKS KAL LOAN LEND PAYBACK PB TWDAT.EXE Included in the rare case your TWDATA.DAT file gets messed up. It's original size is 214452 and if it's bigger, run this utility. TW does this, not Kalworks.. GEN_LOAN Utility to generate the TWLOANS.DAT file. Copyright & Disclaimer This program is Copyright (C) 1992/1993 by Jeroen J van Drie. This program is guaranteed to do nothing but eat diskspace. It might even corrupt your datafiles or harddisk or whatever it isn't supposed to corrupt. If such a thing happens, I am not responsibile. I might feel sorry. However, for any working version you are obliged to pay me a fee in either US dollars or Dutch guilders since this program is shareware, I've worked hard enough for it. Minimum fee for using Kalworks in one universe is 6 US$, 10DM or 10 Dutch guilders to Dutch Postbank/ING account number 5088139 of J.J. van Drie. Send your 6 US$ or 10DM to: Jeroen van Drie Lepelaarstraat 15 6883 EK Velp The Netherlands. Paying for this shareware will fulfill all your obligations vis-a-vis me for the current and all future versions of Kalworks. What's more, your registration will make me happy to work on such future versions. If you want to reach me you might try sending a message to 2:283/512.15 in fidonet. Please do not call my home address! I am wideopen to any kind of suggestions you might have; considered doing things with ports, what? Consider reporting rumors in the tavern, what? Consider weird stuff with planets or warps or whatever, but what? I guess Kalworks already makes TW2002 pretty hyped up, but I guess it's just the beginning, actually there should be lots and lots of things to corrupt here.. If you're a TW-utility programmer yourself, send me your program's activities and how I can adapt Kalworks to interact with it. TradeWars/TW2002 is a product of Gary A. Martin and Mary Ann Martin. Many thanks for their efforts! Hi to Chris Sherrick for TW 1000! Version log 1.45 - And previous : Local Testing. 1.47 - Beta before the 1.5 release. The kalplanet options need testing, daily maint will fly (if wanted) kal's planet through the universe. Like the user record, the sysop has to create and assign this planet. New config options are: prec - Planet number of kal. If no number is given, no operations will occur. leave - chance (%) that kal leaves tollfighters in kalplanet's sector. lmin - minimum amount of tollftrs to leave lmax - maximum amount of tollftrs to leave New command line option "debug" for more on-screen information. I'll probably won't leave it on in an alpha release. 1.48 - Added credit support, CR pays for commands in credits, if Kal's planet exists, it's citadel will receive those credits. 1.5 - Added `Hire a Ferrengi'. Fixed bugs, still beta. DO NOT distribute this version. Version 2.0 will be the alpha release, 1.9 is public beta. 1.6 - Minor adjustments. Fixed user docs on alien command sequence. Adjusted default values in .cfg file, Aliens and Ferrengi's should be expensive. 1.8 - Fixed the noisy "MasterBlaster|~M╚0(\" bug. 1.9 - Public Beta Release, please report bugs!! 2.0 - First Alpha release since 1.9 was ok. 2.1 - Public release version; new gimmicks are that the taxation of intertrade operations can now be defined by the sysop. Daily maintenance also includes adding a sysop-defined amount of interest to the galactic bank accounts. 2.5 - Rewrite, adding lending at the galactic bank. 2.6 - Clean update, lending now works. 2.7 - Added `plant' keyword to make kalworks compatible with David Proper's TWPLANET automated planet maintenance. The keyword can be either -1 or -2, -1 is ferrengi and -2 is rogue mercenaries. -2 is now default, any number other than -1 and -2 will be set to -2. Any reposessed planet will be set to this ownernumber. - Keywords `repp' and `repn' in cfgfile make Kal report on real ferrengi fighter clouds like convo. dat's first entry. (I've heared rumors, etc). - Kal occasionally tells traders in the bar that they should pay back their debt. Future versions may start to include: - Extended Ferrengi and Alien reporting, - Coporate support, - Regulated trade inbetween players, - And more... Be on the lookout for some of my other TW2002 enhancement programs such as: TWS (Public Domain) User Utility TWS is a TWVIEW Compatible TW2002 Universe Simulator, TWVIEW is a popular TW2002 user utility by Robert Weaver. This program reads the TWVIEW database, and simulates the TW2002 universe's known sectors, warps and ports. It simulates the Holographic Scanner, it displays notes as beacons. It does not display the amount of planets, ships, and such, but that info can be added in a note. FERFRT (Public Domain) Sysop Utility TW2002 maintenance generates an amount of ferrengi fighters each time. This amount is calculated by taking the age of the game in days, multiplying it times 50, and taking the percentage of that amount set by the sysop in TEDIT's general options. But the fighters hang about there, clogging up the Ferrengi Empire! Now, FERFTR distributes an amount of these fighters (percentage on the command line) to the ferrengi in the universe; all ferrengi ships will receive their fair share. TWCLEAN (Public Domain) Sysop Utility TWDATA.DAT contains very much noise. Essentially it's containing 1702 records, each 126 bytes (63 integers) long. 2 general, 150 users, 1000 sectors, 400 ports and 150 planet records is 1702 records. The first 84 bytes all are for character data (user, planet, beacon, ship, nebula, etc names), the latter 42 bytes are 21 integers containing general, user, sector, port and planet data. But besides the names, the first 84 bytes contain lots of garbage and if you're interested in directly editing the file, you'll have to count garbage.. That's why I wrote this util and I hope you like it. It just puts a zero in every character byte that doesn't count. PACKSMF (Public Domain) Sysop Utility Packs the TWSMF.DAT file, the Tradewars 2002 small message file. If the user the message is written to is smaller than 2, the message is considered read and will be deleted. The old message file will be called TWSMF.OLD, this latter file will be overwritten once PACKSMF is run again. TWPLANST (Public Domain) Sysop Utility TradeWars 2002 Planetary Statistics generator. TWPLANST can be run after your daily maintenance (extern.exe). It will generate a logfile featuring all planets in the TW2002 universe. It can give all information. The displayed ownernumber is the usernumber or the corporate number, it is not converted to a trader/corp name. The best way to introduce the data into TW2002 is through the starbase library. TWLOG (Public Domain) Sysop Utility TWLOG removes all lines starting with a hex of 11 and 20 (ANSI codes and line with only a space) from the logfile. It will also remove the line saying "TW Maintence program ran". Instead it will show an empty line. Yes, you have seen this accurately and rightly; only the magnificant KALWORKS program is shareware, and behold: just for such a palatable minimum price of $6 or 10 of those more stable uninflatable Dutch guilders. Shareware is defined as the delicate process of using, in the first place, and paying only after such initial use for, software. However there are such unsavoury individuals on this planet busy considering the aforementioned commercial idea unintelligent or unintelligible, and, being so infinitely wise themselves, proceed to use the software without fullfilling the reciprocal debt to the author who now must sit in shredded clothes, holding his stomach as a meagre cure against severe pangs of hunger, watching his eye-devastating hercules monochrome, waiting for his 4.77 mhz XT to spit out yet another work of art. To these wise unpaying individuals I'd like to be granted the privilege of provide the wisdom of sustenance which is the act of supporting artists in their unselfish endeavour to enlighten mankind and the universe with the joint product of their sweat and blood. So if you see those happy smiles on your TW users as their assigned ferrengi destroys their foe, remember the pioneer of progress who made it possible. If this plea has been sufficient to move you to pay for this shareware, then please refer to KALSYSOP.DOC for details.