+tag [Old User]
Permission: [Old User] Caller must either have been a member of the server for 15 minutes or have a role with more permissions than @everyone.
Tags are like bookmarks. You can create them and then later recall them.
This could be for images or even custom scripts
Tags are stored per server. To use one server's tag on another server, you should use the pull, clone or import commands to copy the tag.
There are currently 5 help commands in discord that explain how to use tags, so uh, if the length of the contents didn't give it away already, that should. These commands are:
+help tag General editing commands.+help taginfo Searching and info tools.+help tagmovement Moving tags between servers.+help tagyna Tools for scripting tags.+help tagconfig Different config options.Every tag will have a name, which is unique on your server. To recall a tag, you can just use that name.
+tag 'name' ['args' ...]
You may have noticed some tags seem to be personalised, or always change when you use them. These are yna script tags. To see what the real content of one of these tags are, you can use the raw command.
+tag raw 'name'Tags marked as closed cannot be posted this way unless you own the tag
This section will describe how to create and edit tags, and how to delete them too.
To create a tag, you have 3 options:
+tag create 'name' 'content'+tag create 'name'+tag create 'name' With upload.yna format, the contents of the file will be read and used as the tag.Initialisation Code
If your tags use state variables you can initialise those when you create a tag.
To do this, you should add {init} Your init code here {endinit} to your tag content.
After a tag is created, you can edit it later. Or rather, you and moderators can edit your tag. There are 2 different kinds of edits you can make for a tag, and yes, you can upload yna files for both.
+tag edit 'name' 'new content'You can append content to specific places in a tag. By default this is the end, but you can add new insertion points into your tag manually.
To add an insertion point, you use this syntax:
{!!extend id pre="\n" post="" yna=false public=true}
Only the ID is required and it must be fully lowercase with no numbers or special characters.
The rest of the parameters are optional, but must be in the correct order. pre/post will work but post/pre will not.
The yna parameter says whether yna code insertion should be allowed. If this is false (recomended for public insertion points) then {, }, ; and \ characters will be escaped.
The public parameter says whether the insertion point can be used by general members. If a tag is not marked with the Public flag, then the tag cannot be extended by general members regardless.
You may add a trailing ! to the marker. This is to accomodate for editors that highlight comments between {! and !}
If there is not a marker with the id "end", then a default insertion point is placed at the end of the tag with the same parameters as the example
{oneline:
{choose:
foo;
bar; {!Lets add the first extension point here.}
baz{!!extend choice pre=";\n" public=true}
;}
{!We need to disable the default IP}
{!!extend end public=false}
{!Now users can use "+tag extend 'name' 'content' choice"}
;}
+tag extend 'name' 'content' ['location']Tags can also be renamed by their maker, the moderators and in extremely rare cases*, squas.
*This only happens when a new subcommand is added that otherwise clashes with existing tag names. When this happens, your tag will be renamed to have a single underscore after. Example: +tag config -> +tag config_+tag rename 'name' 'new name'
This command deletes a single tag.
Bot mods on a server can delete any tag they wish regardless of who owns it.
For deleting multiple tags, check the Delete all command.
Side note: Anyone can delete orphaned tags regardless of who the actual owner is, or rather, was.
+tag delete 'name'This section will describe different ways of searching for tags and getting information about those tags.
This command lets you search for tags by name.
If a single tag is found, it's posted immediately, otherwise a list of the tags that were found is posted.
Technical note: This command is a substring search. i.e. "apple" will match "apple crumble" but not "apfel".
+tag search 'query'
This command picks any random tags from the server.
Notes: Tags marked as NSFW or Spoilers will not be brought up in random.
+tag random ['query']Info shows a lot of content about a tag. This includes:
+tag info 'name'You can view all the tags you own on a server. This is printed as a paginated embed.
+tag list ['user']The left and right arrows navigate the pages, while the up arrow takes you to a guild overview. Here, you can see your total tag count, as well as which servers have the most tags, and how many tags you've left on orphaned and dead servers.
Listing all guild tags
You can also view a list of every tag on the server. These are sent as files containing 500 tags at a time.
+tag list all
Each line represents a tag, the bar on the left displays what metadata that tag uses.
H This tag is hiddenY This tag utilises yna scriptingC This tag is closed source! This tag is marked NSFW? This tag is marked spoilerS This tag is syncedR This tag is restrictedP This tag is publicThen it just puts the tag's owner and its name.
This command posts a bunch of statistics about your guild's tags.
This command uses the paginated embeds from +info
+tag stats
As a general rule, tags have an owner and exist only on one server. There are some commands here that allow for easy copying of tags between servers.
There are 2 steps to changing the owner of a tag. Firstly, the current owner needs to request to give it away, then the proposed new owner must accept the tag.
+tag gift 'name' 'user'+accept 'name'
Orphaned tags are tags that are currently owned by someone who has left the server.
If the owner joins the server again, they will automagically be given ownership of their tags. Oh and by "automagically", I mean they never actually lost ownership.
However, if the owner isn't going to come back, or you want to take the tag anyway, you can claim ownership yourself.
+tag claim 'name'
Another important note about the claim command: If you know a generic tag and there is no tag on the server with the same name as the generic tag, you can claim the generic tag to make a copy of it to your server.
Tags are created and exclusively usable inside your server, however you may want to copy some tags into other servers. You could do this by getting the raw content and then recreating the tag on the other server, but 42 has tools to directly copy tags to other servers.
+tag clone 'name' 'guild' ['new name']+tag pull 'name' 'guild' ['new name']
If you need to copy a lot of tags at once, you can use export files.
Notes: You can only export your own tags, and the tags must exist on the source server before they can be copied.
To import a bunch of tags to a server at the same time, you need to first get a file using +tag export the upload the file you get with the caption +tag import
+tag export
The file has 2 sections, the headers and the content.
Here are the headers.
1 │ --DO NOT DELETE THIS LINE-- 2 │ source guild, 1234 3 │ on conflict, ignore 4 │ on general error, ignore 5 │ on state error, ignore 6 │ import nsfw, 0 7 │ import spoiler, 0 8 │ --List of fields for each tag--
Line 2 is the ID of the source server, you probably shouldn't change this.
Line 3 is what to do when a name conflict happens. This can take 1 of 4 values
ignore This will just skip tags that have conflicting namesrename This will append an underscore to tags with conflicting namesupdate/ignore If you own the conflicting tag, the tag from the file will replace the one on the server, otherwise the tag will be ignored.update/rename If you own the conflicting tag, the tag from the file will replace the one on the server, otherwise the tag will be appended with an underscore.Line 4 states what to do when there is a problem reading a tag. This one has 2 values
ignore This will skip the broken tag.stop This will halt the import and alert the user about a broken tag.Line 5 says what to do when there is an issue with a tags state variables.
ignore This will skip the broken tag.delete This will erase the offending variable(s)delete all This will erase all of the state variablesstop This will halt the import and alert the user about a broken tag.Line 6 states whether NSFW tags should be imported. 1 for yes, 0 for no.
Line 7 states whether spoiler tags should be imported. 1 for yes, 0 for no.
Here is a tag
8 │ Tag name, New name, NSFW, Public, Hidden, Restricted, Closed, Spoiler, State:Var 9 │ help, tag, 0, 0, 0, 0, 0, 1, 0, last:create, lastusr:squaswin
Each tag is 1 line in the file.
Line 8 shows what each value is.
Tag name: This is the name of the tag from the source server. This should not be changed.
New name: This is what you want the tag to be called when you import it.
7 Metadata values. These are 0 for off or 1 for on.
State Variables: These are the up to 16 state variables on a tag. The variable name is the content before the colon, the value is the content after.
If you do decide to edit your file, the things you probably need to care about:
To import NSFW or Spoiler tag, change the 0 to 1 next to "import nsfw" and "import spoilers"
To remove a tag from your import file, just find the line where the name is and delete that line.
To rename a tag before you import it, find the tag's line and change the second name on that line to your new name.
+tag import With uploadxdelete is here too
So you or one of your members has just imported a load of garbage, or you are starting to run out of slots for tags. 42 provides tools for deleting a lot of tags all at once.
42 also provides a way of covertly deleting a tag from another server when, say (and this has legitimately happened), someone clones an obviously NSFW tag onto a clearly SFW server.
If you want to delete a tag from a server without that server knowing it was deleted or that it even existed, you can do so.
No notice is sent to the target server about this action.
+tag xdelete 'guild' 'name'
The delete all command lets you delete every tag you own on that server, or instead, you can add a filter to it to change what is deleted.
There are different filters for users and staff.
+tag delete all
Firstly, a couple of definitions.
Orphaned tags are tags from a guild that you are no longer on. They are still "your" tags, but they are open to be claimed by other users.
Dead tags are tags from a guild that 42 is no longer on. They still exist for if 42 rejoins the server, but are otherwise unusable.
Note: Tags must exist on the server to be imported.
Okay, that out of the way? Let me tell you about 42's functions.
+tag delete all orphaned+tag delete all dead+tag delete all on 'guild's-squas, please don't tell them about the next one...
I'm sorry 42, but in the name of completeness, I must.
B-but it's such a dangerous command!
I know 42, I'm sorry.
+tag delete al--+tag delete all everywhere
There are a couple tools that server moderators can do to help clean up or stop problem users.
Do not forget though, that you can also botban problem users.
+tag delete all orphans+tag delete all from 'user'
Each tag can have an optional set of metadata flags that do different things.
There are 7, and yes, tags can have all 7 at once.
Mods can change any metadata about a tag for any reason with 2 exceptions
However, mods can break synced groups.
For all commands listed below, the command acts as a toggle.
e.g. using +tag nsfw on a tag that is already NSFW will remove the NSFW flag from the tag.
Spoilers serve 2 purposes.
+tag spoiler 'name'This is similar to spoilers, but provides a couple of key differences.
The last point makes this a useful tool for if your SFW server defines spoiler rooms.
+tag nsfw 'name'Restricted tags cannot be cloned to or pulled from another server by anyone that isnt the tag's owner
+tag restrict 'name'
Tags marked as closed source prevent users from viewing the raw content with the raw command.
The owner and mods can still get the raw content.
+tag closed 'name'
Making a tag public allows the tag to be used in several ways.
Firstly, any member of the server to use extend on any public insertion points inside the tag.
This would be useful for things like easy bug reporting, suggestions, or adding new things to {choose} objects.
The second thing is that public tags can be used by anyone inside {call} objects, which makes it very useful for library tags.
+tag public 'name'
Syncing is the process of combining a set of tags into a group that get edited all at the same time.
Synced groups consist of a set of tags which are owned by the same person and has exactly the same content.
Moderators cannot create sync groups for other users, nor can they edit tags that are part of a sync group.
However, they can break a group in order to regain editing powers over the tags.
As syncing only covers identical tags, you can create a tag that does not enter a group by adding a yna comment to the tag, for example {! no sync/1 }
When you create a sync group, 42 will gather all the metadata sets of each tag in the proposed group and will give you a prompt to choose which metadata to use. This will probably be a number between 0 and 127.
+tag sync 'name'Tags employ a custom scripting language called Yonni na. This is pronunced however the frick you want, I just say "yna" as 3 letters, some people pronunce it "yona", I've even heard people calling it "nya"... Distractions aside, this section is for listing the tools to aid yna tag creation.
The eval command lets you run your tag and see the output before you actually create a tag.
This command is the equivalent to using
| +tag create anonymous 'content' |
| +tag anonymous ['args'] |
| +tag delete anonymous |
+tag eval 'content' ['args' ...]Sometimes just viewing the output of a script isn't enough to find whats going wrong. This command helps with debugging by posting a file containing details about every object that gets executed in the tag.
+tag debug 'name' ['args' ...]
If you need to debug some content, but haven't created an actual tag yet, this command is a combination of debug and eval, aptly named "deval".
Like in eval, the tag's name will be set to "anonymous" for the sake of the {tag} object.
+tag deval 'content' ['args' ...]
When you create a tag, an initilisation block will run and it will store the output as the tag's default state.
This command provides a way of reverting a tag's state back to what it was when it was created.
+tag reset 'name'+tag reload 'name'
If you are a mod on a server, 42 supplies a whole load of options for how people can use tags.
All limitations are ignored by moderators, but each section will explain exactly whats happening.
Configs can be checked by using the command with no args.
+tag config
You can lock tags such that they are only able to be used inside a specific set of channels. If no usage rooms are defined, tags can be used anywhere.
Note: Defined spoilerrooms are usagerooms by default if any usage rooms are defined.
Mods are not affected by usagerooms.
+tag config usagerooms '#channel' ['#channel' ...]+tag config usagerooms clear
You can lock tags marked with spoiler flags to specified channels.
If you have defined usageroome then tags will also be usable inside spoilerrooms regardless of if they are usagerooms.
If spoilerrooms are defined, mods can't use spoiler tags outside of the channels, so it would be worth adding the staff channel as a spoilerroom.
+tag config spoilerrooms '#channel' ['#channel' ...]+tag config spoilerrooms clear
42 provides a way to limit how many tags a user can create (or rather own) on your server. This is seperate from their regular 5000 tag limit.
You can also completely disallow regular users to create tags.
Mods are unaffected by these limits.
+tag config allow_creation+tag eval.
+tag config creation_limit 'count'+tag config creation_limit 0
42 has a internal coins system in which users can get 300* coins a day. What this setting allows you to do is to have 42 charge up to 30 coins for a user to use a tag.
Do remember that coins are global per user, so if multiple guilds use this limit, their tag usage will be limited between all of those guilds.
Mods are unaffected by this cost. Conversly, tags owned by mods will not charge users to use.
Patreon supporters will gain 1500 coins a day instead of 300.
+tag config coins_cost 'value'+tag config coins_cost 0The NSFW, Spoiler and Restricted flags can all be applied to newly created tags by default.
+tag config default 'flag'This is how you define the custom content to use in 42's welcome message.
You can use {user} and {@user} brackets to name or mention the new user.
+tag welcome ['content']
Gets the welcome message. If content is given, sets the welcome content
Generic tags are a new feature for Patreon supporters and allows for the creation of tags that can be used on any server.
As this poses a lot of issues over content, there are some rules about what a generic tag can contain, and it will be moderated both for content and QA.
These rules are as follows:
e.g. 1: {! tag <Tag name>, owner <Your name> } Don't try using {tag} because it is a comment.
e.g. 2: {!!description <Tag's description here> }
e.g. 3: {!!descshort <Single sentence here> }
Additionally, it is advised against using the {save} object or state variables as generic tags do not support them. Using state variables would require a user to claim the tag for their server.
If your tag requires state variables, you can add a check against {generic} to see if your tag has been copied to the server.
Please note that generic tags are not closed source, not restricted and can be copied to any server by anyone for private use or to view source code.
Pending changes
Any edit to generic tags, including deletion will send a pending change request to Kiwi Hangout. Supporters will be able to see and vote on these requests, though moderators will have the final say.
That being said, if you abuse the commands, you may have your ability to request any change other than a delete revoked until the month is over, so don't over do it please.
Masking generic tags
If you find a generic tag that you dislike or otherwise don't want on your server, you can mask it simply by creating a tag with the same name. This both makes the tag impossible to call, and to claim as the bot will start performing these actions on the local tag instead of the generic one.
There are 2 ways to create a generic tag, both ways submit the tag to the moderation channel before being completed.
Please ensure before you submit your tag that it works and does not break any rules.
+tag generic create 'name' With upload.+tag generic create 'name' from 'tag name'
You can edit generic tags after they have been created, however the edit must also go through moderation.
The key point to editing a generic tag is that the spirit of the tag shouldn't change. As a general rule of thumb, if the description of the old tag doesn't fit the new tag at least in some capacity, your edit will be rejected.
If you want to create a tag with a different idea or theme, you should create a new generic tag
+tag generic edit 'name' With upload.
If you wish to delete your generic tag, it will first be placed in a schedule queue for a week. This serves 2 purposes. It gives you the chance to reverse your decision and it also gives other servers the chance to copy your tag before it is deleted.
Tags scheduled for deletion will be clearly marked in their info page.
+tag generic delete 'name'
If you've made a mistake or wish to stop a change from happening, you can cancel it before it gets approved.
You cannot un-cancel a change, you'd have to propose the change again.
+tag generic cancel 'id'
ID is the ID of the change to cancel. This can be found in the top left corner of the status embed.
While supporters will always be able to see the status of any generic tag, and even vote on which ones to approve, it is useful to be able to see what changes you are waiting on.
This command will tell you what your pending create is, if it has been accepted or rejected and why, and what other changes you have requested.
+tag generic statusGeneric tags can be viewed in a list in the same way that list works. This also posts the short description of each tag.
+tag generic list
Posts an interractive window listing generic tags
Some tags may use state variables and require copying to the server. To do this, you can use the claim command.
This makes a local copy of a generic tag under your name.
If a generic tag is masked, you cannot copy it. This is because instead of copying the generic, 42 will try and take ownership of the tag masking the generic instead.
+tag claim 'name'