BetterBloodMoons

  • community
  • events
  • by Mad
  • Takaro main
  • all
Version
View export JSON

Provides commands to easily enable or disable 'Better Blood Moons' settings on a 7 Days to Die server, automating the configuration changes typically done manually via XML editing.

Key Functionality

  • Enable Better Blood Moons: The /BBM command automatically sets the necessary server commands to activate 'Better Blood Moons'. It also provides a reminder about a recommended XML setting change.
  • Disable Better Blood Moons: The /BBMoff command reverts the server settings to their default, effectively disabling 'Better Blood Moons'. It also provides a reminder about reverting the XML setting if changed.
  • Simplified Management: This module eliminates the need for manual editing of the CPMsettings.xml file, reducing the risk of errors and making it easier to switch between default and enhanced Blood Moon settings.
  • Permission Control: Access to the /BBM and /BBMoff commands is controlled by a dedicated permission.

How to Use

  1. Installation: Install the module on your Takaro instance.
  2. Configuration: (Optional) No configuration is typically needed for this module.
  3. Permissions: Grant the BETTER_BLOOD_MOONS permission to the user roles or players who should be able to use the /BBM and /BBMoff commands.
  4. In-Game Usage:
    • /BBM: Executes the commands to enable 'Better Blood Moons' and displays a recommended XML setting.
    • /BBMoff: Executes the commands to disable 'Better Blood Moons' and displays a reminder about the XML setting.

Important Considerations

  • CPM Mod Dependency: This module is designed to work in conjunction with the 'CPM' (Custom Prefabs Mod) for 7 Days to Die. Ensure that CPM is installed and configured on your server.
  • XML Setting Awareness: The module provides reminders about a specific setting (BloodmoonSpawner_DespawnAllOnStart) in the CPMsettings.xml file. While the module automates other settings, this XML setting might need manual adjustment for optimal behavior.
  • Permission Management: Control access to the module's commands using the provided permission to prevent unintended changes to Blood Moon settings.

Configuration 0

Settings you fill in when installing the module on a server.

This module takes no configuration.

Raw config schema 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": [],
  "additionalProperties": false
}
Raw UI schema 
{}

Commands 2

Chat commands players trigger in game.

  • BBMoff

    BBMoff

    Run this command to set Better Blood Moons to default. If you changed the CPMsettings.xml line BloodmoonSpawner_DespawnAllOnStart to true, set it back to false

    Command source 
    import { takaro, data, checkPermission, TakaroUserError } from '@takaro/helpers';
async function main() {
    const { pog } = data;
    if (!checkPermission(pog, 'BBM_PERMISSION')) {
        throw new TakaroUserError('You do not have permission to use the Better Blood Moons commmand.');
    }

    await pog.pm(`[70FE02]It is recommended to change the CPMsettings.xml line BloodmoonSpawner_DespawnAllOnStart to [CC6CE7]false[-]`);



    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsOverrideVanillaSpawner false`,
    });

    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsAdjustForOnlinePlayers false`,
    });

    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsEnemyCount 0`,
    });

    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsAddMaxAlive 0`,
    });



    await pog.pm(`[ADDFB3]Better Blood Moons have been turned off.[-]`);
}
await main();

  • BBM

    BBM

    [FF6D6A]Run this command to set Better Blood Moons to default. If you change dthe CPMsettings.xml line BloodmoonSpawner_DespawnAllOnStart to true, set it back to false,

    Command source 
    import { takaro, data, checkPermission, TakaroUserError } from '@takaro/helpers';
async function main() {
    const { pog } = data;
    if (!checkPermission(pog, 'BBM_PERMISSION')) {
        throw new TakaroUserError('You do not have permission to use the Better Blood Moons commmand.');
    }

    await pog.pm(`[70FE02]It is recommended to change the CPMsettings.xml line BloodmoonSpawner_DespawnAllOnStart to [CC6CE7]true[-]`);



    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsOverrideVanillaSpawner true`,
    });

    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsAdjustForOnlinePlayers true`,
    });

    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsEnemyCount 6`,
    });

    await takaro.gameserver.gameServerControllerExecuteCommand(data.gameServerId, {
        command: `bmsAddMaxAlive 40`,
    });



    await pog.pm(`[ADDFB3]The rest of the recommended settings will be handled by this command... [CC6CE7]Enjoy![-]`);
}
await main();

Permissions 1

Roles you can grant to decide who may use what.

  • Better Blood Moons

    BETTER_BLOOD_MOONS

    Blood Moons