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.

8ball

by Limon
Add a Magic 8-Ball chat command to your Takaro game server. 8ball gives players a quick social minigame with configurable responses and public or private output.
Use this module to:
  • Let players ask questions with a configurable 8-ball command.
  • Randomly choose from admin-defined responses.
  • Send answers globally or privately to the player.
  • Control access with Takaro permissions.
Good fit for communities that want simple chat fun, lightweight player interaction, and easy-to-configure server minigames.

Module details

Allows players to use a Magic 8-Ball command to receive random fortune-telling responses to their questions.
Key Functionality:
  • 8-Ball Command: Players can use a designated command (default: 8ball) to ask the Magic 8-Ball a question.
  • Random Responses: The module provides a list of configurable responses. When the command is used, the module selects a random response from this list and displays it to the player.
  • Configurable Output: The module allows server administrators to choose whether the 8-Ball's response is sent as a global server message or as a private message (PM) to the player.
  • Customizable Responses: The list of 8-Ball responses can be fully customized, allowing server administrators to tailor the module to their server's theme or language.
  • Permission Control: Usage of the 8-Ball command can be restricted using a configurable permission.
How to Use:
  1. Configuration:
    • sendMessage: Choose whether the 8-Ball's response is sent as a serverMessage (to all players) or a playerPM (private message to the player who used the command).
    • responses: Edit the array of strings to customize the 8-Ball's possible answers. Ensure there is at least one response.
  2. Permissions: Assign the MAGIC_8BALL_USE permission to the player groups or individuals who should be able to use the 8ball command.
  3. In-Game Usage: Players use the /8ball command (or the configured trigger) followed by their question. The 8-Ball's response will be displayed according to the sendMessage configuration.
Important Considerations:
  • Ensure there is at least one response in the responses configuration to avoid errors.
  • Customize the responses to fit your server's style and language.
  • Use the permission system to control who can use the command.
communityTakaro development

Components Overview

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

New Module: 8ball

NEW
August 6, 2025
Updated to version latest. Added 1 command: my-command. New permission: MAGIC_8BALL_USE. New configuration options: sendMessage, responses.

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)

sendMessageenum
sendMessage

Decide on sending it to the server globally or to the individual player

Default: serverMessage
Allowed values (2):
serverMessageplayerPM
responsesarray
responses

Here you can edit the responses of the 8ball command.

Default:Array of 15 items
"It is certain"
"Without a doubt"
... and 13 more items
Constraints: minItems: 1, maxItems: 1000

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

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

my-command

/8ballTrigger Command

Description

No help text available

Function Implementation

my-command Function

JAVASCRIPT

Usage Example

Player types: /8ball

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.

Permissions (1)

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

1 permission

MAGIC_8BALL_USE

MAGIC_8BALL_USEPermission Key
Description

This permissions allows your players to use the Magic 8Ball

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

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.