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.

blood-moon-countdown

by Takaro
for 7 Days to Die
7 Days to Die helper commands that tell players how many in-game days remain until the next blood moon/horde night using live server time.
communityTakaro 0.0.0

Components Overview

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

New Module: blood-moon-countdown

NEW
July 8, 2026
Updated to version latest. Added 2 commands: bloodmoon, day7. Added 1 function: blood-moon-helpers. New configuration options: hordeIntervalDays, firstHordeDay, timeConsoleCommand, responseTemplate, hordeTodayText, daysUntilText, parseErrorMessage, includeConsoleOutputInLogs.

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)

hordeIntervalDaysinteger

How often blood moon/horde night happens, in in-game days. Vanilla is every 7 days.

Default: 7
Constraints: min: 1
firstHordeDayinteger

The first blood moon day in the cycle. Vanilla is day 7.

Default: 7
Constraints: min: 1
timeConsoleCommandstring

Console command used to read current 7D2D game time. The output must include the current day, such as 'Day 12'.

Default: gettime
Constraints: maxLength: 80
responseTemplatestring

Player response template. Supports {currentDay}, {nextHordeDay}, {daysUntil}, {daysUntilText}, {interval}, {firstHordeDay}, and {source}.

Default: Blood moon: Day {nextHordeDay}. Current day: {currentDay}. {daysUntilText}.
Constraints: maxLength: 300
hordeTodayTextstring

Text used for {daysUntilText} when the next horde day is today.

Default: Blood moon is tonight
Constraints: maxLength: 120
daysUntilTextstring

Text used for {daysUntilText} when the horde is in the future. Supports {daysUntil}.

Default: {daysUntil} day(s) remaining
Constraints: maxLength: 120
parseErrorMessagestring

Player-facing message when console time parsing fails.

Default: I couldn't read the current game day. Ask an admin to check the blood-moon-countdown module config a...
Constraints: maxLength: 300
includeConsoleOutputInLogsboolean

Log the raw console output when parsing fails. Useful while tuning timeConsoleCommand.

Default: true

UI Schema

No UI schema defined. Configuration form will use default rendering.

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

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

bloodmoon

/bloodmoonTrigger Command

Description

Usage: /bloodmoon — shows current day, next horde day, and days remaining.

Function Implementation

bloodmoon Function

JAVASCRIPT

Usage Example

Player types: /bloodmoon

day7

/day7Trigger Command

Description

Usage: /day7 — shows how many days remain until the next blood moon/horde night.

Function Implementation

day7 Function

JAVASCRIPT

Usage Example

Player types: /day7

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.

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.

blood-moon-helpers

functionReusable Component

Function Implementation

blood-moon-helpers Function

JAVASCRIPT

Import Usage

Import: import { blood-moon-helpers } 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.