ccTickets

# ccTickets **A lightweight, modern, and configurable ticket management plugin for Paper servers.** ccTickets provides a simple way for players to request help and for staff members to manage support tickets directly in Minecraft. With a clean chat-based interface, clickable actions, multilingual support, and SQLite/MySQL storage, ccTickets makes server support easy without unnecessary inventory GUIs. ## Features - **Modern Chat Interface** – Clean, minimalistic messages with clickable actions and hover information. - **Ticket Management** – Create, view, assign, reply to, close, and delete tickets. - **Staff Notifications** – Notify online staff members when a new ticket is created. - **Ticket Teleportation** – Teleport to the location where a ticket was created. - **SQLite & MySQL** – Choose your preferred database system. - **Multilingual Support** – English and German language files included. - **Customizable Messages** – Configure messages, colors, and symbols. - **Permission-Based Access** – Separate permissions for players, staff, and administrators. - **Ticket Limits** – Configure the maximum number of open tickets per player. - **Configuration Reload** – Reload configuration and language files without restarting the server. - **Persistent Storage** – Tickets and replies are stored across server restarts. --- ## Commands ### Player Commands | Command | Description | |---|---| | `/ticket create ` | Create a new support ticket. | | `/ticket list` | View your own tickets. | | `/ticket info ` | View details of your own ticket. | ### Staff Commands | Command | Description | |---|---| | `/tickets` | View all active tickets. | | `/tickets -a` | View all tickets, including closed tickets. | | `/tickets -c` | View closed tickets only. | | `/ticket info ` | View ticket details and available actions. | | `/ticket take ` | Assign an open ticket to yourself. | | `/ticket teleport ` | Teleport to the ticket's saved location. | | `/ticket reply ` | Reply to a ticket. | | `/ticket close ` | Close a ticket. | | `/ticket close -r ` | Close a ticket with a reason. | **Note:** Taking a ticket does not automatically teleport the staff member. Teleportation is handled separately. ### Administrator Commands | Command | Description | |---|---| | `/ticket delete ` | Permanently delete a ticket. | | `/ticket purge -c` | Delete all closed tickets. | | `/ticket purge -a` | Delete all tickets. | | `/cctickets reload` | Reload configuration and language files. | **Note:** Database connections cannot be reloaded through commands. Database configuration changes require a server restart. --- ## Permissions ### Player Permissions | Permission | Default | Description | |---|---|---| | `cctickets.use` | Everyone | Allows players to create and view their own tickets. | ### Staff Permissions | Permission | Default | Description | |---|---|---| | `cctickets.staff` | OP | Allows staff to view, take, reply to, close, and teleport to tickets. | ### Administrator Permissions | Permission | Default | Description | |---|---|---| | `cctickets.admin` | OP | Allows administrators to delete tickets, purge tickets, and reload configuration files. | Permissions can be managed using a permission plugin such as LuckPerms. --- ## Configuration ccTickets includes a customizable `config.yml`. Available settings include: - Language selection (`en` or `de`) - Chat prefix - SQLite or MySQL database - Maximum open tickets per player - Staff notifications ### Language Files Customize messages using: - `plugins/ccTickets/lang/en.yml` - `plugins/ccTickets/lang/de.yml` The plugin includes MiniMessage support for modern text formatting. ### Database Support **SQLite** – Default database, no additional database server required. **MySQL** – Optional database backend for servers using an external database. Database connections are initialized when the plugin starts. --- ## Installation 1. Download the latest ccTickets `.jar` file. 2. Place it inside your server's `plugins` folder. 3. Start or restart your Paper server. 4. Configure `plugins/ccTickets/config.yml` if needed. 5. Assign staff and administrator permissions. 6. Start managing tickets! --- ## Dependencies **No additional plugins are required.** A compatible Paper server is required. SQLite is available as the default storage option; MySQL requires access to a MySQL database server. --- ## Why ccTickets? ccTickets focuses on simplicity, performance, and usability. Players can quickly request help, while staff members can manage tickets using an intuitive chat interface with clickable actions.