Configuration

Full reference for config.yml — database, skills, combat, magic, thief, taming, economy, and mob settings.

The main configuration file is config.yml, located in plugins/Skills/. Edit it with a text editor and run /skilladmin reload to apply changes without restarting the server.

Language files live in plugins/Skills/lang/ (e.g., en.yml, ja.yml). They are created automatically on first run and can be edited to customize all player-facing messages.

Full default config.yml

# Skills Plugin Configuration

# Database settings
database:
  type: sqlite  # sqlite or mysql
  # MySQL settings (only used if type is mysql)
  host: localhost
  port: 3306
  name: skills
  user: root
  password: ""

# Skill settings
skills:
  total_cap: 700.0       # Maximum total skill points
  individual_max: 100.0  # Maximum for each skill
  gain_amount: 0.1       # Amount gained per successful gain check

# Combat settings
combat:
  damage_multiplier: 10.0    # Converts vanilla damage to internal
  parry_chance_max: 50.0     # Maximum parry chance (%)
  critical_chance_max: 50.0  # Maximum critical hit chance (%)

# Magic settings
magic:
  casting_time_base: 2000   # Base casting time in milliseconds
  targeting_timeout: 10000  # Targeting mode timeout in milliseconds
  spell_range: 12.0         # Maximum spell range in blocks
  reagent_search:
    search_shulker_boxes: true
    search_bundles: true

# Thief settings
thief:
  hide_movement_breaks: false
  stealth_max_distance: 10.0
  detect_range: 10.0
  stealth_distance_divisor: 5.0
  hide_timeout_base: 30
  hide_timeout_max: 300
  hide_timeout_warning: 10
  equipment_steal_penalty: 20

# Taming settings
taming:
  attempt_cooldown: 5000  # Cooldown between tame attempts in milliseconds

# Language settings
language:
  default: ja
  use_client_locale: true
  allow_player_change: true

# Auto-save settings
auto_save:
  enabled: true
  interval: 300  # Seconds between auto-saves

# Integration with other plugins
integration:
  notoriety: true

# Cooldown settings (in seconds)
cooldowns:
  hide: 10
  detect: 5
  snoop: 5
  steal: 3
  poison: 10
  tame: 5
  animal_lore: 3
  arms_lore: 3
  evaluate: 5
  cast_spell: 2
  meditation: 30

# Debug mode
debug: false

# Economy settings (Vault integration)
economy:
  enabled: true
  chunk_limit:
    enabled: true
    chunk_radius: 5
    time_window_minutes: 60
    world_limits:
      world: 500.0
      world_nether: 800.0
      world_the_end: 1000.0
      default: 500.0
  show_on_scoreboard: true

# Sleep Skip settings
sleep:
  enabled: true

# Bed Rest Recovery settings
bed_rest_recovery:
  enabled: true

# VengefulMobs settings
vengeful_mobs:
  enabled: true
  exclude_tamed: true
  anger_duration: 10000
  give_up_distance: 20.0
  extend_anger_while_chasing: false
  enabled_mobs:
    - SHEEP
    - PIG
    - COW
    - CHICKEN
    - RABBIT
    - HORSE
    - DONKEY
    - MULE
    - LLAMA
    - GOAT
    - MOOSHROOM
  default:
    damage: 2.0
    speed: 1.0
    attack_range: 2.0
    attack_cooldown: 1000
    mode: RETALIATE
  overrides:
    CHICKEN:
      damage: 1.0
      attack_cooldown: 1500
    RABBIT:
      damage: 1.0
      attack_cooldown: 1500
    COW:
      damage: 3.0
      attack_cooldown: 1200
      mode: RETALIATE
    GOAT:
      damage: 4.0
      speed: 1.3
      attack_cooldown: 800
      mode: RETALIATE_WITH_SUPPORT
    LLAMA:
      damage: 2.0
      mode: RETALIATE_ONCE
    HORSE:
      damage: 3.5
      speed: 1.5
      attack_cooldown: 1000
      mode: RETALIATE_ONCE

# Ender Dragon Scaling
ender_dragon_scaling:
  enabled: true
  respawn_interval_hours: 24
  hp_per_kill: 50
  max_hp: 1000
  damage_scale_per_kill: 0.15
  max_damage_scale: 4.0
  xp_scale_per_kill: 0.25
  announce_pre_respawn_minutes: [5, 1]

# Scoreboard settings
scoreboard:
  enabled: true
  update_interval_ticks: 20
  conflict_mode: RESPECT
  show_by_default: true
  allow_player_toggle: true

# Chunk Mob Limit settings
chunk_mob_limit:
  enabled: true
  limits:
    passive: 24
    hostile: 32
    ambient: 8
    water_creature: 8
    water_ambient: 16
  check_interval_ticks: 100
  notify_on_limit: true

---

Settings reference

Database

Controls how player skill data is stored. SQLite requires no external setup; MySQL is recommended for networks sharing data across multiple servers.

database.type · string · default: "sqlite"

Storage backend. Set to sqlite or mysql.

SQLite (default — no external server required)

database.host · string · default: "localhost"

Ignored when type is sqlite.

MySQL (used when type: mysql)

database.host · string · default: "localhost"

MySQL server hostname or IP address.

database.port · number · default: "3306"

MySQL server port.

database.name · string · default: "skills"

Name of the MySQL database to use.

database.user · string · default: "root"

MySQL username.

database.password · string · default: ""

MySQL password. Leave empty for no password.

SQLite stores data in plugins/Skills/skills.db. It works well for single-server setups. Use MySQL if you run a multi-server network and need shared player data.

Skills

skills.total_cap · number · default: "700"

Maximum total skill points a player can accumulate across all 37 skills. At 700 points, the player can max out exactly 7 skills at 100 each. When this cap is reached, gaining a skill automatically reduces the least-recently-used skill.

skills.individual_max · number · default: "100"

Maximum value for any single skill.

skills.gain_amount · number · default: "0.1"

Amount added to a skill on a successful gain check. Decreases use the same amount.

The skill decline system activates when the player’s total skill points reach 600 (not 700). Between 600 and 700 points the least-used skill decreases each time another skill increases. This mirrors the Ultima Online design where the “soft cap” creates meaningful trade-offs before the hard cap is reached.

Combat

combat.damage_multiplier · number · default: "10.0"

Multiplier applied when converting vanilla damage to the plugin’s internal HP system. Internal HP is tracked separately from vanilla hearts and is synced back after each hit.

combat.parry_chance_max · number · default: "50.0"

Maximum percentage chance that a parry attempt can succeed (with a shield). Actual chance equals Parrying × 0.5%, capped at this value.

combat.critical_chance_max · number · default: "50.0"

Maximum critical hit chance as a percentage. Actual chance equals Anatomy ÷ 2 %, capped at this value.

Magic

magic.casting_time_base · number · default: "2000"

Base casting time in milliseconds before the spell circle multiplier is applied. Formula: (casting_time_base + circle × 500ms) × (1 − Magery reduction).

magic.targeting_timeout · number · default: "10000"

How long (in milliseconds) the targeting phase waits for a click before automatically cancelling. No mana or reagents are consumed on timeout.

magic.spell_range · number · default: "12.0"

Maximum range in blocks for targeted spells. Clicking a target beyond this range produces an out-of-range error and cancels without consuming resources.

magic.reagent_search.search_shulker_boxes · boolean · default: "true"

When true, the plugin looks inside shulker boxes in the player’s inventory for reagents.

magic.reagent_search.search_bundles · boolean · default: "true"

When true, the plugin looks inside bundles in the player’s inventory for reagents.

Thief

thief.hide_movement_breaks · boolean · default: "false"

When true, any movement (not just sprinting) breaks the Hiding effect. When false, only sprinting breaks it — walking is allowed if the Stealth skill permits.

thief.stealth_max_distance · number · default: "10.0"

Hard cap on how far a player can walk while hidden, regardless of Stealth skill.

thief.detect_range · number · default: "10.0"

Hard cap on /detect radius in blocks, regardless of Detecting Hidden skill.

thief.stealth_distance_divisor · number · default: "5.0"

Controls how Stealth skill translates to walkable distance. Formula: skill ÷ divisor. With the default of 5.0, Stealth 60 allows 12 blocks of movement.

thief.hide_timeout_base · number · default: "30"

Minimum number of seconds a player can remain hidden (at skill 0).

thief.hide_timeout_max · number · default: "300"

Maximum number of seconds a player can remain hidden (at skill 100).

thief.hide_timeout_warning · number · default: "10"

Seconds before the hide duration expires at which the player receives a warning message.

thief.equipment_steal_penalty · number · default: "20"

Additional difficulty applied when attempting to steal an equipped item (worn armour, held weapon, etc.).

Taming

taming.attempt_cooldown · number · default: "5000"

Minimum time in milliseconds between taming attempts, even if the first attempt fails.

Language

language.default · string · default: "ja"

The fallback language used when no per-player setting exists and the client locale cannot be matched. Supported values: en, ja.

language.use_client_locale · boolean · default: "true"

When true, the plugin reads the player’s Minecraft client locale and automatically selects the matching language if supported.

language.allow_player_change · boolean · default: "true"

When true, players can change their own language with /skills language <code>. Set to false to enforce the server default for all players.

Language files are in plugins/Skills/lang/. The plugin ships with en.yml and ja.yml. To add a new language, copy one of these files, rename it to the locale code (e.g., fr.yml), translate the values, and set language.default to the new code.

Integration

integration.notoriety · boolean · default: "true"

When true and the notoriety plugin is installed, successful Stealing actions are recorded as crimes via the notoriety API. If the notoriety plugin is absent, this setting is ignored.

The notoriety plugin is a soft dependency — the Skills plugin loads and functions normally without it.

Scoreboard

scoreboard.enabled · boolean · default: "true"

Master switch for the sidebar scoreboard. When false, no scoreboard is shown and the /skills sb toggle command is disabled.

scoreboard.update_interval_ticks · number · default: "20"

How often the scoreboard updates, in ticks. 20 ticks = 1 second.

scoreboard.conflict_mode · string · default: "RESPECT"

Behaviour when another plugin is using the sidebar slot.

• ALWAYS — always show the Skills scoreboard, overwriting the other plugin.
• RESPECT — do not show if another plugin has claimed the sidebar.

scoreboard.show_by_default · boolean · default: "true"

Whether new players see the scoreboard by default on first join.

scoreboard.allow_player_toggle · boolean · default: "true"

Whether players can toggle the scoreboard on and off with /skills sb.

VengefulMobs

Makes passive mobs retaliate when attacked by a player. Inspired by the VengefulMobs plugin.

vengeful_mobs.enabled · boolean · default: "true"

Enable or disable the entire VengefulMobs feature.

vengeful_mobs.exclude_tamed · boolean · default: "true"

When true, tamed animals owned by the attacking player will not fight back.

vengeful_mobs.anger_duration · number · default: "10000"

How long (in milliseconds) a mob stays in its angry/retaliating state after being hit.

vengeful_mobs.give_up_distance · number · default: "20.0"

Distance in blocks at which an angry mob gives up chasing the player.

vengeful_mobs.extend_anger_while_chasing · boolean · default: "false"

When true, the anger timer resets while the mob is actively chasing, effectively making it chase until the player escapes beyond give_up_distance.

vengeful_mobs.enabled_mobs · string[]

List of mob types that will fight back. See the default config.yml for the full list of supported mob type names.

vengeful_mobs.default.damage · number · default: "2.0"

Damage dealt per attack in half-hearts, applied to all enabled mobs unless overridden.

vengeful_mobs.default.speed · number · default: "1.0"

Movement speed multiplier for angry mobs.

vengeful_mobs.default.attack_range · number · default: "2.0"

Attack range in blocks.

vengeful_mobs.default.attack_cooldown · number · default: "1000"

Milliseconds between attacks (1000 = 1 second).

vengeful_mobs.default.mode · string · default: "RETALIATE"

Aggression mode. Available values:

• RETALIATE — fight back and keep attacking until anger expires
• RETALIATE_ONCE — attack once only (suitable for accidental hits)
• RETALIATE_WITH_SUPPORT — call nearby same-type mobs to join the fight
• HOSTILE — always attack players on sight
• MURDER_ALL — attack all entities
• MURDER_OTHERS — attack all entities except same type

vengeful_mobs.overrides · object

Per-mob overrides for damage, speed, attack_range, attack_cooldown, and mode. The mob type name (e.g., GOAT) is the key. Any field omitted in the override falls back to the default values.

Chunk mob limits

Prevents server lag from large mob farms by capping the number of mobs per chunk category.

chunk_mob_limit.enabled · boolean · default: "true"

Enable or disable the chunk mob limit feature.

chunk_mob_limit.limits.passive · number · default: "24"

Maximum passive mobs (cows, sheep, pigs, etc.) per chunk.

chunk_mob_limit.limits.hostile · number · default: "32"

Maximum hostile mobs (zombies, skeletons, creepers, etc.) per chunk.

chunk_mob_limit.limits.ambient · number · default: "8"

Maximum ambient mobs (bats) per chunk.

chunk_mob_limit.limits.water_creature · number · default: "8"

Maximum water creatures (squid, dolphins, etc.) per chunk.

chunk_mob_limit.limits.water_ambient · number · default: "16"

Maximum water ambient mobs (fish) per chunk.

chunk_mob_limit.check_interval_ticks · number · default: "100"

How often the mob count cache refreshes, in ticks. 100 ticks = 5 seconds.

chunk_mob_limit.notify_on_limit · boolean · default: "true"

When true, players receive a chat message when their breeding attempt is blocked by the chunk limit.

Cooldowns

All values are in seconds.

cooldowns.hide · number · default: "10"

Seconds between /hide attempts.

cooldowns.detect · number · default: "5"

Seconds between /detect uses.

cooldowns.snoop · number · default: "5"

Seconds between /snoop attempts.

cooldowns.steal · number · default: "3"

Seconds between stealing attempts.

cooldowns.poison · number · default: "10"

Seconds between /poison uses.

cooldowns.tame · number · default: "5"

Seconds between /tame attempts.

cooldowns.animal_lore · number · default: "3"

Seconds between /lore uses.

cooldowns.arms_lore · number · default: "3"

Seconds between /arms uses.

cooldowns.evaluate · number · default: "5"

Seconds between /evaluate uses.

cooldowns.cast_spell · number · default: "2"

Seconds between spell casts.

cooldowns.meditation · number · default: "30"

Seconds between meditation skill gain checks.

Auto-save

auto_save.enabled · boolean · default: "true"

Enable periodic background saves of all online player data.

auto_save.interval · number · default: "300"

Seconds between auto-saves. Data is also always saved on player disconnect and server shutdown.