Koen is an IRC bot run by Adreos for Infinitas. Koen features several features to aid players and helps moderation of the RP by providing logs for the staff
#koen - A room setup for testing and using Koen's commands without spamming the main room.
In Character
Most of the commands except !recall will not work int he IC rooms to avoid IC spam.
#infinitas - Main IC Room
#infinitas2
#infinitas3
#infinitas4
#infinitas5
#infinitas6
#infinitas7
Auto-Recall
When a person disconnects and reconnects Koen will automatically PM them the last several lines from any IC room there were chatting in.
Only send logs one hour old or newer will be sent
Only up to 20 logs may be sent from any room.
Only rooms recently posted in by that person will be recalled on rejoin
Automatic recall is tracked by your IRC identity instead of your nick. (Everything after the @ in a /whois query) If your IRC identity changes Koen will not send automatic log recall for IC rooms. A manual !recall may be performed instead.
Definitions
To facilitate ease of role play Koen stores short definitions of character and other things in his database for access through IRC.
Quick definitions are intended to be what a person would notice on meeting for the first time. Appearances, any normal or unusual smells or sounds. Regular attire, and so on. Powers, abilities, history, skills, and so on are not needed for the definitions.
Reading Definitions
To read a definition the following must be said on IRC in #infinitasooc or #koen. Koen may be PMed for a term if the user is joined to #infinitasooc at the time.
!term term
term is the term to look up.
The definition will be posted into the same location the query was asked. Some queries will be multilined.
The following aliases may be used in the place of !term
@info !info !lookup
Adding/Editing Definitions
To add or edit a definition the following must be said on IRC in #infinitasooc or #koen. Logged in users may edit in PMs to Koen too.
!store termdescriptioncslink
term - The definition term to store. All terms must be single words and consist only of letters, numbers, underscores ( _ ) and seperators ( | )
description - The actual description of the definition. Infinitas Rules must be followed. The tilda (~) is used as a line break. To show a tilda in the description it must be escaped first ( /~ )
cslink - This should be included on main character descriptions as a link to that character's character sheet.
Players can only edit definitions they have created under that login. Or if it was made without being logged in, under the same nick on the server.
The following aliases may be used in the place of !store
@store !define
Definition Information
!about term
The above command in IRC will provide the information about the term requested including who created it, when it was created, when it was last updated, and when it was last looked up.
Deleting Definitions
!delete term
The above command will delete a definition from Koen's database. This cannot be undone.
A definition can only be removed by the user it is registered to, or the person who created it, or an operator.
Searching Terms
!search query-d
The above command will search the database for all definitions with a term like query and provide a list. In the event of only a single match that definition will be displayed.
If the optional flag -d is added Koen will search the descriptions for query instead of the terms.
Claiming Definitions
In the past the definitions where stored by another bot known as Quincux. Koen copied definitions as they were stored or called up by Quincux.
Users logged into Koen may claim terms Koen stored from Quincux as their own with the following command
!claim term
Definitions List
All stored descriptions are visible on the Infinitas Website at Term Descriptions.
Please not that this online list is not updated instantly and may take several hours to update from recent changes
Logging In
Koen supports user logins to aid additional functions. All login commands are run by PMing Koen and are not logged by Koen.
To register a user account with Koen one merely needs to PM him the following
!register namepasswordpassword
This will create a user account of name [n]name[/u] using the password password. name does not have to match you forum name or IRC nicks.
Logging in
!login namepassword-s
This will log you in with Koen if name and password match what you created in register.
Adding -s will silence responses to correct logins. In simpler terms, if you login correctly this makes him say nothing.
!password old passwordnew passwordnew password
This will change your password from old password to new password. You must be already logged in to change passwords.
If you forget your password altogether contact an infinitas OP for a password reset
!logout
This will log you out of Koen. You will also log out if you disconnect from IRC or Koen does.
Commands
As an IRC bot Koen readily accepts many commands to aide role playing, assist players, or just be entertaining. The following is a list of all public commands by Koen.
Commands fall into one of four categories.
Role Play Tools - These commands are designed to directly aid role playing on infinitas
Other Tools - These commands commands may help with role playing but can have a variety of other uses
For Fun - These commands are simply for random fun and other purposes.
User Tools - These commands are to help logged in users
Aliases
Many commands have alternates that can be used to the same effect as the original command.
Example: !term water will have the same effect as @info water as !term and @info are aliases for each other.
Spoken Commands
These commands (except !recall) are only executable in OOC chat rooms such as #infinitasooc and #koen. They will not activate in IC rooms.
To use these commands start the line with the provide word, including its symbol.
- Role Play Tools
!about
See the above section on definition information
!alias
!alias aliasdefinition
Forms an alias definition that links to the original definition.
Example: !alias John|Wolf Johnwolf will make the term John|Wolf call up the same information as Johnwolf
!current
Combination of !weather, !time, !lastplay, !sun, and !moon though detail is reduced.
!info
See the above section on reading definitions
Aliases: @info !term
!lastplay
!lastplay !room
Looks up when the last line was said in room. Only IC rooms may be looked up this way.
!moon
Displays the current phases of the two moons.
!pages
Displays all websites relevant to Infinitas Role Playing.
!recent
Shows all IC rooms, if they have been used within the hour, and number of people in the room.
!rooms
Shows all Infinitas relevant chat rooms
!search
See the above section on searching definitions
!store
See the above section on adding/editing definitions
Aliases: @store !define
!sun
Displays the sunrise/sunset times for the current day
!time
Displays the current Infinitas RP time
!weather
!weather area
Displays the current weather information. area may be included for specific information. When omitted a generalized summary is displayed.
area may be
temperature - Shows current temperature
humidity - Shows the current humidity
precipitation - Shows the current precipitation information
clouds - Shows details about the cloud cover
conditions - Shows the current general condition (sunny, cloudy, etc)
winds - Show the current wind details, speed and direction
snow - Shows the accumulated snow on the ground.
- Other Tools
!convert
!convert amountfrom typeto type
Performs a conversion between two measurement types. Only can convert between same types. common abbreviations are allowed.
length - centimeters, meters, kilometers, inches, feet, yards, miles
weight - ounces, pounds, tons, grams, kilograms
temperatures - farenheit, celcius, kelvin
currency - dollars, florins*
* Florins are the IC currency and can only convert to US dollars. Please use a converter to make local currencies into US Dollars for !convert
!flip
!flip amount
Flip an amount of coins for heads or tails. Will flip a single coin if amount is omitted
!help
!help command
Provides the list of available commands.
If command is included it will provide instructions on how to use command
!math
!math equation
Evaluate a math equation like a calculator. Due to the limitations of IRC Koen understands the following math operators
+ - * / ^ ( )
!recall
!recall amount
Display, to the user only, the last amount of lines from the room the command is entered in
!roll
!roll xdy+-z+-w
Rolls X dice with Y sides from xdy. X may be omitted for a single die to be rolled.
+-z may be included, without a space after xdy to modify the results on the individual dice.
+-w may be included, with a space after xdy to modify the the final total result.
!rps
Starts a rock paper scissors game. Twp players must PM Koen the following after game start
!rps throw
The throw must be rock paper or scissors.
Once two players have PMed Koen the results will be displayed in the room !rps was started in.
- For Fun
!8ball
!8ball question
Ask for a random yes/no answer to question
!animal
Calls up a random animal name
!arrest
!arrest namecrime
Have name accused of a ficitious crime. If one is not specified a random one will be assigned. Results display after a minute.
This is fictious and for fun only. Nothing serious
!hangman
!hangman start/stop
Shows the current hangman game in progress. May include start to begin a game or stop to end the current game.
Once a game is started players may guess a letter with
!guess letter
Or attempt to solve with
!solve answer
Due to the spammy nature of the game please do not use in a regular room, use #koen
!humanoid
Gives a random humanoid mythical species.
!location
Gives a random location
!mutate
!mutate target
Gives a random mutation for you or an optional target.
!object
Gives a random object name.
[player]
!uno
!uno actionparameters
Displays the current status on the uno game in progress if no action is specified. action may include the following
start - Prepares a new game. After players have joined entering again will start the game. If only one player joins Koen will be player two.
stop - End the current game
join - After the start action has been entered once allows you to join the current game. Cannot be used after game start
hand - Koen will send the player their current hand
play - Plays the card specified in parameters. Cardnames go "color number/name" to be recognized, without quotes. For wild cards the cardname goes "wild color"
draw - Draw a card. Will force a turn pass instead if a card is already drawn.
pass - Passes the turn. Will force a card draw instead if one has not happened this turn.
Changing nicks during play does not effect the game.
Due to the spammy nature of the game please do not use in a regular room, use #koen[/player]
Personal Commands
These commands are run by sending Koen PM messages in IRC.
- Role Play Tools
!about
See the above section on definition information
!search
See the above section on searching definitions
!term
See the above section on looking up terms
!weather
!weather area
Displays the current weather information. area may be included for specific information. When omitted a generalized summary is displayed.
area may be
temperature - Shows current temperature
humidity - Shows the current humidity
precipitation - Shows the current precipitation information
clouds - Shows details about the cloud cover
conditions - Shows the current general condition (sunny, cloudy, etc)
winds - Show the current wind details, speed and direction
snow - Shows the accumulated snow on the ground.
- Other Tools
!convert
!convert amountfrom typeto type
Performs a conversion between two measurement types. Only can convert between same types. common abbreviations are allowed.
length - centimeters, meters, kilometers, inches, feet, yards, miles
weight - ounces, pounds, tons, grams, kilograms
temperatures - farenheit, celcius, kelvin
currency - dollars, florins*
* Florins are the IC currency and can only convert to US dollars. Please use a converter to make local currencies into US Dollars for !convert
!flip
!flip amount
Flip an amount of coins for heads or tails. Will flip a single coin if amount is omitted
!help
!help command
Provides the list of available commands.
If command is included it will provide instructions on how to use command
!math
!math equation
Evaluate a math equation like a calculator. Due to the limitations of IRC Koen understands the following math operators
+ - * / ^ ( )
!part
[qupte]!part room[/quote]
Tells Koen to leave room. This can only be done by a logged in operator of Koen or an operator (@) of that room.
!recall
!recall roomamount
Display the last amount of lines from room. Must be joined to room for this command to execute
!roll
!roll xdy+-z+-w
Rolls X dice with Y sides from xdy. X may be omitted for a single die to be rolled.
+-z may be included, without a space after xdy to modify the results on the individual dice.
+-w may be included, with a space after xdy to modify the the final total result.
!room
!room room
Quries Koen's settings for room
!rps
!rps throw
The throw must be rock paper or scissors.
Throws rock, paper, or scissors for a Rock Paper Scissors game started in a room with !rps
- User Tools
!login
!login userpassword-s
Will log in the person to Koen as user.
If -s is added Koen will not respond on success.
If password has been forgotten speak to Infinitas Ops about a reset.
!logout
Logs out of Koen
!password
!password old passwordnew passwordnew password
Updates the password when logged in.
!register
!register userpasswordpassword
Registers an account with Koen. user and password will be used with !login