Takaro module library

Takaro Modules

Takaro is a game server management platform for running, automating, and moderating multiplayer communities. These modules install into Takaro to add server automation, Discord workflows, economy systems, and moderation tools.

SVMSeasonalRanking

by SVMOTNIK
for 7 Days to Die
This Takaro module acts as an automated seasonal leaderboard system for 7 Days to Die servers that posts ranking stats directly to Discord.
Use this module to:
  • Rank the top 8 players across zombie kills, levels, scores, session lengths, playtime, and deaths.
  • Update one persistent Discord leaderboard message on a schedule.
  • Store seasonal playtime in dedicated Takaro variables separate from lifetime playtime.
  • Reset seasonal stats without wiping total player history.
Good fit for 7 Days to Die servers that run seasonal wipes, events, or competitive cycles.
Old name: Ranking Sezonowy.
communityTakaro 0.7.3

Components Overview

1
config
0
commands
0
hooks
1
Cron Jobs
0
functions
0
permissions

Configuration

Configure this module using the schemas below. The JSON schema defines the data structure, while the UI schema customizes how the configuration form is displayed.

Configuration Schema

Configuration Properties (2)

discordChannelId*string
Discord Channel ID

The Discord channel ID where seasonal leaderboards will be posted.

Constraints: minLength: 17, maxLength: 20
cronIntervalMinutesinteger
Cron interval minutes

How many playtime minutes to add per leaderboard cron tick. Keep this aligned with the cron schedule.

Default: 5
Constraints: min: 1, max: 60

UI Schema

No configuration properties defined. This module uses default settings.

About Configuration Schemas

The Configuration Schema defines the structure and validation rules for module settings. The UI Schema customizes how the configuration form is displayed in the Takaro interface, including field ordering, labels, and input types.

Scheduled Jobs (1)

These jobs run automatically on a schedule defined by cron expressions. Each job executes JavaScript code at specific times or intervals.

updateLeaderboards

*/5 * * * *Schedule

Description

Runs every hour at minute 55 to collect player stats and update leaderboards

Schedule Details

Cron Expression
*/5 * * * *
Human-Readable Schedule

Every 5 minutes

Function Implementation

updateLeaderboards Function

JAVASCRIPT

Cron Expression Format

minute hour day-of-month month day-of-week

Each field can contain numbers, ranges (1-5), lists (1,3,5), or wildcards (*). Use */n for intervals (e.g., */5 for every 5 units).

About Scheduled Jobs

Cron jobs allow your module to execute code automatically on a schedule. Each job has a cron expression that defines when it runs, and a JavaScript function that executes at those times. Jobs run server-side and can perform maintenance tasks, send notifications, or update game state automatically.