2004-01-13 Revision (ver.6.2) - Updates - *Fix file transfer bug. *Fix redirect hacking bug. ****************************************************************************************** Software: WPN Chat - Remote Command Management System (RCMS) Author: [Nushi]@[Mataari] Website: http://2sen.dip.jp/ ****************************************************************************************** ### [WARNING] ### 1. System Requirement: Windows 2000/XP only. 2. Operation: WPN Chat server of WinMX v3.31 only. 3. Conditions of use: A. Chatrooms with the purpose and intent of offering file exchange over WinMX are forbidden from using this software. B. Reproduction and redistribution of this software is forbidden without permission from the software authors. (The newest version is distributed at ttp://2sen.dip.jp/) C. In order to prevent the misuse of this software, [RCMS] is automatically inserted in front of the Chatroom topic message. ****************************************************************************************** ### [FUNCTIONS] ### 01. Two or more administrators can be appointed to help the host manage the chatroom. 02. Ability to block users with specified words/characters in their name upon chatroom entry, name chage, message content. 03. A user's IP address, write statistics can be displayed. 04. Concealment of ID-number and the use of the anonymous user #NONAME feature. (e.g. Honda123_54321> --> Honda>) (e.g. Noname> Hello! I'm a ghost!) 05. Various User Rankings can be displayed. (e.g. Write Count, Write Frequency, Stay Time, Lurker) 06. User name change notification. 07. Management Window - Seperate window that opens which displays 2 tabs: A. User List + User Name + Files (being shared) + Speed (Internet connection) + IP Address + Count (number of messages contributed to the chatroom) + Status (Host, Admin, User) + Last Text (last message typed by the user) B. Penalty List + User Name + IP Address + Penalty (time before they are allowed to enter again) 08. Entrance Block - The prevention against users who enter and leave the chatrooom continuously without chatting. (Given a "Penalty"). 09. Leechers (Users sharing 0 files) can be blocked. Offensive usernames can be blocked by setting keywords (See RCMSConf.txt file). 10. Trouble creating a chatroom caused by the loopback problem of a router can be solved. 11. Messages and username block are customizable. ****************************************************************************************** ### [INSTALL] ### 1. First make sure that WinMX is closed. 2. Decompress the file "Antisuneo5x.lzh" to "Desktop" using WinRAR (http://www.rarlab.com) 3. Copy both files (WS2_32.dll and WS2_32o.dll) into the folder where WinMX.exe is located. (Make sure you're copying the files for the correct Operating System [2k/XP]) 4. Also copy the file RCMSConf.txt into the same folder. (The software will still function without this file though). 5. If you can hear a beep sound upon starting WinMX, the software is operating correctly. ****************************************************************************************** ### [HOW TO USE] ### 1. Startup the WinMX program. 2. Click on "Chat" tab. 3. Click on "Host New Channel" button and give your chatroom a name. 4. If the RCMS starts correctly, the plugin version information will be displayed in your chatroom. 5. If there is a startup file (your own setup), it will be loaded into the chatroom. ****************************************************************************************** ### [WHEN YOU CAN'T CREATE A CHATROOM WHILST USING PRIMARY CONNECTION] ### This problem may be caused by the loopback of a router. There's a solution: Please describe your global IP address to "YourAddress" under "[Loopback]" in the RCMSConf.txt file. NOTE: DDNS (Dynamic Domain Name Service) name can be specified. (e.g. YourAddress=218.54.26.47) (e.g. YourAddress=nushi.dip.jp) ****************************************************************************************** ### [STARTUP FILE] ### 1. You can create a startup file to automatically set commands for your chatroom. 2. Use a simple text editor such as "Notepad" to add the commands on seperate lines. 3. Make sure to name the file "ChatStartup" (with .txt file extension) and save it into the folder where WinMX.exe is located. 4. Here is what a sample ChatStartup.txt file would contain: #ADMINCMD HIDECOMMANDON #ADMINCMD DISABLEUSERCMD #ADMINCMD SHOWNICKCHANGEON #ADMINCMD TRADERBLOCKON #ADMINCMD PENALTYON #USERCMD WELCOMEMSGON #USERCMD SETWELCOMEMSG #NICKNAME WelcomeBot #MESSAGE Hey there %NAME%! (%IP%) Welcome to our chatroom! /limit 60 /setmotd Welcome to Channel WinMX! #\R\N# We have admins monitoring this room so please behave yourself #\R\N# No file trading is permitted in this room, sorry. #\R\N# Enjoy your visit!! 5. When you start WinMX and host a channel, the ChatStartup.txt file will be loaded and the settings will be implemented instantly. 6. Explanation of the ChatStartup.txt sample: + 1st line - Hides the admin commands from ordinary users. + 2nd line - Disables the use of #USERCMD commands. + 3rd line - Notifies when a user has changed their name. + 4th line - Enables Username Block (Keywords can be set in the RCMSConf.txt file and is useful when you want to block users with offensive names from entering the chatroom). + 5th line - Blocks a user from re-entering the chatroom if they left suddenly without typing any messages. (This command is useful to prevent users from abusing the chatroom by continually entering, leaving and re-entering to flood the room). + 6th line - Enables the Auto-welcome message to greet users upon entry into the chatroom. + 7th line - Sets the Auto-welcome message. ( Hey kawasaki! (123.45.678.90) Welcome to our chatroom!) + 8th line - Sets the maximum number of users permitted to stay in the chatroom. (In this example, the chatroom allows 60 users to stay). + 9th line - Sets the MOTD (Message Of The Day) which is displayed at the top of the main chatroom window when a user enters the chatroom. (To list messages in rows, use the code #\R\N# and make sure the entire text is all on one line). (In this example: topic: Welcome to Channel WinMX! <> We have admins monitoring this room so please behave yourself <> No file trading is permitted in this room, sorry. <> Enjoy your visit!! 7. Please look at the ADMINISTRATOR COMMAND REFERENCE and USER COMMAND REFERENCE for use with your own ChatStartup.txt file. ****************************************************************************************** ### [ENTRANCE PENALTY] ### 1. When a user enters and leaves the chatroom without typing a single message, their IP address is memorized and they will be prevented from re-entry within a specified duration of time. (They are given a Penalty, see the MANAGEMENT WINDOW section for more information). 2. The Penalty Time can be set as follows: 10secs, 30secs, 1min (After which the Penalty Time can be set at 1min increments [e.g. 2mins, 3mins, etc]) NOTE: Penalty Time means the amount of time before the user is allowed back into the chatroom. NOTE: If the user does type a message before leaving the chatroom, their IP address will be erased from memory. NOTE: Penaltied users can be cleared from the MANAGEMENT WINDOW. ****************************************************************************************** ### [ADMINISTRATOR POWER] ### 1. An administrator can change their username without losing their admin power. 2. Attempts at unauthorized use of the admin power by hijacking an admin's name is prevented. ****************************************************************************************** ### [MANAGEMENT WINDOW] ### 1. This is a seperate window that opens when you host a chatroom. 2. The window is resizable. 3. The left panel displays information on users to the chatroom. 4. The right panel display the chat log (Time, Event). 5. You can double-click on any item in the tables to copy the contents. 6. Right-click on a username to get a menu selection (Only applies to the left panel): + Redirect (R) + Kick (K) + KickBan (D) + Ban (B) + UnBan (U) + Clear Ghost (G) --------------------- + User Info (S) + IP Address (I) --------------------- + Add Admin (A) + Remove Admin (C) --------------------- + Private Message (P) NOTE: When you right-click to get the menu, you can just press the corresponding letter displayed in the brackets (keyboard shortcut). ****************************************************************************************** ### [ADMINISTRATOR COMMAND REFERENCE] ### ------------------------------------------------------------------------------------------ #ADMINCMD LOADSETTING RCMSConf.txt file is reloaded into the chatroom system. The configuration setting changes are immediately implemented in the chatroom system. NOTE: Only the Chatroom host can use this command. NOTE: RCMSConf.txt is the configurations and settings of the RCMS software. Do not edit this file unless you know how to change the settings. ------------------------------------------------------------------------------------------ #ADMINCMD ENABLEUSERCMD Enables the the use of #USERCMD command. NOTE: This particular command is of no concern for Administrators. ------------------------------------------------------------------------------------------ #ADMINCMD DISABLEUSERCMD Disables the use of #USERCMD command. NOTE: This particular command is of no concern for Administrators. ------------------------------------------------------------------------------------------ #ADMINCMD HIDEIDON Enables the concealment of username ID-number (e.g. username: ) NOTE: This is the default setting. ------------------------------------------------------------------------------------------ #ADMINCMD HIDEIDOFF Disables the concealment of username ID-number (e.g. username: ) ------------------------------------------------------------------------------------------ #ADMINCMD SHOWNICKCHANGEON Enables notification of username change. ------------------------------------------------------------------------------------------ #ADMINCMD SHOWNICKCHANGEOFF Disables notification of username change. NOTE: This is the default setting. ------------------------------------------------------------------------------------------ #ADMINCMD PRINTIP username Displays the IP address of a specified user. (e.g. #ADMINCMD PRINTIP kawasaki987_24680) ------------------------------------------------------------------------------------------ #ADMINCMD RESETCHATSTAT Resets the chat statistics. ------------------------------------------------------------------------------------------ #ADMINCMD ADDADMIN username Adds the specified user as an administrator. (e.g. #ADMINCMD ADDADMIN yamaha135_12480) NOTE: The channel host can add an administrator with ease by right-clicking on a user's name in MANAGEMENT WINDOW and selecting "AddAdmin" option. The administrator can change his username without losing administrator power. ------------------------------------------------------------------------------------------ #ADMINCMD REMOVEADMIN username Removes the specified user from being an administrator. (e.g. #ADMINCMD REMOVEADMIN yamaha135_12480) NOTE: The channel host can remove an administrator with ease by right-clicking on a user's name in MANAGEMENT WINDOW and selecting "RemoveAdmin" option. ------------------------------------------------------------------------------------------ #ADMINCMD CLEARADMIN Clears all administrators. (i.e. Removes administrator power from all administrators). ------------------------------------------------------------------------------------------ #ADMINCMD NOSHAREBLOCKON Enables Leecher Block. (Users with 0 Shared Files will be blocked from entering the chatroom). ------------------------------------------------------------------------------------------ #ADMINCMD NOSHAREBLOCKOFF Disables Leecher Block. (Users with 0 Shared Files will be able to enter the chatroom). ------------------------------------------------------------------------------------------ #ADMINCMD AUTOROMBLOCKON Enables Lurker Block. NOTE: Users who type only 5 or less messages within the specified Lurker Block time will be automatically kicked out of the chatroom and blocked. NOTE: This feature has no effect on administrators. NOTE: The default countdown time to Lurker Block is set at 60mins ------------------------------------------------------------------------------------------ #ADMINCMD AUTOROMBLOCKOFF Disables Lurker Block. (Users who stay in the background without chatting are permitted to stay in the chatroom). ------------------------------------------------------------------------------------------ #ADMINCMD SETROMBLOCKTIME minutes Sets the countdown time before a user is kicked out of the chatroom and blocked for being inactive. (e.g. #ADMIN SETROMBLOCKTIME 30) If the user is completely inactive for more than 30mins, they will be kicked out of the chatroom and blocked. NOTE: /kickban command does not work when applied to oneself. ------------------------------------------------------------------------------------------ #ADMINCMD TRADERBLOCKON Enables Username Block. Users with certain words or characters in their name can be blocked. NOTE: Locate the file RCMS.txt and set the keywords to block users (located at the very end of that file). (e.g. Word[0]="fuck") Usernames with this keyword in their name will be blocked. NOTE: Maximum number of keywords that can be set is 128. ------------------------------------------------------------------------------------------ #ADMINCMD TRADERBLOCKOFF Disables Username Block. ------------------------------------------------------------------------------------------ #ADMINCMD HIDECOMMANDON Enables the concealment of commands. (Commands will be substituted with ********). NOTE: Only the channel host and administrators will be able to see the commands. NOTE: Ordinary users will not be able to see the commands. NOTE: [Admin Message] is also concealed from ordinary users. ------------------------------------------------------------------------------------------ #ADMINCMD HIDECOMMANDOFF Disables the concealment of commands. NOTE: It is recommended that you don't use this command. ------------------------------------------------------------------------------------------ #ADMINCMD /kickban username Kicks and bans the user from the chatroom. (e.g. #ADMINCMD /kickban kawasaki987_24680) NOTE: Cannot be used on oneself. ------------------------------------------------------------------------------------------ #ADMINCMD /ban username Bans the specified user from the chatroom. (e.g. #ADMINCMD /ban yamaha135_12480) ------------------------------------------------------------------------------------------ #ADMINCMD /limit number Sets the maximum number of users allowed into the chatroom. (e.g. #ADMINCMD /limit 100) ------------------------------------------------------------------------------------------ #ADMINCMD PENALTYON Enables the Entrance Penalty. (This command gives an "Entrance Penalty" to users who enter and leave chat quickly without typing a message. They will be prevented from re-entering the chatroom for a specified amount of time). NOTE: This is the default setting. NOTE: Default penalty is 10secs, next penalty time is 20secs, 30secs, then 1min increments. ------------------------------------------------------------------------------------------ #ADMINCMD PENALTYOFF Disables the Entrance Penalty. (Allows users to enter/quit the chatroom without chatting). NOTE: Penalty List will be cleared simultaneously. ------------------------------------------------------------------------------------------ #ADMINCMD PRINTUSERLIST Displays list of user. ------------------------------------------------------------------------------------------ #ADMINCMD PRINTEVENTLOG Displays last 50 lines event log. ****************************************************************************************** ### [USER COMMAND REFERENCE] ### ------------------------------------------------------------------------------------------ #USERCMD WELCOMEMSGON Enables the automatic welcome message. ------------------------------------------------------------------------------------------ #USERCMD WELCOMEMSGOFF Disables the automatic welcome message. ------------------------------------------------------------------------------------------ #USERCMD SETWELCOMEMSG message Sets the automatic welcome message. The keywords listed below can be used in the welcome message. KEYWORD DESCRIPTION ========= ================================================== %NAME% Displays username. (excludes ID-number: [e.g. lexus]) %RAWNAME% Displays username. (includes ID-number: [e.g. lexus430_10410]) %LINE% Displays the Internet connection type. (e.g. 56k, DSL, Cable, T1, etc) %FILES% Displays the number of Shared Files. (Only the administrator can specify this keyword). %IP% Displays the IP address. (Only the administrator can specify this keyword). %PORT% Displays the connection port. (e.g. 4545) ------------------------------------------------------------------------------------------ #USERCMD PRINTCHATSTAT Displays chatroom statistics. The statistics include: - Total operation time. (Total time since the host started the chatroom). - Total write. (Total messages written in the chatroom). - Write frequency. (The average number of messages written in an hour). - Total block. (Total number of users blocked from the chatroom). - Average write. - Average stay. (Average stay time of a user in the chatroom). ------------------------------------------------------------------------------------------ #USERCMD PRINTUSERSTAT username Displays the Write Count and Stay Time of the specified user. (e.g. #USERCMD PRINTUSERSTAT lexus430_10410) NOTE: The user's ID (e.g. 430_10410) will also be displayed. ------------------------------------------------------------------------------------------ #USERCMD PRINTWRITERANKING Displays Write Frequency Ranking. (Number of messages the users have typed on average per hour in the chatroom). NOTE: The chatroom host is excluded from the Write Frequency Ranking. ------------------------------------------------------------------------------------------ #USERCMD PRINTRAWWRITERANKING Displays Write Count Ranking. (Number of messages the users have typed in the chatroom). NOTE: The chatroom host is excluded from the Print Count Ranking. ------------------------------------------------------------------------------------------ #USERCMD PRINTTIMERANKING Displays Stay Ranking. (Amount of time the users have been in the chatroom). NOTE: The chatroom host is excluded from the Stay Ranking. ------------------------------------------------------------------------------------------ #USERCMD PRINTROMRANKING Displays Lurker Ranking. (Users in the background who don't chat). NOTE: The chatroom host is excluded from the Lurker Ranking. ------------------------------------------------------------------------------------------ #USERCMD /kick username Kicks the specified user out of the chatroom. (e.g. #USERCMD /kick toyota104_98765) ------------------------------------------------------------------------------------------ #USERCMD /unban username Unbans the specified user. (e.g. #USERCMD /unban datsun240_55523) ------------------------------------------------------------------------------------------ #USERCMD /clearbans Clears all banned users. ------------------------------------------------------------------------------------------ #USERCMD CLEARDELAY Clears the "Penalty List". ------------------------------------------------------------------------------------------ #NONAME message Writes a message as the anonymous user [NONAME]. (e.g. #NONAME Hi, I'm Suzuki Ichiro.) (that display in the chatroom as --> Hi, I'm Suzuki Ichiro.) NOTE: Only works when the ID-number is hidden. ------------------------------------------------------------------------------------------ #NICKNAME name #MESSAGE message Writes a message as the anonymous user [depends on the name you choose] (e.g. #NICKNAME Ghost #MESSAGE I'm talking to you from beyond) (that displays in the chatroom as --> I'm talking to you from beyond.) NOTE: Only works when the ID-number is hidden. ------------------------------------------------------------------------------------------ #USERCMD WRITEMESSAGE message Leave a message. (e.g. #USERCMD WRITEMESSAGE I'm away.) ------------------------------------------------------------------------------------------ #USERCMD READMESSAGE username Displays the messages left by the specified user. (e.g. #USERCMD READMESSAGE datsun240_55523) ------------------------------------------------------------------------------------------ #USERCMD PRINTVERSION Displays the version information of RCMS. ------------------------------------------------------------------------------------------ #USERCMD PRINTADMINLIST Displays list of administrator. ------------------------------------------------------------------------------------------ [EOF]