Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create GuildConfigSchema.md #145

Merged
merged 2 commits into from
Dec 26, 2023
Merged

Conversation

GuynnR
Copy link
Contributor

@GuynnR GuynnR commented Dec 25, 2023

adding documentation for GuildConfigSchema.ts

SudoBot Configuration

SudoBot's behavior is controlled through a comprehensive JSON schema. This README provides an overview of the Guild Configuration Schema, allowing you to tailor the bot's behavior to suit your server's needs. Refer to GuildConfigSchema.ts for the complete schema.

Guild Configuration Schema

The Guild Configuration Schema encompasses various settings for SudoBot. Below are detailed explanations for key sections of the schema:

Prefix and Debug Mode

  • prefix: Defines the command prefix for SudoBot. By default, commands are triggered with a prefix of -. You can customize this to align with your server's preferences.

  • debug_mode: When set to true, enables debug mode, providing additional information useful for developers. Typically, debug mode is disabled in production environments.

Commands Configuration

  • commands: Configuration related to bot commands.

    • mention_prefix: If set to true, allows commands to be triggered with mentions (e.g., @SudoBot help). If set to false, only the command prefix triggers commands.

    • bean_safe, shot_safe, fakeban_safe: Arrays of User IDs who are immune from bean, shot or fakeban commands.

    • echo_mentions: If set to "True" option tells the bot whether to also ping roles when someone uses the echo comamnd.

    • moderation_command_behaviour: Specifies the behavior for moderation commands, either "delete" (delete the command message) or "default" (keep the command message).

    • rerun_on_edit: When set to true, the bot will rerun commands when they are edited.

    • default_joke_type: Sets the default type for joke commands. Options are "random", "joke", or "dadjoke".

Permissions Configuration

  • permissions: Configuration for managing permissions.

    • mod_role, admin_role, staff_role: (DEPRECATED) Use available permission systems instead.

    • invincible_roles: Array of Snowflake IDs for roles with invincible permissions. Members with these roles have immunity from certain actions.

    • mode: Permission mode. Options are "discord" (Discord roles only), "levels" (0-100), or "layered" (permission overwrite based system).

    • check_discord_permissions: This option checks for role positions when taking actions by using commands, or when AutoMod decides to take an action. If this is "false", none of those safe permission checking will be done.

@github-actions github-actions bot added the type:docs Improvements or additions to documentation label Dec 25, 2023
@virtual-designer virtual-designer added this to the 7.0.0 milestone Dec 26, 2023
Copy link
Member

@virtual-designer virtual-designer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi, thank you for deciding to contribute to the project. I'd be glad if you can make the changes as I directed. If not, no worries, I will merge this PR and do it myself. I just need a confirmation.

Thanks.

docs/GuildConfigSchema.md Outdated Show resolved Hide resolved
docs/GuildConfigSchema.md Outdated Show resolved Hide resolved
docs/GuildConfigSchema.md Outdated Show resolved Hide resolved
docs/GuildConfigSchema.md Outdated Show resolved Hide resolved
docs/GuildConfigSchema.md Outdated Show resolved Hide resolved
@GuynnR
Copy link
Contributor Author

GuynnR commented Dec 26, 2023

I can do so

@virtual-designer
Copy link
Member

I can do so

Please also modify the GuildConfigSchema.md file. Just editing the PR description won't allow me to merge your changes.

Updated proper link redirection
Removed Example
Updat Snowflake id to User ID who
Copy link
Member

@virtual-designer virtual-designer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cool! Thanks a lot again for investing your time in the project!

@virtual-designer virtual-designer merged commit 329870c into onesoft-sudo:main Dec 26, 2023
7 checks passed
@GuynnR GuynnR deleted the patch-1 branch December 26, 2023 17:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type:docs Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants