Cobbled Level Control - Configuration

All of the configuration files for Cobbled Level Control are located in the <game_directory>/config/cobbled_level_control/ directory.

Main Configuration

• main.json: This is the main configuration file for Cobbled Level Control. It contains settings for the mod, including level caps, catch rules, and wild spawn level caps.

Configuration Options

• difficulties: An array of difficulty preset names that are available in the mod. Each difficulty preset is defined in a separate JSON file located in the difficulty/ directory.
• defaults: An object containing default settings for the mod, including the default difficulty preset and whether to automatically apply the default settings to new players.
  • defaultDifficulty: The name of the default difficulty preset to use for new players.
  • autoApplyDefault: A boolean value indicating whether to automatically apply the default settings to new players when they first join the server.
• spawnConfig: An object containing settings for wild pokemon spawns, including whether to enable scaling and the method to use for scaling.
  • enableScaling: A boolean value indicating whether to enable scaling for wild pokemon spawns.
  • scalingMethod: A string value indicating the method to use for scaling wild pokemon spawns. See Scaling Methods.

Example Configuration

<game_directory>/config/cobbled_level_control/main.json

{
  "difficulties": [
    "default"
  ],
  "defaults": {
    "defaultDifficulty": "default",
    "autoApplyDefault": true
  },
  "spawnConfig": {
    "enableScaling": true,
    "scalingMethod": "+- random7"
  }
}

Messages Configuration

• messages.json: This file contains all the messages that the mod will send to players. It allows for easy customization of the messages without having to modify the mod’s code.

Configuration Options

• messages: An object containing all the messages that the mod will send to players. Each message can contain placeholders that will be replaced with dynamic values when the message is sent.
• errors: An object containing all the error messages that the mod will send to players.

Example Configuration

<game_directory>/config/cobbled_level_control/messages.json

{
  "messages": {
    "useActionBar": false,
    "reloaded": "Cobbled Level Control configuration reloaded successfully.",
    "targetCatchingLevelSet": "Your Catching level has been set to %level%.",
    "sourceCatchingLevelSet": "Set Catching level of %target% to %level%.",
    "targetLevelingLevelSet": "Your Leveling level has been set to %level%.",
    "sourceLevelingLevelSet": "Set Leveling level of %target% to %level%.",
    "targetSetDifficulty": "Your difficulty has been set to %difficulty%!",
    "sourceSetDifficulty": "Set %target%'s difficulty to %difficulty%!",
    "targetCatchingTierSet": "Your tier in catching has increased to %tier%!",
    "sourceCatchingTierSet": "Set %target%'s tier in catching to %tier%!",
    "targetLevelingTierSet": "Your tier in leveling has increased to %tier%!",
    "sourceLevelingTierSet": "Set %target%'s tier in leveling to %tier%!"
  },
  "errors": {
    "useActionBar": false,
    "battle": "One or more of your Pokemon exceeds your leveling cap! Please put it in your PC!",
    "catchingTier": "Your Catching Tier level is too low for this Pokemon!",
    "levelingTier": "Your Leveling Tier level is too low to level up this Pokemon!",
    "missingPermission": "You do not have permission to do that!",
    "invalidDifficulty": "The difficulty you specified is invalid!",
    "missingDifficulty": "Target player does not have a difficulty set. Please set a difficulty first.",
    "difficultyDoesNotExist": "Difficulty %difficultyName% does not exist!",
    "catchingLevelToHigh": "Level exceeds maximum level for Catching module. Max level is %maxLevel%.",
    "levelingLevelToHigh": "Level exceeds maximum level for Leveling module. Max level is %maxLevel%.",
    "invalidModule": "Invalid module specified. Valid modules are: catch, level.",
    "catchingLevelAlreadyMax": "Target player is already at the maximum level for the Catching module.",
    "levelingLevelAlreadyMax": "Target player is already at the maximum level for the Leveling module."
  }
}

Difficulty Presets

• difficulty/<preset_name>.json: These files define the different difficulty presets available in the mod. Each preset contains settings for level caps, catch rules, and wild spawn level caps.

Configuration Options

• battles: An object containing settings for battle level caps, including whether to restrict battles and the level cap for each evolution stage.
  • restrictBattles: A boolean value indicating whether to restrict battles based on level caps.
  • evolutionStages: An object containing the required permission for each evolution stage.
    • singleEvo: The required permission for single-stage pokemon.
    • firstStageEvo: The required permission for first-stage evolution pokemon.
    • secondStageEvo: The required permission for second-stage evolution pokemon.
    • finalStageEvo: The required permission for final-stage evolution pokemon.
  • legendary: The required permission for legendary pokemon.
  • mythical: The required permission for mythical pokemon.
  • ultraBeast: The required permission for ultra beast pokemon.
• catching: An object containing settings for catching level caps, including whether to restrict catching, the level cap for each evolution stage, legendary, mythical, ultra beast, and shiny pokemon, as well as the level cap for each catching tier.
  • restrictCatching: A boolean value indicating whether to restrict catching based on level caps.
  • evolutionStages: An object containing the required permission for each evolution stage.
    • singleEvo: The required permission for single-stage pokemon.
    • firstStageEvo: The required permission for first-stage evolution pokemon.
    • secondStageEvo: The required permission for second-stage evolution pokemon.
    • finalStageEvo: The required permission for final-stage evolution pokemon.
  • legendary: The required permission for legendary pokemon.
  • mythical: The required permission for mythical pokemon.
  • ultraBeast: The required permission for ultra beast pokemon.
  • shiny: The required permission for shiny pokemon.
  • tiers: An object containing the level cap for each tier
• leveling: An object containing settings for leveling level caps, including whether to restrict leveling, the level cap for each evolution stage, and the level cap for each leveling tier.
  • restrictLeveling: A boolean value indicating whether to restrict leveling based on level caps.
  • evolutionStages: An object containing the required permission for each evolution stage.
    • singleEvo: The required permission for single-stage pokemon.
    • firstStageEvo: The required permission for first-stage evolution pokemon.
    • secondStageEvo: The required permission for second-stage evolution pokemon.
    • finalStageEvo: The required permission for final-stage evolution pokemon.
  • tiers: An object containing the level cap for each tier.

Tip

Setting a permission to an empty string will allow all players to use that evolution stage, while setting it to a non-empty string will require players to have that permission in order to use that evolution stage.

Example Configuration

<game_directory>/config/cobbled_level_control/difficulty/default.json

{
  "battles": {
    "restrictBattles": false,
    "evolutionStages": {
      "singleEvo": "",
      "firstStageEvo": "",
      "secondStageEvo": "cobbled_level_control.battles.second_stage_evo",
      "finalStageEvo": "cobbled_level_control.battles.final_stage_evo"
    },
    "legendary": "cobbled_level_control.battles.legendary",
    "mythical": "cobbled_level_control.battles.mythical",
    "ultraBeast": "cobbled_level_control.battles.ultra_beast",
    "shiny": "cobbled_level_control.battles.shiny"
  },
  "catching": {
    "restrictCatching": false,
    "evolutionStages": {
      "singleEvo": "",
      "firstStageEvo": "",
      "secondStageEvo": "cobbled_level_control.catching.second_stage_evo",
      "finalStageEvo": "cobbled_level_control.catching.final_stage_evo"
    },
    "legendary": "cobbled_level_control.catching.legendary",
    "mythical": "cobbled_level_control.catching.mythical",
    "ultraBeast": "cobbled_level_control.catching.ultra_beast",
    "shiny": "cobbled_level_control.catching.shiny",
    "tiers": {
      "5": 100,
      "4": 80,
      "3": 40,
      "2": 20,
      "1": 10
    }
  },
  "leveling": {
    "restrictLeveling": false,
    "evolutionStages": {
      "singleEvo": "",
      "firstStageEvo": "",
      "secondStageEvo": "cobbled_level_control.leveling.second_stage_evo",
      "finalStageEvo": "cobbled_level_control.leveling.final_stage_evo"
    },
    "tiers": {
      "5": 100,
      "4": 80,
      "3": 40,
      "2": 20,
      "1": 10
    }
  }
}

Scaling Methods

Cobbled Level Control supports different scaling methods for wild pokemon spawns. The scaling method determines how the level of wild pokemon spawns is calculated based on the player’s max catching level.

Supported Scaling Methods

• +- randomX: This method will randomly add or subtract a number between 1 and X levels from the player’s max catching level. For example, +- random5 will result in a wild pokemon spawn level that is randomly between 1 and 5 levels higher or lower than the player’s max catching level.
• + X: This method will add X levels to the player’s max catching level. For example, + 3 will result in a wild pokemon spawn level that is 3 levels higher than the player’s max catching level.
• - randomX: This method will randomly subtract a number between 1 and X levels from the player’s max catching level. For example, - random7 will result in a wild pokemon spawn level that is randomly between 1 and 7 levels lower than the player’s max catching level.
• + 0: This method will set the wild pokemon spawn level to be exactly at the player’s max catching level. This is the best way to ensure that wild pokemon spawns are at the player’s max catching level without any variation.