Roleplay Hub

The Roleplay hub groups faction tools in one place: Events, the city faction list, Service IDs, Phone numbers, Warehouse, Absences, Applications, Exams, Faction treasury, Time clock, and Personnel.

They do not appear in the general Modules list. Open Dashboard → your server → Roleplay and pick a tool from the sub-navigation.

Each area has its own enable toggle inside the hub. The bot only runs a feature when that toggle is on.

1. Sign in at lio.gg and open Dashboard.
2. Select your server.
3. Click Roleplay in the sidebar (desktop) or bottom bar (mobile).
4. Pick a tool from the sub-nav: Events, Factions, Service IDs, Phone numbers, Warehouse, Absences, Applications, Exams, Faction treasury, Time clock, or Personnel.

Pre-configured templates (e.g. 40er, Bizwar) with registration panels, participant slots, and manual payouts. No killscreen AI.

Automatic templates follow a weekly schedule; manual templates are started from the dashboard when you are ready.

1. Roleplay → Events → pick a template → Configure.
2. Enable the event, set the registration channel, and adjust payout fields.
3. Save: the Events module is enabled automatically if it was off.
4. For manual events: click Start registration now to post the CV2 panel in Discord.
5. Staff close registration, enter kills/bonus fields per participant, then complete the event for payout totals.

• checkRegistration uses Components V2 buttons. Members register and unregister in Discord.
• check/event start <template>: slash command alternative for manual starts (Manage Server).
• checkPremium-only templates are marked in the overview table.

A live city faction list with categories, build protection, a trial period, and faction warnings. The list in Discord is display-only. You manage factions in the dashboard or with slash commands. Every change is posted to the log channel you set.

1. Roleplay → Factions: enable the toggle.
2. Set the list channel, the change log, and the manager roles. Manage Server always counts.
3. Add categories, then a faction, build protection, and a trial period.
4. The list message refreshes when something changes.

• check/frakadd creates a faction. /frakedit changes name, category, emoji, lead, deputy, note, protection, or trial.
• check/frakoffiziell marks a faction official and sets the lead.
• check/frakaufloesen dissolves a faction with a reason. /frakdelete removes it from the list.
• check/frakwarn adds a warning that stays on the faction. /frakentwarnen removes one.

Live directory panel with register/unregister buttons. Members submit a service number via modal; editors can remove entries.

Optional auto-nickname and department panels depending on your config fields.

1. Roleplay → Service IDs: enable the module toggle.
2. Set the directory channel, title, and description.
3. Configure editor roles and optional nickname sync.
4. Resend panel from the sidebar preview to post or refresh the Discord message.

• checkPlus panel draft: customize banner/layout; entry list and buttons are injected by the bot.
• checkDirectory refreshes when entries change.
• check/dienst-panel refreshes the directory message after you change the channel or the draft.

RP inventory tracking with categories, items, and a live CV2 stock panel.

Staff manage structure in the dashboard designer; members adjust quantities via chat commands in the warehouse channel.

1. Roleplay → Warehouse: enable the module.
2. Set the warehouse channel.
3. Create categories and items in the inventory designer.
4. Sync/resend the panel to Discord.

• checkChat commands: +amount itemname or -amount itemname in the warehouse channel.
• checkPanel draft (Plus): customize warehouse panel layout.
• checkNegative stock may be blocked by minimum quantity rules.

Members submit absence requests via panel button → modal (from/to, reason). Staff approve or reject; optional absent role on approval.

A return / back button lets members end an absence early.

1. Roleplay → Absences: enable the module.
2. Set request channel and approver roles.
3. Optional: absent role applied on approve.
4. Resend panel to Discord.

• checkSubmit → pending until staff acts.
• checkApprove → role applied until return or end date.
• checkReject → user notified via ephemeral response.
• checkRequire approval: when off, submissions may auto-approve if configured.
• check/abmelden submits an absence from chat as well as from the panel.

A live phone book with buttons. Members with an editor role add a name and number in a modal, or remove themselves from a dropdown. The book refreshes on its own.

1. Roleplay → Phone numbers: enable the toggle.
2. Set the directory channel, title, and editor roles.
3. Resend the panel so the buttons appear in Discord.
4. /telefon-panel refreshes the phone book after you change the channel or the draft.

Up to 10 application forms, each with its own panel, review channel, role pings, and an employee file.

Accepted applicants can receive roles, and a service ID can be assigned automatically.

1. Roleplay → Applications: enable the toggle.
2. Create a form, set the panel channel and the review channel.
3. Set reviewer roles and the roles granted on accept.
4. Post the panel. New submissions land in the review channel.

Members pick an exam in a channel. Lio asks the questions in direct messages and posts the result, with duration and user details, to the log.

1. Roleplay → Exams: enable the toggle.
2. Set the selection channel and the result log.
3. Add questions to each exam in the dashboard.
4. Save. The selection menu is posted in the channel.

A faction balance with deposits, withdrawals, an audit log, and automatic credit when an event pays out.

1. Roleplay → Faction treasury: enable the toggle.
2. Set the treasury channel and the manager roles that may book money.
3. Resend the panel. Event payouts can credit the same book when that link is configured.

Members clock in and out. An optional hourly confirmation runs in a private thread. Role-based pay can be written into the treasury.

1. Roleplay → Time clock: enable the toggle.
2. Set the panel channel, manager roles, and hourly rates per role.
3. Optional: a ping channel and the hourly confirmation toggle.
4. Choose the leaderboard window: 7 days, 30 days, or all time.

Hiring posts an embed when a member moves from a standard role to a starter role. Promotion and demotion follow the Discord role list: higher in the list is the higher rank.

Termination, by command or by a form in the channel, applies a fixed terminated role, can strip faction roles, reset the nickname, and post an embed you can edit.

1. Roleplay → Personnel: enable the toggle.
2. Set the personnel log, HR roles, the terminated role, and faction roles to remove.
3. Set standard roles and starter roles so a hire is detected from the role change.
4. Optional: add the service ID to the blacklist on termination.
5. /kuendigung submits a resignation. /verwarnung warns one or more members. /verwarnungen lists or deletes personnel warnings.

• checkManage Server: configure all Roleplay areas in the dashboard; start manual events via slash command.
• checkBot needs Send Messages, Embed Links, and Manage Messages in configured channels.
• checkBot role must be above roles it assigns (absent role, event roles, etc.).
• checkService ID editors need the configured editor role to remove other members' entries.

• checkFeature does nothing → enable its toggle in the Roleplay hub, not only save config.
• checkEvents panel missing → event enabled, channel set, Events module on (save/start enables it).
• checkPanel outdated → use Resend panel / Sync panel in the embed sidebar.
• checkButtons inactive → bot online; correct channel permissions; module enabled.
• checkWarehouse commands ignored → message must be in the configured warehouse channel; check item name spelling.