

MockLamer... The Kit... The Add-on... The Wonder of it all...
=============================================================


Version 2.1 Revision 002
------------------------



Introduction
============


MockLamer is a useless, juvenile, waste of practical scripting space for mIRC
versions 5 and above. Its sole function is what its name implies: to mock
lamers. It's not a flood (although with enough people it certainly could become
one!) and it's not malicious, but it sure gets the attention of your target
lamer to get insulted by a huge quantity of people, all at once.



-- WARNING!!! -- WARNING!!! -- WARNING!!! --

READ THIS FILE ALL THE WAY THROUGH BEFORE TRYING TO INSTALL THE ADD-ON!
If you need help once you've read through that's fine; stop by #mocklamer
and folks there will happily help you. But if you need help that is covered
in this file they will justifiably be less than willing to waste their time
helping you!


Also, DO IT ALL BEFORE TESTING IT! MockLamer is built from a lot of lines
of script and a few files that have to all be in place or it won't work
right.


One last thing. Little Star, scoobster's awesome script, includes a variation of
ML 1.1. BEFORE you can install a newer release of MockLamer, you must remove the
existing version from LS. There are patch files for LS 6.0 and 6.1 available on
the Official ML Website at this URL:

http://www.geocities.com/SiliconValley/Bay/4397/down_mirc.html

This patch MUST be installed properly before you can install ML into Little Star
6.0/6.1. If you don't do this first ML ][ will not behave properly and other 
functions in Little Star might be adversely affected.

-- WARNING!!! -- WARNING!!! -- WARNING!!! --





New in this Release
===================


This one's undergone a LOT of changes. Bugs were fixed, and new features out 
the wahzoo were added. Here's a rundown:


 User-selectable sound files for most events (join, request, mock, kick, 
  part, ML on, ML off), from popups.

 User-selectable taunt files (that no longer require mIRC commands in each 
  line!), from a popup.

 User-editable text (both /echo'd and /notice'd) for several modes, from
  popups.

 Bugfixes in several places.

 All popups embedded into the remote so it loads them automatically
  (which is nice.)

 Another one-file install, requiring two simple commands to do the deed. 
  (NO MORE PASTING SCRIPT!!!!)

 Theme support. If you have a set of sounds, text, and taunts from, say
  Beavis & Butthead, you can build a Theme file and put all the required files
  in a directory, then load the theme file from a popup and autoset all the
  options at once. Eats a lot of variables but it's sweet. When you load a
  theme it plays each sound for 5 seconds as well so you can hear what's what.

 Moved all ML's status info to its own status window where it's less intrusive.

 The files the user selected can be anywhere on their system; ML captures full
  paths to files.

 Added Double-Barrel mode. With this mode activated, MockLamer will fire TWO
  mocks 5 seconds apart from one mock command! DOUBLE the power!

 Added full install/uninstall support for ircN 5 and ircN-compatible script loaders.

 Added the ability to migrate ML to other channels. If the default MockLamer channel
  should be unusable, you can move to another channel and ML can still do the deed.

 Added a cool ML report feature. When you do a MockLamer Request, ML will count who
  does and does not have ML and what state it's set to. Aftr 45 seconds you get a
  report of this. (It will detect ML 2.1 and later for mIRC, ML 2.0.001 and later for
  Eggdrop, and ML for Little Star 6.0/6.1. ML 2.0 and pre-2.0 TCL versions will not
  be counted as having ML even if they do.)





Installation Procedures
=======================


This package contains a textfile o' directions, (this one, duh!) a textfile
called mocklamer.txt, an INI file called mocklamer.ini, an installer file for 
ircN called ml_install.adn, and a RTF file (openable in WordPad) called ThemeDK.rtf.
If you ask around in #MockLamer you can find Themes galore. More on Themes later.






mIRC 5.x FastInstall Instructions
=================================


Installing a fresh MockLamer 2.0 is incredibly easy. Simply place the files included
with this one in the same directory as the mIRC you use, start mIRC, (no need to connect
but you can if you wish) and type these two commands EXACTLY as shown:

/load -a mocklamer.ini
/load -rs mocklamer.ini


If it loads correctly (and it should) MockLamer will tell you it's in place.


If you already have MockLamer installed, you can install a newer version by closing
mIRC completely (it must NOT be running when you do this!) and replace the previous
version's mocklamer.ini file with the newest one, and then restart mIRC. mIRC will
then load the newest version automatically.




ircN Installation Instructions
==============================


If you're using ircN (or other scripts that can handle ircN-compatible script addons)
you can use the included ml_install.adn file to install ML using the usual addon loader
ircN has built-in. Simply decompress all files into the IrcN/Addons directory, launch
ircN, type /addons, and select ml_install.adn. MockLamer will install and configure itself.

ircN users also can unload MockLamer through the MockLamer ][ Management menu. More 
on that later.





mocklamer.txt File
==================


This holds a list of taunts to be fired randomly at a target when a MockLamer 
mocking command gets sent. This file should be put in the same directory as your
mIRC executable is.


NOTE: Some scripts, such as Little Star 6.0, will detect the new addition and ask you
if you want to allow running installation routines in the newly added script. You
want this, so click Yes. If you click No, you'll have to set everything up (and we
mean EVERYTHING) or ML will crash, as it sets default values on first startup.


Oh, and feel free to edit the taunts to suit your liking.




The MockLamer ][ Management menu
================================


mIRC allows scripts to install their own entry into its menu bar, appearing 
between the DCC and Window menus at the top of the mIRC window. ML 2.0 adds a 
very comprehensive menu to the bottom of any menu that exists there. From this
menu you can define sound files for various events, edit text for other events,
check on practically any setting, and in general just plain mess around with
most of MockLamer.

Also, you can get at mode controls from the Power Switch submenu. (Including
the Double-Barrel mode!)

Oh, and there's also a Clear All Setttings option in case you screw evrything
up too badly. That option resets everything to defaults. ircN users can even
uninstall MockLamer from there. (Most other scripts may permit this as well.)

And from there you can load Themes. Read on for specifics on Themes.




Themes
======


ML 2.0 introduces Themes. A "Theme" is a set of sound effects, taunts, and text 
settings that fit a common theme. For example, the Beavis & Butthead theme is chock
full of sound bites and catch phrases from the show.

You can create your own Theme by loading each element from the MockLamer ][ Management
menu and the ThemeDK file (ThemeDK.rtf) describes how to build a Theme file for
one-step loading of a Theme.



The Commands
============


MockLamer only has a few commands, and here they are. Please note that the syntax 
must be followed EXACTLY, Case included. They also can only be effective within a
channel called #mocklamer as some IRC channel Ops don't like script trigger commands
in their channels.



|mocklamer request| <target/reason>

  This command polls all copies of Mocklamer active in #mocklamer to reply with
  their status. This tells you two things: 1. Who has MockLamer and whether theirs 
  is on or off, and 2. How much insult power you're capable of unleashing on the
  hapless lamer.


  By giving a target and/or reason, all people can see who and why you want to 
  fire off some mockings. This might persuade others with MockLamer off to activate
  theirs.


  MockLamer 2.0 automatically adds a "MockLamer Request" option to the channel menu.
  To use it, rightclick the channel window, select "MockLamer Request" (at the bottom
  usually) and optionally give a reason.



|mocklamer <target>

  This command actually triggers all copies of MockLamer in the channel (except your 
  own due to how mIRC handles events) to mock the target nick you specify. Make sure
  you give the correct spelling of the target's nick or you'll annoy other MockLamer
  users.


  MockLamer 2.0 automatically adds a "Mock This Lamer!" option to the Nicknames list
  menu. to use it, leftclick the nick to mock, then rightclick it, then select the
  "Mock This Lamer!" option (again, usually at the bottom) and that's it!



/mock? <target/reason>

  This is an alias that sends a |mocklamer request| <target/reason> into #mocklamer
  for you. Aren't shortcuts great?



/mockon

  This alias activates MockLamer and will trigger you to automatically join the
  MockLamer IRC channel #mocklamer. mIRC will show you that you have enabled
  LamerMocking once you enter this command. Once turned on, MockLamer remains
  on until deactivated with /mockoff.


  You can set this from the MockLamer ][ Management menu's Power Switch submenu.



/mockoff

  This alias DEactivated MockLamer, useful in situations where you might not
  approve of the intended target choices or the idea of sending out every
  lamer mocking that comes along. Once turned off, MockLamer remains off until
  reactivated with /mockon.


  You can also set this from the MockLamer ][ Management menu's Power Switch submenu.




Testing it out!
===============


The section you've been waiting for! Testing it out!

1. Connect to an Efnet IRC server and type /mockon and mIRC should automatically
   join #mocklamer. A sound bite should play when you join #mocklamer if you've
   defined a Join sound or loaded a Theme that defined one.
2. Type /mock? Test and see how many MockLamers reply.
3. Ask someone in #mocklamer to test yours the same way.
4. Type /mockon and ask someone to mock themselves to test it further.
5. If you send out both replies to requests and actual mockings' congrats! You are
   now equipped to Mock Lamers!!!




MockLamer Etiquette
====================


There are some rules of sorts to mocking lamers properly. Here's the breakdown.

1. Don't flood the lamer or the lamer mockers. This means don't send the same
   |mocklamer <nick> command repeatedly and rapidly into #mocklamer. It's
   annoying and malicious. And it could get you kicked out of #mocklamer.

2. Don't hit the same person more than once. It's not funny if say 50 people hit
   one lamer more than once. Once usually is more than enough.

3. Check out your target first. Mocking an IRCop for example would be, well, less
   than smart. Do a /whois on your target first and see who/what you're about to
   mock.


#MockLamer has a more comprehensive listing of rules available on request. It's
STRONGLY recommended that you get a copy and read it before mocking the first time.




Credits and Stuff
=================

MockLamer was created by OddOne, who had to have been REALLY bored to do it.

IRCers who have helped immensely with its development are (in no particular order):

   aPaRaSiTe
   RDMustang
   CornNut
   Lepre-Con
   SteelClaw
   War_Cow
   _Axe
   gofool



