LilDevil Bot Commands
Careful! It is AI generated so some description can be bullshit! I'll fix those when I can. =)
/add_staff Staff Only
Usage: /add_staff role:<@role>
Adds a specified role to the bot’s staff group, granting users in that role access to staff-level commands.
[role]: The Discord role to add to the staff group, allowing those members to use restricted commands.
Example: `/add_staff role:@Moderator` will add the "Moderator" role to the staff group.
Back to top
/set_user_roles Staff Only
Usage: /set_user_roles user:<@user> roles:<@role1, @role2, ...>
Assigns specific roles to a given user within the server. This command is for staff use to manage users’ roles directly.
[user]: The user to whom roles will be assigned.
Example: `/set_user_roles user:@User roles:@Member, @SpecialRole` will add the "Member" and "SpecialRole" roles to @User.
[roles]: A comma-separated list of roles to assign to the specified user.
You can specify multiple roles by separating them with commas, such as `@Role1, @Role2`.
Back to top
/remove_staff Staff Only
Usage: /remove_staff role:<@role>
Removes a specific role from the staff group, revoking staff-level command access from members with that role.
[role]: The role to remove from the staff group.
Example: `/remove_staff role:@Moderator` will remove the "Moderator" role from the staff group.
Back to top
/list_staff Staff Only
Usage: /list_staff
Lists all roles that currently belong to the bot’s staff group, showing which roles have permission to use staff commands.
This command is useful for reviewing which roles have access to administrative commands within the bot.
Back to top
/set_preset
Usage: /set_preset name: content: delete:
Creates or updates a message preset with a unique name, allowing you to save custom messages for easy access. You can also delete an existing preset.
[name]: A unique identifier for the preset.
Example: `/set_preset name:MeetingReminder content:"Please remember to join the meeting at 3 PM."` saves this message under the name "MeetingReminder". If you enter "delete" value, the part of the field you enter it in will be sleared when editiing.
[content]: The message content you want to save. This will be the text posted when using the preset.
You can save a message like "Meeting at 5 PM in Room 3" by using this parameter.
[delete] (optional): A flag to delete an existing preset if set to `true`.
Use `/set_preset name:Reminder delete:true` to remove the "Reminder" preset from saved presets.
Back to top
/post_preset
Usage: /post_preset name:
Posts a saved preset message in the current channel using the preset name. This is useful for quickly reusing common messages.
[name]: The name of the preset to post.
Example: `/post_preset name:MeetingReminder` will post the saved "MeetingReminder" message in the channel.
Back to top
/list_presets
Usage: /list_presets
Lists all saved message presets, displaying each preset’s name and associated content for easy reference.
This command is useful for viewing all saved messages and their identifiers. Example: `/list_presets` will display all presets saved in the system.
Back to top
/set_location
Usage: /set_location shortcode: location_name: description: image1: image2: image3: image4: delete:
Allows you to create or update a location with a unique shortcode, making it easy to reference locations. You can update or remove values, including clearing fields by setting a value to "delete".
[shortcode]: A unique identifier for the location.
Example: `/set_location shortcode:beach location_name:"Sunny Cove"` creates or updates a location with the identifier "beach".
[location_name]: The name of the location you are creating or updating.
Example: `/set_location shortcode:beach location_name:"Sunny Cove"` sets the name as "Sunny Cove".
[description] (optional): A brief description of the location.
Use a short text to describe the location's features, for example, "A beautiful sunny beach with golden sands."
[image1] - [image4] (optional): URLs for images representing the location.
Example: `/set_location shortcode:beach image1:"https://example.com/beach.jpg"` adds an image to the location.
[delete] (optional): To remove the contents of a field, set the field to "delete".
Example: `/set_location shortcode:beach description:delete` removes the description from the "beach" location.
Back to top
/post_location
Usage: /post_location shortcode:
Posts the details of a saved location to the current channel by using its unique shortcode.
[shortcode]: The unique identifier of the location you want to post.
Example: `/post_location shortcode:beach` displays the "beach" location details, including its name, description, and any images saved.
Back to top
/list_location
Usage: /list_location
Displays a list of all saved locations, showing each location's shortcode, name, and basic details.
Example: `/list_location` will display all available locations, with each location’s shortcode and details for easy reference.
Back to top
/set_npc
Usage: /set_npc shortname: npc_name: npc_avatar: delete:
Creates or updates an NPC (Non-Player Character) with a unique shortcode, allowing for easy reference and posting. Use "delete" as the value for fields you wish to clear.
[shortname]: A unique identifier for the NPC.
Example: `/set_npc shortname:sheriff` creates or updates an NPC with the identifier "sheriff".
[npc_name]: The full display name of the NPC.
Example: `/set_npc shortname:sheriff npc_name:"Sheriff Brutus"` names the NPC as "Sheriff Brutus".
[npc_avatar] (optional): A URL link to an image that represents the NPC’s avatar.
Example: `/set_npc shortname:sheriff npc_avatar:"https://example.com/avatar.jpg"` adds an avatar for the NPC.
[delete] (optional): Use "delete" to clear a field's value, such as the NPC's avatar.
Example: `/set_npc shortname:sheriff npc_avatar:delete` removes the avatar from "Sheriff Brutus".
Back to top
/post_npc
Usage: /post_npc shortname: text:
Posts a message as the specified NPC in the current channel, enabling interactive roleplay.
[shortname]: The unique identifier of the NPC you want to use.
Example: `/post_npc shortname:sheriff text:"Welcome to the city"` posts a message from "Sheriff Brutus" saying "Welcome to the city".
[text]: The message content you wish to post as the NPC.
The text is displayed as if the NPC is speaking or sending it, complete with their avatar and name.
Back to top
/list_npc
Usage: /list_npc
Lists all created NPCs along with their shortnames, full names, and avatars for easy reference.
Example: `/list_npc` displays a list of all NPCs, including each NPC's shortname and associated details for quick identification.
Back to top
/set_tracker_channel Staff Only
Usage: /set_tracker_channel channel:<#channel> image: delete:
Sets or updates the scene tracker channel and image, where scenes are tracked and organized. Use "delete" in the image field to clear it.
[channel]: The Discord text channel to set as the tracker channel.
Example: `/set_tracker_channel channel:#tracker-channel` sets the specified channel as the tracker channel.
[image] (optional): A URL to an image representing the scene. Use "delete" to remove the current image.
Example: `/set_tracker_channel channel:#tracker-channel image:https://example.com/image.jpg` adds or updates the tracker image.
Back to top
/list_tracker_channel Staff Only
Usage: /list_tracker_channel
Displays the currently set scene tracker channel and associated image (if any).
Example: `/list_tracker_channel` shows the current tracker channel and image.
Back to top
/scene_start (or /ss)
Usage: /scene_start players:<@players> gm:<@gm> purpose:
Begins a new roleplay scene in the tracker channel with specified players, GM(s), and an optional purpose description.
[players]: Mentions of players participating in the scene.
Example: `/scene_start players:@Player1 @Player2` adds "Player1" and "Player2" to the scene.
[gm] (optional): Mentions the Game Master(s) leading the scene.
Example: `/scene_start players:@Player1 gm:@GM1` assigns "GM1" to the scene.
[purpose] (optional): The purpose or theme of the scene.
Example: `/scene_start players:@Player1 purpose:"Diplomatic Meeting"` sets a purpose.
Back to top
/scene_edit
Usage: /scene_edit text:
Modifies the ongoing scene by updating the scene’s description or purpose.
[text]: The new text for the scene.
Example: `/scene_edit text:"Negotiations take a tense turn"` updates the scene description.
Back to top
/es
Usage: /es
Posts an "End Scene" message to mark the conclusion of a scene in the current channel.
Example: `/es` displays "End Scene" in the current channel.
Back to top
/ps (or /sp)
Usage: /ps
Posts a "Scene Paused" message, indicating a temporary halt in the scene's events.
Example: `/ps` shows "Scene Paused" in the current channel.
Back to top
/fc (or /ftc)
Usage: /fc
Posts "Faded to Chats" to transition the scene focus to informal or off-screen roleplay in chats.
Example: `/fc` posts "Faded to Chats" in the current channel.
Back to top
/ftb
Usage: /ftb
Posts "Faded to Black" to signify the scene moving off-screen for sensitive content or when details are not public.
Example: `/ftb` shows "Faded to Black" in the current channel.
Back to top
/filter_set_channel_category Staff Only
Usage: /filter_set_channel_category category:<#category>
Sets a channel category for filtered content, organizing specific messages by this category.
[category]: The Discord category to set for filtering content.
Example: `/filter_set_channel_category category:#Roleplay` sets a category named "Roleplay" for filtered posts.
Back to top
/filter_role Staff Only
Usage: /filter_role role:<@role>
Specifies a role that can access the filtered content in the chosen channel category.
[role]: The role that will have access to view the filtered content.
Example: `/filter_role role:@VIP` allows only "VIP" members to view filtered posts in the set category.
Back to top
/filter_add Staff Only
Usage: /filter_add keyword: delete:
Adds a keyword to filter messages within the set category. Use "delete:true" to remove a keyword.
[keyword]: The keyword or phrase to filter.
Example: `/filter_add keyword:Battle` filters messages containing "Battle".
[delete]: Set to "true" to remove an existing keyword.
Example: `/filter_add keyword:Battle delete:true` removes "Battle" from the filter list.
Back to top
/list_filter_data Staff Only
Usage: /list_filter_data
Lists all current filters, including keywords and roles assigned to view filtered content.
Example: `/list_filter_data` displays all filter settings, keywords, and authorized roles.
Back to top
/moon
Usage: /moon
Displays the current phase of the moon for the server’s region or a specified location.
Example: `/moon` provides the moon phase, such as "Full Moon" or "Waning Crescent".
Back to top
/coinflip
Usage: /coinflip [comment]
Flips a coin, showing "Heads" or "Tails" along with an optional comment.
[comment] (optional): An optional message to accompany the result.
Example: `/coinflip comment:"Decision for the group"` displays "Heads" or "Tails" with the provided comment.
Back to top
/time
Usage: /time time: timezone:
Converts a specified time or date to a target timezone, showing both the time and a Discord timestamp code for the conversion.
[time]: The time or date to convert, in formats like `HH:MM`, `yyyy-mm-dd`, or `yyyy-mm-dd HH:MM`.
Example: `/time time:2023-12-31 14:30 timezone:GMT` shows the equivalent in GMT with a timestamp.
[timezone]: The target timezone or location.
Example: `/time time:14:30 timezone:EST` converts 2:30 PM to Eastern Standard Time.
Back to top
/rr
Usage: /rr [roll]
Rolls dice based on pool and difficulty with optional specialties, comment, or NdN dice format.
[roll]: Specifies the dice pool, difficulty, specialty, or NdN format for multiple rolls.
Example: `/rr 5d10 + specialty` for a specialty roll, or `/rr 4d6` rolls 4 six-sided dice.
Back to top
/save_roll
Usage: /save_roll rollname: roll: delete:
Saves a roll under a unique name or deletes an existing roll when delete:true.
[rollname]: A unique name to save or refer to the roll.
Example: `/save_roll rollname:Stealth roll:3d6` saves a "Stealth" roll with 3 six-sided dice.
[delete]: Optional delete flag to remove a saved roll.
Example: `/save_roll rollname:Stealth delete:true` deletes the saved roll named "Stealth".
Back to top
/list_rolls
Usage: /list_rolls [user]
Lists all saved rolls for the user or a specified user (for Staff/Admin roles only).
[user] (optional): The user whose rolls are listed (only available for staff).
Example: `/list_rolls user:@Player1` lists saved rolls for "Player1".
Back to top
/init_roll
Usage: /init_roll dex: wits: total_celerity_value: activated_celerity: character:
Rolls for initiative based on the character's stats and active/passive celerity.
[dex] (Required): The character's Dexterity score.
[wits] (Required): The character's Wits score.
[total_celerity_value] (Optional): Passive Celerity value, defaults to 0 if not provided.
[activated_celerity] (Optional): Active Celerity value to adjust initiative calculation.
[character] (Optional): The character's name. If omitted, defaults to the user’s display name.
Example: `/init_roll dex:4 wits:3 total_celerity_value:2 activated_celerity:1 character:Vampire` rolls initiative for "Vampire".
Back to top
/init_dec
Usage: /init_dec actions: character:
Declares actions for the current initiative round, using `--c1`, `--c2`, etc., for celerity actions.
[actions] (Required): The character's action declaration, with `--c1`, `--c2`, etc., for additional celerity actions.
[character] (Optional): The character's name. Defaults to the user’s display name if omitted.
Example: `/init_dec actions:"Attack --c1 Dodge" character:Warrior` declares actions for "Warrior", including a Celerity Dodge action.
Back to top
/init_show
Usage: /init_show
Displays the current initiative order and celerity turns for characters in the current channel.
Example: `/init_show` displays the initiative order with character actions and any celerity turns.
Back to top
/init_reroll
Usage: /init_reroll character: activated_celerity:
Rerolls initiative for a character, optionally updating active celerity for a fresh roll.
[character] (Optional): The character's name. Defaults to the user’s display name if omitted.
[activated_celerity] (Optional): Updates active celerity for this reroll only.
Example: `/init_reroll character:Vampire activated_celerity:2` rerolls initiative for "Vampire" with updated active celerity.
Back to top
/init_rm
Usage: /init_rm character:
Removes a character from the initiative list for the current channel.
[character] (Optional): The character's name. Defaults to the user’s display name if omitted.
Example: `/init_rm character:Hunter` removes "Hunter" from the initiative list.
Back to top
/init_clear
Usage: /init_clear
Clears all initiative data for the current channel.
Example: `/init_clear` removes all characters' data from the current channel's initiative list.
Back to top
/init_purge_all
Usage: /init_purge_all
Deletes all initiative data across all channels.
Example: `/init_purge_all` purges initiative lists across every channel, clearing data for all characters.
Back to top
/help
Usage: /help
Displays a list of all commands and provides help with usage and examples.
Example: `/help` lists all commands available to the user along with descriptions and examples.
Back to top