> For the complete documentation index, see [llms.txt](https://docs.timecord.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timecord.dev/docs/general/patchnotes.md). # Patchnotes ## Patchnotes #### Update 2.3 (Shifts, Payroll & Gamification) **New commands** * **`/shift`** (premium) - schedule shifts and rosters, assign by role. TimeCord reminds assignees \~15 min before start and flags no-shows in your logs channel after the shift ends. * **`/quota`** (premium) - set weekly/monthly hour targets and run a compliance report. Members on approved leave are excluded. * **`/payrate`** + **`/payroll`** (premium) - set hourly pay per role and export a CSV payroll report (hours x rate, with totals). * **`/promotion`** (premium) - auto-promote members to a role once they reach an all-time-hours threshold. * **`/recap`** (premium) - post a scheduled weekly recap (top trackers and totals) to a channel of your choice. * **`/webhook`** (premium) - push a periodic stats snapshot to an outbound webhook. * **`/sanction`** (premium) - issue, list, pay off and remove sanctions. * **`/audit`** - flag suspicious sessions (implausibly long or stuck open) for review. * **`/break`** - pause and resume your own session; break time does not count. * **`/streak`** - see your current and longest consecutive-day streak and your milestones. * **`/leave`** - request time off; staff approve or deny with buttons. Approved leave excludes you from quota and no-show reports. * **`/stats`** (premium) - a 14-day daily-hours bar chart plus your totals. **Reworked** * **Streaks & milestones.** Members earn milestones for hours tracked (100 up to 5000) and streak length (7, 30, 90, 365 days), updated automatically. See Statistics & Time. * **Automatic clock-out on offline** (optional). TimeCord can clock a member out when they go offline in Discord. It is off by default and needs the bot operator to enable presence tracking. * **French.** TimeCord is now available in French; switch with `/language fr`. **Under the hood** * All background jobs (shift reminders, no-show checks, streaks, auto-promotion, recap, webhook) are failure-isolated, so one hiccup can never crash the bot. * Every channel message now has a delivery safeguard: if the bot is missing access to a channel, it warns the server admins instead of failing silently. * Session clock-in/out is fully atomic, so rapid double-clicks can never double-count or double-open a session. {% hint style="info" %} Running your own dashboard or integration against the database? See the developer handoff for the new config fields (`quotas`, `payRates`, `promotions`, `recap`, `webhook`) and the new `timecord_shifts` / `timecord_leave` collections. {% endhint %} *** #### Update 2.2 (Reliability & Payroll) **New** * **`/export`** (premium) - download a CSV of every employee's daily, weekly, monthly and all-time hours, ready for payroll. * **`/timezone`** - set the timezone used to group daily, weekly and monthly stats, so totals match your team's calendar. See Statistics & Time. * **`/tracking list`** - a paginated list of every hired employee, on-duty members first. **Reworked** * **`/leaderboard`** is now paginated, so it works on large servers. * **Warnings expire automatically.** Expired warns stop counting and are cleaned up; `/info` and `/warn show` only show active ones. * **Automatic clock-out** for forgotten shifts. Enable it in the dashboard to close sessions that stay open too long. * **Correct weekly and timezone-aware stats.** Weekly totals now honor your configured week start, and all stats are grouped in your chosen timezone. * **Full localization.** English and German are both complete; switch with `/language`. **Under the hood** * Major dependency update (discord.js, database driver, Stripe) and a large reliability pass: the bot now rides out brief database hiccups instead of restarting, shuts down cleanly, and no longer re-registers commands on every start. * Long-term storage for old sessions keeps profiles fast without losing any all-time totals. * A permanent audit log records every administrative action, even if the Discord log channel is deleted. {% hint style="info" %} Running your own dashboard or integration against the database? See the developer handoff for the schema changes in this update. {% endhint %} *** #### Update 2.1 (TimeCord Release) **Breaking Changes** **Ranks** - Introducing the new rank system, see Ranks. **Settings** - A new dashboard page where you can change, edit and configure your bot as you like. **Command Settings** - You can now configure every command. Go to **Settings → Commands** to enable/disable commands and choose whether only permitted users may use them. **Autoroles** - Configure autoroles under **Settings → General**. If a user gains the specified role they are hired, and if the role is removed they are dismissed. **Bot Changes** See Commands for detailed explanations. ``` Legend - -> REMOVED + -> ADDED % -> REWORKED Updates + /weekstart -> Manage when a week resets + /leaderboard -> See top times + /timerequest -> Request a timechange % /overview -> Fixed a known display bug % /employee -> Fixed localization bugs % /info -> Added rank display % /time -> Reworked how time is added to a user ``` *** #### Update 2.0 **Breaking Changes** **Discord API v10** - Updating to discord.js v14 moves us to Discord API v10. **TypeScript** - The bot was rewritten in TypeScript for type safety and cleaner error handling. **Localization** - TimeCord now supports multiple languages, starting with German (`de`) and English (`en`). Want to add a language? Open a ticket. **Payments & Subscriptions** - TimeCord uses a subscription model (monthly and yearly), and keeps one-time purchases (a 3-month option and a Lifetime one-time purchase). **Performance & Sharding** - Commands, events and APIs were reworked for a large performance gain, and Discord sharding prerequisites are in place for future scaling. **Script Support** - Script support for FiveM (Lua) is available, with RageMP and AltV in development. See Script. **Bot Changes** ``` Legend - -> REMOVED + -> ADDED % -> REWORKED Updates + /tracking -> Manage general tracking + /language -> Change language + /role -> Bulk operations - /delwarn -> Moved to /warn - /warns -> Moved to /info - /einstellenall -> Moved to /role - /erfassungsstop -> Moved to /tracking - /pinfo -> Moved to /info - /setup -> Setup moved to dashboard - /resetup -> Setup moved to dashboard - /stempelnachricht -> Added to /tracking - /weekreset -> Statistics are now managed automatically % /overview -> See all stamped members % /employee -> Manage employees % /info -> Displays information about a user % /time -> Manage time from users ``` Setting up the bot is now done in the dashboard.