# fray docs

> fray is a free discord bot for community servers. these are its docs.


## start here

- [drain](https://docs.fray.lol/): a discord bot for running a server: keeping it safe, setting it up, and giving people something to do in it
- [quickstart](https://docs.fray.lol/quickstart): add drain, give it a role that can do its job, and turn on the parts you want
- [permissions](https://docs.fray.lol/permissions): what drain needs to do each job, and where its role has to sit
- [reading commands](https://docs.fray.lol/reading-commands): what the brackets, flags and aliases in these docs mean

## keeping a server safe

- [antinuke](https://docs.fray.lol/security/antinuke): stops a compromised admin or a hostile bot, punishes them, and rebuilds what they deleted
- [automod](https://docs.fray.lol/security/automod): discord's own rules for invites, links, spam, mentions and word filters, plus the four things they can't see
- [verification](https://docs.fray.lol/security/verification): a captcha between joining a server and seeing it
- [honeypot](https://docs.fray.lol/security/honeypot): a channel nobody should post in, for catching hacked accounts and spam bots
- [moderation](https://docs.fray.lol/security/moderation): warns, timeouts, mutes, jail, bans and purge, each one kept as a case
- [logs](https://docs.fray.lol/security/logs): what happens in your server, posted to the channels you pick

## setting a server up

- [setup](https://docs.fray.lol/server/setup): drain's join post, the three one-press setups under it, and how to post it again
- [language](https://docs.fray.lol/server/language): the language drain answers in, one for the whole server
- [greetings](https://docs.fray.lol/server/greetings): welcome, goodbye, boost, a dm on join, and a join ping that deletes itself
- [birthdays](https://docs.fray.lol/server/birthdays): save your birthday once, and every server that celebrates wishes you on the day
- [auto-replies](https://docs.fray.lol/server/autoresponder): custom commands and auto responders: a word or phrase, and what drain says back
- [embeds](https://docs.fray.lol/server/embeds): post an announcement, a rules card or any message drain draws, and change it later
- [self roles](https://docs.fray.lol/server/selfroles): a panel people pick their own roles from, as a dropdown or as buttons
- [autorole](https://docs.fray.lol/server/autorole): a role for everybody who joins, or just the people, or just the bots
- [voicemaster](https://docs.fray.lol/server/voicemaster): join a channel and get a voice room of your own, with buttons to run it
- [vanity rewards](https://docs.fray.lol/server/vanity): a role for anybody with your server in their status
- [giveaways](https://docs.fray.lol/server/giveaways): entries, requirements, bonus roles, and a draw that still happens after a restart
- [tickets](https://docs.fray.lol/server/tickets): support in a private channel, opened from a panel you set up in chat
- [forums](https://docs.fray.lol/server/forums): a reply under every new post, votes for a suggestions forum, and closed posts that stay closed

## community

- [messages](https://docs.fray.lol/community/messages): live message counts for everybody, and a leaderboard
- [invites](https://docs.fray.lol/community/invites): who brought a member in, and whether they stayed
- [levels](https://docs.fray.lol/community/levels): xp for talking, a level from it, a leaderboard, and roles at a level
- [voice time](https://docs.fray.lol/community/voicetime): how long people spend in voice, a leaderboard, and roles for time spent together
- [music](https://docs.fray.lol/community/music): play songs in voice from a name or a link, with lyrics that follow along and last.fm scrobbling
- [roleplay](https://docs.fray.lol/community/roleplay): sixty-one actions with a gif each, and a count between every two people
- [games](https://docs.fray.lol/community/games): black tea, scramble, fast type, hangman, connect four, tic tac toe, rock paper scissors, minesweeper, dice, and truth or dare
- [rewind](https://docs.fray.lol/community/rewind): what the server was saying on this day, years ago
- [recap](https://docs.fray.lol/community/recap): the last seven days here, counted from what drain already keeps
- [stats](https://docs.fray.lol/community/stats): messages, voice and member growth for the server, drawn from counts drain already keeps
- [snipe](https://docs.fray.lol/community/snipe): the last deleted or edited message in a channel

## looking things up

- [server and member info](https://docs.fray.lol/lookups/info): serverinfo, roles, inrole, avatars, invites and crypto prices
- [name history](https://docs.fray.lol/lookups/names): the usernames and display names somebody has had
- [socials](https://docs.fray.lol/lookups/socials): look people up, unroll links where they're dropped, and follow accounts into a channel
- [last.fm](https://docs.fray.lol/lookups/lastfm): what you're listening to, your top plays as a collage, who knows an artist best here, crowns and taste
- [roblox](https://docs.fray.lol/lookups/roblox): a roblox profile with everything behind one menu, and anybody's friends list
- [ai](https://docs.fray.lol/lookups/ai): chat, images, speech, reading text and translation, free with daily limits
- [tools](https://docs.fray.lol/lookups/tools): quote a message, name a song, transcribe a voice message, screenshot a page

## help

- [faq](https://docs.fray.lol/faq): the questions that come up most
- [voting](https://docs.fray.lol/voting): what a vote does, where to cast one, and what drain keeps
- [tools we like](https://docs.fray.lol/tools): free tools that do what drain doesn't, and work well beside it