# modl – support & moderation reimagined
\nStreamline administrative duties with AI, dynamic punishments, and a slick web-interface.<\/p>\n
### Description
\nmodl is a modern solution to completely streamline moderation and support for your Minecraft server. The system is fully customizable, free to use, and open-sourced under the AGPL-3.0 license. Stay in control of your server from anywhere with our web-interface at https:\/\/modl.gg. Use AI to automatically handle chat reports. Simplify punishments through dynamic punishment types powered by points and severities.<\/p>\n
**Free forever** and completely branded for your server – your players and staff will not see any modl.gg branding (assuming you enable custom domain).<\/p>\n
modl can run natively on **Spigot, PaperSpigot, Folia, BungeeCord, and Velocity**, without feature degradation on any platform.<\/p>\n
Fully free & source repositories | Support Discord Server | Locale File | Config File <\/p>\n
## Features
\n#### 3rd Iteration Punishment System
\nDesigned to fairly and consistently sanction players whilst maintaining moderator discretion.<\/p>\n
– Fully customizable **point system** to designate low, medium, and habitual designations for both Gameplay and Social offenses
\n– Fully customizable punishment durations for each **severity** (lenient, normal, severe) and each **offender status** (low, medium, habitual)
\n– Issue punishments for bad usernames and skins that **automatically pardon** when a player changes his\/her skin\/username.
\n– Ability to make a ban “stat-wiping” that issues a command on the server upon _expiration_ to reset stats (not executed when pardoned or cancelled)
\n– Full modification system for **changing durations** and **pardoning** (remove points)
\n– Full evidence system for **uploading files** and linking to other sites (YouTube, Imgur, etc)
\n– 8-char alphanumeric ID system for streamlined appeal system, staff see all punishment details and can pardon\/change duration without leaving the page. **Customize** the appeal page for each different punishment type
\n– Bans on offline players wait until a successful login to start the expiration countdown.
\n– Stack multiple bans\/mute that execute **consecutively** (one after the other becomes inactive) – start time is when the player attempts to login unimpeded by other bans\/mutes.
\n– Traditional, manual punishments also exist (ban, tempban, mute, tempmute, kick, blacklist)
\n– Import all bans, mutes, and player data (IPs) from **LiteBans** seamlessly<\/p>\n
\n<\/p>\n
#### Full Player Profiles and Smart Alt-account Linking<\/p>\n
– See player info (playtime, session details, country), notes, history, alts, reports in sleek in-game and web UIs (windows for many open players on web).
\n– **Link accounts** that have the same non-proxy IP logins OR have the shared proxy logins within 2 hours of each other. This system tracks logins even if denied by a banned screen, allowing you to link accounts whenever a **bad actor** screws up and attempts to login on a banned account (to check) before logging into their ban evading account.
\n– Handle each linked ban **independently**- was there a mistake? Public internet or sibling? Easily handle the linked ban on a specific account without changing the initial ban.
\n– Linked bans expire when the original ban expire automatically.<\/p>\n
\n<\/p>\n
#### Elegant, Efficient Player Reporting<\/p>\n
– Automatically **snapshot** full context chat-logs when someone is chat-reported.
\n– Allow players to **upload files** or link external evidence to all reports.
\n– Issue punishments from reports without leaving the ticket page.
\n– Link tickets to punishments that will auto-close the ticket and send a response letting the reporter know the offender was punished. Also can be used as evidence when hooked up to modl-anticheat-bridge (Anti-cheat automatically creates reports based on flags)
\n– You can sort online players by number of reports to identify potential rule breakers across your network.<\/p>\n
\n<\/p>\n
#### Full Audit and Analytics System<\/p>\n
– Audit and **rollback** any staff punishment actions.
\n– See statistics on average ticket response times and **staff activity** (ticket responses, punishments issued, etc)
\n– See **trends** for different types of punishments and ticket data.
\n– Manage all files uploaded (evidence, ticket attachments): easily view, search, filter, delete, and download all files.<\/p>\n
\n<\/p>\n
#### Smart AI Chat Moderation<\/p>\n
– To not pester players and use excessive tokens, AI chat moderation **only scans messages that are chat-reported**. This is the most effective way of moderating chat as current systems that analyse all messages issuing auto-mutes are incredibly annoying for players and expensive.
\n– Constantly evolving system prompts to improve **accuracy** of AI auto-mod, is context-aware of Minecraft (e.g: “i’m going to kill you with a fireball” is a game term, not an IRL death threat).
\n– Configure AI to look for specific things and execute punishments **automatically** or make suggestions for staff approval.<\/p>\n
<\/p>\n
#### Support One-Stop-Shop: Use **your own domain** (recommended: support.yourserver.com)<\/p>\n
– **Fully customizable** knowledgebase homepage with logo, external link, and sections
\n– Searchable markdown article support, write **your** rules, guidelines, and support articles with ease.
\n– Create fully **custom forms** for bug reports, support tickets, and staff applications: reveal hidden sections based on answer to multiple-choice questions.
\n– Customizable **quick-response buttons** to significantly streamline efficiency and keep responses consistent.
\n– Send in-game and email **notifications** for when staff respond to a player’s ticket.
\n– We use browser cookies to verify that responses in tickets are the same as the initial responder.
\n– Staff members are automatically **subscribed** to tickets they respond in and can easily track updates to those tickets in their home feed.<\/p>\n
<\/p>\n
#### Professional Interface<\/p>\n
– Invite your staff team and fully customize their **roles** and permissions (permission nodes for each punishment type)
\n– Set each staff member’s Minecraft account so that permissions and punishments are **synced** between panel and in-game.
\n– Make modl yours: upload a custom logo, favicon, homepage image, and set your custom domain.
\n– Everything is fully **customizable**, from Minecraft plugin locale to ticket forms and punishment types.<\/p>\n
<\/p>\n
### Requirements
\n1. Java 8+
\n2. Working internet connection
\n3. Any version Spigot, PaperSpigot, Folia, BungeeCord, or Velocity<\/p>\n
### Installation
\n1. Register your server at https:\/\/modl.gg
\n2. Go to your panel’s settings and find your API key under “Server & Billing” **>** “Server Config”.
\n3. Drop **modl-(version).jar** into your \/plugins directory (Install on all Spigot servers and your proxy if you run a network. Run Spigot modl instances in bridge mode if so.)
\n4. Restart your server and wait for **\/plugins\/modl\/config.yml** to generate, once it does input your API key and panel URL then restart
\n5. Done!<\/p>\n
**Showcase & Installation Video (outdated – view docs installation guide):**