=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Warnings for CircleMUD 3.1 Copyright (C) 2003 G. Davis & J. Maloney Friday, May 23rd, 2003 geoff@myrapidsys.com =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- 1. Introduction While it's certainly not a thrilling part of our existences, sometimes those of us who perform administrative tasks on a game may need to intervene in mortal affairs, delivering warnings and executing judgment. Unfortunately, it's very easy for things to get away from us sometimes, especially if there is a team of admins and no simple, common interface for relaying infractions a player has perpetrated. This warning system, originally designed, but not implemented, by Jeremy Maloney (riodan@cyberspace.org), gives administrators the ability to send a formal warning to a player. When a warning is delivered, a record is added to the character to indicated this, including the date and time, the admin sending the warning, and the message text of the warning. At any time an admin may call up the warnings a given player has received, whether the player is online or not. 2. Disclaimer Please do use this patch at your own risk. I can only vouch for the stability of this code under the precise configuration it was tested in. And even then I could easily have overlooked something -- even something simple. I can't guarantee this patch will go in flawlessly on anything but vanilla CircleMUD 3.1, so please, please, *please* backup your MUD source code *before* attempting to apply this patch. I would be very appreciative of any credit given me for my work, but I don't really expect it, and I certainly won't hunt you down and brutalize you if you choose not to do so. I do expect, however, that you will not take credit, yourself, for this code, either implicitly or explicitly, in the event that its origins are divulged. If you make enhancements to this patch, find bugs, or have comments of any civil sort, please do feel free to email me at geoff@myrapidsys.com. I will gladly assist with any *technical* issues or problems with this patch as my time permits. 3. Installation To install this patch, move the cm31-guardians.patch file into your src directory (usually directly underneath your circle-3.1 directory) and execute the following command: % patch < cm31-warn.patch It is likely, if your MUD is modified at all, that you'll receive some rejects (*.rej files). These will need to be hand-patched. Remember, '+' means add, '-' means remove, and '!' means change. Once this is done, you will need to create the following directories in in your CircleMUD lib directory: plrwarn/ plrwarn/A-E/ plrwarn/F-J/ plrwarn/K-O/ plrwarn/P-T/ plrwarn/U-Z/ plrwarn/ZZZ/ Unfortunately, I really can't assist with patching or directory creation should you have a problem there, as these processes are fairly simple and very well documented on many websites and would consume much too much of my time if I had to conduct classes on them. 4. Known Issues (a) Once a warning is delivered, it can't be deleted. This could've easily been implemented, but I saw no need, as I personally would like to keep track of all of the warnings delivered to a player for their entire tenure with the game. If you really wish to purge a delivered warning, edit the player's player.warn file. (b) If a player is offline when a warning is delivered, they will not *see* the warning, but it will still be added to their warning file. I leave it as a task for the thus included to implement a solution, perhaps delivering a MUD mail or simply baring the warn command from delivering warnings to offline players. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Warnings for CircleMUD 3.1 Copyright (C) 2003 G. Davis & J. Maloney =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-