# 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](https://halpybot-status.hullseals.space/) #### 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
CommandArgumentsUse
!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
CommandArgumentsUseRequirements
!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
CommandArgumentsUseRequirements
!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. Valid options include `SEAL`, `BLACK`, `BLUE`, and `FISH`. Drilled Seals Only, must be run in a channel.
!platform\[Case ID\] \[New Case Platform\]Set the updated case platform. Valid options include `ODYSSEY`, `LIVE`, `LEGACY`, `XBOX`and `PLAYSTATION`. 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 `LIFT`, `GOLF`, `PUCK`and `PICK`. 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
CommandArgumentsUseRequirements
!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
CommandArgumentsUseRequirements
!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
CommandArgumentsUsesRequirements
!mancase, !manualcase\[IRC Name\] \[Case Info\]Used to start a new Manual Seal Case by DispatchersDrillled Seals Only, and run in a channel.
!manfish, !manualfish\[IRC Name\] \[Case Info\]Used to start a new Manual Kingfisher Case by DispatchersDrillled 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-RequestsDrilled 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.
CommandArgumentsUsesRequirements
!ping Check to see if the bot is responding to commands
!dbping Check to see the responsiveness of the databaseCyberseals Only.
!edsmping Check to see the responsiveness of EDSM's APICyberseals 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 nameMust be a registered user, and run in DMs with HalpyBOT.
!whoami Check the user information on yourselfMust 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 issueMust 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 issuesMust 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
CommandArgumentsUsesRequirements
!drillcase\[cmdr\], \[platform\], \[system\], \[hull\]Manually create a new Seal drill caseDrilled 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 caseDrilled Seals +, in a channel.
##### Fact Management Commands
CommandArgumentsUsesRequirements
!factinfo\[name-lang\]Get information about a factAdmin or Cyberseal
!addfact\[fact-lang\] \[text\]Add a new fact to the databaseAdmin or Cyberseal
!deletefact\[fact-lang\]Delete a factAdmin 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 factAdmin or Cyberseal
!ufi, !updatefactindex Manually update the Fact listing cacheCyberseals Only.
#### Common Facts Below are some of the registered Facts in HalpyBOT.
Fact Use
!bacon A fun little link - who doesn't love Bacon!
!beacon, !bc How to turn on a Wing Beacon
!cbinfo To gather Code Black information from a manual case.
!cbmining Information about how mining works for clients in Code Black cases.
!chatter If Repair Requests has too much side conversation happening, to redirect Seals to better places.
!clientinbob For use when a Case is in the Seal Bob, and the channel must shift to a rescue focus.
!clientinfo To gather case information from a manual case.
!cmdlist This page!
!drillpw Paperwork link for Drill cases.
!escapeneutron Information and guides on how to escape a Neutron Cone
!fuel Redirect a Client to the Fuel Rats
!highg Prepare a Client to take off from a High G planet.
!join Provide a user information on how to join the Hull Seals
!kfbeacon, !srvbeacon Request a Client turn on their Wing Beacon from their SRV
!nickserv How to authenticate with NickServ
!paperwork, !pw, !clear, !ppwk Send a Seal their paperwork link.
!pcfr Request a Client add their Seals to their Friends List.
!pcfrcbInstructions on how to add a Seal to your Friends List from the Main Menu
!prep Get a Client ready for their Seal's arrival.
!psfr Request a Client add their Seals to their Friends List.
!rebootrepair, !rr Provide instructions on what a reboot and repair cycle is, and what it does
!securechannel For when important Case info is being discussed in the Seal Bob, and other topics should wait until the case is over.
!stuck To gather Kingfisher information from a manual case.
!synth Instructions on how to synth a new life support refill
!teamInstructions on how to add a Seal to your Team (Odyssey)
!ticketQuicklink to the support ticket creation page
!tos A quicklink to our TOS. If this is used, a hammer is likely to follow.
!verify Request a suspect Client provide an image or other information to help validate their repair request. If used, immediately inform a staff member.
!welcome Welcome a Client and get them ready for a Dispatcher's arrival
!wing, !wr Request a Client add their Seals to their wing.
!xbfr Request a Client add their Seals to their Friends List.
You have to be a registered (+r) user in our IRC in order to use these facts.