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.

dailyRewardsItems

by Limon
Give players daily item rewards with streaks, milestones, and configurable chances. This module supports player retention by turning repeat visits into a predictable reward loop.
Use this module to:
  • Configure daily claim rewards and bonus milestones.
  • Encourage players to return across multiple days.
  • Tie reward behavior to Takaro commands and server inventory actions.
communityTakaro v0.0.21
(2 versions available)

Components Overview

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

New Module: dailyRewardsItems

NEW
August 6, 2025
Updated to version 2.0.0. Added 3 commands: streak, daily, topstreak. Added 1 hook: dailyLoginCheck (player-connected). Added 1 function: utils. New permissions: DAILY_CLAIM, DAILY_REWARD_MULTIPLIER. New configuration options: baseReward, maxStreak, milestoneRewards, possibleItems, itemChance, useStreakMultiplier, streakMultiplierValue, maxItemChance.

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 (8)

baseReward*number
Base Reward

Base amount of currency given for daily rewards. This is multiplied by streak level.

Default: 100
Constraints: min: 1
maxStreak*number
Maximum Streak

Maximum streak level a player can reach

Default: 365
Constraints: min: 1
milestoneRewards*array
Milestone Rewards

Additional rewards for reaching certain streak milestones

Default:Array of 5 items
days:7
reward:1000
message:"You did it! 7 days in a row!"
days:30
reward:5000
message:"A whole month! You're on fire!"
... and 3 more items
possibleItemsarrayitem
Possible Items

Items that can be randomly awarded as daily rewards

Default: [] (empty array)
Constraints: uniqueItems
itemChancestring
Base Item Chance

Base chance to receive an item (1-100)

Default: 25
Constraints: minLength: 1, maxLength: 100
useStreakMultiplierboolean
Use Streak Multiplier

Increase the item chance based on player streak

Default: false
streakMultiplierValuenumber
Streak Multiplier Value

How much to increase item chance per streak day (e.g. 0.5 = +0.5% per day)

Default: 0.5
Constraints: min: 0
maxItemChancenumber
Maximum Item Chance

Cap for total item chance after streak multiplier (1-100)

Default: 95
Constraints: min: 1, max: 100

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.

Commands (3)

These commands can be executed by players in-game. Each command has a trigger word, optional arguments, and executes JavaScript code on the server.

streak

/streakTrigger Command

Description

Check your current daily reward streak and next claim time

Function Implementation

streak Function

JAVASCRIPT

Usage Example

Player types: /streak

topstreak

/topstreakTrigger Command

Description

Shows the players with highest daily reward streaks

Arguments (1)

count
numberPosition 0
Help: Number of players to show (max 25)
Default: "5"

Function Implementation

topstreak Function

JAVASCRIPT

Usage Example

Player types: /topstreak <count>

daily

/dailyTrigger Command

Description

Claim your daily reward

Function Implementation

daily Function

JAVASCRIPT

Usage Example

Player types: /daily

About Module Commands

Commands allow players to interact with your module through chat. Each command has a trigger word that players type (prefixed with /), optional arguments for parameters, and a JavaScript function that executes when the command is used. Arguments are automatically validated and passed to the function.

Hooks (1)

These hooks respond to various game events automatically. Each hook executes JavaScript code when its specific event type occurs, allowing modules to react to player actions, system changes, and more.

Real-time Events

1 hook

dailyLoginCheck

player-connectedEvent Type
Function Implementation

dailyLoginCheck Hook Function

JAVASCRIPT
Event Details
Event Type:player-connected
Trigger:Automatic
Category:Real-time Events

About Module Hooks

Hooks allow your module to respond automatically to game events like player actions, server status changes, and chat messages. Each hook has an event type that determines when it triggers, optional regex patterns for filtering specific events, and a JavaScript function that executes when the conditions are met. Hooks are grouped by category for better organization.

Functions (1)

Reusable JavaScript functions that can be imported and used by other module components like commands, hooks, and cron jobs. These promote code reuse and modularity.

utils

functionReusable Component

Function Implementation

utils Function

JAVASCRIPT

Import Usage

Import: import { utils } from './utils';

About Module Functions

Functions are reusable JavaScript components that can be imported and used by commands, hooks, and cron jobs within your module. They promote code reuse, improve maintainability, and allow you to organize complex logic into modular pieces. Functions must be exported with proper ES6/CommonJS syntax to be importable by other components.

Permissions (2)

These permissions control who can access different features of this module. Administrators can assign these permissions to roles, allowing fine-grained access control.

General Permissions

2 permissions

Claim Daily Rewards

DAILY_CLAIMPermission Key
Description

Allows the player to claim daily rewards

Permission Details
Full Key:DAILY_CLAIM
Can Have Count:No
Category:General

Multiplier

DAILY_REWARD_MULTIPLIERPermission KeyCountable
Description

Control the multiplier per role. This is useful to give your donors a little extra. Count is an integer multiplier.

Permission Details
Full Key:DAILY_REWARD_MULTIPLIER
Can Have Count:Yes
Category:General
Countable Permission

This permission supports numeric values/levels. For example, you could grant someone "10" of this permission to limit their usage or set permission levels.

About Module Permissions

Permissions control access to module features and functionality. Each permission has a unique key for identification, a friendly name for display, and a description explaining what it allows. Some permissions are countable, meaning they can have numeric values or limits assigned. Administrators assign these permissions to user roles to control who can use different module features.