From a1a348c09250618e3684e5dde76767911ac053fc Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:14:27 +0200 Subject: [PATCH 001/156] Update let.md Fix grammar and spelling to the main description of the function --- guide/Variables/let.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Variables/let.md b/guide/Variables/let.md index 86b80e6..60ad59e 100644 --- a/guide/Variables/let.md +++ b/guide/Variables/let.md @@ -1,9 +1,9 @@ # $let -define a variable, that you can access later through [$get](./get.md) -This functions is useful to temporary store variables, like for to save a result of a calculation +Define a variable, that you can access later through [$get](./get.md). +This function is useful to temporarily store variables, like to save the result of a calculation #### Usage: `$let[variable name;variable value;remain after execution (yes/no , default no) (optional)]` -The first value will only exist till cc ends its execution,the second will be still accessable till next bot restart (every 5d) +The first value will only exist umtil cc ends its execution,the second will still be accessable until next bot restart (every 5d) You can use $get[varname] or $varname to retrieve the value
From efee31a7fed7e6dd0cd6e6d63181820498f20303 Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:19:09 +0200 Subject: [PATCH 002/156] Update ObjectGet.md Fix grammar and spelling in the description --- guide/Text/Object/ObjectGet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Object/ObjectGet.md b/guide/Text/Object/ObjectGet.md index c4e2047..b7364b1 100644 --- a/guide/Text/Object/ObjectGet.md +++ b/guide/Text/Object/ObjectGet.md @@ -1,5 +1,5 @@ # $objectGet -Get a object value/property by key, if key not found them return `undefined` (same as `$getObjectProperty`) +Get a object value/property by key, if the key is not found then return `undefined` (same as `$getObjectProperty`) #### Usage: `$objectGet[key]`
From ada1348557b3d31873e5271f87e16fb7d1e86cee Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:20:32 +0200 Subject: [PATCH 003/156] Update ObjectIncrease.md Updated spelling and grammar --- guide/Text/Object/ObjectIncrease.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Object/ObjectIncrease.md b/guide/Text/Object/ObjectIncrease.md index f8fccee..ef0351a 100644 --- a/guide/Text/Object/ObjectIncrease.md +++ b/guide/Text/Object/ObjectIncrease.md @@ -1,6 +1,6 @@ # $ObjectIncrease -To increase key value, if not exists, it will create it and set to the value +To increase a key value, if they key doesn't exist, it will create one and set to that value ## Usage @@ -30,4 +30,4 @@ $ObjectIncrease[Key;Amount] {"Mido":20} - \ No newline at end of file + From 486a56b7002ffe49177273c5de7b70936781c533 Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:21:19 +0200 Subject: [PATCH 004/156] Update ObjectKeys.md Update to grammar --- guide/Text/Object/ObjectKeys.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Object/ObjectKeys.md b/guide/Text/Object/ObjectKeys.md index 4378150..c720aa7 100644 --- a/guide/Text/Object/ObjectKeys.md +++ b/guide/Text/Object/ObjectKeys.md @@ -1,6 +1,6 @@ # $ObjectKeys -Return the Object Keys with seperator between each key +Return the Object Keys with the seperator between each key ## Usage @@ -26,4 +26,4 @@ $ObjectKeys[Seperator (optional, default:, );Nested Property 1;Nested Property 2 name/id/weapon - \ No newline at end of file + From 7adbc90361245dc0c52c994e79cd2af705c98c7d Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:23:09 +0200 Subject: [PATCH 005/156] Update ObjectLoop.md Removed the unnecessary $arrayloop from the example --- guide/Text/Object/ObjectLoop.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Object/ObjectLoop.md b/guide/Text/Object/ObjectLoop.md index f849f9f..1f716a6 100644 --- a/guide/Text/Object/ObjectLoop.md +++ b/guide/Text/Object/ObjectLoop.md @@ -14,9 +14,9 @@ CODE... ### Example: - !!exec $objectSet[Mido;Sword]
$objectSet[Rake;Staff]
$objectLoop[name;weapon;index]{
$index. $name has $weapon
}
$arrayLoop[age]{
age is $age
}

+ !!exec $objectSet[Mido;Sword]
$objectSet[Rake;Staff]
$objectLoop[name;weapon;index]{
$index. $name has $weapon
}

 1. Mido has Sword
2. Rake has Staff - \ No newline at end of file + From 357dce4fa8697ffbd7e7dd283fb6ca968bf1c487 Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:27:24 +0200 Subject: [PATCH 006/156] Update ObjectSet.md Replaces createObject with objectCreate due to createObject being deprecated --- guide/Text/Object/ObjectSet.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/guide/Text/Object/ObjectSet.md b/guide/Text/Object/ObjectSet.md index e82388c..59b97af 100644 --- a/guide/Text/Object/ObjectSet.md +++ b/guide/Text/Object/ObjectSet.md @@ -5,7 +5,7 @@ set an object property value by key
- !!exec $createObject[{"name":"Wiki"}] $objectSet[name;Rake] $objectSet[tag;0001] $getObject + !!exec $objectCreate[{"name":"Wiki"}] $objectSet[name;Rake] $objectSet[tag;0001] $getObject {"name":"Rake","tag":"0001"} @@ -14,12 +14,12 @@ set an object property value by key ::: tip Setting Objects inside Objects ``` -$createobject[{"type":0}] +$objectCreate[{"type":0}] $objectset[version;2.5] /* will return {"type:0,"version":"2.5"} */ -$createobject[{"type":0}] +$objectCreate[{"type":0}] $objectSet[userdata;age;20] $objectSet[userdata;name;Member] @@ -29,7 +29,7 @@ $objectSet[userdata;role;Moderator] ::: tip Setting values inside array ``` - $createobject[{ "userdata":{ + $objectCreate[{ "userdata":{ "age":0, "name":"undefined", "role":"undefined" @@ -40,7 +40,7 @@ $objectSet[userdata;name;Member] $objectSet[userdata;role;Moderator] /* this is the format for normal groups */ -$createobject[{ "userdata":[{ +$objectCreate[{ "userdata":[{ "age":0, "name":"undefined", "role":"undefined" @@ -55,4 +55,4 @@ $objectSet[userdata;0;role;Moderator] ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 88f5fe8ddc439cd9b34a708c2b312787ae911c35 Mon Sep 17 00:00:00 2001 From: naem Date: Mon, 15 Jul 2024 22:39:46 +0200 Subject: [PATCH 007/156] Update let.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fix my own spelling mistake 🧠 --- guide/Variables/let.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Variables/let.md b/guide/Variables/let.md index 60ad59e..60495ae 100644 --- a/guide/Variables/let.md +++ b/guide/Variables/let.md @@ -3,7 +3,7 @@ Define a variable, that you can access later through [$get](./get.md). This function is useful to temporarily store variables, like to save the result of a calculation #### Usage: `$let[variable name;variable value;remain after execution (yes/no , default no) (optional)]` -The first value will only exist umtil cc ends its execution,the second will still be accessable until next bot restart (every 5d) +The first value will only exist until cc ends its execution,the second will still be accessable until next bot restart (every 5d) You can use $get[varname] or $varname to retrieve the value
From ddbc7b26f9da8fb3cca989c421106e170ceb0f05 Mon Sep 17 00:00:00 2001 From: naem Date: Tue, 16 Jul 2024 07:01:21 +0200 Subject: [PATCH 008/156] Update main.md Fixed grammar and updated some hyperlinks --- guide/Contribution_Info/main.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/guide/Contribution_Info/main.md b/guide/Contribution_Info/main.md index 7baa1e7..bd69893 100644 --- a/guide/Contribution_Info/main.md +++ b/guide/Contribution_Info/main.md @@ -1,26 +1,26 @@ # Main Information ## Rules -Please follow the following rules: +Please follow the contribution rules: * Use the template for every function. Template can be found [here](./function_template.md) * Please use correct English sentences. Swearing is forbidden -* Make clear what you have changed when you make an pull request. Use an appropriate title & description -* Make sure you make docs on functions you know well. You should prevent, in any way possible, that wrong information is pushed. +* Make clear what you have changed when you make a pull request. Use an appropriate title & description +* Make sure you make docs on functions you know well. You should avoid, in any way possible, that wrong information is pushed. ### Editing existing or adding docs You can edit pages in our github repo. You can click the edit page button for existing page. #### Requirements * Github [account](https://github.com) - * Never used Github? Check this https://docs.github.com/en + * Never used Github? Check the github [docs](https://docs.github.com/en) * Basic knowledge of [markdown]( https://www.markdownguide.org/cheat-sheet/) Since the function doesn't exist,you have to create a file inside the specific folder in the [repo](https://github.com/raspdevpy/ccdoc/tree/main/guide) Example $botCount 0. Check in `undone.md` to be sure,that nobody else already documented the function. -1. Fork the [repo](https://github.com/raspdevpy/ccdoc/tree/ +1. Fork the [repo](https://github.com/raspdevpy/ccdoc/tree/) ![](https://i.ibb.co/2kPRCX0/image.png) 2. Create a file in bot folder with name `botCount.md` ![](https://i.ibb.co/BLCbs7q/image.png) @@ -30,8 +30,8 @@ Example $botCount ![](https://i.ibb.co/8XvCCdm/image.png) 5. go to undone.md and move the function to done ![](https://i.ibb.co/85PxQjM/image.png) -5. If you have done all your changes(add many function docs,not only 1 change), do a pull request,which we will review. +5. If you have done all your changes(add/change many function docs,not only 1), do a pull request,which we will review. ![](https://i.ibb.co/p3RCGYf/image.png) ![](https://i.ibb.co/R9fJz7g/image.png) -### For extra information, please contact a moderator/ developer in our discord server! \ No newline at end of file +### For extra information, please contact a moderator/developer in our discord server! From 307d199e3d6196a0901beceb6678ebb2ee72653e Mon Sep 17 00:00:00 2001 From: naem Date: Tue, 16 Jul 2024 07:39:52 +0200 Subject: [PATCH 009/156] Update getObject.md Edited the example to correctly show the "with spaces" example --- guide/Text/Object/getObject.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/guide/Text/Object/getObject.md b/guide/Text/Object/getObject.md index eb47423..0c93950 100644 --- a/guide/Text/Object/getObject.md +++ b/guide/Text/Object/getObject.md @@ -11,15 +11,15 @@ With spaces: $getobject[1] Without spaces: {"Owner":"Rake","Manager":"Mika","Dev":"Mido","Contributor":"Wiki"} -With spaces: { - "Owner": "Rake", - "Manager": "Mika", - "Dev": "Mido", - "Contributor": "Wiki" +With spaces: {
+ "Owner": "Rake",
+ "Manager": "Mika",
+ "Dev": "Mido",
+ "Contributor": "Wiki"
} ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From d93b2bda19f7d44067fbb9ee11b40dd25949d333 Mon Sep 17 00:00:00 2001 From: naem Date: Wed, 17 Jul 2024 10:42:43 +0200 Subject: [PATCH 010/156] Update isValidHex.md --- guide/Text/isandhas/isValidHex.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/isandhas/isValidHex.md b/guide/Text/isandhas/isValidHex.md index 05ae202..45e9999 100644 --- a/guide/Text/isandhas/isValidHex.md +++ b/guide/Text/isandhas/isValidHex.md @@ -1,5 +1,5 @@ # $isValidHex -checks if the given int or hex code is valid ,returns true,false +Checks if the given text is a valid hex code, returns true or false #### Usage: `$isValidHex[int or hexcode]` Example: @@ -16,4 +16,4 @@ Example: ##### Function difficulty ###### Tags: - \ No newline at end of file + From 3c02cbe9b778da1012ee97cc368f2d0743b122ab Mon Sep 17 00:00:00 2001 From: naem Date: Wed, 17 Jul 2024 10:52:39 +0200 Subject: [PATCH 011/156] Update regexCheck.md --- guide/Text/Regex/regexCheck.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Text/Regex/regexCheck.md b/guide/Text/Regex/regexCheck.md index 034442c..5468956 100644 --- a/guide/Text/Regex/regexCheck.md +++ b/guide/Text/Regex/regexCheck.md @@ -1,6 +1,6 @@ # $regexCheck -To check if a text match a regex or not +To check if a text matches a regex or not, returns true or false ## Usage @@ -8,7 +8,7 @@ To check if a text match a regex or not $regexCheck[Text;Regex;Flags] ``` -### Example (Check If Text is alphabets): +### Example (Check If Text is letters): !!exec $regexCheck[ABC;^[a-zA-Z]+$]

@@ -26,4 +26,4 @@ $regexCheck[Text;Regex;Flags] false - \ No newline at end of file + From 0a20e389bab4019704878801a982153644e94810 Mon Sep 17 00:00:00 2001 From: naem Date: Wed, 17 Jul 2024 10:53:45 +0200 Subject: [PATCH 012/156] Update regexMatch.md --- guide/Text/Regex/regexMatch.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Regex/regexMatch.md b/guide/Text/Regex/regexMatch.md index 9f8298e..da87c4a 100644 --- a/guide/Text/Regex/regexMatch.md +++ b/guide/Text/Regex/regexMatch.md @@ -1,5 +1,5 @@ # $regexMatch -Matches a string with given Regex Pattern +Matches a string with the given Regex Pattern and returns the matched text or multiple matches seperated by the seperator #### Usage: `$regexMatch[text;regexp;flags(optional);group index(optional, 0 by default) or all;separator (optional)]` From 791f626e00e6d01815427efde53aefeafa96f070 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 19:19:38 +0200 Subject: [PATCH 013/156] Update 1.create.md fixed spelling and grammar --- guide/Guide/1.create.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/guide/Guide/1.create.md b/guide/Guide/1.create.md index ba55986..fde7076 100644 --- a/guide/Guide/1.create.md +++ b/guide/Guide/1.create.md @@ -20,11 +20,11 @@ Before we start working on our command, we have to create one. > ![](https://i.imgur.com/VFsbL20.png) ::: tip Tour On your first visit you will be greeted with a dashboard tour! -We highly suggest NOT skipping through it... It will save you a lot of trouble in the future! +We highly suggest NOT skipping through it. It will save you a lot of trouble in the future! ::: ## Type -A very first part of every command is it's type, an action which will activate your command. +The very first part of every command is it's type, an action which will activate your command. It can be selected using this dropdown menu: > ![Type dropdown](https://cdn.discordapp.com/attachments/957286111250624552/1096882428422918164/image.png) @@ -50,8 +50,8 @@ You can proceed to a guide on specific trigger by clicking the green name of it. ::: ## Trigger -Command type is sometimes not enough to make your command working perfectly. -Sometimes you need the action to meet some conditions, for example: a message should be a certain `!ping` to activate your **ping** command. +Command type is sometimes not enough to make your command work perfectly. +Sometimes you need the action to meet some conditions, for example: a message should start with `!ping` to activate your **ping** command. This field can be specified using this input field: > ![trigger input](https://cdn.discordapp.com/attachments/957286111250624552/1096884667686326302/image.png) ::: tip @@ -61,7 +61,7 @@ The value expected greatly depends on the type of your command. We recommend che ## Code -Now as you know how to make a triggered, we can move on to the real **meat** of a custom command, the **code**. +Now as you know how to make a trigger, we can move on to the real **meat** of a custom command, the **code**. Code is simply what the bot will do upon triggering. It can be set using this field: > ![code editor](https://cdn.discordapp.com/attachments/957286111250624552/1096900826791944304/image.png) @@ -69,7 +69,7 @@ It can be set using this field: ### What should I put there? The simplest code is just a text which gets sent after triggering. But typing in a plain text is of course not all you can do with CC. -Inside the code field you can use various functions, which you can find under `Functions` tab in this documentation, or in docs built-in the dashboard. +Inside the code field you can use various functions, which you can find under the `Functions` tab in this documentation, or in docs built into the dashboard. ::: tip Examples You can find some examples of CC in action in the [Tutorials & Examples](../Tutorials/1.ping.md) tab. @@ -95,4 +95,4 @@ Here's a short explanation of all of them: You do not always have to code every single command by yourself. From the dashboard you get access to a great deal of templates, that can be effortlessly imported and setup easily. #### Want to learn more? -If you want to learn more about what templates are, and how to get them, please check the [template section](./4.template.md). \ No newline at end of file +If you want to learn more about what templates are, and how to get them, please check the [template section](./4.template.md). From dc701a8dc4bfda4de56b561e3e5468a6d7aa00d5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 19:33:40 +0200 Subject: [PATCH 014/156] Update 2.faq.md updated grammar/spelling and added a few things to make it clearer for new users (most prominent example is in "are there built in commands") --- guide/Guide/2.faq.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/guide/Guide/2.faq.md b/guide/Guide/2.faq.md index 9341174..a3fce9b 100644 --- a/guide/Guide/2.faq.md +++ b/guide/Guide/2.faq.md @@ -1,35 +1,35 @@ # Frequently Asked Questions -## Why does the bot has such high cooldowns? +## Why does the bot have such high cooldowns? ::: details Answer Our bot is unique in it's sort. -But sadly we aren't quite big enough yet, to get our raidimits decreased! +But sadly we aren't quite big enough yet to get our rateimits decreased. Regarding to this, we sadly have to add cooldowns to functions and command executions. This to prevent a punishment from Discord Inc. ::: ## I don't see the "copy ID" option. Help! :::details Fix -Enable the developer mode on discord. This will give you all the required options! +Enable developer mode on discord. This will give you all the required options! https://media.discordapp.net/attachments/772051120368910371/882629065314566144/get_id.gif ::: -## Are there inbuild commands? Or do I have to code them all myself +## Are there inbuilt commands, or do I have to code them all myself? :::details Answer -You kind of need to... We only have some basic commands like `!!purge` & `!!ban` build in. +You kind of need to. We only have some basic commands like `!!purge` and `!!ban` built in. You can view them all by running `!!commands` in your server. -There are some commands that you can use to get a dashboard link and your total amount of votes. Read [me](../Guide/botInfo.md) to learn more +Other commands that you can use include getting a dashboard link or your total amount of votes. Read [me](../Guide/botInfo.md) to learn more ::: -## Why does my embed not sends correctly? +## Why does my embed not send correctly? ::: details Answer -It's probably because you have a hyperlink in it... +It's probably because you have a hyperlink in it. ![](https://media.discordapp.net/attachments/772051120368910371/883355096308654080/url_in_description_embed.gif) ::: -## How do I get an ID from a channel, user, message, thread or guild? +## How do I get an ID from a channel, user, message, thread or guild(server)? ::: details Answer ![](https://media.discordapp.net/attachments/772051120368910371/882629065314566144/get_id.gif) @@ -47,4 +47,4 @@ This is bugged in the web version of discord! You need to use the desktop client A variable is a place to store some data and get it back later. For example in another command! Check out the variable category, to see all types available! -::: \ No newline at end of file +::: From a4ed9581e45431239605142e5e55d4acc3c68f01 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 19:44:57 +0200 Subject: [PATCH 015/156] Update 3.policy.md spelling and grammar update. also changes some sentences/words a bit to make a little more sense when reading it the first time --- guide/Guide/3.policy.md | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/guide/Guide/3.policy.md b/guide/Guide/3.policy.md index 0b0e0e6..4d2e9b5 100644 --- a/guide/Guide/3.policy.md +++ b/guide/Guide/3.policy.md @@ -1,59 +1,59 @@ -# Custom Command Bot's Privacy Policy -Get detailed information here about our, your rights and other information. +# Custom Command bot's Privacy Policy +Get detailed information here about our rights, your rights and other information. # Our Rights -* Children under 13 years are not allowed to use our service +* Children under 13 years are not allowed to use our service. -* Any type of Selfbotting or Misusage of our Bot is strictly prohibited +* Any type of selfbotting or misusage of our bot is strictly prohibited. -* Our Bot including Custom Bots can't be used to send/host Discussing Offensive/Controversial Material/Pirated content and NSFW Content. +* Our bot including Custom bots can't be used to send/host Discussing Offensive/Controversial Material/Pirated content and NSFW Content. * You are not allowed to break the Discord TOS or third-party TOS. -Not following our rules can lead to a ban and, in the worst case, a detailed report to Discord. For example, (Scam Servers). +Not following our rules can lead to a ban and, in the worst case, a detailed report to Discord. For example, Scam Servers. # User Rights * **Data Removal/Request**: You can contact us to have your data deleted or requested. - * (Server Owner)You can delete data yourself by deleting all Custom Commands and Variables. - * (User) + * Server Owner: You can delete data yourself by deleting all Custom Commands and Variables. + * User: You can leave the server or contact us to opt-out -* **Content Removal** The Bot and the website use third-party content like open source icons. As owner/maintainer, you have the right to request content removal. +* **Content Removal**: The bot and the website use third-party content like open source icons. As owner/maintainer, you have the right to request content removal. -* **Reports** Every user has the right to report a server that misuses our bot. +* **Reports**: Every user has the right to report a server that misuses our bot. # Data we collect * Server ID for identifying data and storing functional data (for example, commands count) -* Users work like commands content(code) -We don't store any private data like other bots. Generally, we only store IDs of servers that are functional for the Bot. +* User's work like command code +We don't store any private data like other bots. Generally, we only store IDs of servers that are functional for the bot. -* Variables setted by yourself on a command. You can leave the server to opt-out. +* Variables set by yourself on a command. You can leave the server to opt-out. # New: Message Content Intent Since the new approval of the discord message intent Useful information gets listed here. -* We don't log out/save any type of message. -If a user sends a message, a custom command with the specified trigger gets executed. So not every message triggers a custom command. In this way, your privacy stays protected.Moreover, we have cooldowns, where a command can only receive a message every 4s if the command has been triggered. With the command! !!view, you can view what type of commands the server uses. -* You can always **opt-out** from our bot by leaving the server, and your data will be deleted within 15 days or immediately(~ 1-2 day) (you must contact us for this). +* We don't log/save any type of message. +If a user sends a message, a custom command with the specified trigger gets executed. So not every message triggers a custom command. In this way, your privacy stays protected. Moreover, we have cooldowns, where a command can only receive a message every 4s if the command has been triggered. With the command `!!view`, you can view what commands the server uses. +* You can always **opt-out** from our bot by leaving the server, and your data will be deleted within 15 days or immediately(~ 1-2 days) (you must contact us for this). # Data Retention * We regularly do backups(every 10 days). Old backups get overwritten. -For more detailed information about what "User ID","Session Cookies" are, look [here pls.](https://ccommandbot.com/docs) (difficult to read due to lawyer English) +For more detailed information about what "User ID", "Session Cookies" are, look [here please.](https://ccommandbot.com/docs) (difficult to read due to lawyer English) # Encryption -All data is saved encrypted in our database. In this way, nobody can view the plain database (Example: on an exploit) without our salted token. +All data is saved and encrypted in our database. In this way, nobody can view the plain database (Example: on an exploit) without our salted token. # Contact Us -Generally,we recommend you contact us through our server to get a faster response. +Generally, we recommend you contact us through our server to get a faster response. * Email: [contact@ccommandbot.com](mailto:contact@ccommandbot.com) -* Server: [ccommandbot.com/join](http://ccommandbot.com/join) \ No newline at end of file +* Server: [ccommandbot.com/join](http://ccommandbot.com/join) From 99300a213d0a92cdb833af94f0e45e7c46d59353 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 19:54:44 +0200 Subject: [PATCH 016/156] Update 4.template.md edited some steps and added one or two things to others to be a bit more clear --- guide/Guide/4.template.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/guide/Guide/4.template.md b/guide/Guide/4.template.md index 0f72cdb..13d66e0 100644 --- a/guide/Guide/4.template.md +++ b/guide/Guide/4.template.md @@ -5,23 +5,23 @@ They can be effortlessly imported, and set up directly in the dashboard (no bot ## How to import a template? 1. Go to the custom commands tab -2. Click a yellow template button +2. Click the yellow template button(middle button) 3. Find a template you want to import -4. Select all commands of the template +4. Select all commands of the template(if multiple exist) ::: details Video 1 ![Guide part 1](/images/template/templates1.gif) ::: -1. Configure the command (not for all templates) -2. Wait for the template to import -3. Read usage instructions +5. Configure the command (not all the templates need to be configured) +6. Wait for the template to import +7. Read the usage instructions ::: details Video 2 ![Guide part 2](/images/template/templates2.gif) ::: -8. Template will be imported as custom command(s) +8. Template(s) will be imported as custom command(s) 9. You can edit them at any time ::: details Video 3 From 4c7a118a04450d520420d16a8f89a9ca0dfbfb02 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 19:59:24 +0200 Subject: [PATCH 017/156] Update 5.comment.md reworded some explanations to reflect what a comment looks like --- guide/Guide/5.comment.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/guide/Guide/5.comment.md b/guide/Guide/5.comment.md index 6a045ef..9558b28 100644 --- a/guide/Guide/5.comment.md +++ b/guide/Guide/5.comment.md @@ -11,19 +11,18 @@ Comments come in handy in a few situations: With our syntax it's pretty easy to add comments: ``` -// Single Line Comment +// Single line comment -/* Multiple -Lines -Comments +/* Multi +Line +Comment */ ``` ## Single line Comment -The first comment type, is a single line one. -It can be achieved by placing to slashes on the beginning of the line: +A single line comment can be achieved by placing two forward slashes at the beginning of a line: ### Code -Let's create a code and describe it with a short comment +Let's code something and describe it with a short comment ```bash // this part sums 2 numbers $let[num1;5] @@ -42,8 +41,8 @@ Now it's time to check if the comment worked fine As you see the comment at line 1 didn't appear in the result ## Multiple Lines Comment -In some cases you may want to comment out more then one line, or just a specific part of it. -You can do that by wrapping the comment with a combination of slashes and asterisks `/* Comment */` +In some cases you may want to comment out more than one line. +You can do that by wrapping the comment with a combination of slashes and asterisks: `/* Comment */` ### Code Let's extend our previous comment with some extra lines: @@ -71,5 +70,5 @@ Here's what the bot returns: As you can see it didn't add any extra content despite adding more lines. ::: tip Keystroke -When using the dashboard editor, you can hit `ctrl` + `/` to automatically comment out selected line(s) +When using the dashboard editor, you can hit `ctrl` + `/` to automatically comment out the selected line(s) ::: From cb5a7d7bcec03c188380bb49b1d71d1a6bc0e0f6 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:09:33 +0200 Subject: [PATCH 018/156] Update 6.variables.md updates some things to be a bit clearer as well as a few grammar fixes --- guide/Guide/6.variables.md | 41 +++++++++++++++++++------------------- 1 file changed, 20 insertions(+), 21 deletions(-) diff --git a/guide/Guide/6.variables.md b/guide/Guide/6.variables.md index 23115dd..1ba15c2 100644 --- a/guide/Guide/6.variables.md +++ b/guide/Guide/6.variables.md @@ -2,17 +2,16 @@ Variables are used to store data, Custom Command supports two main types of variables: temporary and permanent. ## Temporary -Temporary variables are usually deleted right after execution, can be accessed really easily, and are commonly used when editing the data. +Temporary variables are usually deleted right after execution, can be accessed really easily, and are commonly used when editing data. ### How to use them? * [$let](../Variables/let.md) - to define temporary variables -* [$get](../Variables/get.md) - to get value of temporary variable +* [$get](../Variables/get.md) - to get the value of temporary variables -Also temporary variables can be accessed by typing their name prefixed by a dollar sign. -For example: `$name` will return the value of `name` variable. +Temporary variables can also be accessed by typing their name prefixed by a dollar sign. +For example: `$name` will return the value of the `name` variable. ### Examples -Here are some examples of using temporary variables ## 1. Basic usage In this example we will save information about Bob, and send a text with all the info in it: @@ -36,7 +35,7 @@ Let's see what would be the output: -As you can see all variables have been replaced by their corresponding values. +As you can see all the variables have been replaced by their corresponding values. ## 2. Saving function output Variables do not always have to keep a fixed text or number, you may also include a function when defining a variable. @@ -50,8 +49,8 @@ Command we are going to work on will be report command used in the following way So we will use the following code: ```php /* Note: - $user would interfere with a default $user function. - We will have to use $get function. + $user would interfere with the default $user function. + We will have to use the $get function. */ $let[user;$message[1]] $let[reason;$message[2+]] @@ -74,15 +73,15 @@ You can see all the message parameters have been printed out successfully. ## Permanent -As the name suggests, permanent variables remain after executions. -In CC, permanent variable can be attached to one of a few discord components. +As the name suggests, permanent variables remain after execution. +In CC, permanent variables can be attached to one of a few discord components. * **Server** - one value for the whole server * **Channel** - one value for each channel * **User** - one value for every user * **Message** - one value for each message -### How to define one? +### How to define a permanent variable. All functions used to define & access permanent variables follow the same naming convention: ```bash $[action][vartype]Var @@ -94,7 +93,7 @@ $setMessageVar ``` ### Examples -Here are some examples of putting permanent variables into reality +Here are some examples of implementing permanent variables: ::: tip Where is the data stored? Permanent variables are not stored within discord, they are kept in Custom Command's database. @@ -102,7 +101,7 @@ If you are concerned about privacy please refer to the [Privacy Policy](./3.poli ::: ## 1. Server -Let's define a server variable called `welcomeMsg` containing content of welcome message. +Let's define a server variable called `welcomeMsg` containing content of a welcome message. @@ -167,10 +166,10 @@ You can see that different channels received different values of the same `descr ## 3. User -Another type of permanent variables are **user** variables. -As the name suggests the same user variable can have varying values among users. +Another type of permanent variable are the **user** variables. +The same user variable can have varying values among users different users, the same as channel variables. -This example will show user variables by creating an `!aboutMe` command that allows users to set their own descriptions. +This example will show user variables by creating an `!aboutMe` command that allows users to set their own description. ### `!aboutMe` command Let's start of by creating a command for setting a description @@ -185,7 +184,7 @@ $setUserVar[aboutMe;$message] Your about me has been set successfully ``` -Now two different members, Member, and Steve will set their descriptions: +Now two different members, Member and Steve, will set their descriptions: @@ -242,7 +241,7 @@ It's time to see if !profile command returns the correct descriptions ## 4. Message If you read the previous sections carefully, you should already get the idea of permanent variables. -Message variables work in the same way as other types do, but can be attached to a single message. +Message variables work in the same way as other types do, but are attached to a single message. Here we will make a nickname change request command, that will allow button handler to access requested nickname. @@ -288,8 +287,8 @@ Let's create a new command with **button** trigger. The code has to: -1. Grab **new nickname** and **requesting user** from message variables -2. Change the nicknamee +1. Grab the **new nickname** and **requesting user** from the message variables +2. Change the nickname 3. Notify user in the `#bots` channel 4. Disable the approve button @@ -322,5 +321,5 @@ That's because the default value of the third parameter is `$messageID` which is ::: ::: warning Server owner -Keep in mind that discord doesn't allow bots to change server owner's nickname. If server owner executes this command, the bot will reply with an error message. +Keep in mind that discord doesn't allow bots to change the server owner's nickname. If the server owner executes this command, the bot will reply with an error message. ::: From d5daa3bd8fe6cfd672cdf4ff64fc1d50317aac2e Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:15:47 +0200 Subject: [PATCH 019/156] Update 7.array.md miniscule updates to grammar --- guide/Guide/7.array.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/guide/Guide/7.array.md b/guide/Guide/7.array.md index ade37ed..2d19630 100644 --- a/guide/Guide/7.array.md +++ b/guide/Guide/7.array.md @@ -1,10 +1,10 @@ # Using arrays -In this guide you will learn: what arrays are, and how to use them. +In this guide you will learn what arrays are, and how to use them. ## General info Generally speaking, arrays are collections of elements arranged in order. -You can think of them as lines, queues containing multiple elements. +You can think of them as lines/queues containing multiple people(elements). ## Indexing Indexes are used to differentiate elements in most array-related functions. @@ -15,7 +15,7 @@ Let's say we had an array of three people: **Bob**, **Adam**, and **Lucy**. * **Adam**'s index is 2 * **Lucy**'s index is 3 -Once you have an array, you can use a variety of functions to edit, and get information from it. +Once you have an array, you can use a variety of functions to edit and get information from it. ## Using arrays In Custom Command there are two main ways of creating an array. In this guide, we will cover both of them. @@ -47,13 +47,13 @@ Let's execute the code, and check how many elements have been created. -As you can see, the number returned matches with the number of fruits we provided in the first place. +As you can see, the number returned matches with the number of fruits we provided. ## 2. Pushing elements You may not always want to create an array from a given text. In some cases, you may prefer to start building an array, by appending new elements to an empty one. -In order to do that, you may use [$arrayPush](../Text/Array/arrayPush.md) function, which adds a new element to the end of the array. +In order to do that, you can use the [$arrayPush](../Text/Array/arrayPush.md) function, which adds a new element to the end of the array. Let's craft an array of a few different animals, and check what's the first and last one. @@ -79,12 +79,12 @@ Let's execute this code and see what it returns. As you can array push has correctly registered separate animals. ## 3. Searching for values -As you may know, array functions mostly work based on element indexes. -Generally, this kind of behavior is convenient, but we also need a way to get those indexes from existing arrays. +As you may know, array functions mostly work based on element indices. +Generally, this kind of behavior is convenient, but we also need a way to get those indices from existing arrays. Here's how to use [$arraySearch](../Text/Array/arraySearch.md) to do just that. -Let's start off by creating a new array of a few staff members, and check `fajfaj`'s index. +Let's start off by creating a new array of a few staff members, and get `fajfaj`'s index. ```php $arrayCreate[RAKE Oanretesue Mido fajfaj ThatKev; ] @@ -101,11 +101,11 @@ Now, head back to discord, and let's check the output: ## 4. Saving arrays By default, all changes made to an array are reset right after execution. -However, you may want to use arrays to store some valuable data, that has to keep track of all changes among the executions. +However, you may want to use arrays to store some data accros executions/commands, that has to keep track of all changes among the executions. -In that case [Permanent variables](./6.variables.md#permanent) come in handy. +In that case [permanent variables](./6.variables.md#permanent) come in handy. -In this example we will create `!todo` command that will store and display all tasks scheduled. +In this example we will create a `!todo` command that will store and display all tasks scheduled. More specifically, we want it to: ![](https://cdn.discordapp.com/attachments/1105873889155895407/1109232936735232100/image.png) @@ -150,4 +150,4 @@ Notice that changes made to the array do not expire after execution. ### 🎉 Congratulations You've reached the end of this tutorial, but not the end of array capabilities! -There's a plenty of functions that make arrays tick, have fun exploring the [Array category](../Text/Array/arrayClear.md)! \ No newline at end of file +There's a plenty of functions that make arrays tick, have fun exploring the [Array category](../Text/Array/arrayClear.md)! From 134dc5e8f8752dbf6f66958e250201c00652547d Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:20:11 +0200 Subject: [PATCH 020/156] grammar fix to onlyForCategories.md edited the function description to make sense --- guide/Text/only/onlyForCategories.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Text/only/onlyForCategories.md b/guide/Text/only/onlyForCategories.md index a60d107..27356e1 100644 --- a/guide/Text/only/onlyForCategories.md +++ b/guide/Text/only/onlyForCategories.md @@ -1,9 +1,9 @@ # $onlyForCategories -Only in given categories categorie will be able to execute this command +The command will only be executable in the provided categories. #### Usage: `$onlyForCategories[categoryID;categoryID;...;error message]` -#### Example: `$onlyForCategories[797978978978988;:x: - this command is restricted to Main category]` +#### Example: `$onlyForCategories[797978978978988;:x: - this command is restricted to the Main category]` ::: danger Use this code, on the FIRST line of your code! If you do not, it will execute all code before this line and not after! @@ -14,4 +14,4 @@ You can send embed using [Message Curl Format](../../CodeReferences/ref.message_ ::: ##### Function difficulty -###### Tags: \ No newline at end of file +###### Tags: From 79b52b7419e80f5f80816ecd2f1bf8493f30d730 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:23:29 +0200 Subject: [PATCH 021/156] description update + warning removal to advancedTextSplit.md Updated the description to explain the function usage better removed the warning saying the function doesnt work as it does now --- guide/Text/textSplit/advancedTextSplit.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/guide/Text/textSplit/advancedTextSplit.md b/guide/Text/textSplit/advancedTextSplit.md index 184a886..f13b9ef 100644 --- a/guide/Text/textSplit/advancedTextSplit.md +++ b/guide/Text/textSplit/advancedTextSplit.md @@ -1,11 +1,8 @@ # $advancedTextSplit -The first field is the message we want to split and get indexes for. The second -field would be the split used in the text, and the next field would get the value of the index, setting this index value as the new text. The next -fields work as splitters and new indexes. +The first field is the message we want to split and get indices for. The second +field would be the split/seperator used in the text, and the next field would get the value of the index provided, setting this index value as the new text. The next +fields work as splitters/seperators and new indices for this new text. -::: danger Currently bugged -don't even respond at all -::: #### Usage: `$advancedTextSplit[text;split;index;split;index;...]`
@@ -21,4 +18,4 @@ don't even respond at all ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From acb3184e14fee2054f64b0eb61301a4455bc19de Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:25:16 +0200 Subject: [PATCH 022/156] description update | spliceTextJoin.md added a bit at the end to explain where "seperator3 goes" --- guide/Text/textSplit/spliceTextJoin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/textSplit/spliceTextJoin.md b/guide/Text/textSplit/spliceTextJoin.md index c242dfc..18d0e7d 100644 --- a/guide/Text/textSplit/spliceTextJoin.md +++ b/guide/Text/textSplit/spliceTextJoin.md @@ -1,5 +1,5 @@ # $spliceTextJoin -Splits a text with `separator1`, then joins with `separator2` every `x` times, and them joins with `separator3`. +Splits a text with `separator1`, then joins with it `separator2` every `x` times, and then joins with `separator3` every `x-1` times. #### Usage: `$spliceTextJoin[text;separator1;separator2;separator3;every]`
@@ -13,4 +13,4 @@ Splits a text with `separator1`, then joins with `separator2` every `x` times, a ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 4f70cdcd353909b75e4f6bc619af314aefc62d4b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:26:45 +0200 Subject: [PATCH 023/156] description update | textSplit.md improved the description to properly describe what the function does --- guide/Text/textSplit/textSplit.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/textSplit/textSplit.md b/guide/Text/textSplit/textSplit.md index c163c84..6909ea3 100644 --- a/guide/Text/textSplit/textSplit.md +++ b/guide/Text/textSplit/textSplit.md @@ -1,5 +1,5 @@ # $textSplit -splits text into pieces! To access them use: [$arrayGet](./../Array/arrayGet.md) or array functions +Splits the provided text with `seperator` and returns an array. To access them use: [$arrayGet](./../Array/arrayGet.md) or other array functions #### Usage: `$textSplit[text;separator(optional, default = ,)]` @@ -13,4 +13,4 @@ splits text into pieces! To access them use: [$arrayGet](./../Array/arrayGet.md) ##### Function difficulty -###### Tags: \ No newline at end of file +###### Tags: From 79f4ecbe51a171ab9938597d8b4bdcc6e8a35f71 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:29:53 +0200 Subject: [PATCH 024/156] description update | vcAfter.md updated the description to better explain what the function does --- guide/Channel/vcAfter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Channel/vcAfter.md b/guide/Channel/vcAfter.md index ca6c1af..a9510e3 100644 --- a/guide/Channel/vcAfter.md +++ b/guide/Channel/vcAfter.md @@ -1,6 +1,6 @@ # $vcAfter -Returns the Voice channelID that the user switched to, **after**. +Returns the Voice channelID that the user switched to, **after** switching voice channels or joining a voice channel without being in one prior. ## Usage From 46cf650808071d08cad69afe5ff2ebf4bf48dac4 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:31:09 +0200 Subject: [PATCH 025/156] description update | vcBefore.md same as vcafter, updated the description to better explain the function --- guide/Channel/vcBefore.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Channel/vcBefore.md b/guide/Channel/vcBefore.md index 0c4ff7d..9a448b0 100644 --- a/guide/Channel/vcBefore.md +++ b/guide/Channel/vcBefore.md @@ -1,6 +1,6 @@ # $vcBefore -Returns the Voice channelID the user switched from. +Returns the Voice channelID the user switched from when switching voice channels or when a user leaves a voice channel. ## Usage From d4e555ca968172bb418fd024c63d7feb2dbcca4b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:38:29 +0200 Subject: [PATCH 026/156] update to some limits specified | button.md made it so users know you cant have 2 of the same button ids in the same message also edited the available colors section to say that discord limits you to 4 colors only --- guide/Text/Components/button.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Text/Components/button.md b/guide/Text/Components/button.md index 21bb546..a97d1f5 100644 --- a/guide/Text/Components/button.md +++ b/guide/Text/Components/button.md @@ -16,11 +16,11 @@ $button[Click me!;;verySimpleButton] ::: tip What's an ID? ID is used to identify the button clicked. This way, you can decide what happens after clicking a specific button. -Keep in mind, that there musn't be two buttons with the same ID in one message. +Keep in mind, that there can't be two buttons with the same ID in one message. ::: ## Colors -There are four button colors available: +There are four button colors discord allows you to use: `blurple`, `grey`, `green`, and `red`. ```php @@ -98,4 +98,4 @@ Check these pages: ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 14c272f9b704e44e11d570fb0c1409ddb8f9d876 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:39:26 +0200 Subject: [PATCH 027/156] typo fixed | buttonURL.md --- guide/Text/Components/buttonURL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Components/buttonURL.md b/guide/Text/Components/buttonURL.md index f9c2c60..9bd3aa3 100644 --- a/guide/Text/Components/buttonURL.md +++ b/guide/Text/Components/buttonURL.md @@ -1,6 +1,6 @@ # $buttonURL -Return the clicked button's URL in Button trigger if it exists. Else, returns `undefined`` if not found. +Return the clicked button's URL in Button trigger if it exists. Else, returns `undefined` if not found. ## Usage From 7f198382d349f80ab0ae393a244d21fc235519ed Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:41:03 +0200 Subject: [PATCH 028/156] description update | abs.md explained what is meant by absolute value --- guide/Text/Math/abs.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Math/abs.md b/guide/Text/Math/abs.md index 353cb15..60f8ccf 100644 --- a/guide/Text/Math/abs.md +++ b/guide/Text/Math/abs.md @@ -1,6 +1,6 @@ # $abs -Return the absolute of a number +Return the absolute value of a number. Basically forces a number to be positive ## Usage @@ -16,4 +16,4 @@ $abs[Number] 25 - \ No newline at end of file + From 1e991b0953c2fd3471768a101901cd66f75f26c4 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:41:46 +0200 Subject: [PATCH 029/156] Update divide.md added what order the numbers get divided in --- guide/Text/Math/divide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Math/divide.md b/guide/Text/Math/divide.md index a7f8146..b6ec478 100644 --- a/guide/Text/Math/divide.md +++ b/guide/Text/Math/divide.md @@ -1,5 +1,5 @@ # $divide -divides (a) number(s) from each other +divides (a) number(s) from each other, from left to right #### Usage: `$divide[10;2;...]`
@@ -13,4 +13,4 @@ divides (a) number(s) from each other ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 80d6c23415c260ecaae6efe787fd3ccaed379056 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:42:13 +0200 Subject: [PATCH 030/156] Updated terminology | mathMax.md --- guide/Text/Math/mathMax.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Math/mathMax.md b/guide/Text/Math/mathMax.md index 0c3d179..464e5b0 100644 --- a/guide/Text/Math/mathMax.md +++ b/guide/Text/Math/mathMax.md @@ -1,6 +1,6 @@ # $mathMax -Return the highest number from a list of numbers +Return the largest number from a list of numbers ## Usage @@ -16,4 +16,4 @@ $MathMax[Number 1;Number 2;Number 3;...] 150 - \ No newline at end of file + From 9292d692147734c44788b71aabd2883576f613c2 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:42:33 +0200 Subject: [PATCH 031/156] Updated terminology | mathMin.md --- guide/Text/Math/mathMin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Math/mathMin.md b/guide/Text/Math/mathMin.md index f1551bc..8a21b9e 100644 --- a/guide/Text/Math/mathMin.md +++ b/guide/Text/Math/mathMin.md @@ -1,6 +1,6 @@ # $mathMin -Return the lowest number from a list of numbers +Return the smallest number from a list of numbers ## Usage @@ -16,4 +16,4 @@ $mathMin[Number 1;Number 2;Number 3;...] 50 - \ No newline at end of file + From 241182258f7c60065c3e72e375147c2e6196cf4f Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:43:41 +0200 Subject: [PATCH 032/156] fixed possible direct translation error | modulo.md --- guide/Text/Math/modulo.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Math/modulo.md b/guide/Text/Math/modulo.md index 4297d7c..6e7ed53 100644 --- a/guide/Text/Math/modulo.md +++ b/guide/Text/Math/modulo.md @@ -1,5 +1,5 @@ # $modulo -calculates the rest of a division +calculates the remainder of a division operation #### Usage: `$modulo[10;2;...]`
@@ -13,4 +13,4 @@ calculates the rest of a division ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From c90fa0ae575f469503d994005350e52de7aee696 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:45:15 +0200 Subject: [PATCH 033/156] description terminology update | round.md --- guide/Text/Math/round.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Math/round.md b/guide/Text/Math/round.md index e7f7e46..4619370 100644 --- a/guide/Text/Math/round.md +++ b/guide/Text/Math/round.md @@ -1,5 +1,5 @@ # $round -Rounds the number to the unit! +Rounds the number to the nearest integer. #### Usage: `$round[number]`
From 777f38be41f1d779053ee6ceb2394b7f17698446 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:48:20 +0200 Subject: [PATCH 034/156] description + example | update roundTenth.md made the description clearer updated the example to better reflect the description, as the previous example "rounded to 2 numbers" as a 9 was rounded up --- guide/Text/Math/roundTenth.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Text/Math/roundTenth.md b/guide/Text/Math/roundTenth.md index 8bce07f..bb27c4c 100644 --- a/guide/Text/Math/roundTenth.md +++ b/guide/Text/Math/roundTenth.md @@ -1,16 +1,16 @@ # $roundTenth -rounds the number to a fixed decimals after comman +Rounds the number to the nearest decimal specified in `toFixed` #### Usage: `$roundTenth[number;tofixed]`
- !!exec $roundTenth[10.897890790;2] + !!exec $roundTenth[10.877890790;2] - 10.90 + 10.88 ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From c8d5f75fe41f404e46f9d20e5730906825d42bfe Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:55:48 +0200 Subject: [PATCH 035/156] description + timeout update | awaitButton.md updated the description to be a bit clearer and added what tier 0's timeout limit is because 60 x 0 is 0 seconds yet the limit is 60 --- guide/Text/Components/awaitButton.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Text/Components/awaitButton.md b/guide/Text/Components/awaitButton.md index 4930729..ded1c1a 100644 --- a/guide/Text/Components/awaitButton.md +++ b/guide/Text/Components/awaitButton.md @@ -1,5 +1,5 @@ # $awaitButton -Wait a button to be pressed and return its button Id, or `undefined` in case of no button pressed until the timeout. +Waits for a button to be pressed and return its button Id, or `undefined` in case no button was pressed when the timeout is reached. :::tip Tip This function supports the [Message Curl Format](/CodeReferences/ref.message_curl_format.html). This way, you can send a message with buttons by using `{button:label:style/url:emoji:id:newline(yes/no)}`. @@ -9,9 +9,9 @@ This way, you can send a message with buttons by using `{button:label:style/url:
### Timeout -It means the maximum time bot can wait user button click for.\ -it accept format of time like `10s`.\ -The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. +The maximum time the bot waits for a user to click a button. +Accepts time in the format `10s` for example. +The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's limit is 60 seconds. ::: details Examples From c8631edf323018f72450561ee2b45b3c7e4132b7 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 20:59:10 +0200 Subject: [PATCH 036/156] timeout update | awaitMenu.md added the default timeout time for tier 0, like i did with awaitbutton --- guide/Text/Components/awaitMenu.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Text/Components/awaitMenu.md b/guide/Text/Components/awaitMenu.md index e59219b..a16ea7d 100644 --- a/guide/Text/Components/awaitMenu.md +++ b/guide/Text/Components/awaitMenu.md @@ -1,7 +1,7 @@ # $awaitMenu -To wait for a menu option to be selected and return the selected options values. -If nothing is selected, it returns `undefined`.` +To wait for a menu option to be selected and return the selected option(s) values. +If nothing is selected, it returns `undefined`. If multiple values are selected, all of them will be returned, separated with `,`. ## Usage @@ -12,7 +12,7 @@ $awaitMenu[Message (optional);user id (optional, default:author);timeout (option ### Timeout It means the maximum time bot can wait user message for.\ it accept format of time like `10s`.\ -The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. +The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's limit is 60 seconds. ### Example: @@ -21,4 +21,4 @@ The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180 -![](https://i.imgur.com/58Wzc05.gif) \ No newline at end of file +![](https://i.imgur.com/58Wzc05.gif) From f00fe136589547381203d0ad416b5f3c989ea3aa Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:00:07 +0200 Subject: [PATCH 037/156] Updated an error on my end | awaitButton.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit readded backslashes i thought were useless but they actually added newlines 🧠 --- guide/Text/Components/awaitButton.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Components/awaitButton.md b/guide/Text/Components/awaitButton.md index ded1c1a..ad10386 100644 --- a/guide/Text/Components/awaitButton.md +++ b/guide/Text/Components/awaitButton.md @@ -9,8 +9,8 @@ This way, you can send a message with buttons by using `{button:label:style/url:
### Timeout -The maximum time the bot waits for a user to click a button. -Accepts time in the format `10s` for example. +The maximum time the bot waits for a user to click a button.\ +Accepts time in the format `10s` for example.\ The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's limit is 60 seconds. ::: details Examples From 2c5343097037537721582dd7f5e472d6fb4fd4d6 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:01:46 +0200 Subject: [PATCH 038/156] description update | onlyIf.md --- guide/Text/only/onlyIf.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/only/onlyIf.md b/guide/Text/only/onlyIf.md index 0211376..d00a0ff 100644 --- a/guide/Text/only/onlyIf.md +++ b/guide/Text/only/onlyIf.md @@ -1,5 +1,5 @@ # $onlyIf -Continue execution only if certain [expression](../../CodeReferences/ref.expression.md) is satisfied, else send error message +Continue the execution only if certain [expression](../../CodeReferences/ref.expression.md) is satisfied, otherwise top the execution and send the error message. In theory $onlyif can replace all other $onlyFor with the proper [expression](../../CodeReferences/ref.expression.md) #### Usage: `$onlyif[Expression;error message]` @@ -14,4 +14,4 @@ You can send embed using [Message Curl Format](../../CodeReferences/ref.message_ ::: ##### Function difficulty -###### Tags: \ No newline at end of file +###### Tags: From 86850788ce0d3755036fefe475dd0a00ac264f5a Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:03:01 +0200 Subject: [PATCH 039/156] timeout update | awaitMessage.md added default timeout time for tier 0 --- guide/Message/awaitMessage.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Message/awaitMessage.md b/guide/Message/awaitMessage.md index 5fe5105..2ecfaa5 100644 --- a/guide/Message/awaitMessage.md +++ b/guide/Message/awaitMessage.md @@ -1,6 +1,6 @@ # $awaitMessage -Awaits a message from given user ID or everyone in this channel, and return it +Awaits a message from given user ID or everyone in this channel, and returns it's message id/content. ## Usage @@ -11,7 +11,7 @@ return the user reply or undefined ### Timeout It means the maximum time bot can wait user message for.\ it accept format of time like `10s`.\ -The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. +The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's max timeout is 60 seconds. ### Example: @@ -27,4 +27,4 @@ The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180 Your answer is: YES - \ No newline at end of file + From 6d8899e6257ff8b0f90978737de1ed2fe8c20d7c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:44:24 +0200 Subject: [PATCH 040/156] Fixed hyperlink | formatDate.md --- guide/Date/formatDate.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Date/formatDate.md b/guide/Date/formatDate.md index 65cdc46..f7c037e 100644 --- a/guide/Date/formatDate.md +++ b/guide/Date/formatDate.md @@ -1,5 +1,5 @@ # $formatDate -Formats the providen Date in Milliseconds / Stringed Date / ISO String to default/given format. syntax of formats can be found (here)[https://momentjs.com/docs/#/parsing/string-format/] +Formats the providen Date provided in Milliseconds/Stringed Date/ISO String to default/given format. Syntax of formats can be found [here](https://momentjs.com/docs/#/parsing/string-format/) #### Usage: `$formatDate[date in ms / string / iso string / javascript convertable date;format]` Example:
@@ -39,4 +39,4 @@ Date functions uses on default UTC timezone,but you can change it [Learn More](. ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From c3a5f06646447e924a8e94ae38d03917d9bd4a98 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:46:23 +0200 Subject: [PATCH 041/156] Grammar update | humanizeMS.md --- guide/Date/humanizeMS.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Date/humanizeMS.md b/guide/Date/humanizeMS.md index aad0b6e..cf0f0bb 100644 --- a/guide/Date/humanizeMS.md +++ b/guide/Date/humanizeMS.md @@ -1,5 +1,5 @@ # $humanizeMS -Converts Milliseconds into a Readable durations +Converts milliseconds into human readable durations #### Usage: `$humanizeMS[MS;limit (Number) (optional), separator (optional)]` Example: @@ -13,9 +13,9 @@ Example: -::: tip Other Timezone -Date functions uses on default UTC timezone,but you can change it [Learn More](./timezone.md) +::: tip Other Timezones +Date functions by default use the UTC timezone,but you can change it [Learn More](./timezone.md) ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 23c82a70edad1b03c4ad6fcbaa1a61382be148a5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:47:56 +0200 Subject: [PATCH 042/156] Grammar update | memberJoinedDate.md --- guide/Date/memberJoinedDate.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Date/memberJoinedDate.md b/guide/Date/memberJoinedDate.md index 76140b7..4885a9d 100644 --- a/guide/Date/memberJoinedDate.md +++ b/guide/Date/memberJoinedDate.md @@ -1,5 +1,5 @@ # $memberJoinedDate -returns the date the member Joined in date or time or from the current Author +Returns the date a member joined in date or time from the provided user/command executor. #### Usage: `$memberJoinedDate[userid;date/time(optional)]` or `$memberJoinedDate` Example:
@@ -17,4 +17,4 @@ Date functions uses on default UTC timezone,but you can change it [Learn More](. ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 43e11ea9e729ab1325451e05a5b767a6a8f61f6c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Wed, 17 Jul 2024 21:50:25 +0200 Subject: [PATCH 043/156] Fixed the hyperlink + description update | timezone.md --- guide/Date/timezone.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Date/timezone.md b/guide/Date/timezone.md index ccb6123..e64a2cc 100644 --- a/guide/Date/timezone.md +++ b/guide/Date/timezone.md @@ -1,6 +1,6 @@ # $timezone -this function set the timezone for all date functions -get tz name (here)[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones] +This function sets the timezone for all date functions after the `$timezone` function itself.\ +Get valid timezone names from [this website](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) #### Usage: `$timezone[Region/City]` Example: From 6438dbacf5573fe5260a1be4b055fdc91e75292f Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 19:51:42 +0200 Subject: [PATCH 044/156] spelling update | randomTextBiased.md --- guide/Random/randomTextBiased.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Random/randomTextBiased.md b/guide/Random/randomTextBiased.md index c024e95..fba3a2a 100644 --- a/guide/Random/randomTextBiased.md +++ b/guide/Random/randomTextBiased.md @@ -9,7 +9,7 @@ $randomTextBiased[Text1,Weight1;Text2,Weight2;Text3,Weight3] ``` ### Note: -The more weight a text have, the more likely it will be selected +The more weight a text has, the more likely it it to be selected ### Example (Unlucky guy): @@ -29,4 +29,4 @@ The more weight a text have, the more likely it will be selected Your reward is: Epic Box - \ No newline at end of file + From 2aa01b4ee977da63fbd3b77d62f9daf58f26a4e5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 19:52:27 +0200 Subject: [PATCH 045/156] spelling update | randomTextBiased.md made a typo myself --- guide/Random/randomTextBiased.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Random/randomTextBiased.md b/guide/Random/randomTextBiased.md index fba3a2a..2d4bbc5 100644 --- a/guide/Random/randomTextBiased.md +++ b/guide/Random/randomTextBiased.md @@ -9,7 +9,7 @@ $randomTextBiased[Text1,Weight1;Text2,Weight2;Text3,Weight3] ``` ### Note: -The more weight a text has, the more likely it it to be selected +The more weight a text has, the more likely it is to be selected ### Example (Unlucky guy): From 8859e903ecdf37cab33fc65cd9c693820f06c751 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 19:53:33 +0200 Subject: [PATCH 046/156] grammar update | eventDelete.md --- guide/Events/eventDelete.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/guide/Events/eventDelete.md b/guide/Events/eventDelete.md index 3a006cb..7d6da56 100644 --- a/guide/Events/eventDelete.md +++ b/guide/Events/eventDelete.md @@ -1,7 +1,6 @@ # $eventDelete -to delete an already existed event - +To delete an existing event ## Usage ```bash From 0f9e62ac46e86ed98e65ff98bf91060499eb9fcf Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 19:58:06 +0200 Subject: [PATCH 047/156] description update | timeoutAction.md updated the description to make more sense --- guide/Timeout/timeoutAction.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/guide/Timeout/timeoutAction.md b/guide/Timeout/timeoutAction.md index 579cdee..1e66c4c 100644 --- a/guide/Timeout/timeoutAction.md +++ b/guide/Timeout/timeoutAction.md @@ -1,6 +1,7 @@ # $timeoutAction -Return `add` in case of timeout user, `remove` in case of timeout got removed by someone in Timeout trigger +Returns `add` if a user was timed out, `remove` if the timeout was removed. +This function only works in the Timeout trigger. ## Usage From 86e200d11b3ab3d558b086900474ba6b2dd8922c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 19:58:18 +0200 Subject: [PATCH 048/156] Update timeoutAction.md --- guide/Timeout/timeoutAction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Timeout/timeoutAction.md b/guide/Timeout/timeoutAction.md index 1e66c4c..238c8b4 100644 --- a/guide/Timeout/timeoutAction.md +++ b/guide/Timeout/timeoutAction.md @@ -1,6 +1,6 @@ # $timeoutAction -Returns `add` if a user was timed out, `remove` if the timeout was removed. +Returns `add` if a user was timed out, `remove` if the timeout was removed.\ This function only works in the Timeout trigger. ## Usage From 33c046819bd72d00684b02cdad98524b747f08f4 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:16:33 +0200 Subject: [PATCH 049/156] description update timeoutBy.md --- guide/Timeout/timeoutBy.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/guide/Timeout/timeoutBy.md b/guide/Timeout/timeoutBy.md index def9ed9..41b3b1f 100644 --- a/guide/Timeout/timeoutBy.md +++ b/guide/Timeout/timeoutBy.md @@ -1,6 +1,7 @@ # $timeoutBy -Return the user id of the admin/mod that timeout the user in Timeout trigger +Return the user id of the admin/mod that timed out the user.\ +This function only works in the Timeout trigger. ## Usage From ae28a17af0f4c32ac9316e4ca1fb5c120c1213cd Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:17:13 +0200 Subject: [PATCH 050/156] description update | timeoutReason.md --- guide/Timeout/timeoutReason.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/guide/Timeout/timeoutReason.md b/guide/Timeout/timeoutReason.md index 2a011a5..e8de337 100644 --- a/guide/Timeout/timeoutReason.md +++ b/guide/Timeout/timeoutReason.md @@ -1,6 +1,7 @@ # $timeoutReason -Return the reason of timeout in Timeout trigger +Return the reason of the timeout.\ +This function only works in the Timeout trigger. ## Usage From 8b59c17145f1a4c24883f0c8d07af793aa9dd3e1 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:21:13 +0200 Subject: [PATCH 051/156] description update | userGetTimeout.md --- guide/Timeout/userGetTimeout.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Timeout/userGetTimeout.md b/guide/Timeout/userGetTimeout.md index 9d8ad55..d9d8b01 100644 --- a/guide/Timeout/userGetTimeout.md +++ b/guide/Timeout/userGetTimeout.md @@ -1,7 +1,7 @@ # $userGetTimeout -Return timeleft for timeout expiry in milliseconds\ -If user is not timeout, it will return 0 +Return the time left of the timeout in milliseconds.\ +If user is not timed out, it will return 0. ## Usage From efa333a31850c40e5073af0357648717bb7c3edd Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:21:59 +0200 Subject: [PATCH 052/156] description update | userRemoveTimeout.md --- guide/Timeout/userRemoveTimeout.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Timeout/userRemoveTimeout.md b/guide/Timeout/userRemoveTimeout.md index 71a28e7..5240fd5 100644 --- a/guide/Timeout/userRemoveTimeout.md +++ b/guide/Timeout/userRemoveTimeout.md @@ -1,6 +1,6 @@ # $userRemoveTimeout -Remove timeout on a user, so he can talk +Removes a timeout from a user. ## Usage From f8adb6a3d7d8c9d3644ab70351fd05690b6b6d8c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:33:42 +0200 Subject: [PATCH 053/156] description update | userSetTimeout.md --- guide/Timeout/userSetTimeout.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Timeout/userSetTimeout.md b/guide/Timeout/userSetTimeout.md index 7718b7c..af2f29c 100644 --- a/guide/Timeout/userSetTimeout.md +++ b/guide/Timeout/userSetTimeout.md @@ -1,6 +1,6 @@ # $userSetTimeout -Set timeout user so he can't chat or communicate for specified period +Sets a user timeout, so the user cannot talk/interact with the server. ## Usage From 3b6980defa92808929edde01da62b1a35c6a5ea9 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:40:16 +0200 Subject: [PATCH 054/156] description update | addField.md --- guide/Text/Embed/addField.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/addField.md b/guide/Text/Embed/addField.md index 540b483..d70963e 100644 --- a/guide/Text/Embed/addField.md +++ b/guide/Text/Embed/addField.md @@ -1,5 +1,5 @@ # $addField -Adds fields to a message +Adds fields to a message embed. #### Usage: `$addField[title;value;inline(yes/no default=yes)(optional)]`
@@ -56,4 +56,4 @@ Use: `{field:name:value:inline(yes/no default=yes)(optional)}` ::: danger Please be aware!! If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) -::: \ No newline at end of file +::: From 13c0146c887f92ff9064026fae71830146134ca3 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:42:32 +0200 Subject: [PATCH 055/156] description update | addTimestamp.md --- guide/Text/Embed/addTimestamp.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/addTimestamp.md b/guide/Text/Embed/addTimestamp.md index 9615331..c0ce10d 100644 --- a/guide/Text/Embed/addTimestamp.md +++ b/guide/Text/Embed/addTimestamp.md @@ -1,5 +1,5 @@ # $addTimestamp -Adds a timestamp to a message +Adds a timestamp to a message embed. #### Usage: `$addTimestamp` or `$addTimestamp[ms]`
@@ -38,4 +38,4 @@ Use: `{timestamp:ms}` ::: danger Please be aware!! If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) -::: \ No newline at end of file +::: From 78f1485a44960eed3b16a7260e3e0ca4bf86369f Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:45:28 +0200 Subject: [PATCH 056/156] description update | attachment.md --- guide/Text/Embed/attachment.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Text/Embed/attachment.md b/guide/Text/Embed/attachment.md index 5944ea1..2b940b5 100644 --- a/guide/Text/Embed/attachment.md +++ b/guide/Text/Embed/attachment.md @@ -1,8 +1,8 @@ # $attachment -adds an attachment.\ +Adds an attachment to a message.\ \ -If name field is given, you must specify the extension for the attachment (png, webp, or gif) +If the name field is given, you must specify the extension for the attachment (png, webp, or gif) ## Usage @@ -11,4 +11,4 @@ $attachment[data;name (optional);type (url or buffer) (optional);spoiler (yes/no ``` ## Example -![](https://i.imgur.com/ZoePBlD.png) \ No newline at end of file +![](https://i.imgur.com/ZoePBlD.png) From 2f7c3f014ec6f83b43a32e8e88a1f57abd57136b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:47:34 +0200 Subject: [PATCH 057/156] description update | author.md also fixed some spelling --- guide/Text/Embed/author.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Text/Embed/author.md b/guide/Text/Embed/author.md index b80f4bc..06d31cd 100644 --- a/guide/Text/Embed/author.md +++ b/guide/Text/Embed/author.md @@ -1,7 +1,7 @@ # $author -Adds the author to a message with hyper link / icon or text +Adds an author to a message embed, with an optional icon url and/or hyperlink. -#### Usage: `$author[text;icon url(optional);hyper link(optional)]` +#### Usage: `$author[text;icon url(optional);hyperlink(optional)]`
@@ -46,4 +46,4 @@ Use: `{author:text:icon url(optional):hyper link(optional)}` ::: danger Please be aware!! If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) -::: \ No newline at end of file +::: From 6d362cf5f49ed2406ba0aa4de505433b722dceae Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:48:29 +0200 Subject: [PATCH 058/156] description update | description.md --- guide/Text/Embed/description.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/description.md b/guide/Text/Embed/description.md index 07260e3..39d9537 100644 --- a/guide/Text/Embed/description.md +++ b/guide/Text/Embed/description.md @@ -1,5 +1,5 @@ # $description -Adds a description to a message +Adds a description to a message emnbed. #### Usage: `$description[your text]`
@@ -38,4 +38,4 @@ Use: `{description:your text}` ::: danger Please be aware!! If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) -::: \ No newline at end of file +::: From a62b1ff2175ab95d640a9cb1d6bb042c8ba50ec8 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 20:59:28 +0200 Subject: [PATCH 059/156] function update | example.md removed the int option of $color as the function doesn't accept int color inputs also updated the description --- guide/Text/Embed/example.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/guide/Text/Embed/example.md b/guide/Text/Embed/example.md index 87158e6..b450976 100644 --- a/guide/Text/Embed/example.md +++ b/guide/Text/Embed/example.md @@ -1,13 +1,12 @@ # Complete Embed -Here is a code for a complete embed and a comprehension of both embed formats. - +Here is a code example for a complete embed in both function and curl format. ## Function Format ```php $author[name;avatar;link] $title[title;url] -$color[hex/int/COLOR] +$color[hex/colorname/random] $thumbnail[url] $description[description] $addField[name;value;inline (yes/no)] @@ -30,7 +29,7 @@ Here are all curl embed components you can use in any function containing `messa ``` {author:name:avatar:link url} {title:title} -{color:hex/int/COLOR} +{color:hex/colorname/random} {url:title url} {thumbnail:url} {description:description} @@ -62,10 +61,10 @@ These arguments can be used in interaction trigger commands. {message=content, curl embed, menus, buttons...} // Only in $interactionReply ``` -::: tip What are ephemerals? -Ephemerals are interaction replies visibile only to the one who executed the command. +::: tip What are ephemeral messages? +Ephemeral messages are interaction replies visibile only to the one who executed the command. -![Ephemerals preview](https://cdn.discordapp.com/attachments/957286111250624552/1100459877480013914/image.png) +![Ephemeral message preview](https://cdn.discordapp.com/attachments/957286111250624552/1100459877480013914/image.png) ::: ## What is the difference between function and embed format? @@ -88,7 +87,7 @@ $changeNickname[$authorID;$toLowercase[$username]] ### 2. Curl Format: -Curl embeds are a more complex way of sending embeds. It's used to "attach" an embed to a message sent with a function like `$sendMessage`, or `$interactionReply`. +Curl embeds are a more complex way of sending embeds. It's used to "attach" an embed to a message sent with a function like `$sendMessage` or `$interactionReply`. This format unlike the previous one, follows the normal code flow. #### Example: @@ -113,8 +112,8 @@ $editMessage[$sentMessageID; ::: danger Separators Please note, that separators vary between the formats: -* Function arguments are separated `;` -* Curl embed arguments are separated with `:` +* Function arguments are separated by a `;` +* Curl embed arguments are separated by a `:` ::: ###### Tags: From 71336cf7dfcaa488341fc648766c7dc0e8f686b0 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:08:18 +0200 Subject: [PATCH 060/156] Update color.md --- guide/Text/Embed/color.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/color.md b/guide/Text/Embed/color.md index 5235e47..fda6c23 100644 --- a/guide/Text/Embed/color.md +++ b/guide/Text/Embed/color.md @@ -1,7 +1,7 @@ # $color sets the color of the embed -#### Usage: `$color[hex or colorname or RANDOM]` +#### Usage: `$color[hex/colorname/random/transparent]`
@@ -24,4 +24,4 @@ Example: `{color:#0099ff}` ::: danger Please be aware!! If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) -::: \ No newline at end of file +::: From 1c43aa98d7e286c13cf0ea14b760df94893ae692 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:09:05 +0200 Subject: [PATCH 061/156] description update | footer.md --- guide/Text/Embed/footer.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Text/Embed/footer.md b/guide/Text/Embed/footer.md index 67963d7..277c8c1 100644 --- a/guide/Text/Embed/footer.md +++ b/guide/Text/Embed/footer.md @@ -1,7 +1,7 @@ # $footer -Adds a footer to a message +Adds a footer to a message embed with an optional icon url -#### Usage: `$footer[YOUR TEXT HERE;icon url(optional)]` +#### Usage: `$footer[text;icon url(optional)]`
@@ -25,4 +25,4 @@ Use: `{footer: Your text here:icon url(optional)}` If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) Link escapes are needed, use `\` to escape characters. Read [me](../../Other/syntax.md) to see more -::: \ No newline at end of file +::: From a37a4cbae10c5820f30215c3ab36b2f7b57283ee Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:09:30 +0200 Subject: [PATCH 062/156] description update | image.md --- guide/Text/Embed/image.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/image.md b/guide/Text/Embed/image.md index d410d68..b9fb2e2 100644 --- a/guide/Text/Embed/image.md +++ b/guide/Text/Embed/image.md @@ -1,5 +1,5 @@ # $image -Adds an image to a message +Adds an image to a message embed #### Usage: `$image[YOUR URL HERE]`
@@ -25,4 +25,4 @@ Use: `{image: Your link here}` If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) Link escapes are needed, use `\` to escape characters. Read [me](../../Other/syntax.md) to see more -::: \ No newline at end of file +::: From c43fb579fd610676636345f7305fab2cc1e53dad Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:09:55 +0200 Subject: [PATCH 063/156] description update | thumbnail.md --- guide/Text/Embed/thumbnail.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/thumbnail.md b/guide/Text/Embed/thumbnail.md index 787bfc1..5755af5 100644 --- a/guide/Text/Embed/thumbnail.md +++ b/guide/Text/Embed/thumbnail.md @@ -1,5 +1,5 @@ # $thumbnail -Adds an thumbnail to an message +Adds a thumbnail to a message embed. #### Usage: `$thumbnail[YOUR URL HERE]`
@@ -25,4 +25,4 @@ Use: `{thumbnail: Your link here}` If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) Link escapes are needed, use `\` to escape characters. Read [me](../../Other/syntax.md) to see more -::: \ No newline at end of file +::: From 8c65db792b295db3caad24919bee60e84d2cdec5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:10:26 +0200 Subject: [PATCH 064/156] description update | title.md --- guide/Text/Embed/title.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Embed/title.md b/guide/Text/Embed/title.md index c90e773..ea95462 100644 --- a/guide/Text/Embed/title.md +++ b/guide/Text/Embed/title.md @@ -1,5 +1,5 @@ # $title -Adds an title to an message +Adds a title to a message embed. #### Usage: `$title[YOUR TITLE TEXT HERE;url(optional)]`
@@ -39,4 +39,4 @@ Use: `{title: Your title here}` ::: danger Please be aware!! If you add any `:` in this function it will error! Check out [this](../../Other/syntax.md) -::: \ No newline at end of file +::: From 7cbccda5cdaf1e7e09c1b16b9b079b17299887d5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:12:17 +0200 Subject: [PATCH 065/156] timeout update | awaitMessage.md updated the timeout description to reflect the docs after the recent commit --- guide/Message/awaitMessage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Message/awaitMessage.md b/guide/Message/awaitMessage.md index 2ecfaa5..9763539 100644 --- a/guide/Message/awaitMessage.md +++ b/guide/Message/awaitMessage.md @@ -11,7 +11,7 @@ return the user reply or undefined ### Timeout It means the maximum time bot can wait user message for.\ it accept format of time like `10s`.\ -The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's max timeout is 60 seconds. +The max time is 60 x (bot tier + 1) seconds, for example for tier 3 it would be 240 seconds. ### Example: From 1fdfa2b8ae5d97340fee39fb377ae2a7828a4989 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:14:32 +0200 Subject: [PATCH 066/156] timeout update | awaitButton.md updated the timeout section to reflect the recent commit to the docs --- guide/Text/Components/awaitButton.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/Components/awaitButton.md b/guide/Text/Components/awaitButton.md index ad10386..6b97da0 100644 --- a/guide/Text/Components/awaitButton.md +++ b/guide/Text/Components/awaitButton.md @@ -1,5 +1,5 @@ # $awaitButton -Waits for a button to be pressed and return its button Id, or `undefined` in case no button was pressed when the timeout is reached. +Waits for a button to be pressed and return its button id, or `undefined` in case no button was pressed when the timeout is reached. :::tip Tip This function supports the [Message Curl Format](/CodeReferences/ref.message_curl_format.html). This way, you can send a message with buttons by using `{button:label:style/url:emoji:id:newline(yes/no)}`. @@ -11,7 +11,7 @@ This way, you can send a message with buttons by using `{button:label:style/url: ### Timeout The maximum time the bot waits for a user to click a button.\ Accepts time in the format `10s` for example.\ -The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's limit is 60 seconds. +The max time is 60 x (bot tier + 1) seconds, for example for tier 3 it would be 240 seconds. ::: details Examples From bb4a37a8c617e7b4e74258fedb789abb9eb91e08 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Thu, 18 Jul 2024 21:15:17 +0200 Subject: [PATCH 067/156] timeout update | awaitMenu.md updated the timeout section to reflect the docs after the recent commit --- guide/Text/Components/awaitMenu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Components/awaitMenu.md b/guide/Text/Components/awaitMenu.md index a16ea7d..0ec3971 100644 --- a/guide/Text/Components/awaitMenu.md +++ b/guide/Text/Components/awaitMenu.md @@ -12,7 +12,7 @@ $awaitMenu[Message (optional);user id (optional, default:author);timeout (option ### Timeout It means the maximum time bot can wait user message for.\ it accept format of time like `10s`.\ -The max time is `60 x bot tier` seconds, for example for tier 3 it would be `180` seconds. Tier 0's limit is 60 seconds. +The max time is 60 x (bot tier + 1) seconds, for example for tier 3 it would be 240 seconds. ### Example: From f20d6ce174392a6e5d537de1abb8340d26b62d66 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 10:42:10 +0200 Subject: [PATCH 068/156] Minor sentence updates | CustomBot.md --- guide/Other/CustomBot.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/guide/Other/CustomBot.md b/guide/Other/CustomBot.md index 6604b54..45edf32 100644 --- a/guide/Other/CustomBot.md +++ b/guide/Other/CustomBot.md @@ -1,8 +1,8 @@ # Custom Bot -You can find here how to setup custom bot. You need this if you have tier 3+ by redeeming it or by winning in our support server. +Here you can find how to setup your custom bot. You need to do this if you have tier 3+ by redeeming it or by winning in our support server. -# Steps (Only Once) -## 1. Go to [Discord Dev Portal](https://discord.com/developers/applications) +# Steps (Only do these once) +## 1. Go to the [Discord Developer Portal](https://discord.com/developers/applications) ## 2. Create a new Application @@ -17,19 +17,19 @@ You can find here how to setup custom bot. You need this if you have tier 3+ by ## 4. Go to `Bot` ![go to section bot](https://i.imgur.com/xUCbccq.png) -## 5. Click Reset Token, To show a new valid token +## 5. Click Reset Token, to show a new valid token ![](https://i.imgur.com/GbWfwyy.png) ## 6. Click on 'Copy' to copy the token ![](https://i.imgur.com/pHYqcIT.png) -## 7. Go to the Dashboard [(click here)](https://ccommandbot.com/dashboard) and select the server where you want to have premium. +## 7. Go to the [Dashboard](https://ccommandbot.com/dashboard) and select the server where you want premium. ![](https://i.imgur.com/Ostshet.png) ![](https://i.imgur.com/fQXdiT3.png) -## 8. Paste the copied token in 'Token' input, then click 'Save' button +## 8. Paste the copied token in 'Token' input and then click 'Save' button ![](https://i.imgur.com/2FAuEKp.png) @@ -37,6 +37,5 @@ You can find here how to setup custom bot. You need this if you have tier 3+ by ![](https://i.imgur.com/zkjCUvB.png) -10. You are done! - Wait for few minutes, your bot should go online. - and that's it :tada:. **Ensure to leave the main bot in your server, otherwise you'll lose the ability to access the dashboard!** +## 10. You are done! + Wait for few minutes and your bot should go online and that's it :tada:! **Ensure to keep the main bot in your server, otherwise you'll lose the ability to access the dashboard!** From 80f7ef4f9c44c4b65c55c8fafd4600e6c89fbdd1 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 10:45:58 +0200 Subject: [PATCH 069/156] Description update | curl.md Made some things a little bit clearer --- guide/Other/curl.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/guide/Other/curl.md b/guide/Other/curl.md index a00d8e5..da527dd 100644 --- a/guide/Other/curl.md +++ b/guide/Other/curl.md @@ -1,6 +1,6 @@ # Curl Arguments -Curl arguments helps to pass arguments to a function instead of using a param array like $randomText[one;two;three]. -We have added curl arguments to improve the readability of long and complicated codes. Its not required anymore to fill optional values with `;;;` +Curl arguments help to pass arguments to a function instead of using a parameter array like $randomText[one;two;three]. +We have added curl arguments to improve the readability of long and complicated codes. With curl it's not required to fill optional values with empty parameter values like this: `;;;` ## Example @@ -13,8 +13,8 @@ $createChannel[ ] ``` -will create a channel without having to specify params like "return ID" & "NSFW" +This will create a channel without having to specify parameters like "return ID" or "NSFW" ## Curl support -Curl are not supported on every function. -Check the curl support by using !!func `fname` \ No newline at end of file +Curl is not supported on every function. +Check if a function supports curl by using !!func `function name` From 5c3924b0c39c93cf0edb336c447eaf31b4c42716 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 10:49:57 +0200 Subject: [PATCH 070/156] Wording update | ratelimits.md --- guide/Other/ratelimits.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/guide/Other/ratelimits.md b/guide/Other/ratelimits.md index 5a3c8f9..82c395c 100644 --- a/guide/Other/ratelimits.md +++ b/guide/Other/ratelimits.md @@ -2,16 +2,20 @@ Rate Limits prevents misleading usage or abuse of the API. Our Bot receives a lot of requests, that's why we have decided to use our own cooldown system. ## Function Cooldown -Many functions have a **cooldown** — time till next execution is possible for the same data input/user/place (e.g. channel or guild). +Many functions have a **cooldown** — time until next execution is possible for the same data input/user/place (e.g. channel or guild). + +The Bot acts differently if a called function is on cooldown: +* waits for cooldown to pass, then execute +* sends an error message +* cancels the execution without warning. -The Bot acts differently if a called function is on cooldown: waits for cooldown to pass, then execute; sends an error message; cancels the execution without warning. ::: tip -You can retrieve the cooldown of a function by using the command `!!func fname`. +You can see the cooldown (if any) of a function by using the command `!!func function name`. ::: ## Function Limit The same function with cooldown can only be called **5 times in the code**.
-If Function Limit is reached, bot cancels the execution of the function without warning. +If the function limit is reached, the bot cancels the execution of the function without warning. ## Execution Limits The Bot supports up to **5 parallel executions** of the same custom command. @@ -25,4 +29,4 @@ Following Limits are removed: * Function Cooldown * Function Limit hard capped to 20 calls * Execution Limits hard capped to 60 parallel executions -* Execution Cooldown hard capped to 0.5 seconds \ No newline at end of file +* Execution Cooldown hard capped to 0.5 seconds From e3869b0ba1cd707e91b80a7d28882ad3f4123269 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 10:54:48 +0200 Subject: [PATCH 071/156] Partial update | syntax.md Had to leave to do smth Carried on in a later commit --- guide/Other/syntax.md | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/guide/Other/syntax.md b/guide/Other/syntax.md index 66dad8d..a5d0f87 100644 --- a/guide/Other/syntax.md +++ b/guide/Other/syntax.md @@ -8,20 +8,20 @@ We are not affiliated with BDFD. But we're using a similar syntax ::: ## Syntax -In general the code only have 2 types:\ +In general the code only has 2 types:\ 1- [Text](#what-is-text)\ 2- [Function](#what-is-a-function) ## What is Text? -In the code anything is text except for [function](#what-is-a-function)\ +In the code anything is text except for [functions](#what-is-a-function)\ for example in this code: ``` Hello $username to our server ``` -`Hello`: is a text\ +`Hello`: is text\ [`$username`](../Member/username.md): is a function\ -`to our server` is a text +`to our server` is text ## What is a function Any function starts with `$` like [`$username`](../Member/username.md)\ @@ -31,26 +31,25 @@ Hello $username to our server ``` [`$username`](../Member/username.md) is the only function in this code -### But what function does? +### But what do functions do? Each function in general can do one of the 3 things: -* Replace itself by a value +* Replace itself with a value * Do an action -* Do an action and Replace itself by a value +* Do an action and Replace itself with a value -For Example In running this code: +For example running this code: ``` -Hello $username to our server! +Hello $username, welcome to our server! ``` -When this code runs you will find the bot sending: +you will find the bot sends: ``` -Hello Mido to our server! +Hello Mido, welcome to our server! ``` -Which clearly shows that [`$username`](../Member/username.md) function is `Replaced by value` type\ -and this value will always be the username of the author +Which clearly shows that the [`$username`](../Member/username.md) function is `Replaced by value` type and this value will always be the username of the author -::: tip `Replaced by value` type\ is also called `return` -Read carefully function descriptions in docs. +::: tip `Replaced by value` type is also called `return`\ +Read the function descriptions in docs carefully. If a function is replaced by value, it returns that value. E.g.: [`$username`](../Member/username.md) ***Returns*** the name of the user that executed the command From ba988d332158540f1849791d2e17c27b1006a0f8 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 12:46:01 +0200 Subject: [PATCH 072/156] Grammar update | syntax.md The other half of that update I wasn't able to finish earlier --- guide/Other/syntax.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/guide/Other/syntax.md b/guide/Other/syntax.md index a5d0f87..bba0377 100644 --- a/guide/Other/syntax.md +++ b/guide/Other/syntax.md @@ -64,9 +64,9 @@ Some functions requires an input from you to behave differently and this is the $function[Inputs] ``` Previously we used [`$username`](../Member/username.md) without inputs but why?\ -because [`$username`](../Member/username.md) documentations will tell you, that by default it will return the author name, but if you want to return someone else username you will need to do an input in this case\ -Assume that we want to get Rake name instead of Mido\ -we will first need to get Rake User ID, assume (1234) and input it to [`$username`](../Member/username.md): +As the [`$username`](../Member/username.md) documentation will tell you, that by default it will return the exrcutor's name, but if you want to return someone else username you will need to do an input in this case\ +Assume that we want to get Rake's name instead of Mido\ +We will first need to get Rake's User ID, assume 1234, and input it to [`$username`](../Member/username.md): ``` Hello $username[1234] ``` @@ -75,13 +75,13 @@ Output Hello Rake ``` ### Multiple Inputs -In some function it wants from you more than just 1 input like $channelSendMessage\ +Some functions need more than just 1 input like $channelSendMessage\ it asks for 2 different inputs (in order): * Channel ID to send to * Message Content -Assume that channel id is `1234`, and content is `Hello $username` -To apply these inputs in the function, we will separate them by `;`\ +Assume that the channel id is `1234`, and content is `Hello $username` +To apply these inputs in the function, we will separate them by a semicolon `;`\ Like this: ``` $channelSendMessage[1234;Hello $username] @@ -91,10 +91,10 @@ Output (in channel with ID 1234): Hello Mido ``` -Note: [`$channelSendMessage`](../Message/channelSendMessage.md) doesn't not get replaced by value, but only does an action (like sending the message) +Note: [`$channelSendMessage`](../Message/channelSendMessage.md) doesn't get replaced by a value, but only does an action (sending a message) ::: tip Function names are case insensitive -It means $authorID and $aUtHoRiD will work! +It means $authorID and $aUtHoRiD will work the same! ::: ## Expressions @@ -104,7 +104,7 @@ Provide an expression In this case, please read about the [expressions](../CodeReferences/ref.expression.md) here ## Escaping Characters -There's some danger characters that is troublesome to work with +There's some dangerous characters that are troublesome to work with for example let's say you want to send [`$username`](../Member/username.md) to be literally be sent like that and not be replaced to be the user name For example code: From 39edcc46010f5b24e71a5c5936cc0b70a6e6503c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 12:47:45 +0200 Subject: [PATCH 073/156] Spelt a singular word correctly | troubleshooting.md --- guide/Other/troubleshooting.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Other/troubleshooting.md b/guide/Other/troubleshooting.md index 3b48581..e09ed09 100644 --- a/guide/Other/troubleshooting.md +++ b/guide/Other/troubleshooting.md @@ -1,7 +1,7 @@ # Troubleshooting -Since our bot is very advanced, everyone faces there own problems. Because of this, we made a section, with some common problems. Sorted from most common to less common +Since our bot is very advanced, everyone faces their own problems. Because of this, we made a section, with some common problems. Sorted from most common to less common -The problem is the title, the answer is below it & after the question is the trigger type: +The problem is the title, the answer is below it and after the question is the trigger type: ## My command does not trigger Have you set the minimum permission for the command execution to `None`? From e8b26455bbe3a2cc3b8c6424630b8ee896565eef Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 12:51:23 +0200 Subject: [PATCH 074/156] Grammar update | useful.md --- guide/Other/useful.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Other/useful.md b/guide/Other/useful.md index d955ae7..ef5aa98 100644 --- a/guide/Other/useful.md +++ b/guide/Other/useful.md @@ -11,14 +11,14 @@ This page includes useful Information about the bot and this documentation. ::: tip What is a parameter? Parameters are Values, which a Function needs. To understand it let us see the usage of `$giveRoles[userid;roleid]` -* Parameter 1 is a userid. a userid is an ID unique to that user. To get the userid we will use another function named $authorID, which returns the id of the executor +* Parameter 1 is a userid. A userid is an ID unique to that user. To get the userid we will use another function named $authorID, which returns the id of the executor -* Parameter 2 is an roleid. To get the roleid, you can copy the id of the role you want to give or use an another function named `$roleID[rolename]` +* Parameter 2 is a roleid. To get the roleid, you can copy the id of the role you want to give or use an another function named `$roleID[rolename]` ::: #### Example: `$giveRoles[authorid;roleid1;...]` -`...` -> stands for that the func can have more then 1 parameter.Every paramter (in this case roleid ) gets seperated with `;` +`...` -> means the function can have more then 1 parameter. Every paramter (in this case roleid ) gets seperated with `;` #### Example: `$random[min;max;allowDecimals (yes/no)(optional, default=no)]` @@ -28,7 +28,7 @@ You don't have to provide an optional parameter,if you use the default parameter ### Okay, cool... But how do functions even work? ## Functions -A function is a building block for your code. For example, if you want to send a message, you use a function called [$channelSendMessage](../Message/channelSendMessage.md) or [$sendMessage](../Message/sendMessage.md). Or if you want to kick a member, you use a function called [$kick](../Member/kick.md) +A function is a building block for your code. For example, if you want to send a message, you use can a function called [$channelSendMessage](../Message/channelSendMessage.md) or [$sendMessage](../Message/sendMessage.md). Or if you want to kick a member, you use a function called [$kick](../Member/kick.md) ### Nice, now I understand the basics! How do I proceed? From 28c0704204c7d4cc7d4caebd5ebf5a3c4ce9e1a9 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 15:36:40 +0200 Subject: [PATCH 075/156] changed the "word" trigger description + other misc things --- guide/Trigger/1.triggers.md | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/guide/Trigger/1.triggers.md b/guide/Trigger/1.triggers.md index e99c1fd..2e3d0ad 100644 --- a/guide/Trigger/1.triggers.md +++ b/guide/Trigger/1.triggers.md @@ -2,15 +2,15 @@ Here's a quick preview of all available triggers: ## [Word](./word.md) -Responds to a message with specified content +Triggers on specific words/patterns > ![Word](https://i.imgur.com/zQtDgDM.png) ## [Reaction](./reaction.md) -Fires off once someone reacts to a message +Fires once someone reacts to a message > ![](https://i.imgur.com/h1pe28J.gif) ## [Button](./button.md) -Detects users clicking buttons +Detects users clicking buttons sent by the bot > ![](https://i.imgur.com/QrxFg8d.png) ## [Menu](./menu.md) @@ -18,11 +18,11 @@ Activates when someone confirms their choice in menu > ![](https://i.imgur.com/7wZLMIq.gif) ## [Slash command](./slash.md) -Responds to a discord slash command +Responds to a discord slash command created with the bot > ![](https://i.imgur.com/Hspy46H.gif) ## [Modal](./modal.md) -Triggers on submittion of a modal (form) +Triggers on submittion of a modal (form) if that modal was sent by the bot > ![](https://i.imgur.com/ON9e1D4.png) ## [Channel](./channel.md) @@ -31,35 +31,30 @@ Detects channels being added or removed ## [Role](./roleaddremove.md) Triggers on role assignment - > ![](https://cdn.discordapp.com/attachments/957286111250624552/1105149730553614486/voice-trigger.gif) ## [Timed event](./time.md) -Executes the code in provided time +Executes the code at a set time > ![](https://cdn.discordapp.com/attachments/1105135517055594508/1105141376083038240/image.png) ## [Interval](./time.md) -Repeatedly executes the code once in a specific time (e.g per hour) +Repeatedly executes the code once in a specific time (e.g every hour) > ![](https://cdn.discordapp.com/attachments/1100128432395927765/1116042286812385370/image.png) ## [Voice](./voicecondecon.md) Fires of when user leaves or joins a voice channel - > ![](https://cdn.discordapp.com/attachments/957286111250624552/1105149730553614486/voice-trigger.gif) ## [Server boost](./serverboost.md) Detects people boosting the server - > ![](https://cdn.discordapp.com/attachments/957286111250624552/1105142982270783587/image.png) ## [Join or Leave](./joinorleave.md) Triggers when someone joins or leaves the server - > ![](https://cdn.discordapp.com/attachments/957286111250624552/1105143572510027806/image.png) ## [Library](./library.md) A code which can be imported in any other code - > ![](https://cdn.discordapp.com/attachments/957286111250624552/1105145858581872750/image.png) > > In this example $includeLibrary has been used to import a library called `tools` which contained a custom $embedMsg function. From c50a9047ae93964dda370b73116df41c46df0644 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 15:41:04 +0200 Subject: [PATCH 076/156] grammar updates --- guide/Trigger/button.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Trigger/button.md b/guide/Trigger/button.md index 644abb4..63bcd6b 100644 --- a/guide/Trigger/button.md +++ b/guide/Trigger/button.md @@ -1,6 +1,6 @@ # Button Click -This trigger type, will detect when a user clicks a button. +This trigger type will detect when a user clicks a button. The button has to be sent by the bot. #### Example of a button: @@ -9,13 +9,13 @@ The button has to be sent by the bot. ## Syntax -In order for button command to work, there must be button ID to be matched specified. Here's how you can provide it: +In order for a button command to work, there must be a button ID specified. Here's how you can provide it: | Name | Syntax | Example | Explanation | | --- | --- | --- | --- | | Single ID | `button ID` | `staff-app` | Detects a button with "staff-app" ID | | Multiple IDs | `buttonID\|buttonID` | `Apple\|Banana\|Orange` | Matches a buttons with IDs: "Apple", "Banana", or "Orange" | -| Regex | `/RegExp/` | `/User-\d{18,}/` | Will trigger on any following the pattern "User-ID" like "User-434342521997492224" | +| Regex | `/RegExp/` | `/User-\d{18,}/` | Will trigger on any button following the pattern "User-ID" like "User-434342521997492224" | ::: tip Capitalization @@ -49,4 +49,4 @@ In regex ^ and $ are used to match the start and end of the string. ## More Info -Do you want to know more, about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! +Do you want to know more about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! From c11bb0c843690abe95851aa9e867638213dff836 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 15:44:48 +0200 Subject: [PATCH 077/156] minor changes to grammar --- guide/Trigger/channel.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Trigger/channel.md b/guide/Trigger/channel.md index 2edfd06..f29fc6b 100644 --- a/guide/Trigger/channel.md +++ b/guide/Trigger/channel.md @@ -17,12 +17,12 @@ Use this syntax to let the bot trigger when a channel is added or removed or bot `remove=category id` -> trigger when a channel is being deleted in category with id `category id` -::: tip Supported Channel Type +::: tip Supported Channel Types You can see the whole list [here.](../CodeReferences/ref.channel_types.md) ::: ## Related Functions -The following list is a functions that you might need: +The following list is functions that you might need: [$eventChannelID](../Channel/eventChannelID.md): will return the channel id that got created/removed From 47d3bc2799e0974cfbdde19209cc5c8a53a647f0 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 15:46:43 +0200 Subject: [PATCH 078/156] minor changes to grammar --- guide/Trigger/joinorleave.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Trigger/joinorleave.md b/guide/Trigger/joinorleave.md index 56414ca..9a356e6 100644 --- a/guide/Trigger/joinorleave.md +++ b/guide/Trigger/joinorleave.md @@ -1,14 +1,14 @@ # Member Join/Leave ## Basic Information -This trigger type, will trigger when a user joins or leaves the server. For premium users, the present intent needs to be enabled! +This trigger type will trigger when a user joins or leaves the server. For premium users, the presence intent permission needs to be enabled! #### Example of a join trigger: ![](https://cdn.discordapp.com/attachments/772051120368910371/882199989873414184/join_leave.gif) ## Syntax -Use this syntax to let the bot trigger when a member joined/ left your guild/ server +Use this syntax to let the bot trigger when a member joined/left your guild/server `add` -> If this is filled in in the trigger field, the command will trigger when a member joined your server! @@ -16,7 +16,7 @@ Use this syntax to let the bot trigger when a member joined/ left your guild/ se `remove` -> If this is filled in in the trigger field, the command will trigger when a member left your server! ::: tip Testing -We understand that testing with this trigger, can be quite difficult! For that reason, we made a command! +We understand that testing with this trigger can be quite difficult! For that reason, we made a command! `!!emit uadd` to simulate that you joined your guild @@ -25,4 +25,4 @@ We understand that testing with this trigger, can be quite difficult! For that r ## More Info -Do you want to know more, about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! \ No newline at end of file +Do you want to know more about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! From 200c28a272200e565563281dddd0eea0462a419c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 15:53:02 +0200 Subject: [PATCH 079/156] updated the description and fixed other stuff --- guide/Trigger/library.md | 25 +++++++++++-------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/guide/Trigger/library.md b/guide/Trigger/library.md index abbcf62..e5bf0a1 100644 --- a/guide/Trigger/library.md +++ b/guide/Trigger/library.md @@ -1,25 +1,22 @@ # Library ## Basic Information -Library is one of the unique triggers, that doesn't get triggered automatically -but only by you (the designer) +Library is one of the unique triggers, that doesn't get triggered by events in your server. It can be included in other commands so you can use the code in it by calling `$includeLibrary[Library name]` -it helps you execute a code by calling `$includeLibrary[Library name]` - -the goal of this trigger, is simply sharing a code or functions between custom commands (you will understand in the examples) +The goal of this trigger is simply sharing code or functions between custom commands (you will understand in the examples) ## Syntax -the value of this trigger is the `Library name` +the value of the trigger is the `Library name` ## Example -### Create your library that contains users informations -> note that the library name is `users` we will use it in next step. +### Create your library that contains users' information +> note that the library name is `users`. We will use it in next step. ![](https://i.imgur.com/93WZesG.png) ### Create a normal word command `whois` First let's include the library, with `$includeLibrary` -after including, we can directly use the object and retrieve some informations to display. +after including, we can directly use the object and retrieve some information to display. ![](https://i.imgur.com/KQbkjrS.png) @@ -28,12 +25,12 @@ after including, we can directly use the object and retrieve some informations t ## What is the point? Here we only included this library in 1 commands -what if we have 10 or 50 commands that uses these informations, you can easily use it without copy the user informations for each commands, -besides if you plan to add a new user, with library you will only add it to the `users` library -but without library, you would have to add the same users 50 times, to update every commands +what if we have 10 or 50 commands that uses this information, you can easily use it without copying the user information for each command, +besides if you plan to add a new user, with libraries you will only add it to the `users` library +but without libraries, you would have to add the same users 50 times, to every command -that's demonstrate Library usefulness. +That demonstrates Library's usefulness. ## Some functions related to Library -[$includeLibrary](../Unclassified/includeLibrary.md): Include your library \ No newline at end of file +[$includeLibrary](../Unclassified/includeLibrary.md): Include your library From 1bfd39e479abf66bd9736e096fc2b109142b988b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:01:52 +0200 Subject: [PATCH 080/156] nothing --- guide/Trigger/menu.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Trigger/menu.md b/guide/Trigger/menu.md index e7cc55b..9ad5367 100644 --- a/guide/Trigger/menu.md +++ b/guide/Trigger/menu.md @@ -1,14 +1,14 @@ # Menu Interaction ## Basic Information -This trigger type, will trigger when a user select an option in a menu. +This trigger type will trigger when a user selects an option in a menu. ## Syntax the value is the menu id, for example: -`test` -> will trigger only when a user select an option in a menu with id `test` +`test` -> will trigger only when a user selects an option in a menu with id `test` -`menu_1|menu_2` -> will trigger only when a user select an option in a menu with id `menu_1` or `menu_2` +`menu_1|menu_2` -> will trigger only when a user selects an option in a menu with id `menu_1` or `menu_2` ## Example ### let's first send a menu (with id mymenu) with some options using [$selectMenu](../Text/Components/selectMenu.md) @@ -29,4 +29,4 @@ Now to know which option the user selected, we will use a function `$eventSelect ## Some functions related to Menu Trigger `$eventSelected`: Return the option's value that user selected -`$menuId`: Return the menu id that triggered the command \ No newline at end of file +`$menuId`: Return the menu id that triggered the command From 7a8f78a34033e85d3d6b70a8f5f2c7ede3c60fa8 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:02:54 +0200 Subject: [PATCH 081/156] nothing major again --- guide/Trigger/modal.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guide/Trigger/modal.md b/guide/Trigger/modal.md index 9bd43b1..4d9b50b 100644 --- a/guide/Trigger/modal.md +++ b/guide/Trigger/modal.md @@ -1,14 +1,14 @@ # Modal (Form) Interaction ## Basic Information -This trigger type, will trigger when a user submit a modal. +This trigger type will trigger when a user submits a modal. ## Syntax the value is the modal id, for example: -`modal_1` -> will trigger only when a user submit a modal with id `modal_1` +`modal_1` -> will trigger only when a user submits a modal with id `modal_1` -`modal_1|modal_2` -> will trigger only when a user submit a modal with id `modal_1` or `modal_2` +`modal_1|modal_2` -> will trigger only when a user submits a modal with id `modal_1` or `modal_2` ## Example ### let's first send a button (with id apply-form) using [$button](../Trigger/button.md) @@ -41,4 +41,4 @@ To get what user input in the modal, we will use [$modalAnswer](../Interaction/m You need to send a modal with [$modal](../Interaction/modal.md) within 1 second of button/menu/slash execution ::: -###### Tags: \ No newline at end of file +###### Tags: From a983194cac1cae5b670d667cfe0e44379bc4a68e Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:04:14 +0200 Subject: [PATCH 082/156] Update reaction.md --- guide/Trigger/reaction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Trigger/reaction.md b/guide/Trigger/reaction.md index 709be16..373af76 100644 --- a/guide/Trigger/reaction.md +++ b/guide/Trigger/reaction.md @@ -5,7 +5,7 @@ triggers when user react/unreact with certain emoji ## Trigger When User React With Emoji ### Single Emoji -To set it to trigger when user react with certain emoji (i.e 👍), set trigger to: add, emoji\ +To set it to trigger when user react with a certain emoji (i.e 👍), set trigger to: add, emoji\ Example: ![](https://i.imgur.com/PZEM5gu.png) From 105c6fbd1a80c70780c26229405e7375de6cffce Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:06:08 +0200 Subject: [PATCH 083/156] Update roleaddremove.md --- guide/Trigger/roleaddremove.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Trigger/roleaddremove.md b/guide/Trigger/roleaddremove.md index 158a14e..9de0e82 100644 --- a/guide/Trigger/roleaddremove.md +++ b/guide/Trigger/roleaddremove.md @@ -77,9 +77,9 @@ Role trigger will work with no input at all, but you can restrict the command to ### Role input To specify a role you can either use an ID or it's name. -But be aware, all role names are caSe seNsiTiVe, so a if a command doesn't trigger, check the capitalization! +But be aware, all role names are case sensitive, so a if a command doesn't trigger, check the capitalization! ### Multiple roles -You can make your command trigger on any of provided roles by putting role names/ids separated by "|". +You can make your command trigger on any provided roles by putting role names/ids separated by "|". -For example `Admin|Moderator`, will take effect either on Admin or Moderator role. \ No newline at end of file +For example `Admin|Moderator`, will take effect either on Admin or Moderator role. From a57171f38dbf44051c8bf0b6980d0efd07605ab5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:18:07 +0200 Subject: [PATCH 084/156] removed unnecessary commas --- guide/Trigger/serverboost.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/guide/Trigger/serverboost.md b/guide/Trigger/serverboost.md index 03d3918..bb0f0db 100644 --- a/guide/Trigger/serverboost.md +++ b/guide/Trigger/serverboost.md @@ -1,13 +1,13 @@ # Server Boost Trigger ## Basic Information -This trigger, will only trigger if someone boosted or removed the boost from your server +This trigger will only trigger if someone boosted or removed the boost from your server ## Syntax the trigger value should be `add/remove` -`add`: for trigger only if someone boosted -`remove`: for trigger only if someone removed the boost +`add`: to trigger only if someone boosted\ +`remove`: to trigger only if someone removed the boost if you leave it blank, it will trigger for both @@ -15,7 +15,7 @@ if you leave it blank, it will trigger for both ### Let's create the server boost trigger command ![](https://i.imgur.com/9AOu4J4.png) -Notice, that we left trigger value blank, because we want it to trigger for both cases +Notice that we left trigger value blank, because we want it to trigger for both cases we will know if user boosted or unboosted with `$isBoosting` ### Output (When boosting) @@ -25,4 +25,4 @@ we will know if user boosted or unboosted with `$isBoosting` ### That's it ## Some functions related to Library -[$isBoosting](../Text/isandhas/isBoosting.md): return true if user is boosting otherwise false \ No newline at end of file +[$isBoosting](../Text/isandhas/isBoosting.md): return true if user is boosting otherwise false From 9d1501a2f187b26296b7457bfef2b32f1fec7918 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:26:15 +0200 Subject: [PATCH 085/156] grammar + step 8 update edited steps to include the new dropdown you get when selecting a trigger for a slash command --- guide/Trigger/slash.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/guide/Trigger/slash.md b/guide/Trigger/slash.md index 20a7dc1..6cf77e4 100644 --- a/guide/Trigger/slash.md +++ b/guide/Trigger/slash.md @@ -1,20 +1,20 @@ # Slash Command # Introduction -triggers when a user uses a slash command. This needs to be a slash command from the bot! +triggers when a user uses a slash command. This needs to be a slash command from the bot. ## Creating a slash command -In this example we will create `/avatar` command, that show user avatar on request +In this example we will create an `/avatar` command, that shows the user's avatar ![](https://i.imgur.com/MtHPQWd.png) ### Steps -1. Go to dashboard, your server page, click on Slash Builder +1. Go to dashboard, your server page, click on Slash Command Builder ![](https://i.imgur.com/L2dnA5D.png) 2. Click `Create` ![](https://i.imgur.com/GlwHeER.png) -3. Fill the slash name and description, remember this name, we will use it later +3. Fill the slash name and description ![](https://i.imgur.com/LL52VH2.png) 4. To add user option, to the slash, select from the option menu @@ -29,10 +29,10 @@ In this example we will create `/avatar` command, that show user avatar on reque 7. Click `Deploy Command/Save` ![](https://i.imgur.com/PwJ8kLv.png) -8. Create a new custom command, select type to be `Slash Command` and `Trigger` to be `avatar` (the name from step 3) +8. Create a new custom command, select type to be `Slash Command` and select your slash command from the dropdown in `Trigger` ![](https://i.imgur.com/YF6EfSY.png) -9. Set the code to be (will be explained in next section) +9. Set the code to be executed when the slash command is used ::: details Code ``` @@ -44,7 +44,7 @@ In this example we will create `/avatar` command, that show user avatar on reque ``` ::: -10. go to your server and use the command as fellow: +10. go to your server and use the command as follows: ![](https://i.imgur.com/XZTeNVO.png) @@ -54,19 +54,19 @@ In this example we will create `/avatar` command, that show user avatar on reque ## Code Explanation ### Retrieving the option from user -When user use the command like in Step 10, we can retrieve the option through [$getOption](../Interaction/getOption.md) function: +When a user uses the command like in Step 10, we can retrieve the option through the [$getOption](../Interaction/getOption.md) function: ``` $getOption[option name] ``` In our example `option name` is `user` from step 6\ -then the user id will be stored in `user_id` using [$let](../Variables/let.md), this way we can recall it later in the code through `$user_id`: +then the user id will be stored in a temporary variable named`user_id` using [$let](../Variables/let.md), this way we can recall it later in the code through `$user_id`: ``` $let[user_id;$getOption[user]] ``` ### Sending Message Next, to send a message with [$interactionReply[message]](../Interaction/interactionReply.md)\ -but here we will send an embed with title and image, using {title}, {image} [Curl Message Format](../CodeReferences/ref.message_curl_format.md): +Here we will send an embed with a title and image using {title} and {image} [Curl Message Format](../CodeReferences/ref.message_curl_format.md): ``` $interactionReply[ {title:Embed Title} @@ -80,7 +80,7 @@ To get the username `Mido#1234` we will use [$userTag[user id]](../Member/userTa Avatar of $userTag[$user_id] ``` -2. In Image to retrieve the user image, we will use [$userAvatar[user id]](../Member/userAvatar.md): +2. In Image to retrieve the user avatar, we will use [$userAvatar[user id]](../Member/userAvatar.md): ``` $userAvatar[$user_id] ``` @@ -107,4 +107,4 @@ To send the message in private we have to set the 2nd input `ephemeral` to `yes` That's it, Save and test it out ### Output -![](https://i.imgur.com/SsFJHfv.png) \ No newline at end of file +![](https://i.imgur.com/SsFJHfv.png) From f56b6a81217ad15588a672fc810fab26d9c4900c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:27:22 +0200 Subject: [PATCH 086/156] spelling fixes --- guide/Trigger/time.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/guide/Trigger/time.md b/guide/Trigger/time.md index 7d0f8e3..348f89f 100644 --- a/guide/Trigger/time.md +++ b/guide/Trigger/time.md @@ -1,16 +1,16 @@ # Timed or Interval ## Interval: Basic Information -This trigger type, will execute a code ones per x time. +This trigger type will execute a code once per x time. #### Example of an interval trigger: ![](https://cdn.discordapp.com/attachments/772051120368910371/880525770710220872/first-interval.gif) ## Timed Event: Syntax -Use this syntax to let the bot know, how long it should wait until execution! +Use this syntax to let the bot know how long it should wait until execution! -You can specify any time, in the following format: +You can specify any time in the following format: ``` 1s -> execute after 1 second @@ -21,9 +21,9 @@ You can specify any time, in the following format: ``` ## Interval: Syntax -Use this syntax to let the bot know, how long it should wait until the next command execution! +Use this syntax to let the bot know how long it should wait until the next command execution! -You can specify any time, in the following format: +You can specify any time in the following format: ``` 1s -> execute after 1 second @@ -35,9 +35,9 @@ You can specify any time, in the following format: ::: danger DO NOT FORGET: -Set a channel used, otherwise errors will not be send anywhere! This makes bug fixing really difficult! +Set a channel used, otherwise errors will not be sent anywhere! This makes bug fixing really difficult! ::: ## More Info -Do you want to know more, about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! \ No newline at end of file +Do you want to know more about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! From 7d720d0c7ed3b217c0a45d30249d1776e30af9ae Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:27:43 +0200 Subject: [PATCH 087/156] Update time.md --- guide/Trigger/time.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Trigger/time.md b/guide/Trigger/time.md index 348f89f..d970dc1 100644 --- a/guide/Trigger/time.md +++ b/guide/Trigger/time.md @@ -1,7 +1,7 @@ # Timed or Interval ## Interval: Basic Information -This trigger type will execute a code once per x time. +This trigger type will execute a command once per x time. #### Example of an interval trigger: From 8b7bdfc5a5138e1a5c59c1bc8c6b5e54d336f987 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:30:59 +0200 Subject: [PATCH 088/156] cleaned up sentences and removed redundancy --- guide/Trigger/voicecondecon.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/guide/Trigger/voicecondecon.md b/guide/Trigger/voicecondecon.md index 7ac9872..cb806f7 100644 --- a/guide/Trigger/voicecondecon.md +++ b/guide/Trigger/voicecondecon.md @@ -1,7 +1,7 @@ # Voice Join/Leave ## Basic Information -This trigger type, will trigger when a user joins or leaves a voice channel. +This trigger type will trigger when a user joins or leaves a voice channel. #### Example of a voice join trigger: @@ -9,14 +9,14 @@ This trigger type, will trigger when a user joins or leaves a voice channel. ## Main Syntax -Use this syntax to let the bot trigger when a vc is joined/ leaved! +Use this syntax to let the bot trigger when a user joins/leaves a voice channel! -`join` -> If this is filled in in the trigger field, the command will trigger when a voice channel is joined! +`join` -> the command will trigger when a voice channel is joined -`leave` -> If this is filled in in the trigger field, the command will trigger when a member left a voice channel! +`leave` -> the command will trigger when a member left a voice channel -`join/leave=voice channel id` -> in this case, will only trigger when user join/leave this specific voice channel +`join/leave=voice channel id` -> will only trigger when user joins/leaves this specific voice channel ::: danger Special event! Because this is a special event type, you CANNOT use `$channelID` to return the channel that was joined! Use [$voiceChannelID](../Channel/voiceChannelID.md) instead @@ -24,9 +24,9 @@ Because this is a special event type, you CANNOT use `$channelID` to return the ::: danger DO NOT FORGET: -Set a channel used, otherwise errors will not be send anywhere! This makes bug fixing really difficult! +Set a channel used, otherwise errors will not be sent anywhere! This makes bug fixing really difficult! ::: ## More Info -Do you want to know more, about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! +Do you want to know more about the bot's syntax? You can check out [this](../Other/syntax.md) page to learn more! From 9440be6854abfd8ddb5a7610283c3aacaa9aef46 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 16:39:57 +0200 Subject: [PATCH 089/156] some grammar things + extra info on regex triggers --- guide/Trigger/word.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/guide/Trigger/word.md b/guide/Trigger/word.md index 5aaea95..1e6171d 100644 --- a/guide/Trigger/word.md +++ b/guide/Trigger/word.md @@ -2,7 +2,7 @@ Word commands, also known as message commands are executed when the bot receives a text message. ## Basic word command -Let's create a word command with a trigger `!ping`, this means the command will be triggered whenever someone sends a `!ping` message. +Let's create a word command with a trigger `!ping`, this means the command will be triggered whenever someone sends a message starting with `!ping`. In the code part we will type `pong!`, so the bot will respond with it. ![Word example](https://cdn.discordapp.com/attachments/1100128432395927765/1100813255418576966/pingcmd.png) @@ -17,9 +17,9 @@ In the code part we will type `pong!`, so the bot will respond with it. ## Using parameters -A crucial feature of word type are parameters. They are data provided when executing the command. +A crucial feature of the word type are parameters. They are data provided when executing the command. -Let's say we had a `?hug` command, which users can use to express their feelings towards other users. +Let's say we had a `?hug` command, which users can use to hug other users. In that case we would want users to select a user by mentioning him. #### Usage @@ -31,7 +31,7 @@ The mention will be the `parameter 1`, because users will mention their victim r #### Setup -Parameters can be retrived using the [$message](../Message/message.md) function, we will use it to get user mention: +Parameters can be retrived using the [$message](../Message/message.md) function, we will use it to get the user mention: ![?hug code](https://cdn.discordapp.com/attachments/1100128432395927765/1100816608198402049/hugcmd.png) @@ -146,6 +146,7 @@ Here is the expression which we are going to use: ```regex /<@!?\d{18,}>/ ``` +You need to add a forward slash before and after your expression, otherwise the bot will only reply when you literally send `<@!?\d{18,}>` in your message ![Ping detector](https://cdn.discordapp.com/attachments/957286111250624552/1100839560532983908/image.png) @@ -297,4 +298,4 @@ you can do so through `$message[2+]`, which means get 2nd word and what after it let's try it out: ![](https://i.imgur.com/KZBeAVT.png) -Yay! works well. --> \ No newline at end of file +Yay! works well. --> From a90237d9f749c98dad454f0ae1164c5a56c8187a Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:10:41 +0200 Subject: [PATCH 090/156] grammar updates --- guide/Tutorials/1.ping.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/guide/Tutorials/1.ping.md b/guide/Tutorials/1.ping.md index ee817ab..763f1c5 100644 --- a/guide/Tutorials/1.ping.md +++ b/guide/Tutorials/1.ping.md @@ -1,5 +1,5 @@ # Ping command -Let's make a simple ping command, where you send a command `ping` and bot reply with `pong` +Let's make a simple ping command, where you send a command `ping` and the bot replies with `pong` # Steps ## #1 Creating Command @@ -7,20 +7,20 @@ Your first step, will be creating a new custom command, check this [page](../Gui ## #2 Trigger Settings In the trigger settings -1. Select Type to be `Word`, you can know more about this trigger [here](../Trigger/word.md) -2. Set Trigger to be `ping` +1. Select the Type to be `Word`, you can know more about this trigger [here](../Trigger/word.md) +2. Set the Trigger to be `ping` ![](https://i.imgur.com/o5UIcB5.png) -This means, it will run this command when user send `ping` +This means, it will run this command when a user sends `ping` ## #3 Response -To make him reply with `pong` when this command run, we simply write `pong` in the code section +To make the bot reply with `pong` when this command is run, we simply write `pong` in the code section ![](https://i.imgur.com/WtNpGdM.png) ## Test time Save the command and go to your server and send `ping` ![](https://i.imgur.com/smxmtfA.png) -Congratulations :tada: \ No newline at end of file +Congratulations :tada: From 54debcf249b4a5ca9ad8f4b9aaed17b21831318c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:13:23 +0200 Subject: [PATCH 091/156] grammar updates --- guide/Tutorials/2.staff-app.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Tutorials/2.staff-app.md b/guide/Tutorials/2.staff-app.md index 5367727..30f78e0 100644 --- a/guide/Tutorials/2.staff-app.md +++ b/guide/Tutorials/2.staff-app.md @@ -7,7 +7,7 @@ Here's how it's going to look like: ## 1. Button sending Let's send a button users will use to open up the form. -The button will be `blurple`, have a label `Apply`, and an id `staff-app`. +The button will be `blurple`, have a label `Apply` and an id `staff-app`. ```php !!exec $button[Apply;blurple;staff-app] ``` @@ -112,7 +112,7 @@ We recommend you to continue reading about anything that seems unclear to you: | [$let](../Variables/let.md) | define a temporary variable | | [$get](../Variables/get.md) | retrive a temporary variable | | [$modalAnswer](../Interaction/modalAnswer.md) | get user's answer | -| [$channelSendMessage](../Message/channelSendMessage.md) | send a message elsewhere | +| [$channelSendMessage](../Message/channelSendMessage.md) | send a message in a different channel | | [$channelID](../Channel/channelID.md) | find a channel by it's name | | [$if](../Text/Condition/if.md) | conditional statement | | [Complete embed](../Text/Embed/example.md) | create an embed | @@ -121,4 +121,4 @@ We recommend you to continue reading about anything that seems unclear to you: ### 🎉 Congratulations! -You've made a complete staff application system! \ No newline at end of file +You've made a complete staff application system! From 101337560e73bf3ffc212b0dbc13778e9c39cd9b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:17:37 +0200 Subject: [PATCH 092/156] spelling update --- guide/Tutorials/3.report.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Tutorials/3.report.md b/guide/Tutorials/3.report.md index 79e2d83..d35bb40 100644 --- a/guide/Tutorials/3.report.md +++ b/guide/Tutorials/3.report.md @@ -26,7 +26,7 @@ $let[reason;$message[2+]] ``` ## 4. Send report -As we have all data stored and ready, we will procceed to sending the report. For that we will use: +As we have all data stored and ready, we will procceed to send the report. For that we will use: * [$channelID](../Channel/channelID) - to change channel name to ID * [$channelSendMessage](../Message/channelSendMessage.md) - to send a message to a different channel @@ -61,4 +61,4 @@ Meanwhile in #reports ### 🎉 Congrats! -You've passed the course with grade A! \ No newline at end of file +You've passed the course with grade A! From 913cd2f1cab404de28aae0cd31dc1fe833a233f2 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:20:26 +0200 Subject: [PATCH 093/156] spelling fix --- guide/Tutorials/4.collect.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Tutorials/4.collect.md b/guide/Tutorials/4.collect.md index a74d55a..25c813a 100644 --- a/guide/Tutorials/4.collect.md +++ b/guide/Tutorials/4.collect.md @@ -17,7 +17,7 @@ Users will collect their reward by using the `!collect` command, so let's set th Now that we have the initial setup done, it's time to make the command actually work. ::: tip We will use: -* [$getUserVar](../Variables/getUserVar.md) - to load user's balance +* [$getUserVar](../Variables/getUserVar.md) - to load the user's balance * [$let](../Variables/let.md) - to temporarily store the balance * [$math](../Text/Math/math.md) - to calculate new balance * [$setUserVar](../Variables/setUserVar.md) - to set the new balance @@ -25,7 +25,7 @@ Now that we have the initial setup done, it's time to make the command actually ### Prize -The reward that users will receive is 100$ with [template economy](../Guide/4.template.md). Since the template economy uses the `money` user var to store a user's balance, we will contribute to that var. +The reward that users will receive is 100$ with the [template economy](../Guide/4.template.md). Since the template economy uses the `money` user var to store a user's balance, we will contribute to that var. ### Getting user var @@ -94,4 +94,4 @@ You may not always limit executions to one per user, you can use other vars like ::: ### 🎉 Congrats! -You've learned how to make a command that can be used only one time! \ No newline at end of file +You've learned how to make a command that can be used only one time! From b5a2af3c8248242d7646b61ae008f4a1d41a73ca Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:24:47 +0200 Subject: [PATCH 094/156] grammar update --- guide/Tutorials/5.confession.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/guide/Tutorials/5.confession.md b/guide/Tutorials/5.confession.md index 3815d01..e23ca8a 100644 --- a/guide/Tutorials/5.confession.md +++ b/guide/Tutorials/5.confession.md @@ -3,20 +3,20 @@ In this guide, you will learn how to make a simple slash command called `/confes ![](https://i.imgur.com/kJwJ9Fi.png) ## 1. Create a command -The first step is to create a new command slash command: +The first step is to create a new slash command: * Head to your server in [dashboard](https://ccommandbot.com/dashboard) * Click `Slash Command Builder` * Construct the confess command (follow the next GIF) ![](https://i.imgur.com/1IUUCn9.gif) ## 2. Responding To Code -Next, Let's write the code that will respond when user run the slash command: +Next, Let's write the code that will respond when user runs the slash command: * Head to your server in [dashboard](https://ccommandbot.com/dashboard) * Click `Manage Your Commands` * Click `Create` -* In Command Settings, Select Trigger Type to be "Slash Command", then select `/confess` +* In Command Settings, select the Trigger Type to be "Slash Command", then select `/confess` * For Code: - * To respond to user, you can do so with `$interactionReply[message]` where message is the text you would like to display: + * To respond tothe user, you can do so with `$interactionReply[message]` where message is the text you would like to display: > For example: $interactionReply[Hello World] * To receive user input of confession, we can use $getOption[option name], where `option name` is same option name we used while building the slash command which is `message` > For example: $getOption[message] @@ -36,8 +36,8 @@ That is all, let's test it out :star_struck: It works :happy:! but... what about making the respond into a beautiful embed? ## 4. Modify Code To Respond With Embed -To build an embed, we need to use [curl message](../CodeReferences/ref.message_curl_format.md). -Curl Message is a way for you to build an embed in place of `message` input for example to set up an embed with description and title we will use: +To build an embed, we need to use [curl message format](../CodeReferences/ref.message_curl_format.md). +Curl is a way for you to build an embed in the place of the `message` input, for example to set up an embed with description and title we will use: ```js {desc:My embed description} {title:My embed title} @@ -63,4 +63,4 @@ Let's test again! Congratulations, You made a functional slash command :tada:! -> Of course, this might be simple. but it's good start! \ No newline at end of file +> Of course this might be simple, but it's good start! From d6c8e5d9fd4b95751f97cd5e9f724bead29248e8 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:29:50 +0200 Subject: [PATCH 095/156] removed an unneccesary word --- guide/Variables/deleteUserVar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Variables/deleteUserVar.md b/guide/Variables/deleteUserVar.md index a064edf..f46250a 100644 --- a/guide/Variables/deleteUserVar.md +++ b/guide/Variables/deleteUserVar.md @@ -1,5 +1,5 @@ # $deleteUserVar -Deletes a user variable, from the author of the command triggered or from the ID specified. +Deletes a user variable, from the author of the command or from the ID specified. #### Usage: `$deleteUserVar[variable;userID]`
From 32a5e54c0fd2bdae8ecda4bbf7d57ad41edb522d Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:32:16 +0200 Subject: [PATCH 096/156] grammar --- guide/Variables/getMessageVar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Variables/getMessageVar.md b/guide/Variables/getMessageVar.md index b917d32..c5eae42 100644 --- a/guide/Variables/getMessageVar.md +++ b/guide/Variables/getMessageVar.md @@ -1,5 +1,5 @@ # $getMessageVar -Gets an message variable value +Gets a message variable value #### Usage: `$getMessageVar[variable;messageID(optional)]`
From 9ba8f22afc82e46a799acbb3c3f354b953924939 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:42:58 +0200 Subject: [PATCH 097/156] description update idk if the wording is weird or difficult to understand. it makes sense to me --- guide/Variables/increaseChannelVar.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/guide/Variables/increaseChannelVar.md b/guide/Variables/increaseChannelVar.md index 2cb5dae..746e79c 100644 --- a/guide/Variables/increaseChannelVar.md +++ b/guide/Variables/increaseChannelVar.md @@ -1,6 +1,7 @@ # $increaseChannelVar -To increase channel variable with a certain amount +To increase channel variable with a certain amount.\ +If the variable doesn't exist it will be created and its value set to the answer of the value as if the original value of the var is 0. ## Usage @@ -23,4 +24,4 @@ $increaseChannelVar[messages;1] Before: 5
After: 10 - \ No newline at end of file + From 02eadba2bd1488f300ebb0677ca9cf2cdea40137 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:45:36 +0200 Subject: [PATCH 098/156] description update same as $increaseChannelVar, description makes sense to me idk how clear it is --- guide/Variables/increaseServerVar.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/guide/Variables/increaseServerVar.md b/guide/Variables/increaseServerVar.md index 852765d..8b369c9 100644 --- a/guide/Variables/increaseServerVar.md +++ b/guide/Variables/increaseServerVar.md @@ -1,6 +1,7 @@ # $increaseServerVar -To increase server variable with a certain amount +To increase server variable with a certain amount.\ +If the variable doesn't exist it will be created and its value set to the answer of the value as if the original value of the var is 0. ## Usage @@ -23,4 +24,4 @@ $increaseServerVar[ticket numbers;1] Before: 5
After: 10 - \ No newline at end of file + From ad1f3d28bea78f37626e009a32d6d1af200d1c19 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 18:47:38 +0200 Subject: [PATCH 099/156] description update same as previous two increasevar functions. makes sense to me --- guide/Variables/increaseUserVar.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/guide/Variables/increaseUserVar.md b/guide/Variables/increaseUserVar.md index 19b94c6..e254475 100644 --- a/guide/Variables/increaseUserVar.md +++ b/guide/Variables/increaseUserVar.md @@ -1,6 +1,7 @@ # $increaseUserVar -To increase user variable with a certain amount +To increase user variable with a certain amount.\ +If the variable doesn't exist it will be created and its value set to the answer of the value as if the original value of the var is 0. ## Usage @@ -23,4 +24,4 @@ $increaseUserVar[money;1000] Before: 1000
After: 2000 - \ No newline at end of file + From 9785dfee086e1ba9c2d760655122d8e4cd3c5064 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:29:35 +0200 Subject: [PATCH 100/156] updated asc and desc to be a bit clearer + spelling --- guide/Variables/userLeaderboard.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Variables/userLeaderboard.md b/guide/Variables/userLeaderboard.md index de6ba40..937fae7 100644 --- a/guide/Variables/userLeaderboard.md +++ b/guide/Variables/userLeaderboard.md @@ -17,11 +17,11 @@ Available Variables: | {discriminator} | returns the discriminator like 1234 | Order: -* `desc`: Will display all the top ranked member with the biggest numbers. -* `asc`: Will display all the bottom ranked member with the lowest numbers. +* `desc`: Will display all the members' ranks from largest to smallest. +* `asc`: Will display all the members' ranks from smallest to largest. #### Example: -To use this function your uservar must have nummeric values . +To use this function your uservar must have numeric values .
From 847c0d5328fad269606efde1e616a0dae57e18e8 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:31:47 +0200 Subject: [PATCH 101/156] updated description to match viewchannelvars --- guide/Variables/viewServerVars.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Variables/viewServerVars.md b/guide/Variables/viewServerVars.md index 35da23a..84a7cce 100644 --- a/guide/Variables/viewServerVars.md +++ b/guide/Variables/viewServerVars.md @@ -1,6 +1,6 @@ # $viewServerVars -Get list of defined server variables, and optionally filter then using query regex +View a list of all the variables that are defined for the server, and search for specific variables using a regular expression query filter ## Usage @@ -26,4 +26,4 @@ $viewServerVars[Separator;Query Regex (optional)] level1_xp, level2_xp, level3_xp,level1_reward - \ No newline at end of file + From b42945f38fc5b1ad62fdafc0ce333dee7f41ee26 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:32:49 +0200 Subject: [PATCH 102/156] Updated description to be similar to the other two viewvars funcs --- guide/Variables/viewUserVars.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Variables/viewUserVars.md b/guide/Variables/viewUserVars.md index 2b24ae5..b1a0912 100644 --- a/guide/Variables/viewUserVars.md +++ b/guide/Variables/viewUserVars.md @@ -1,6 +1,6 @@ # $viewUserVars -Get List Of Defined User Vars on user +View a list of all the variables that are defined for a specific user ## Usage @@ -16,4 +16,4 @@ $viewUserVars[User ID;Separator] xp, money, bonus - \ No newline at end of file + From eeaa4fd0fd4050d42a5d22dfb87d8bcdbe170e58 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:33:58 +0200 Subject: [PATCH 103/156] grammar fic --- guide/Bot/botCount.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Bot/botCount.md b/guide/Bot/botCount.md index 357bd44..b2c0cde 100644 --- a/guide/Bot/botCount.md +++ b/guide/Bot/botCount.md @@ -13,7 +13,7 @@ Returns the amount of bots in your server/guild! ::: danger Warning -This data comes from the cache, not the api, therefore it may not be precise unless all the guild members are cached (which only in tier 5). +This data comes from the cache, not the api, therefore it may not be precise unless all the guild members are cached (which is only in tier 5). ::: ##### Function Difficulty: From 80fb58aa59ba920a8f7ed18cb6c45100ee60ba1b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:34:29 +0200 Subject: [PATCH 104/156] grammar fix --- guide/Bot/botOwnerID.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Bot/botOwnerID.md b/guide/Bot/botOwnerID.md index 8faa1fb..7684531 100644 --- a/guide/Bot/botOwnerID.md +++ b/guide/Bot/botOwnerID.md @@ -1,8 +1,8 @@ # $botOwnerID Returns the ID of the bot owner. -If the bot belongs to a team, it'll return multiple ID. -Optionally, and if there is more than one owner (team), you can input a separator. +If the bot belongs to a team, it'll return multiple IDs. +Optionally, if there is more than one owner (team) you can input a separator. ## Usage From 74204246b04028008849b6c7e50a150c2aca2329 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:41:20 +0200 Subject: [PATCH 105/156] removed the ` around the function name+value in the example since the discord messages example format doesnt support backticks removing them gives a more accurate representation of what it will look like when ran in discord --- guide/Bot/ping.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Bot/ping.md b/guide/Bot/ping.md index 59e9251..a4524f2 100644 --- a/guide/Bot/ping.md +++ b/guide/Bot/ping.md @@ -5,10 +5,10 @@ This function returns the bot's ping, it can be used to check if the bot is onli
- !!exec `$ping`ms + !!exec $pingms - `20`ms + 20ms From 758771d639b17d89519c32372430da48e2a3b235 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:42:45 +0200 Subject: [PATCH 106/156] removed ` in the example same as $ping, is more accurate when compared to being ran in discord --- guide/Bot/serverCount.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Bot/serverCount.md b/guide/Bot/serverCount.md index f3ec684..b7c696e 100644 --- a/guide/Bot/serverCount.md +++ b/guide/Bot/serverCount.md @@ -5,10 +5,10 @@ Returns the amount of servers the bot is in.
- !!exec I am in `$serverCount` servers. + !!exec I am in $serverCount servers. - I am in `15000` servers. + I am in 15000 servers. From 84ed8c384ebe2fcbd99da3af4b1a12cff9a69b12 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:45:46 +0200 Subject: [PATCH 107/156] grammar fix --- guide/Useful/deleteTrigger.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Useful/deleteTrigger.md b/guide/Useful/deleteTrigger.md index dd63532..51ffc74 100644 --- a/guide/Useful/deleteTrigger.md +++ b/guide/Useful/deleteTrigger.md @@ -1,6 +1,6 @@ # $deleteTrigger -delete a command with token, **empty token = delete current command** +Delete a command using its token, **empty token = delete current command** ## Usage From 87d2245cb3b178e40d1b25cb8cdc940da03758a4 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:48:02 +0200 Subject: [PATCH 108/156] parity update with the other end functions --- guide/Useful/endForEach.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Useful/endForEach.md b/guide/Useful/endForEach.md index cdc7322..365016e 100644 --- a/guide/Useful/endForEach.md +++ b/guide/Useful/endForEach.md @@ -1,6 +1,6 @@ # $endForEach -its used as closer for $forEach +To close $foreach ## Usage From 25403f469b5f3981fbd90126cb9273af1d65b9bb Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:51:10 +0200 Subject: [PATCH 109/156] grammar fix --- guide/Useful/redirectErrors.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Useful/redirectErrors.md b/guide/Useful/redirectErrors.md index b5ed44a..cf5f28e 100644 --- a/guide/Useful/redirectErrors.md +++ b/guide/Useful/redirectErrors.md @@ -1,5 +1,5 @@ # $redirectErrors -To redirect any kind of errors to specific channel, by default errors will appear in execution channel +To redirect any kind of errors to a specific channel, by default errors will appear in the execution channel #### Usage: `$redirectErrors[Channel ID]` @@ -30,4 +30,4 @@ Check the [$modifyChannelPerms](../Channel/modifyChannelPerms) for the correct u ::: ##### Function difficulty -###### Tags: \ No newline at end of file +###### Tags: From 7fb87bf245a60122f178787fc888e98e706a3753 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:52:06 +0200 Subject: [PATCH 110/156] grammar fix --- guide/Useful/return.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Useful/return.md b/guide/Useful/return.md index c5b9931..752abe1 100644 --- a/guide/Useful/return.md +++ b/guide/Useful/return.md @@ -1,6 +1,6 @@ # $return -Can only be used inside user-defined function created by $function\ +Can only be used inside user-defined functions created with $function\ It has no effect outside the user-defined function ## Usage @@ -14,4 +14,4 @@ $return[Return Value] $function[add;num1;num2] $return[$math[$num1+$num2]] $endFunction -``` \ No newline at end of file +``` From 0197a8aeaea5ec8671948a9a67658fc702de2047 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 19:54:35 +0200 Subject: [PATCH 111/156] description clarity update --- guide/Useful/triggerExists.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Useful/triggerExists.md b/guide/Useful/triggerExists.md index 4e39cb4..98b5171 100644 --- a/guide/Useful/triggerExists.md +++ b/guide/Useful/triggerExists.md @@ -1,6 +1,6 @@ # $triggerExists -Check if a trigger with token exists or not +Check if a trigger with the specified token exists ## Usage @@ -26,4 +26,4 @@ $triggerExists[Token] false - \ No newline at end of file + From f3e76da93af5b8b3d03525981520786af3f2f66d Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:04:49 +0200 Subject: [PATCH 112/156] sentence consctruction update --- guide/Member/ban.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Member/ban.md b/guide/Member/ban.md index 4604986..8a2dfb7 100644 --- a/guide/Member/ban.md +++ b/guide/Member/ban.md @@ -35,7 +35,7 @@ Discord prevents users (members/bots) from banning members above their highest r ::: ::: danger Be really careful with adding this to a command! -EVERY member that can execute the command, this function is added in. Will be able to BAN everyone below the bot role! +EVERY member that can execute the command that this function is added in will be able to BAN everyone below the bot role! We highly suggest, not putting the bot role above "Admin" and "head moderator" ::: @@ -47,4 +47,4 @@ We highly suggest, not putting the bot role above "Admin" and "head moderator" ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 7a4b22bfe9a0f5fc42ac3203ba304cea20239aee Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:07:34 +0200 Subject: [PATCH 113/156] fix grammar] --- guide/Member/hasAnyPerm.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Member/hasAnyPerm.md b/guide/Member/hasAnyPerm.md index 9d87898..40a303b 100644 --- a/guide/Member/hasAnyPerm.md +++ b/guide/Member/hasAnyPerm.md @@ -1,6 +1,6 @@ # $hasAnyPerm -Checks if an user or author has one of the provided permissions +Checks if a user or the author has one of the provided permissions ## Usage From d52eb5957092ed295f4fa76dbb4baa5fe00d9ace Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:08:59 +0200 Subject: [PATCH 114/156] fix grammar --- guide/Member/kick.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Member/kick.md b/guide/Member/kick.md index 206c726..b3dcf1f 100644 --- a/guide/Member/kick.md +++ b/guide/Member/kick.md @@ -32,7 +32,7 @@ Discord prevents users (members/bots) from kicking members above their highest r ::: ::: danger Be careful with adding this to a command! -every member that can execute the command, this function is added in. Will be able to kick everyone below the bot role! +EVERY member that can execute the command this function is added in will be able to kick everyone below the bot role! We highly suggest, not putting the bot role above "Admin" and "head moderator" ::: @@ -44,4 +44,4 @@ We highly suggest, not putting the bot role above "Admin" and "head moderator" ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 815073448cea2fd5ab895af4043cbd8d3a3e5215 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:11:20 +0200 Subject: [PATCH 115/156] fixed a spelling mistake --- guide/Member/unban.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Member/unban.md b/guide/Member/unban.md index 717c415..bb241ff 100644 --- a/guide/Member/unban.md +++ b/guide/Member/unban.md @@ -13,10 +13,10 @@ If member can be banned by the bot: ::: tip Related Functions -[$kick](../Member/kick.md), to kick a member instead of banning him/here +[$kick](../Member/kick.md), to kick a member instead of banning him/her [$ban](../Member/ban.md), to ban a member ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 5ec5c18fdfd586552a0b82d2e35cc0b0a424944d Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:12:52 +0200 Subject: [PATCH 116/156] fix grammar --- guide/Member/userConnectedVC.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Member/userConnectedVC.md b/guide/Member/userConnectedVC.md index b34d39f..360f345 100644 --- a/guide/Member/userConnectedVC.md +++ b/guide/Member/userConnectedVC.md @@ -1,6 +1,6 @@ # $userConnectedVC -return the voice channel ID of the voice channel to which the user is currently connected +return the voice channel ID of the voice channel to which the user is currently connected to ## Usage @@ -8,7 +8,7 @@ return the voice channel ID of the voice channel to which the user is currently $userConnectedVC[User ID (default is $authorID)] ``` -### In case of no connected: +### If the user is not connected: the function will return `undefined` ### Example: @@ -19,4 +19,4 @@ the function will return `undefined` 951224449250779199 - \ No newline at end of file + From 186c89799c5e57116854a0925f53b5432703186b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:13:59 +0200 Subject: [PATCH 117/156] tip box thing fixed --- guide/Member/userReacted.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Member/userReacted.md b/guide/Member/userReacted.md index 57c566d..f0d5d11 100644 --- a/guide/Member/userReacted.md +++ b/guide/Member/userReacted.md @@ -13,9 +13,9 @@ checks if a user reacted on a message or users which reacted on a message -::: info Member must be cached! +::: tip Member must be cached! If you use the main bot the member must be cached to get valid results.You can ignore the message,if you use custom bot! ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 3badedbc4e9efe07e84affc2a5b545172199d6e4 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:21:15 +0200 Subject: [PATCH 118/156] fixed the broken tip box --- guide/Member/userRoleColor.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Member/userRoleColor.md b/guide/Member/userRoleColor.md index 88bf098..9d81c65 100644 --- a/guide/Member/userRoleColor.md +++ b/guide/Member/userRoleColor.md @@ -13,9 +13,9 @@ returns the hex color of the highest role of the user -::: info Member must be cached! +::: tip Member must be cached! If you use the main bot the member must be cached to get valid results.You can ignore the message,if you use custom bot! ::: ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 0e80266398d2f1c81dccc155746dce26b1fa2053 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:40:51 +0200 Subject: [PATCH 119/156] fix typo --- guide/Member/usersWithRole.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/guide/Member/usersWithRole.md b/guide/Member/usersWithRole.md index 46d1a98..c223aff 100644 --- a/guide/Member/usersWithRole.md +++ b/guide/Member/usersWithRole.md @@ -1,7 +1,6 @@ # $usersWithRole -Returns a list of users with given role (members are given from the cache.\ -) +Returns a list of users with given role (members are given from the cache.) ## Usage From 1a3058fe76081b977b1023998ec3b88a59c9e4ca Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:45:57 +0200 Subject: [PATCH 120/156] fic spelling --- guide/Message/deleteIn.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Message/deleteIn.md b/guide/Message/deleteIn.md index 6da75f9..94f40d8 100644 --- a/guide/Message/deleteIn.md +++ b/guide/Message/deleteIn.md @@ -1,5 +1,5 @@ # $deleteIn -Deletes a message send, after a certain time +Deletes a message sent after a certain time #### Usage: `$deleteIn[time]` @@ -14,4 +14,4 @@ Deletes a message send, after a certain time ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From 0ae385b8759c227123be784cede38529aadcdb5b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:47:14 +0200 Subject: [PATCH 121/156] fixed the tags not being on its own line --- guide/Message/deleteWebhook.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/guide/Message/deleteWebhook.md b/guide/Message/deleteWebhook.md index 890b1e9..217615b 100644 --- a/guide/Message/deleteWebhook.md +++ b/guide/Message/deleteWebhook.md @@ -3,5 +3,6 @@ Deletes a webhook by using its token and ID #### Usage: `$deleteWebhook[webhookID;webhookToken`
-##### Function difficulty: -###### Tags: \ No newline at end of file +##### Function difficulty: +
+###### Tags: From 206707a5c3b48a0014a0bbeb4397a360d7d884d9 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:48:59 +0200 Subject: [PATCH 122/156] reverted the change because it did nothing somehow --- guide/Message/deleteWebhook.md | 1 - 1 file changed, 1 deletion(-) diff --git a/guide/Message/deleteWebhook.md b/guide/Message/deleteWebhook.md index 217615b..c05ac38 100644 --- a/guide/Message/deleteWebhook.md +++ b/guide/Message/deleteWebhook.md @@ -4,5 +4,4 @@ Deletes a webhook by using its token and ID #### Usage: `$deleteWebhook[webhookID;webhookToken`
##### Function difficulty: -
###### Tags: From 53522742e6b75a48f6089bacc22143d7e7dc57b3 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 20:51:40 +0200 Subject: [PATCH 123/156] clarity update to the desc --- guide/Message/editMessage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Message/editMessage.md b/guide/Message/editMessage.md index 38d58d0..5b54f27 100644 --- a/guide/Message/editMessage.md +++ b/guide/Message/editMessage.md @@ -1,5 +1,5 @@ # $editMessage -Edits a message. +Edits a message sent by the bot. #### Usage: `$editMessage[messageid;new message;channelid(optional)]`
From 1eb512fa9f3d78c1fbe62cbdd76f3f26b15c90ca Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 21:01:01 +0200 Subject: [PATCH 124/156] clarified that its not just rich type embeds that return true --- guide/Message/hasEmbeds.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Message/hasEmbeds.md b/guide/Message/hasEmbeds.md index 9610604..7849a31 100644 --- a/guide/Message/hasEmbeds.md +++ b/guide/Message/hasEmbeds.md @@ -1,7 +1,7 @@ # $hasEmbeds -Checks if given message ID contains an embed.\ - returns true or false +Checks if given message ID contains an embed. Returns true or false.\ +This includes images/videos you upload for example. ## Usage From 8ef7538767646be3c8b36d04dfc162930200e3e0 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 21:05:23 +0200 Subject: [PATCH 125/156] grammar fix --- guide/Message/messageExists.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Message/messageExists.md b/guide/Message/messageExists.md index 5f78436..22066fd 100644 --- a/guide/Message/messageExists.md +++ b/guide/Message/messageExists.md @@ -1,5 +1,5 @@ # $messageExists -returns true/false ,if the message Exists from the message +returns true/false if the message exists #### Usage: `$messageExists[channelID;messageID]` @@ -14,4 +14,4 @@ returns true/false ,if the message Exists from the message ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From fdce1f07c67fe4173c038dfe3241524957ad2ffc Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 21:07:09 +0200 Subject: [PATCH 126/156] fixed markdown --- guide/Message/messagePublish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Message/messagePublish.md b/guide/Message/messagePublish.md index d5aea71..f7ef8a6 100644 --- a/guide/Message/messagePublish.md +++ b/guide/Message/messagePublish.md @@ -1,7 +1,7 @@ # $messagePublish Publishs message to an annoucemnet channel -#### Usage: $messagePublish or $messagePublish[messageID] or $messagePublish[channelID;messageID] +#### Usage: `$messagePublish or $messagePublish[messageID] or $messagePublish[channelID;messageID]` ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From e980733fb4105d0c519ee2e83ed6ae042794b8d0 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 21:08:52 +0200 Subject: [PATCH 127/156] added the correct function description had $messageWebhookID's desc before --- guide/Message/messageType.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Message/messageType.md b/guide/Message/messageType.md index 4667484..4940137 100644 --- a/guide/Message/messageType.md +++ b/guide/Message/messageType.md @@ -1,5 +1,5 @@ # $messageType -returns the id of the webhook +Returns the type of this message. #### Usage: `$messageType` @@ -14,4 +14,4 @@ returns the id of the webhook ##### Function difficulty: -###### Tags: \ No newline at end of file +###### Tags: From afd360e1098a35ee017205db44316c461d6edb80 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 21:10:35 +0200 Subject: [PATCH 128/156] fixed markdown --- guide/Message/newTicket.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/guide/Message/newTicket.md b/guide/Message/newTicket.md index a860059..87a32f9 100644 --- a/guide/Message/newTicket.md +++ b/guide/Message/newTicket.md @@ -4,9 +4,8 @@ Create a ticket which can be closed using $closeTicket function #### Usage: `$newTicket[ticket name;ticket message(optional);categoryID(optional);return ticket ID(yes/no)(optional);error message(optional)]`
This will create a ticket named "Member-ticket" and send "Hello World!" in the ticket channel: -``` - !!exec $newTicket[$usertag-Ticket;Hello World!] -``` + +```!!exec $newTicket[$usertag-Ticket;Hello World!]``` ::: tip Looking for tickets system There are templates which you can clone directly from the dashboard, that includes button tickets. Higly customizable. From 285460e5d0279d19b2095e45067dbb6099dddd7a Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 19 Jul 2024 21:14:54 +0200 Subject: [PATCH 129/156] description clarity update --- guide/Message/referenceChannelID.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Message/referenceChannelID.md b/guide/Message/referenceChannelID.md index 69b42bc..8679ba8 100644 --- a/guide/Message/referenceChannelID.md +++ b/guide/Message/referenceChannelID.md @@ -1,6 +1,6 @@ # $referenceChannelID -The ID of the channel where this user replied in +The ID of the channel where the message the user replied to is in ## Usage From cfb231f877dff5fdc21ddf61bf4ce5979ea09a6e Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 07:34:35 +0200 Subject: [PATCH 130/156] Update let.md From 99df2653370b9cef597f1ab152a394b1e8a229bf Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 07:36:18 +0200 Subject: [PATCH 131/156] Spelling error fix --- guide/Text/Object/ObjectIncrease.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Object/ObjectIncrease.md b/guide/Text/Object/ObjectIncrease.md index ef0351a..d19c199 100644 --- a/guide/Text/Object/ObjectIncrease.md +++ b/guide/Text/Object/ObjectIncrease.md @@ -1,6 +1,6 @@ # $ObjectIncrease -To increase a key value, if they key doesn't exist, it will create one and set to that value +To increase a key value, if the key doesn't exist, it will create one and set to that value ## Usage From c1336e9c82306f4ad816968fc8aca0347faa9aea Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 07:41:04 +0200 Subject: [PATCH 132/156] Readded that you can comment out specific parts of lines --- guide/Guide/5.comment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Guide/5.comment.md b/guide/Guide/5.comment.md index 9558b28..90bbd35 100644 --- a/guide/Guide/5.comment.md +++ b/guide/Guide/5.comment.md @@ -41,7 +41,7 @@ Now it's time to check if the comment worked fine As you see the comment at line 1 didn't appear in the result ## Multiple Lines Comment -In some cases you may want to comment out more than one line. +In some cases you may want to comment out more than one line or a specific part of it. You can do that by wrapping the comment with a combination of slashes and asterisks: `/* Comment */` ### Code From 6697bf0a0fe2f75dabb32e8257df7e04d8f0a7c2 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 07:42:51 +0200 Subject: [PATCH 133/156] Removed a full stop --- guide/Guide/6.variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Guide/6.variables.md b/guide/Guide/6.variables.md index 1ba15c2..561c7f9 100644 --- a/guide/Guide/6.variables.md +++ b/guide/Guide/6.variables.md @@ -81,7 +81,7 @@ In CC, permanent variables can be attached to one of a few discord components. * **User** - one value for every user * **Message** - one value for each message -### How to define a permanent variable. +### How to define a permanent variable All functions used to define & access permanent variables follow the same naming convention: ```bash $[action][vartype]Var From 4838886678e86d85940f773ede8aa9e185fcc287 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 07:52:09 +0200 Subject: [PATCH 134/156] changes the uservar section to singular, not plural --- guide/Guide/6.variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Guide/6.variables.md b/guide/Guide/6.variables.md index 561c7f9..e54a653 100644 --- a/guide/Guide/6.variables.md +++ b/guide/Guide/6.variables.md @@ -166,7 +166,7 @@ You can see that different channels received different values of the same `descr ## 3. User -Another type of permanent variable are the **user** variables. +Another type of permanent variable is the **user** variable. The same user variable can have varying values among users different users, the same as channel variables. This example will show user variables by creating an `!aboutMe` command that allows users to set their own description. From 2a7623b8bb46e44f2c5b91ef0e80be8b6c18f9ad Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 07:55:41 +0200 Subject: [PATCH 135/156] reverted indices back to indexes --- guide/Guide/7.array.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Guide/7.array.md b/guide/Guide/7.array.md index 2d19630..d48d358 100644 --- a/guide/Guide/7.array.md +++ b/guide/Guide/7.array.md @@ -79,8 +79,8 @@ Let's execute this code and see what it returns. As you can array push has correctly registered separate animals. ## 3. Searching for values -As you may know, array functions mostly work based on element indices. -Generally, this kind of behavior is convenient, but we also need a way to get those indices from existing arrays. +As you may know, array functions mostly work based on element indexes. +Generally, this kind of behavior is convenient, but we also need a way to get those indexes from existing arrays. Here's how to use [$arraySearch](../Text/Array/arraySearch.md) to do just that. From 1f317ec02a231f66a6349c4134f405149564982b Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 08:02:02 +0200 Subject: [PATCH 136/156] fixed a spelling mistake --- guide/Guide/7.array.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Guide/7.array.md b/guide/Guide/7.array.md index d48d358..ce5f890 100644 --- a/guide/Guide/7.array.md +++ b/guide/Guide/7.array.md @@ -101,7 +101,7 @@ Now, head back to discord, and let's check the output: ## 4. Saving arrays By default, all changes made to an array are reset right after execution. -However, you may want to use arrays to store some data accros executions/commands, that has to keep track of all changes among the executions. +However, you may want to use arrays to store some data across executions/commands, that has to keep track of all changes among the executions. In that case [permanent variables](./6.variables.md#permanent) come in handy. From 57fa0e19dc830ba8ccdbae23e06bf4c173e050e1 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 08:05:06 +0200 Subject: [PATCH 137/156] changed returns an array to creates an array --- guide/Text/textSplit/textSplit.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/textSplit/textSplit.md b/guide/Text/textSplit/textSplit.md index 6909ea3..36022d1 100644 --- a/guide/Text/textSplit/textSplit.md +++ b/guide/Text/textSplit/textSplit.md @@ -1,5 +1,5 @@ # $textSplit -Splits the provided text with `seperator` and returns an array. To access them use: [$arrayGet](./../Array/arrayGet.md) or other array functions +Splits the provided text with `seperator` and creates an array. To access them use: [$arrayGet](./../Array/arrayGet.md) or other array functions #### Usage: `$textSplit[text;separator(optional, default = ,)]` From 2b10d85122db1a708eb67d3a049caa0fc1a7e203 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 08:08:36 +0200 Subject: [PATCH 138/156] fix spelling error --- guide/Text/only/onlyIf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/only/onlyIf.md b/guide/Text/only/onlyIf.md index d00a0ff..ebc658c 100644 --- a/guide/Text/only/onlyIf.md +++ b/guide/Text/only/onlyIf.md @@ -1,5 +1,5 @@ # $onlyIf -Continue the execution only if certain [expression](../../CodeReferences/ref.expression.md) is satisfied, otherwise top the execution and send the error message. +Continue the execution only if certain [expression](../../CodeReferences/ref.expression.md) is satisfied, otherwise stop the execution and send the error message. In theory $onlyif can replace all other $onlyFor with the proper [expression](../../CodeReferences/ref.expression.md) #### Usage: `$onlyif[Expression;error message]` From 564482fb825712fac3296de56ad30b10967f954e Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sat, 20 Jul 2024 08:31:37 +0200 Subject: [PATCH 139/156] grammar update forgot to check the text that wasnt conflicting with the main branch --- guide/Message/awaitMessage.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Message/awaitMessage.md b/guide/Message/awaitMessage.md index 4aa0bb8..da631c6 100644 --- a/guide/Message/awaitMessage.md +++ b/guide/Message/awaitMessage.md @@ -9,8 +9,8 @@ $awaitMessage[MESSAGE (Optional);userid / everyone (optional, default everyone); return the user reply or undefined ``` ### Timeout -It means the maximum time bot can wait user message for.\ -it accept format of time like `10s`.\ +The maximum time the bot waits for a user to send a message.\ +Accepts time in the format `10s` for example.\ The max time is `60 x (bot tier + 1)` seconds, for example for tier 3 it would be `240` seconds. ### Example: From 0c1adc57ef56e0e6092624e56d61998f471e71b9 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sun, 21 Jul 2024 19:43:10 +0200 Subject: [PATCH 140/156] fix grammar --- guide/Image/imageFill.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/Image/imageFill.md b/guide/Image/imageFill.md index b7af9ad..3c5591d 100644 --- a/guide/Image/imageFill.md +++ b/guide/Image/imageFill.md @@ -1,6 +1,6 @@ # $imageFill -Fill image with specific color name +Fill an image with a specific color ## Usage @@ -9,7 +9,7 @@ $imageFill[color;x;y;width;height;opacity] ``` ### Colors: -Accept Color Hex or Common Color Names like gray, black +Accepts hex or Common Color Names like gray or black # Position: X & Y You can read more about X, Y [here](./../CodeReferences/ref.imgbuild.position.md) @@ -38,4 +38,4 @@ You can read more about Width, Height [here](./../CodeReferences/ref.imgbuild.si - \ No newline at end of file + From 9abe95a46df5a9e028ea07aac6f3a93c923f1e7c Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sun, 21 Jul 2024 19:49:56 +0200 Subject: [PATCH 141/156] removed unnecessary newlines in {image:...} --- guide/Image/imageOutput.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/guide/Image/imageOutput.md b/guide/Image/imageOutput.md index fe50cfa..e9c388f 100644 --- a/guide/Image/imageOutput.md +++ b/guide/Image/imageOutput.md @@ -1,9 +1,6 @@ # $imageOutput -Generate the current draw into file, and return the filename, it can be used inside $image or {image:.\ -.\ -.\ -} and other places that accept image +Generate the current draw into file, and return the filename, it can be used inside $image or {image:...} and other places that accept image ## Usage @@ -28,4 +25,4 @@ $image[$imageOutput] // send the image $imageCreate[..] // Building the image $sendMessage[{image:$imageOutput[png]}] // send the image -``` \ No newline at end of file +``` From 45af04040d43ec8793dcd154676613b990db017f Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sun, 21 Jul 2024 19:56:20 +0200 Subject: [PATCH 142/156] fix grammar --- guide/Image/imageStrokeWidth.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Image/imageStrokeWidth.md b/guide/Image/imageStrokeWidth.md index 76711af..ccb514c 100644 --- a/guide/Image/imageStrokeWidth.md +++ b/guide/Image/imageStrokeWidth.md @@ -1,6 +1,6 @@ # $imageStrokeWidth -Control the stroke line thickness when drawing like $imageStroke +Control the stroke line thickness when drawing with $imageStroke ## Usage @@ -25,4 +25,4 @@ You can read more about Width, Height [here](./../CodeReferences/ref.imgbuild.si
- \ No newline at end of file + From 66423683847091250f84c87339ea975c20d12a99 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sun, 21 Jul 2024 19:57:38 +0200 Subject: [PATCH 143/156] fix spelling --- guide/Image/imageTextAlign.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Image/imageTextAlign.md b/guide/Image/imageTextAlign.md index 17c7677..3145163 100644 --- a/guide/Image/imageTextAlign.md +++ b/guide/Image/imageTextAlign.md @@ -1,6 +1,6 @@ # $imageTextAlign -specify the alignment of the text, effects the meaning of pos x and pos y for writing text positions +specify the alignment of the text, affects the meaning of pos x and pos y for writing text positions ## Usage @@ -9,4 +9,4 @@ $imageTextAlign[Alignment] ``` # Alignments -left, center, right \ No newline at end of file +left, center, right From ff4091c5c751c8b168cf73dfe1ff581a34e39928 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Sun, 21 Jul 2024 20:00:40 +0200 Subject: [PATCH 144/156] removed unnecessary newlines --- guide/Image/imageTextWeight.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/guide/Image/imageTextWeight.md b/guide/Image/imageTextWeight.md index e3c12d1..f8798c5 100644 --- a/guide/Image/imageTextWeight.md +++ b/guide/Image/imageTextWeight.md @@ -1,8 +1,6 @@ # $imageTextWeight -specify the weight of font, i.\ -e bold, italic.\ -. +specify the weight of the font, i.e bold, italic. ## Usage @@ -11,4 +9,4 @@ $imageTextWeight[Weight Type] ``` # Types -regular, bold, italic, bold italic \ No newline at end of file +regular, bold, italic, bold italic From bf731dce7b5919145e46994060c7e628906b8d23 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Mon, 22 Jul 2024 12:12:21 +0200 Subject: [PATCH 145/156] Added a space between $ping and ms --- guide/Bot/ping.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Bot/ping.md b/guide/Bot/ping.md index a4524f2..3e98ecb 100644 --- a/guide/Bot/ping.md +++ b/guide/Bot/ping.md @@ -5,10 +5,10 @@ This function returns the bot's ping, it can be used to check if the bot is onli
- !!exec $pingms + !!exec $ping ms - 20ms + 20 ms From 742c011be8861c58a5cb8a07e667efa37d4cab36 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 26 Jul 2024 17:44:05 +0200 Subject: [PATCH 146/156] spelling error fix --- guide/Other/syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Other/syntax.md b/guide/Other/syntax.md index bba0377..593e61c 100644 --- a/guide/Other/syntax.md +++ b/guide/Other/syntax.md @@ -64,7 +64,7 @@ Some functions requires an input from you to behave differently and this is the $function[Inputs] ``` Previously we used [`$username`](../Member/username.md) without inputs but why?\ -As the [`$username`](../Member/username.md) documentation will tell you, that by default it will return the exrcutor's name, but if you want to return someone else username you will need to do an input in this case\ +As the [`$username`](../Member/username.md) documentation will tell you, that by default it will return the executor's name, but if you want to return someone else username you will need to do an input in this case\ Assume that we want to get Rake's name instead of Mido\ We will first need to get Rake's User ID, assume 1234, and input it to [`$username`](../Member/username.md): ``` From 8814309d7cd8143d4fc7fc994dbf3106901ed510 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 26 Jul 2024 17:45:06 +0200 Subject: [PATCH 147/156] fix spelling --- guide/Text/Embed/description.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Text/Embed/description.md b/guide/Text/Embed/description.md index 39d9537..369991d 100644 --- a/guide/Text/Embed/description.md +++ b/guide/Text/Embed/description.md @@ -1,5 +1,5 @@ # $description -Adds a description to a message emnbed. +Adds a description to a message embed. #### Usage: `$description[your text]`
From 891ef821e974b0e94957c44b5dbff8ad8c81c4f3 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 26 Jul 2024 17:46:02 +0200 Subject: [PATCH 148/156] wording update --- guide/Timeout/userSetTimeout.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Timeout/userSetTimeout.md b/guide/Timeout/userSetTimeout.md index af2f29c..ec64460 100644 --- a/guide/Timeout/userSetTimeout.md +++ b/guide/Timeout/userSetTimeout.md @@ -1,6 +1,6 @@ # $userSetTimeout -Sets a user timeout, so the user cannot talk/interact with the server. +Sets a user timeout, so the user cannot talk/interact in the server. ## Usage From 5294b04e752c38cf36f517088dfdfb09e0849dc5 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 26 Jul 2024 17:46:52 +0200 Subject: [PATCH 149/156] fixed typo --- guide/Tutorials/5.confession.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Tutorials/5.confession.md b/guide/Tutorials/5.confession.md index e23ca8a..e74d2be 100644 --- a/guide/Tutorials/5.confession.md +++ b/guide/Tutorials/5.confession.md @@ -16,7 +16,7 @@ Next, Let's write the code that will respond when user runs the slash command: * Click `Create` * In Command Settings, select the Trigger Type to be "Slash Command", then select `/confess` * For Code: - * To respond tothe user, you can do so with `$interactionReply[message]` where message is the text you would like to display: + * To respond to the user, you can do so with `$interactionReply[message]` where message is the text you would like to display: > For example: $interactionReply[Hello World] * To receive user input of confession, we can use $getOption[option name], where `option name` is same option name we used while building the slash command which is `message` > For example: $getOption[message] From 2273fd075d1ae2398ce57821d56740d086bcf034 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 19:58:42 +0200 Subject: [PATCH 150/156] removed a word i forgot to remove --- guide/Guide/6.variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Guide/6.variables.md b/guide/Guide/6.variables.md index e54a653..16c4209 100644 --- a/guide/Guide/6.variables.md +++ b/guide/Guide/6.variables.md @@ -167,7 +167,7 @@ You can see that different channels received different values of the same `descr ## 3. User Another type of permanent variable is the **user** variable. -The same user variable can have varying values among users different users, the same as channel variables. +The same user variable can have varying values among different users, the same as channel variables. This example will show user variables by creating an `!aboutMe` command that allows users to set their own description. From 0b8200b36c270c386b9d3f4ef27a7531d6b1ceed Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 20:06:36 +0200 Subject: [PATCH 151/156] fix to grammar that i missed --- guide/Guide/7.array.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/Guide/7.array.md b/guide/Guide/7.array.md index ce5f890..9a02406 100644 --- a/guide/Guide/7.array.md +++ b/guide/Guide/7.array.md @@ -150,4 +150,4 @@ Notice that changes made to the array do not expire after execution. ### 🎉 Congratulations You've reached the end of this tutorial, but not the end of array capabilities! -There's a plenty of functions that make arrays tick, have fun exploring the [Array category](../Text/Array/arrayClear.md)! +There's plenty of functions that make arrays tick, have fun exploring the [Array category](../Text/Array/arrayClear.md)! From 8e90eb906e168768a773358bc9ebc0eaf26531a8 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 21:19:46 +0200 Subject: [PATCH 152/156] Create message_types.md A list of all available message types to add as reference to $messageType, similar to the channel types reference --- guide/CodeReferences/message_types.md | 42 +++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 guide/CodeReferences/message_types.md diff --git a/guide/CodeReferences/message_types.md b/guide/CodeReferences/message_types.md new file mode 100644 index 0000000..ea9299d --- /dev/null +++ b/guide/CodeReferences/message_types.md @@ -0,0 +1,42 @@ +# Message types +Use the `$messageType` function to return the type of the message. + +### Current message types: +``` +Default +Recipient Add +Recipient Remove +Call +Channel Name Change +Channel Icon Change +Channel Pinned Message +User Join +Guild Boost +Guild Boost Tier 1 +Guild Boost Tier 2 +Guild Boost Tier 3 +Channel Follow Add +Guild Discovery Disqualified +Guild Discovery Requalified +Guild Discovery Grace Period Initial Warning +Guild Discovery Grace Period Final Warning +Thread Created +Reply +Chat Input Command +Thread Starter Message +Guild Invite Reminder +Context Menu Command +Auto Moderation Action +Role Subscription Purchase +Interaction Premium Upsell +Stage Start +Stage End +Stage Speaker +Stage Topic +Guild Application Premium Subscription +Guild Incident Alert Mode Enabled +Guild Incident Alert Mode Disabled +Guild Incident Report Raid +Guild Incident Report False Alarm +Purchase Notification +``` From cb3e1f5974961bbd80f773dad54bd919659428e7 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 21:20:24 +0200 Subject: [PATCH 153/156] Rename message_types.md to ref.message_types.md --- guide/CodeReferences/{message_types.md => ref.message_types.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename guide/CodeReferences/{message_types.md => ref.message_types.md} (100%) diff --git a/guide/CodeReferences/message_types.md b/guide/CodeReferences/ref.message_types.md similarity index 100% rename from guide/CodeReferences/message_types.md rename to guide/CodeReferences/ref.message_types.md From a28113165a92cb6117ebb3e596b8198fd603f99e Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 21:22:52 +0200 Subject: [PATCH 154/156] add a link to the reference list of message types --- guide/Message/messageType.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/guide/Message/messageType.md b/guide/Message/messageType.md index 4940137..66186ab 100644 --- a/guide/Message/messageType.md +++ b/guide/Message/messageType.md @@ -13,5 +13,9 @@ Returns the type of this message. +::: tip Note +This function returns a type of message from this [list.](../CodeReferences/ref.message_types.md) +::: + ##### Function difficulty: ###### Tags: From 104876dc6c1755d6f0de2c2bb717b98d8a939433 Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 21:42:37 +0200 Subject: [PATCH 155/156] reverted back to using "indexes" --- guide/Text/textSplit/advancedTextSplit.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/Text/textSplit/advancedTextSplit.md b/guide/Text/textSplit/advancedTextSplit.md index f13b9ef..a990d69 100644 --- a/guide/Text/textSplit/advancedTextSplit.md +++ b/guide/Text/textSplit/advancedTextSplit.md @@ -1,7 +1,7 @@ # $advancedTextSplit -The first field is the message we want to split and get indices for. The second +The first field is the message we want to split and get indexes for. The second field would be the split/seperator used in the text, and the next field would get the value of the index provided, setting this index value as the new text. The next -fields work as splitters/seperators and new indices for this new text. +fields work as splitters/seperators and new indexes for this new text. #### Usage: `$advancedTextSplit[text;split;index;split;index;...]` From 05a7a212aea02bae8dfe3ebfd19138597effa2ad Mon Sep 17 00:00:00 2001 From: naem <175557420+naem-less@users.noreply.github.com> Date: Fri, 2 Aug 2024 22:00:56 +0200 Subject: [PATCH 156/156] added a description of what the function does --- guide/Useful/return.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/guide/Useful/return.md b/guide/Useful/return.md index 752abe1..271fbbc 100644 --- a/guide/Useful/return.md +++ b/guide/Useful/return.md @@ -1,12 +1,14 @@ # $return -Can only be used inside user-defined functions created with $function\ +Stops a user defined function execution and returns the Return Value + +Can only be used inside user-defined functions created with `$function`\ It has no effect outside the user-defined function ## Usage ```bash -$return[Return Value] +$return[Return Value(optional)] ``` ### Example: