DiscordTickets/README.md

> **Warning**
> 
> This is the development branch, it may be unstable and may not work as expected.
> 
> *dev notes:*
> - https://static.eartharoid.me/k/22/08/02185801.png - for user/create, slash/force-close, slash/claim, slash/release, and slash/move
> - menu question max length cannot be higher than question options 
> - ports <1024 require root
> - TODO: update notifications
> - TODO: user:create, force-close
> - **likely to be rate limited by discord**: 
> 
> [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/eB6TkX?referralCode=Z3aYd2) 



<div align="center">

![bots](https://img.shields.io/badge/dynamic/json?color=5865F2&label=bots&query=clients.total&url=https%3A%2F%2Fstats.discordtickets.app%2Fapi%2Fv3%2Fcurrent&logo=discord&logoColor=white&style=for-the-badge)
![tickets](https://img.shields.io/badge/dynamic/json?color=5865F2&label=tickets&query=tickets&url=https%3A%2F%2Fstats.discordtickets.app%2Fapi%2Fv3%2Fcurrent&logo=discord&logoColor=white&style=for-the-badge)
[![GitHub stars](https://img.shields.io/github/stars/discord-tickets/bot?style=for-the-badge)](https://github.com/discord-tickets/bot/stargazers)
[![Codacy](https://img.shields.io/codacy/grade/b974eb5f984c40868e07d82c968bd02d?logo=codacy&amp;style=for-the-badge)](https://www.codacy.com/gh/discord-tickets/bot/dashboard)
[![All Contributors](https://img.shields.io/github/all-contributors/discord-tickets/bot?color=ee8449&style=for-the-badge)](https://github.com/discord-tickets/bot/blob/main/CONTRIBUTORS.md)
[![Discord](https://img.shields.io/discord/451745464480432129?label=discord&amp;color=7289DA&amp;style=for-the-badge)](https://lnk.earth/discord)

<br>

![Discord Tickets](https://static.eartharoid.me/discord-tickets/logo/wordmark/gradient-by-eartharoid.png)

**A free alternative to the premium and white-label plans of other ticket management bots.**

<br>
<a
  href="https://www.producthunt.com/posts/discord-tickets?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-discord&#0045;tickets"
  target="_blank">
<img
	src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=321112&theme=light"
	alt="Discord&#0032;Tickets - A&#0032;free&#0032;ticketing&#0032;solution | Product Hunt"
	style="width: 250px; height: 54px;"
	width="250"
	height="54"
  />
</a>

<br>

---

[![PebbleHost](https://img.eartharoid.me/insecure/rs:auto:180/plain/s3://eartharoid/sharex/21/10/pebblehost.webp)](https://pebble.host/discordtickets)

<a href="https://pebble.host/discordtickets">Partnered with PebbleHost</a>
<br>
<sub>for affordable bot hosting</sub>

---

<br>
</div>

## 📖 Contents

- [📖 Contents](#-contents)
- [✨ Features](#-features)
  - [Want to learn more?](#want-to-learn-more)
- [⚡ Getting started](#-getting-started)
- [🤑 Sponsors](#-sponsors)
- [🎖️ Contributors](#️-contributors)
  - [💻 Contributing](#-contributing)
    - [🌎 Translating](#-translating)
- [😕 Support](#-support)
- [⭐ Star History](#-star-history)
- [🥱 License](#-license)


## ✨ Features

- 📖 [**Documentation**](https://discordtickets.app/getting-started/) - comprehensive documentation and guides to help you get started
- ⚙️ **Simple settings** - configure your bot with the included and easy-to-use dashboard
- 🎨 **Highly customisable** - tweak features, colours, messages, and more to your liking
- 🛸 **Modern features** - including slash commands, buttons, select menus, and modals
- 🤖 **Automation** - ease your staff team's workload with configurable automation
  - 🏷️ [**Tags**](https://v4--discordtickets.netlify.app/features/#tags) - resolve members' problems without escalating to tickets
  - 🎫 **Tickets** - close inactive tickets automatically
- 📜 **Archiving** - store messages in the database and view transcripts later
- ❓ **Context** - ask for a topic or up to 5 custom questions before creating a ticket, and see references to a message or previous ticket at a glance
- 🗃️ **Organisation** - claim, release, move and transfer tickets between members and categories
- 🌎 [**Internationalisation**](#-translating) - available in more than 10 languages
- ⏱️ **Statistics** - analyse your staff members' performance
- 🪓 **Battle-tested** - trusted by thousands of servers, with over [half a million tickets](https://stats.discordtickets.app/) created since 2019
- 🐳 [**Docker**](https://discordtickets.app/self-hosting/installation/docker/) - reliable and quick deployment with Docker

[*...and more!*](https://discordtickets.app/features/)

### Want to learn more?

**Visit [the website](https://discordtickets.app/) for more features, details, and screenshots**,
or skip to the [full feature tour](https://discordtickets.app/features/).

## ⚡ Getting started

> *🙏 Please read the [documentation](https://discordtickets.app/self-hosting/installation/) before you start.*

There are 3 ways to get started with Discord Tickets:

- ☁️ [Add the public bot](https://discordtickets.app/public/) - instant setup, but branded *(great for testing)*
- 😴 [Get a managed bot](https://discordtickets.app/managed/) - your own bot, hosted by me *(easy and cheap)*
- 🧑‍💻 [Install your own bot](https://discordtickets.app/self-hosting/) - host it yourself *(experience recommended)*

**[Read the documentation](https://discordtickets.app/getting-started/)** for more information.

> **Warning**
> This button is here because it looks nice, but I will cry if you click it before reading the [documentation](https://discordtickets.app/getting-started/). :)

[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/eB6TkX?referralCode=Z3aYd2)

<!-- [![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/discord-tickets/bot) -->

## 🤑 Sponsors

Discord Tickets is made possible by these awesome people and organisations:

![Sponsors](https://cdn.jsdelivr.net/gh/eartharoid/sponsors/sponsorkit/sponsors.svg)

Please consider sponsoring the project if it adds value to your business/community.

**[Sponsor on GitHub](https://github.com/discord-tickets/bot/?sponsor=1)**, or

[![Donate at ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/eartharoid)

> **Note**
>
> Your logo will only appear here if you sponsor through GitHub Sponsors.
> 
> [Create an organisation](https://github.com/account/organizations/new?plan=free) if you want to use your business/community logo.

## 🎖️ Contributors

<!-- [![Contributors](https://contrib.rocks/image?repo=discord-tickets/bot)](https://github.com/discord-tickets/bot/graphs/contributors) -->

Discord Tickets is made possible by all of the people listed in [CONTRIBUTORS.md](https://github.com/discord-tickets/bot/blob/main/CONTRIBUTORS.md).


### 💻 Contributing

If you want to help translate, suggest a feature, submit a bug report,
or contribute in any other way, please read the [contributing guidelines](https://github.com/discord-tickets/.github/blob/main//CONTRIBUTING.md).

> **Note**
> You can add yourself to the list of contributors [here](https://github.com/discord-tickets/bot/issues/new/choose).

#### 🌎 Translating

[![Translation status](https://hosted.weblate.org/widgets/discord-tickets/-/open-graph.png)](https://hosted.weblate.org/engage/discord-tickets/)

## 😕 Support

[![Discord](https://discordapp.com/api/guilds/451745464480432129/widget.png?style=banner4)](https://lnk.earth/discord)

## ⭐ Star History

<details>
  <summary>Show graph</summary>
  
  [![Star History Chart](https://api.star-history.com/svg?repos=discord-tickets/bot&type=Date)](https://star-history.com/#discord-tickets/bot&Date)

</details>

## 🥱 License

Discord Tickets by eartharoid™️ is licensed under the [GPLv3 license](https://github.com/discord-tickets/bot/blob/main/LICENSE).

This is not an official Discord product. It is not affiliated with nor endorsed by Discord Inc.

© 2023 Isaac Saunders