Skip to content

Configuration

Jump to bottom
Rudra edited this page Jan 2, 2026 · 3 revisions

Configuration (config.yml)

The main configuration file for LevelTools. This file contains global settings that apply across all profiles.

File Location

plugins/LevelTools/config.yml

Settings

Update Checker

update:
  start: true        # Check for updates on server start
  periodically: true # Check for updates periodically

Controls whether LevelTools checks for new versions. Recommended to keep enabled.

Block Data Storage

block_data_storage:
  type: SQLITE

Defines how placed block data is stored (for preventing XP from player-placed blocks).

Type Description
SQLITE Embedded SQLite database. Recommended for performance and scalability.
LEGACY_TEXT Plain text file format. Easy to modify by hand but slower with large datasets.

Messages

messages:
  no_permission: "&cYou do not have permission to execute this command!"
  successful_reload: "&aSuccessfully reloaded LevelTools!"
  successfully_executed_action: "&aSuccessfully executed action for item in hand."
  item_not_tool: "&cThe item in hand is not supported by LevelTools!"
  successfully_reset_tools: "&aSuccessfully reset all tool XP/Levels for {player}."
  successfully_reset_hand_tool: "&aSuccessfully reset tool in hand's XP/Levels for {player}."

All plugin messages. Supports color codes with &.

Anvil Combine Mode

anvil_combine: "ADD_BOTH"

Determines what happens when combining two leveled items in an anvil.

Mode Behavior
ADD_BOTH Adds the levels and XP of both items together
HIGHER_OF_BOTH Takes the level and XP of the higher level item
LOWER_OF_BOTH Takes the level and XP of the lower level item

XP Formula

level_xp_formula: "100 + {current_level} * 100"

Mathematical formula for calculating required XP per level. The {current_level} placeholder is replaced with the item's current level.

Examples:

  • "100 + {current_level} * 100" - Level 1 needs 200 XP, Level 10 needs 1100 XP
  • "{current_level} * {current_level} * 50" - Exponential scaling
  • "1000" - Fixed 1000 XP per level

This is the global default. Can be overridden per item profile.

Player Placed Blocks

playerPlacedBlocks: false

If false, blocks placed by players won't give XP when broken. This prevents XP farming exploits.

Level Up Sound

level_up_sound:
  sound: "ENTITY_PLAYER_LEVELUP"
  pitch: 1.0
  volume: 1.0

Sound played when an item levels up. Set sound to null to disable.

See Spigot Sound List for valid sounds.

Hide Attributes

hide_attributes: true

If true, attribute modifiers added by LevelTools won't show in item lore. Recommended to prevent lore spam.

Disabled Worlds

disabled_worlds:
  - "disabled_world"

List of worlds where LevelTools is disabled. Items won't gain XP in these worlds. API functionality still works.

Useful Links

Clone this wiki locally