yagpdb-cc / yagpdb-cc

A curated collection of custom commands for the YAGPDB Discord bot

 YAGPDB Custom Commands

A curated collection of custom commands for your server

If you are looking to browse through our collection of custom commands, please refer to our website instead, which displays all custom commands available in a user-friendly manner.

Introduction

A curated collection of custom commands for the YAGPDB Discord Bot to enhance your server.

It is:

• Extensive: There are over sixty custom commands (and we're adding more regularly!), meaning that it's likely that you'll be able to find what you're looking for.
• Vetted: This collection of commands is maintained by a group of YAGPDB staff members.
• Well tested: We review all commands added and many commands have widespread usage, meaning that it's unlikely — though not impossible — for there to be serious bugs in them.
• Well documented: We take pride in our high quality of documentation, which makes it easy for anyone to figure out how to use a command.

Disclaimer

The YAGPDB developer, staff, and/or support are not responsible for any issues with or caused by these custom commands. Furthermore, though we thoroughly review all commands added, they are not guaranteed to be working; use them at your own risk.

Need help?

If you are experiencing issues with a custom command from this collection, feel free to ask on the YAGPDB Support Server. However, do keep in mind that not every staff member knows about every custom command present.

With the above in mind, a better way to get in touch might be via opening a GitHub Discussions, as these are also easily searchable.

If you believe you found a bug, please open an issue.

Contributing

If you are looking to contribute, please read the contributing guide first.

Contributors

yagpdb-cc is currently maintained by a group of YAGPDB staff members: @jo3-l, @Satty9361, @l-zeuch, @Pedro-Pessoa, and @DaviiD1337.

It is made available under the MIT License.

We would also like to acknowledge our community contributors. Thank you!

yagpdb-cc's Issues

request: restructure folders

Im on mobile and am lazy but you should prob move the contents of the util folder into a new "misc" folder with the birthday cmds and such rather than calling it util
Edit: i love not being able to add tags to my own issues :^)

Bracket missing at FlagMessage Command

Bracket missing at the 10th line of Flag Message Command

Levels

How to reset xp and level for everyone?

Suggestion system

When I use an admin command, it says not valid ID when I clearly copied the right ID. I did not change anything

Branches

Delete the patch branch from satty and maybe add a WIP branch? Or a wip folder or smth for commands that arent quite finished or need refining.

request: subfolders for individual commands

Rather than changing all the commands to MD files (#40) why not make an individual subfolder for each one with a README file? Seems like its the best of both worlds and it only adds 1 click, its clean and could remove the comments at the top of the files entirely. It would probably make it easier to navigate as well considering there are already some commands that have their own folders.

bug at the leveling cc

with the -rank set-color [color] you could change your embed color. but if you just do randomly like in this pic:

it will just change to random colors, where it should say Please provide a valid hex to set your rank card color to.

and in the code ther already is:
{{ $user.Mention }}, I set your rank card color to #{{ $hex }}. {{ else }} Please provide a valid hex to set your rank card color to.

Just want help, Not issue

In the slot machines, for all users, there is no balance. How do I add and manage balance?

Won't send afk message

When I turn on the afk and someone pings me it doesn't send the aft message

Broken Links

Broken Links in Main Readme file.

leveling: Setting user XP/level sometimes does not give roles

Reported by Pedro Pessoa#5354 on Discord.

Issue

When a user's XP or level is set using the setxp/level command, their role rewards will not be updated if the mode is set to highest and the new level is not a role reward on the list.

Reason

highest mode for role reward giving was implemented by removing all roles the user has which are role rewards if their current level has a role reward associated with it, and then giving them the role reward for the current level. This works because users level up level by level, meaning they cannot just skip from level X to Y without getting the appropriate role rewards in between.

Solution

Optimal solution would be to give and remove role every level-up. This could be done by range'ing over all the role rewards and finding the level that is closest to the new level but >= the new level as well. Remove all other role rewards, add this role.

If anyone wants to implement / fix this, feel free to, I don't have too much time to do this right now.

request: website for browsing CCs

I feel like maybe trying to use github pages might just be the way to go here

Suggestion System

Compress everything to a single Custom Command rather than having 4 of them for a suggestion system.

Suggestion: sticky roles

Would be great feature to control, possibility to exclude which role it shouldnt reassign upon user rejoin and cooldown

Birthday system

Birthday System

A birthday system has often been requested in the support server, I feel that this repo is an appropriate place to put it.

Description

A user may set their birthday using a one-use command (to prevent abuse). Every day, the bot checks for birthdays on that date. If there are, a notification is sent in a given channel and an optional role is given to all users with birthdays on that date (removed during the next day's check).

Admins may force set birthdays if a user has set their birthday to the wrong date.

Implementation

Command for users to set their birthday
First, we check whether this user has a birthday set. Next, the date they have given is validated. If it is valid, we add their user ID to a database entry with the key being in the format DD-MM-YYYY.

Interval trigger
Firstly, we get the DB entry latestBirthdays. We loop over all user IDs in this entry, and remove the birthday role from them. Then, we get the current date, then retrieve the entry for that day. We update the DB entry latestBirthdays with the value of the entry just retrieved. After, we loop over the user IDs for today, sending a single congratulation message and then adding the birthday role to all of them.

We may need to ensure that we don't hit ratelimits during this process.

request: allow edit CC to edit embed fields

I saw that there was a CC that copies the function of simple embed to create se with fields. It would be interesting to add their editing to the edit CC.

I'd like to do it but I'm not at all familiar with the way this command has been coded...

Script not working?

Hi! I love this giveaway script btw it has worked perfectly up until now. I just hosted a giveaway on my community Discord server with 207 participants and the bot just announced the winners, saying: "No Participants :("

Please help! Everyone is mad :<

editing all messages

edit.CC.lua should be able to edit complex messages as well.

Suggestion for the leveling system(if possible)

for right now, the rank card is just an embed, and the progress bar is small. instead make it like other bots, if its possible so it shows better, and also looks better

meta: project status

Current project status

Hey all!

I'd just like to provide a notice about the project status currently - there's several open issues of note and also several PRs that haven't been reviewed. I apologize for this, I've been quite busy with school lately and most of my free time is directed towards my own private bot which I'm writing for a server I own.

I'm still going through the PRs regularly, so you can expect bugfixes and other small additions / changes to be merged quickly, though don't expect any large PRs to be merged until sometime later.

At this point in time I think I'll have some time to address the issues and review the open large PRs in this repo sometime later this month / early next month, no promises though!

TL;DR

I'm busy with other things right now, but am still reviewing small PRs and issues regularly and plan to come back to the repo whenever I have time.

bug: starboard errors if db entry overflows max size

Issue

Starboard works by using a text entry to store key-value pairs in a single database entry, formatted in messageId:starboardMessageId. At the time of writing, I considered 100k to be ample space for most server starboards, however, it seems that some servers have come very close to it causing an error when attempting to append data to the entry (which would cause it to go over 100k).

Error:

20 May 20 01:13 UTC - Failed executing template (dur = 185.897545ms): template: CC #15:74:5: executing "CC #15" at <dbSet 0 "starboardMe...>: error calling dbSet: short write

Solution

There's many ways of solving this issue, currently, as a hotfix I've recommended the reporter of the issue to simply clear the database. This is by no means, of course, a permanent fix. One solution would be to create another entry in the code when the last entry is too close to 100k characters, and then looping through a dbTopEntries to find the message ID.

I'm also looking for other solutions, this may take a while.

Use deleteMessageReaction template for pagination

Basically what title says, use deleteMessageReaction template for pagination (remove the reaction which user just added). I'm a little busy this weekend so if anyone could PR it, that'd be great!

request: disable level up message

I think it should be possible to disable the leveling up message/announcement in the leveling system

DeathMatch: Default $yag value crashes CC, when there are no arguments

Issue

Hi! I wanted to test that CC, and the first run failed with this error code:

An error caused the execution of the custom command template to stop:
Failed executing template (dur = 1.280173581s): template: CC #21:98:4: executing "CC #21" at <editMessage .Channel...>: error calling editMessage: HTTP 400 Bad Request, {"embed": ["fields"]}

Reason

When no arguments are provided, YAG will try to get user 624608566426468373, who may not be in the guild (my case). So, it will fail to send/edit the embed, causing the error code posted above

Solution

Editing the ID in line 19 solves the issue. I used YAG's ID, but also could be used Guild's owner for example. By default, Yggdrasil starts the battle between you and a random guild member, but I think this isn't possible to implement

PS: I think PAGSTDB#3732 is a selfhosted YAG fork, but that's not relevant to the issue

Smol mistype on Edit CC

"simply editing provoded fields of embed"
https://github.com/Jo3-L/yagpdb-cc/blob/91d4597fcd667405ca8695aaad3f9e6ee6ae76ae/maintenance/edit.cc.lua#L8

Standard Timezones

Use standard timezones for stuff like worldclock.cc.lua or other timezone based stuff.
This automatically handles daylight saving. Its also a issue in one of my ccs so putting this here as a reminder.

request: allow usage of attached images as base for meme CC

Allow the usage of Attached images as the base for the meme instead of their link. If a attachment is found the command will require only top text as arg.
Also make the Bottom Text optional, and if is not provided use Bottom Text as default because this is a meme by itself

can't evaluate field AppendSlice in type []interface {}

Hi,

I tried to add the fun animal command and when I type httpcat as a type I got this error :

Failed executing template (dur = 72.589µs): template: CC #1:23:146: executing "CC #1" at <599>: can't evaluate field AppendSlice in type []interface {}

Cheer

Maze command no longer works

It appears that the website linked to the maze command does not function anymore. Can you verify this and change (or remove if cannot be changed) the command?

Partnership system through rep

Commonly requested system, give rep to user when they partner with another server, detect with discord link regex.

request: manage suggestions through reactions

2 ideas here to make the lives of the admins a lot easier

1. Allow custom emoji's to be set to assign approve/reject/dupe/impemented status to suggestion as well as delete and archive. We are already right clicking on the suggestion to get the ID anyways, it would save the whole next step if we could just apply a custom emoji to it that would end in the same result.

2. Batch status change of suggestions by allowing multiple ID's to be placed after -sa approve/delete/implement etc

Rank embed color does not carry over

Suppose user A has set his color to red,
User B has has set his color to blue.
When user B types -rank @UserA the color which is shown is blue instead of red.

User which left the server is still in the db

For the AFK and Leveling systems, users who already left the server are still stored in the db (see the attachments). I guess this can be solved by a dbDel in the leave message. Might want to look into it...

-role-rewards does not work as written

Trying to implement this awesome leveling script, and the only part that doesn't work is the -rr command. Any insight into how we can get it to work? We run it and nothing happens. Logs are enabled but no output.

another suggestion for leveling

a -leveling set-disabled-channel
where you can set what channel you won't get exp, usefull to disabled getting xps in bot commands. or if you have a spam channel and you dont want people to get xp tehre

Suggestion System Readme

A bit of a primer would be useful.. For example
{{$Suggestion_Channel:=}} - Is this the suggestion channel where suggestions are posted after being accepted or the one where suggestions are made?
{{$Logging_Channel:=}} - What is the purpose of this and what is outputted to this channel?
{{$Implemented_Channel:=}} - In the sample config this is unique, is there any issue with it being the same as say logging or approved?
{{$Approved_Channel:=}} - Same question as above
{{$Upvote:="upvote:524907425531428864"}} - Assuming this is the emote and id, is it necessary to have the emote name and then the id or would just the ID work? Might be usefulto do a step by step on how to grab this info is it's not very well known how to grab emote IDs. It should also be made clear that this doesn't work with standard discord emojis which are svg files like /assets/08c0a077780263f3df97613e58e71744.svg , when entering in 08c0a077780263f3df97613e58e71744 after upvote or thumbsup in this case you are unable to save the response at all due to an error message of "Response Too Long" Even though the response is not longer than 10k chars, something about these values messes it up.

-Open the emoji panel and make sure you have the emoji you want to use.
-Next, open up the Developer Console, using Ctrl-Shift-I,then Ctrl-Shift-C. Click on the emoj you want to use.
Provided you have done that correctly, something blue will show in the console. Look for a long link looking similar to this: https://cdn.discordapp.com/emojis/587026903584735243.gif?v=1
-If you only want the ID, copy the thing between the emojis/ and the extension. (In this case it is 587026903584735243)

{{$Downvote:="downvote:524907425032175638"}} - same as above

yagpdb-cc

Suggestion: @mention original poster for all implemented suggestions

Would be really nice if they received a notification via a mention when their suggestion was approved

Reaction Log doesn't respond to added reactions, only removed reactions

I'm talking about this CC. I'm pretty sure I've set everything up correctly, Added and Removed reactions for the trigger, no role or channel restrictions, and also correctly changed the channel id. However, the bot only logs removed reactions, and not added. I looked through the code, and I think it's supposed to log added reactions too. Is there something I'm doing wrong? Here's a gif demonstrating the problem https://gyazo.com/198dfd36a5e54364b09991d2ca102542 .

bug: can't implement approved suggestions

No problems approving or implementing normal suggestions however when -sa implement is used on an approved task I get "Error: Not a valid Suggestion Message"

request: set required role to enter giveaways

An -r flag where you can set an optional role to join the giveaway and remove the reaction if the user doesn't have the role.

bug: empty file for emoji-info cc

While working on #90, I noticed that there was an empty file for an emoji command, and no history attached to that file. Did that command get misplaced, or was that command never created?
There was a PR (#9) for that exact file, but it was never merged

request: afk v2 - automatically turn off afk when message sent

Many people want afk to turn off automatically when user types a message. Maybe made a separate version for that.

In suggestion system v2, there is an error

I did not change anything, I get this issue. Failed executing template: template: CC #31:43:5: executing "CC #31" at <addReactions $Upvote>: error calling addReactions: HTTP 404 Not Found, {"message": "Unknown Message", "code": 10008}. Issue appears to be in addReactions. Maybe yagpdb changed or deprecated something?

request: message requirements to enter giveaways

The ability to issue message requirements where they will only be able to enter the giveaway if they have sent a certain amount of message

mute person after inactive for duration then then kick

can you do script for person who is afk in voice channel for 5 then the bot will kick him?

request: analytics for last week server activity

With the introduction of server insight and the partnership requirement, people will look many ways to improve their member retention.
One idea would be a recap which encourages the member to revisit the server once in a while.

Recap of last week could be
Which ch had most message
Which message had most reaction(serve great purpose for starboard with categorization as most popular image, or/and most controversial message)

which voice channel had most activity?

bug: startboard cc isnt working on self hosted bots

Describe the bug in as much detail as possible:

Using the Starboard on a self hosted version of the bot (Latest public docker) will error out instead of adding the msg to he starboard

To Reproduce:

Add the startboard cc on a self-hosted bot, try to add a star to any msg that the command can see, get the error code like this one:

Failed executing template (dur = 962.868µs): template: CC #14:58:32: executing "CC #14" at <$embed.fields.append>: can't evaluate field append in type interface {}

meta: Change file extensions to .MD?

See title.

Pros

• Descriptions are easier to read (instead of a leading comment, we can have markdown)
• Eliminates any possible confusion that YAGPDB CC has any relation to Lua or other programming languages
• Can still have syntax highlighting in codeblocks

Cons

• Harder to copy code on mobile

Suggestion V2: CC doesn't execute when message contains "YAGPDB" or mentions bot

Hi! I think It's expected behavior due to RegEx trigger. With this original message I've found it:

-suggest Respecto a los cumpleaños:

1. Que el YAGPDB envíe un mensaje a las 0:00 hora UTC
2. Que lo envíe a las 0:00 hora CdeCountry (o sea, 0:00 UTC +6)
3. Que no envíe ningún mensaje, y solo se encargue del rol de CdeCumpleaños (esto último pendiente)

But just -suggest YAGPDB or -suggest @YAGPDB is enough. I didn't test SuggestionV1, so maybe it doesn't have this bug