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
- 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.
Module details
Trevor_RegionResetRandomiser: Map Region Reset Manager
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
Components Overview
New Module: RegionResetRandomiser
NEWrandomiseResetRegions (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
(Required) Specify the number of regions to randomly selected for reset. Must be fewer than the total number of flagged regions.
5debugChannel
(Optional) Supply a discord channel ID to receive debug activity messages.
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
activationPhrase
To manually trigger this module, the authorised person(s) can type this keyphrase into the Discord debugChannel specified above. e.g.: reset-regions
reset-regionssendDebugMessages
If enabled, debug messages will be sent to the debugChannel. The listening channel for keyphrase triggering is specified separately in the hook, below.
falseUI 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
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
Schedule Details
Cron Expression
Human-Readable Schedule
Daily at midnight
Function Implementation
randomiseResetRegions Function
JAVASCRIPTCron Expression Format
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.







































