HalpyBOT Command and Fact Listing
What is HalpyBOT?
HalpyBOT (v2.0.0-alpha) is our Second-Generation IRC Assistant, designed to help Seals get limpets on target faster and more painless than ever before. It comes with a lot of features, and is easy to build upon with new features. Most notably for Seals, it powers our custom commands and functions. This command reference will help you understand the power that HalpyBOT puts in your hand.
Want to check the current status of HalpyBOT? Click Here: HalpyBOT Status Page
Commands vs Facts
You may see two different terms thrown around a lot - Commands and Facts. In short, Commands do something while Facts are just spit out as programmed. If the response needs to be calculated, it's a command. If it's pre-programmed recital, it's a fact.
Case Board
The Case Board serves as a repository for all active cases. When a client initiates a case, it is assigned a unique ID and added to the board. Each entry encompasses vital details such as client name, system, IRC nick, along with specifics regarding the case type (Seal, Black, Blue, KF) and pertinent details for each category. Additionally, it tracks the dispatching and response personnel for each case. Dispatchers have the ability to append notes to the case, detailing factors like the source of damage, notable issues, or information regarding meetup times. Upon filing PW, cases with identical client names are automatically designated as completed and are subsequently removed from the publicly accessible board.
There is currently an issue where some cases are not automatically cleared and have to be manually removed from the case board by the Cyberseals or Admins. This issue occurs if the client name on the case board and the paperwork do not match exactly, for example if someone made a typo, if the client replaced spaces with underscores or dots or if they included the term cmdr in front of their name.
HalpyBOT Command Listing
Below are the HalpyBOT commands that may be used by Seals. You can also access the help documentation by running the !help command.
General Commands
Command | Arguments | Use |
!help | [command] | Provides a contextual help for the various features in HalpyBOT. |
!about | Provide information about HalpyBOT. Responds in DMs, regardless of where run. | |
!welcome | [Client Name or Case ID] | Welcome a client and disables Reminders for that case. |
!spansh | [System/CMDR/Case ID] : [System/CMDR/Case ID] : [Jump Range] | Get spansh jump counts and a link from pojntA to pointB. |
!dist | [System/CMDR/Case ID] : [System/CMDR/Case ID] : <Jump Range> | Check the distance between two points in EDSM and optionally calculate an estimated jump count. |
!diversion | [System/CMDR/Case ID] | Calculate the 5 closest FDEV-placed structures with repair capability to given location. |
!dssa | [System/CMDR/Case ID] | Check for the closest DSSA carrier to a given location. |
!landmark | [System/CMDR/Case ID] | Check if a given point is nearby a given Landmark System. |
!lookup | [System/CMDR/Case ID] | Check if a system exists in EDSM |
!coords | [Set of coordinates, X Y and Z seperated by spaces] | Find a system known to EDSM within a 100ly radius of the provided coordinates |
!locate | [CMDR Name] | Check if a CMDR exists and shares their location in EDSM |
Case Board Management
Command | Arguments | Use | Requirements |
!listboard | Print out the current cases on the Board in DMs. |
Drilled Seals Only, must be run in a channel. | |
!listcase | [Case ID] | # Print out the current cases on the Board in DMs. | Drilled Seals Only, must be run in a channel. |
!status | [Case ID] [New Status] | Set the updated case status. Valid options include ACTIVE , DELAYED , and INACTIVE |
Drilled Seals Only, must be run in a channel. |
!last | Check the time since the last case. | Drilled Seals Only, must be run in a channel. | |
!delcase, !remcase | [Case ID] |
Administratively removes a case from the board, in case something screwed up. Not to be done lightly! |
Admin or Cyberseal |
Case Detail Management
Command | Arguments | Use | Requirements |
!rename | [Case ID] [New Client Name] | Rename the client for a given case. | Drilled Seals Only, must be run in a channel. |
!ircn | [Case ID] [Valic IRC User] | Rename the client for a given case. | Drilled Seals Only, must be run in a channel. |
!system | [Case ID] [New System] | Set the updated client's System. | Drilled Seals Only, must be run in a channel. |
!hull | [Case ID] [New Hull %] |
Set the updated case hull percentage. |
Drilled Seals Only, must be run in a channel. |
!casetype | [Case ID] {New Case Type] |
Set the updated case type. |
Drilled Seals Only, must be run in a channel. |
!platform | [Case ID] [New Case Platform] |
Set the updated case platform. |
Drilled Seals Only, must be run in a channel. |
!planet | [Case ID] [New Planet] |
Edit the planet for a given KF Case. |
Drilled Seals Only, must be run in a channel. |
!casecoords | [Case ID] [X Coordinate] [Y Coordinate] |
Edit the planetary coordinates for a given KF Case. |
Drilled Seals Only, must be run in a channel. |
!kftype | [Case ID] [New Type] |
Change the case type between KF subtypes. Valid options include |
Drilled Seals Only, must be run in a channel. |
!o2time | [Case ID] [O2 Time in MM:SS ] |
Edit the planetary coordinates for a given KF Case. |
Drilled Seals Only, must be run in a channel. |
!synth | [Case ID] [Yes/True/No/False] |
Toggle if a CMDR has synths available for a given case. |
Drilled Seals Only, must be run in a channel. |
!canopy | [Case ID] [Yes/True/No/False] |
Toggle if the canopy is broken for a given case. |
Drilled Seals Only, must be run in a channel. |
Case Responder Management
Command | Arguments | Use | Requirements |
!welcome | [Client Name or Case ID] | Welcome a client and disables Reminders for that case. | |
!silencewelcome | [Client Name or Case ID] | Disables welcome reminders for a case. | |
!go | [Client Name or Case ID] [New Responders] | Add one or more identified Seals as responders to a case on the board. | |
!addresp | [Client Name or Case ID] [New Responders] | Add a new responder to a given case on the board. |
Drilled Seals Only, must be run in a channel. |
!adddisp | [Client Name or Case ID] [New Dispatchers] | Add a new dispatcher to a given case on the board. | Drilled Seals Only, must be run in a channel. |
!remresp | [Client Name or Case ID] [Responders] | Remove a responder from a given case on the board. |
Drilled Seals Only, must be run in a channel. |
!remdisp | [Client Name or Case ID] [Dispatchers] | Remove a dispatcher from a given case on the board. | Drilled Seals Only, must be run in a channel. |
Case Note Management
Command | Arguments | Use | Requirements |
!listnotes | [Case ID] | List the case notes for the given case. |
Drilled Seals Only, must be run in a channel. |
!addnote | [Case ID] [New Note] | Adds a new line to the case notes. |
Drilled Seals Only, must be run in a channel. |
!editnote | [Case ID] [Note Index] [New Note Content] | Edit the specified case note. |
Drilled Seals Only, must be run in a channel. |
!delnote | [Case ID] [Note Index] | Delete the specified case note. |
Drilled Seals Only, must be run in a channel. |
Dispatcher Commands
Command | Arguments | Uses | Requirements |
!mancase, !manualcase | [IRC Name] [Case Info] | Used to start a new Manual Seal Case by Dispatchers | Drillled Seals Only, and run in a channel. |
!manfish, !manualfish | [IRC Name] [Case Info] | Used to start a new Manual Kingfisher Case by Dispatchers | Drillled Seals Only, and run in a channel. |
!tsping, !wssping | [Case Info] | Used to ping the "Trained Seal" role in the Seal discord. |
Drillled Seals Only, and run in a channel. |
!forcejoin | [user] [channel name] | Force a user to join an allowed channel in IRC. | Drilled Seals Only, must be run in a channel. |
!rrjoin | [user] | Forces a user to join #Repair-Requests | Drilled Seals Only, must be run in a channel. |
[Case Info] means that any text after the command will be passed as the case information.
Abuse of tsping will result in heavy disciplinary action.
Utility Commands
Utility commands are useful tools in HalpyBOT, but don't have a specific task in normal repair workflows.
Command | Arguments | Uses | Requirements |
!ping | Check to see if the bot is responding to commands | ||
!dbping | Check to see the responsiveness of the database | Cyberseals Only. | |
!edsmping | Check to see the responsiveness of EDSM's API | Cyberseals Only. | |
!utc | Check for the current In Game Time and Date | ||
!year | Check for the current In Game Year | ||
!whois | [name] | Check the user information for registered name | Must be a registered user, and run in DMs with HalpyBOT. |
!whoami | Check the user information on yourself | Must be a registered user, and run in DMs with HalpyBOT. | |
!say | [channel] [message] | Make HalpyBOT say something in a channel. | Cyberseals Only. |
!serverstatus | Check the current FDEV-Provided Server Status | ||
!cybersignal, !summontech, !calltech, !cybersig | [message] | Sends a notification to all Tech Staff to report an issue | Must be a registered user, and run in a channel. |
!summonstaff, !callstaff, !opsig, !opsignal | [message] | Sends a notification to all non-technical staff to report abuse of systems or other rule issues |
Must be a registered user, and run in a channel. |
!joinchannel |
[channel name] | Instruct HalpyBOT to join a new channel. |
Cyberseals Only. |
!partchannel
|
[channel name] | Instruct HalpyBOT to leave a channel. |
Cyberseals Only. |
!shorten |
[URL] |
Shortens a URL using the hullse.al shortlink host. |
Drilled Seals Only. |
Cybersig and Opsig are limited to once every 5 minutes. Abuse or spam of these commands will result in disciplinary action.
Drill Commands
Command | Arguments | Uses | Requirements |
!drillcase | [cmdr], [platform], [system], [hull] | Manually create a new Seal drill case | Drilled Seals +, in a channel. |
!drillcbcase | [cmdr], [platform], [system], [hull], [cansynth], [o2] | Manually create a new CB drillcase. | Drilled Seals +, in a channel. |
!drillkfcase | [cmdr], [platform], [system], [planet], [coords], [type] | Manually create a new Kingfisher drill case | Drilled Seals +, in a channel. |
Fact Management Commands
Command | Arguments | Uses | Requirements |
!factinfo | [name-lang] | Get information about a fact | Admin or Cyberseal |
!addfact | [fact-lang] [text] | Add a new fact to the database | Admin or Cyberseal |
!deletefact | [fact-lang] | Delete a fact | Admin or Cyberseal |
!allfacts, !factlist, !listfacts |
<language> | List all facts by a given language (English by default) | |
!editfact, !updatefact | [fact-lang] [new text] | Edit an existing fact | Admin or Cyberseal |
!ufi, !updatefactindex | Manually update the Fact listing cache | Cyberseals Only. |
Common Facts
Below are some of the registered Facts in HalpyBOT.
You have to be a registered (+r) user in our IRC in order to use these facts.
No Comments