** ** **** ** *******
/** /** /**/** /** **/////**
/** /** /**//** /** ** //**
/** /** /** //** /** /** /**
/** /** /** //**/** /** /**
/** /** /** //**** //** **
//******* /** //*** //*******
/////// // /// /////// UNO v3.1 by poiuy_qwert
|
| Contents |
- Changes
- Introduction
- Installation
- Settings
- Settings Section
- Bonus, Earned, and Awards Section
- Admins Section
- Points, Winslosses, and Nicks Sections
- Commands
- Playing
- Rules
- Game
- Credits
- Contact
|
| 1. Changes (Back) |
UNO v3.1 (Nov 14, 2008)
- Fixed a problem with the channel setting (first channel no longer needs to be network specific)
- Fixed a problem with the game ending when awarding points
UNO v3.0 (Aug 10, 2007)
- Lots of bug fixes
- Probably the best new feature, the bot can now play in the game with you!
- Added commands *stop, *cards, *turn, *score, *records, *elapsed,*played, *top, *shuffle, *botjoin, *botreplace, and *botleave
- Removed *uno command
- Most commands got shortforms
- Took out gender specifics
- Added settings needtrigger, networks, spambot, drawskips, awards, and sortcards
- Channels can now be network specific
- Added sections bonus, awards, winslosses, and nicks to settings
- Added bonus awards when you win
- Bot updates IAL when joining the uno chan (fixes bot not recognizing people, like the owner)
- You can only pass if you've drawn (should have already but was bugged), and can only play the card you drew after you've drawn (can also play a stack with that card as the starter)
- BIG changes to how points are saved (check 4-5. Points, Winslosses, and Nicks Sections to save your current points points)
UNO v2.2 (Dec 26, 2006)
- Minor bug fixes
- Added spam settings spamcmds, spamcmdtime, spamlines, and spamlinetime
UNO v2.1 (Feb 7, 2006)
UNO v2 (Feb 23, 2006)
- Admin is now Owner and can have multiple Admins under him.
- Added commands *AddAdmin, *DelAdmin, *Suspend, and *Unsuspend.
- Changed multiply if's to if-elseif-else's.
- Reverses now Skip when playing 1 on 1.
- Documented the undocumented nocolor setting(:D).
- Added settings noprefix, autojoin, and moderror.
- Help command no longer is just on/off, you can supply an access level (Documentation said it was this way before but it wasn't).
UNO v1 (Jan 31, 2006)
|
| 2. Introduction (Back) |
This is a bot writen in mIRC Scripting Langue to emulate the clasic card game UNO. It is a text base game played in a channel by 2-10 players. This readme should tell you all you need to know about how to install and use this addon.
Note: A * is used to replace the command trigger. Anything new in the current version will have New! next to it.
|
| 3. Installation (Back) |
The installation of this addon is quite simple, just follow these steps:
- Extract all the files to your hard drive.
- Open a second mIRC (Not the one you will use to play), preferably one with no scripts loaded.
- Hold the ALT key and press R.
- Hold the CTRL key and press L.
- Navigate to where you extracted the files on your hard drive then open UNO.mrc.
- Press the Ok button.
- Change the settings you want (Explained in 4. Settings).
- Connect to your server and join the channel you set in the settings.
- Start to play! (Explained in 6. Playing).
|
| 4. Settings (Back) |
Before using UNO, you should edit the settings in the settings.ini file. You must edit the settings in the 4-1. Settings Section, and you may want to check the 4-2. Bonus, Earned, and Awards Section. For information on saving scores from UNO v2.2, check the 4-4. Points, Winslosses, and Nicks Section.
1. Settings Section
- Trigger:
This is the character that users must place before commands.
- New! NeedTrigger:
Defines if users must place the trigger before commands or not (1 for yes, 0 for no)
- New! Networks:
A list of network names (whats returned by $network), seperated by spaces, for which networks UNO is enabled on. If no networks are supplied all networks have UNO enabled.
- Channel:
This is a list of channels, seperated by spaces, which UNO is enabled on. To make a channel network specific, use Network:#chan.
- AutoJoin:
This automatically joins the home channel(s) on connecting to a network (network specific and global chans).
- Owner:
This is the address of the bot owner (most likely you). To get the correct address of the admin, use //echo -a $address(nick,2).
- NoColor:
Strips colors from bot messages (This is automatically done when mode +c is set). 1 for no colors, 0 for colors.
- NoPrefix:
This prevents the bot from prefixing messages with [UNO]. 1 to turn off prefixing, 0 to leave it on.
- ModError:
This prevents the bot from giving an error message if the channel is +m and the bot is not voiced or opped. 1 for error message, 0 for not.
- SpamCMDs:
This is how many commands each user can use in the time specified by SpamCMDTime untill the bot starts to temprorary ignore.
- SpamCMDTime:
The length of time the user has for SpamCMDs in seconds.
- SpamLines:
How many lines the bot can say in the time limit specified by SpamTime, untill they start to queue.
- SpamTime:
The length of time used for SpamLines in seconds.
- New! SpamBot:
This is whether the bot will say its moves or not (1 for yes, 0 for no)
- New! DrawSkips:
Defines if cards which make players draw also skip their turn (1 for yes, 0 for no)
- New! UNOCmd:
Defines if users must comply with the *uno command rules (1 for yes, 0 for no)
- New! Awards:
Defines if awards will be issued to the winner at the end of games (1 for yes, 0 for no)
- New! SortCards:
Sorts cards in players hands.
- Help, On, Join, BotJoin, Start, Stop, Shuffle, Replace, Off, AddAdmin, DelAdmin, Suspend, Unsuspend:
This is where you can specify the access needed for the commands. You can specify a number from 1-6 meaning:
- Only the bot owner can use it.
- Voice, and Op can use it.
- Op can use it.
- Admin can use it.
- 2 and 4.
- 3 and 4.
Note: 0 or blank to let anyone use the command. Also, the bot owner can do anything regardless of access.
2. Bonus, Earned, and Awards Section New!
The Bonus section is where settings for the bonuses are held:
- New! Fastest:
How many seconds the fastest game was.
- New! CardsPlayed:
How many cards the most amount of cards played by a winner was.
- New! PointsEarned:
How many points the most amount of points earned (excluding bonuses) was.
- New! Streak:
How many games where won in the streak.
- New! StreakBreaker:
How many games have to be in a streak when you break it to win the Streak Breaker award.
When a user wins the Fastest, Cards Played, Points Earned, or Streak Breaker awards, the settings will be updated with the new record.
The Earned section is where the record of who earned the bonuses are held. This shouldn't be manually edited.
The Awards section is where the points earned from a bonus are stored:
- New! Fastest, CardsPlayed, Points Earned, and StreakBreaker:
Points awarded to the corrispondin bonus.
- New! Blackjack and Hundred:
Points earned if the winner gets exactly 21 or 100 points respectively at the end of the game (not counting bonuses).
- New! Streak:
How many points are awarded for streaks, multiplied by the amount of wins in the streak.
3. Admins Sections New!
The Admins Section is set up like: Address=1/2. Having a 2 means they are suspended, 1 means they arn't. You should not manually edit this section, instead use the commands *AddAdmin, *DelAdmin, *Suspend, and *Unsuspend (Explained in 5. Commands).
4. Points, WinsLosses, and Nicks Sections New!
The way points are saved has been changed a lot in UNO v3.0+, and is no longer compatable with the way v2.2 and bellow worked. To save any points you have from your older versions, copy the Points Section from your old settings.ini, and paste it into a new section named OldPoints. When someone wins it will check if they have points in the OldPoints Section, if they do it transfers it to the Points Section and removes it. There are also two new sections used for points: WinsLosses, and Nicks. The WinsLosses Section holds a players wins and losses, seperated by a space, the Nicks Section holds the last known nickname of players with points.
Note: None of these sections should be manually edited.
|
| 5. Commands (Back) |
This is a list of all the commands, they are all used like *command [parameters]. Command shortforms are shown in parenthesis.
Commands:
- On:
This turns UNO on so a game can begin.
- Join (jo):
This is the command used to join the game.
- New! BotJoin (bo):
Makes the bot join the game.
- Leave:
This lets you leave the game.
- New! BotLeave (bl):
This makes the bot leave the game.
- Start (st):
This starts the game.
- New! Stop:
This stops the game, but doesn't turn it off.
- New! Cards (ca):
Tells you your current cards, and the card being played on currently.
- New! Turn (tu):
Tells you who's turn, which direction the order is, the players list, and who's turn is next.
- Play (pl):
This command lets you play a card on your turn. It is by far the hardest command. To play a normal card you just type *play Card. Playing a wildcard is the same except you must specify a color to change to, like *play Card Color. To play all of a certain card, you must type *play S Card Color where Card is the card without its color attached and Color is the color to end on.
- Draw (dr):
If you can't or don't want to play a card, you can draw a card with this.
- Pass (pa):
Once you've drawn a card, you can then play it or pass with this command.
- New! Shuffle:
Shuffle's played cards back into the deck.
- Replace:
If someone leaves during the game, they will be replaced with someone in the replace list. This command places you on the replace list.
- New! BotReplace:
Place the bot on the replace list in case anyone leaves.
- Off:
This turns UNO off. If a game is in progress it is lost.
- Trigger:
This changes the trigger.
- Help:
This gives help for people on mIRC.
- AddAdmin:
Adds a user as an admin.
- DelAdmin:
Deletes an admin.
- Suspend:
Suspends an admin.
- Unsuspend:
Unsuspends an admin.
- New! Score:
Shows your score and rank to the channel. If a nickname is supplied, *score Nick, it will check that nicks score.
- New! Records:
Shows bonus records and the awarded points.
- New! Elapsed:
Shows how long a game has been so far.
- New! Played:
Shows how many cards have been played in total and by each player.
- New! Top:
Takes one paramater X which is a number form 1 to 10, and gives a top X list of players. If you dont supply X it gives the top 10.
|
| 6. Playing (Back) |
1. Rules
There are a total of 108 cards:
- 19 Blue number cards. (One 0, two of each 1-9).
- 19 Green number cards. (One 0, two of each 1-9).
- 19 Red number cards. (One 0, two of each 1-9).
- 19 Yellow number cards. (One 0, two of each 1-9).
- 8 Draw 2 cards, 2 in every color.
- 8 Reverse cards, 2 in every color.
- 8 Skip cards, 2 in every color.
- 4 Wild cards.
- 4 Wild Draw 4 cards.
Each player is dealt 7 cards, the remaining cards are placed face down to form the DRAW pile. The top card of the DRAW pile is turned over to form the DISCARD pile. The first player has to match the top card of the DISCARD pile either by Color, or Card. For example, a Red 2 can be played on a Red S, a Red 2 can be played on a Blue 2, and a Red Skip can be played on a Blue Skip. The player can also put a wild card down. If the player can't play anything or doesn't want to, he can draw a card from the DRAW pile. If the player draws and can play it, he can, if not, he can pass. Once the player plays a card or passes, it is the next players turn. Once a player has no cards left, the game ends and scoring takes place. The cards are scored like so:
- Number cards are face value.
- Draw 2, Reverse, and Skip are 20 points.
- Wild cards are 50 points.
Custom:
If someone leaves during the game, they are replaced by a player in the replace list. If there is noone in the replace list, his cards are put into the DRAW pile, unless there is only one person left which results in the game ending.
2. Game
Someone must type *on to start letting people join. Everyone who wants to join must type *join. Once all the players are in, someone must type *start to begin the game. The first player must either play a card with *play or draw a card with *draw then play the card/pass with *pass. Once their turn is done, the next player continues by doing the same thing. Once a player reaches 0 cards the game ends, and points are calculated for the winner.
|
| 7. Credits (Back) |
UNO v3.0 (Aug 10, 207)
- mklaif:
Idea for cards command and lots of testing (Thanks!).
- Log1x:
Helped test.
- Feren6:
Reported a bug in *uno command.
- agent-smith:
Bug reports, requested all new features, and LOTS of testing. Everyone should kiss his feet for his ideas!
UNO v2.2 (Dec 26, 2006)
- Sparkle:
Idea for spam filters.
UNO v2.1 (Feb 27, 2006)
- flash-Skills:
Notified me of the bug.
UNO v2 (Feb 23, 2006)
- Mpdreamz:
Found a bug that I couldn't reproduce and didn't know how it happened but I think by making reverse's skip in a 1 on 1, it should be fix.
UNO v1 (Jan 31, 2006)
- O-exr8eD-AA-VD:
Made me want to write this.
- nivel:
Helped test.
|
| 8. Contact (Back) |
If you found bugs, have some suggestions or comments, you can contact me any of these ways:
- irc.gamesurge.net in channels #script and #eval as poiuy_qwert or anything with p_q in it.
- irc.undernet.org in channels #mircscripting and #mirc.net as poiuy_qwert or anything with p_q in it.
- Or simply reply where you downloaded it.
|