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.

RegionResetRandomiser

by TrevorJD
Randomize 7 Days to Die region resets from Takaro so admins can refresh parts of the map without wiping the whole server. RegionResetRandomiser helps keep resources available, reduce stale areas, and schedule map maintenance through an automated workflow.
Use this module to:
  • Select map regions for reset on a configurable schedule.
  • Preserve the broader world while refreshing targeted areas.
  • Reduce manual region-reset work for 7 Days to Die admins.
  • Coordinate reset behavior through Takaro hooks and cron jobs.
Good fit for 7 Days to Die communities that need periodic map-region maintenance, resource renewal, or controlled world cleanup between full wipes.

Module details

Trevor_RegionResetRandomiser: Map Region Reset Manager

The Trevor_RegionResetRandomiser module provides an intelligent solution for 7 Days to Die servers to maintain fresh gameplay experiences through automated region resets. This advanced Takaro module works with CPM to randomly select and reset map regions on a configurable schedule.

Key Benefits:

  • Reset Regions: Keeps the game world fresh with renewed resources in selected areas
  • Performance Optimization: Targeted resets help maintain server performance
  • Balanced Gameplay: Prevents complete resource depletion while preserving player builds
  • Selective Regeneration: Only resets a configurable subset of regions
  • Administrator Control: Allows manual triggering via Discord commands

Features:

  • Configurable number of regions to reset at each interval
  • Automatic daily region reset via cron job scheduling
  • Manual reset capability through Discord commands
  • Permission-based control with authorized user list
  • Custom activation phrase for manual triggering
  • Detailed debug logging to Discord channels
  • Smart region selection algorithm
  • Error handling for various edge cases
  • Unicode support for international player names
  • Timestamp logging for audit trails
Requires Prisma501's CPM mod for 7 Days to Die. Ideal for long-running servers that need region resets without full map resets.
communityTakaro main

Components Overview

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

New Module: RegionResetRandomiser

NEW
August 6, 2025
Updated to version latest. Added 1 hook: randomiseResetRegions (discord-message). Added 1 scheduled task: randomiseResetRegions. New configuration options: resetQuantity, debugChannel, authorisedPlayer, activationPhrase, sendDebugMessages.

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

resetQuantity*number
resetQuantity

(Required) Specify the number of regions to randomly selected for reset. Must be fewer than the total number of flagged regions.

Default: 5
debugChannelstring
debugChannel

(Optional) Supply a discord channel ID to receive debug activity messages.

Default:
authorisedPlayerstring
authorisedPlayer

People authorised to manually execute the hook via the discord debugChannel. Separate with commas. e.g.: Trevor, Barry, John Tested OK with unicode like 🆃🆁🅴🆅🅾🆁 Not tested with odd symbols like: ☕ Catalysm

activationPhrasestring
activationPhrase

To manually trigger this module, the authorised person(s) can type this keyphrase into the Discord debugChannel specified above. e.g.: reset-regions

Default: reset-regions
sendDebugMessagesboolean
sendDebugMessages

If enabled, debug messages will be sent to the debugChannel. The listening channel for keyphrase triggering is specified separately in the hook, below.

Default: false

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.

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

randomiseResetRegions

discord-messageEvent Type
Function Implementation

randomiseResetRegions Hook Function

JAVASCRIPT
Event Details
Event Type:discord-message
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.

Scheduled Jobs (1)

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

randomiseResetRegions

0 0 * * *Schedule

Schedule Details

Cron Expression
0 0 * * *
Human-Readable Schedule

Daily at midnight

Function Implementation

randomiseResetRegions 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.