Rasher
Admin
Joined: 05 Sep 2008
Posts: 13
|
 Posted: 06/09/2008 13:15 Post subject: sansan v3 released! |
 |
|
Here it is:
http://vicecitymultiplayer.com/downloads/scripts/vcmp-sansan_v3.0.zip
sansan has a ton of features, but requires a little custom setup of your server config.ini and a copy of it in the bot directory to really shine....
/*
sansan v3.0 rcon mIRC echo bot with gamemode support for VC:MP 0.3z
coded by bakasan
inspired by Falcon and Tommis and their mIRC scripts ._.
*/
Note: This was only tested on mIRC version 6.16, but should work on newer versions of mirc just fine.
Getting Started:
1) make a new folder and extract sansan into it
2) copy your mirc.exe and a copy of your server's current "config.ini" file into the new sansan folder
3) run the mirc.exe and fill out all the needed mirc info in Tools->Options (mirc nicks, email, irc-server address, etc)
4) in irc type: /load -rs rcon.mrc
5) sansan will ask you for your /identify password
note: sansan uses this to auto-identify your bot on the irc network
6) sansan will ask you for your "homechan" info
note: this is the mIRC channel you want your bot to live in - include channel password if one is required to join the channel
7) sansan will ask you for the host - this is the server ip of your vcmp server
sansan will ask you for the port - this is your RCON port from your vcmp server config.ini
9) sansan will ask you for the pass - this is your adminpassword from your vcmp server config.ini
10) sansan should connect to the server right away
troubleshooting:
-if it doesn't load right away, first try just disconnecting/reconnecting to irc
-if it still wont connect, you may have entered wrong info (click Scripts Editor button and go to Variables tab to view/change what you entered)
-if all the above is correct you have some other problem not related to sansan
11) join server and register using /c register <password>
12) from mIRC do !mkadmin <yourfullnickname> 10 (note: u cannot do !commands from the bot itself and you must be an op in the channel)
13) next time you login with /c login <password> you will be admin level 10 (if you are still ingame just type /c login <pass> again, no need to rejoin)
Enjoy! Write a mode! Share it on the forums!
-----------------------------------------------------------------------------------
sansan v3.0 Features:
mIRC Features:
-Auto-Identify with NickServ
-Auto-HomeChannel Join
-HomeChannel Commands based on channel permissions (game commands for vop, basic admin commands for hop, and top level commands for op)
-HomeChannel Command flood protection
-"EchoLevel" feature allows you to control how much of the game is echoed into mIRC (usage: !echolevel <level> - e.g. !echolevel 6) note: must be at least hop in the homechan to set the echolevel
!echolevel settings:
0 - no echo into home channel (but game is still processed by the bot)
1 - only joins / parts are echoed
2 - only joins / parts and kills / deaths are echoed
3 - only joins / parts, kills / deaths and chat are echoed
4 - (default setting) echo shows all events that 3 does plus shows server adminchat events
5 - shows all events 4 does, plus adminmsg server pms to players
6 - shows all events 5 does, plus player enter/exit vehicle events
if you just do !echolevel with no number, it will display the current echolevel
-IRC HomeChannel Commands:
These commands can be done from the mIRC channel the bot is echoing into.
Commands for anyone:
!players - Lists Players ingame
!say or !chat - Allows a person in mirc to chat into the vcmp server
!msg or !pm <player nick or id> - Allows a person in mirc to private message someone in the vcmp server
!spree or !killingspree - Shows how is on a killing spree
Game Commands for vop and higher +
!hp <player nick or id> - Shows a player's current health and armour
!car <player nick or id> - Shows a player's current vehicle
!loc <player nick or id> - Shows a player's current location
!cash <player nick or id> - Shows a player's current money
!spawned <player nick or id> - Shows if a player is currently spawned
!stats <player nick or id> - Shows a player's stats (work's if the player is offline as well)
Admin Commands for hop and higher +
!kick <player nick or id> - Kicks a player
!ban <player nick or id> - Bans a player
!banip <IP Address> - Bans an IP Address
!unban or !unbanip <IP Address> - Unbans an IP Address (Usually)
!rcon - Checks if the bot is connected, if not tries to reconnect
!forecast - Calls for a weather forecast (switches to the next random weather soon)
!lock <full nickname> - Locks a player's account making them unable to login
!unlock <full nickname> - Unlocks a player's account allowing them to login again
!reset <full nickname> - Resets a player's password: Next time they login it will ask them to reset their password with /c password <newpassword>
!stfu <player nick or id> - Adds a player to the stfu list (Autokick for chatting)
!unstfu <player nick or id> - Removes a player from teh stfu list
!tstfu <player nick or id> <minutes> - Temp STFU for x minutes
!disarm <player nick or id> - Disarm a player (no weapons)
!echolevel - Get echolevel
!echolevel <level> - Set echolevel
Commands for op only @ & ~
!mkadmin <full nickname> <admin level> - Sets a player's admin level (If they are ingame when their adminlevel is set from mIRC, they must type /c login <theirpassword> to gain admin privs)
!<botname> commands (Commands based on your bot's current name (if your bot is called MyBot, the commands would be !myBot)
InGame Commands:
!help
!info
!irc
!players
!commands
!rules
!weather
!count or !cd
!spree or !killingspree
!hp
!stat or !stats
!team or !skin
!report
!admin
!spawned
!car
!cash or !money
!givecash or !gc or !givemoney
!account or !bank
!deposit or !bank+
!withdraw or !bank-
!bankrupt or !br
!disarm
!slap
!forecast
!cloudy
!lightning
!fog
!sun
!rain
!eclipse
!setweather or !sw
!settime or !st
!coord
!healthpickup
!armourpickup
!setpickup or !sp
!mkadmin
!kick
!ban
!tban
!getcar
!lock
!unlock
!stfu
!unstfu
!tstfu
!mode
!radar
RCON Features:
-Auto-Connect
-Keep-Alive keeps trying to reconnect the bot if it disconnects
-Random Weather set at random times (add settings to %climate to have them included into the randomizer)
-Chat Flood protection stops spammers
-InGame-Command flood protection
-GameMode Support
Modes can be loaded from mirc or from ingame by admins
Last Man Standing Mode included!
http://www.youtube.com/watch?v=QRa9TIwRqZQ Hopefully it will give some people ideas on how to make their own modes as well
Generic Blank mode included (copy it to use as a start point for making a new mode)
To load a mode from ingame, Admin level 10 or higher do:
!mode - view current mode
!mode <modename> - load a mode
!mode list - list recently loaded modes
From mIRC, @ & ~ op or higher do:
!<botname> mode - view current mode
!<botname> mode load <modename> - load a mode
!<botname> mode list - list recently loaded modes
More about modes will probably appear in the forums...
-Config.ini Support
Place a copy of your server's config.ini into the bot directory and reload the bot to enable config.ini support
The config.ini file is parsed into a hash table which sansan can use to add alot of functionality to the game
Features that config.ini support enables:
-Skin and Team Detection
-Dynamic Spawnkill Protection (based on the spawnpoints in your config.ini)
-Pickups from teh config.ini will be included in with script pickups by default
-Counts the number of spawnpoints, Pickups, and Vehicles in your ini for you and displays the totals when being parsed
-Saves a crc of the config.ini when its read, if you replace your config.ini and reload the bot it will notice it has changed and rescan it
Special config.ini configuration needed to enable team names:
1) You must have a copy of your latest server config.ini file in the bot directory
2) You must label the ClassDescription according to the team number for each team
For instance, if the Class Description of team 3 is "Robbers", ClassDescription.3 = Robbers
As long as the ClassDescription has the .3 it will become associated with team 3
If any of these steps are missing or not correct, some features will fail or work unpredictably -_-
Account System:
Stats system from RPGDMv2 included
Stats include Joins, Kills, Times Killed, Deaths, Best Killing Spree, Kill to Killed Ratio, and Exhaustiv time played in the server (before last login - this is the time played as of the last time you quit, not including the current time if you are currently ingame - counts from join to quit)
Stats also conține number of kills per weapon (known as "weapon Stats")
Passwords are stored with one-way encryption, so even server admin won't know anyone's password
Reset Password feature included - !reset <fullnickname>
Auto Login Feature (use /c logout to disable AutoLogin on next join if using a shared computer)
There are alot more features, including lots of highly useful generic aliases for making modes. I reccomend looking thru the code just to see what features are available before starting a mode, it may simplify alot for you codewise. I developed this bot to use as a base for my RPGDM script you may have seen in UltraMegaServer. It has alot of the functionality that makes RPGDM work the way it does. I even left the account system setup similar to how RPGDM is, so it would be fairly easy to use for making a comparable RPG script. Happy scripting! |
|
