Wiki / OutlawSMP / Configuration

Configuration

The most accurate 1:1 recreation of Outlaw SMP - v1.3, $7.99 on BuiltByBit, 5.00 star across 18 ratings, 137 purchases.

Overview Commands Permissions Configuration

Default config.yml

The complete real generated config from OutlawSMP v1.3, confirmed via in-game testing. The license key and NPC skin texture blobs are shown as <secret> - they're personal to your install and not useful to copy anyway.

config.yml

# ╔═══════════════════════════════════════════════════════════════╗
# ║                    OutlawSMP Configuration                    ║
# ║           Plugin Made by Lusik (@lusik_2155)             ║
# ╚═══════════════════════════════════════════════════════════════╝
# License key - auto-filled by BuiltByBit at download
license-key: <secret>
#  ▄█████ ▄▄ ▄▄  ▄▄▄  ▄▄▄▄  ▄▄ ▄▄ ▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄  ▄▄▄▄▄ ▄▄▄▄
#  ▀▀▀▄▄▄ ██▄██ ██▀██ ██▄█▀ ██▄█▀ ██▄▄  ██▄▄  ██▄█▀ ██▄▄  ██▄█▄
#  █████▀ ██ ██ ▀███▀ ██    ██ ██ ██▄▄▄ ██▄▄▄ ██    ██▄▄▄ ██ ██
# Shopkeeper Settings
shopkeeper:
  name: "<gold>Joe Metri Desh"
  skin-value: <secret>
  skin-signature: <secret>
  messages:
    # Cooldown between welcome/leave messages to reduce spam.
    cooldown-seconds: 3
    # true = message is broadcast to everyone, false = only to player entering/leaving range.
    broadcast: false
#  ▄█████ ▄▄ ▄▄ ▄▄▄▄▄ ▄▄▄▄  ▄▄ ▄▄▄▄▄ ▄▄▄▄▄
#  ▀▀▀▄▄▄ ██▄██ ██▄▄  ██▄█▄ ██ ██▄▄  ██▄▄
#  █████▀ ██ ██ ██▄▄▄ ██ ██ ██ ██    ██
# Sheriff Woody NPC Configuration
sheriff:
  name: "<white>Sheriff Woody"
  skin-value: <secret>
  skin-signature: <secret>
#  ██████ ▄▄▄▄   ▄▄▄   ▄▄▄▄ ▄▄ ▄▄ ▄▄▄▄▄ ▄▄▄▄
#    ██   ██▄█▄ ██▀██ ██▀▀▀ ██▄█▀ ██▄▄  ██▄█▄
#    ██   ██ ██ ██▀██ ▀████ ██ ██ ██▄▄▄ ██ ██
# Player Tracker Configuration
player-tracker:
  enabled: true
  give-on-join: true
  prevent-drop: true
  prevent-storage: true
  tracking-fee: 10
#  ██      ▄▄▄   ▄▄▄▄  ▄▄▄▄  ▄▄▄
#  ██     ██▀██ ███▄▄ ███▄▄ ██▀██
#  ██████ ██▀██ ▄▄██▀ ▄▄██▀ ▀███▀
# Lasso Tool Configuration
lasso:
  cooldown-seconds: 30
  throw-force: 2.5
  pull-force: 1.2
  wiggle-flips: 6
#  █████▄ ▄▄ ▄▄    ▄▄      ▄█████  ▄▄▄  ▄▄    ▄▄    ▄▄▄▄▄  ▄▄▄▄ ▄▄▄▄▄▄ ▄▄▄  ▄▄▄▄
#  ██▄▄██ ██ ██    ██      ██     ██▀██ ██    ██    ██▄▄  ██▀▀▀   ██  ██▀██ ██▄█▄
#  ██▄▄█▀ ██ ██▄▄▄ ██▄▄▄   ▀█████ ▀███▀ ██▄▄▄ ██▄▄▄ ██▄▄▄ ▀████   ██  ▀███▀ ██ ██
# Bill Collector Tool Configuration
billcollector:
  tax-percent: 30
#  ▄█████ ▄▄ ▄▄ ▄▄ ▄▄    ▄▄     ▄▄▄▄
#  ▀▀▀▄▄▄ ██▄█▀ ██ ██    ██    ███▄▄
#  █████▀ ██ ██ ██ ██▄▄▄ ██▄▄▄ ▄▄██▀
# Skill Effect Settings
skills:
  mirage:
    required-hits: 20
    teleport-range: 8  # max block range for target block lookup
  degenerate:
    required-hits: 40
    duration-seconds: 10
  swift:
    required-hits: 30
    duration-seconds: 10
    speed-level: 2  # Speed II = 2
    haste-level: 2  # Haste II = 2
  fatigue:
    required-hits: 40
    duration-seconds: 10
    mining-fatigue-level: 1  # Mining Fatigue I applied to enemy per hit
    slowness-level: 2  # Slowness II applied to enemy per hit
  tank:
    required-hits: 30
    duration-seconds: 8
    resistance-level: 2  # Resistance II = 2
  venom:
    required-hits: 50
    duration-seconds: 15
    poison-level: 0  # 0 = Poison I
  inferno:
    required-hits: 30
    duration-seconds: 12
  shockwave:
    required-hits: 30
    range: 5  # radius in blocks for nearby enemies
    damage: 6.0  # raw damage dealt to launched enemies
    launch-power: 2.0  # velocity multiplier
  frostbite:
    required-hits: 40
    freeze-seconds: 3  # how long the enemy is frozen
  breach:
    required-hits: 50
    duration-seconds: 15
    armor-pierce-multiplier: 0.5
  lifestealer:
    required-hits: 40
    duration-seconds: 10
    regen-ticks: 60  # how long Regen is applied to CASTER per hit
    regen-level: 0  # 0 = Regen I
  wager:
    required-hits: 40
    min-duration-seconds: 10  # random duration between min and max
    max-duration-seconds: 20
    haste-level: 4  # Haste V (level 4, 0-indexed -> Haste V displayed)
    damage-bonus: 1.5  # flat attack damage added via Attributes
  hypnosis:
    required-hits: 40
    duration-seconds: 10
#  █████▄ ▄▄▄▄▄ ▄▄▄▄  ▄▄ ▄▄  ▄▄▄▄
#  ██▄▄█▀ ██▄▄  ██▄█▄ ██▄█▀ ███▄▄
#  ██     ██▄▄▄ ██ ██ ██ ██ ▄▄██▀
# Perk Tiers Configuration
perks:
  # TIER 1 Perks
  toughness:
    # Fraction of non-player damage absorbed (0.95 = 95% reduction)
    damage-reduction: 0.95
  blacksmith:
    recipes:
      cobweb:
        result:
          material: COBWEB
          amount: 1
        shape:
          - "SSS"
          - "S S"
          - "SSS"
        ingredients:
          S: STRING
      cheap-gap:
        result:
          material: GOLDEN_APPLE
          amount: 1
        shape:
          - " G "
          - "GAG"
          - " G "
        ingredients:
          G: GOLD_INGOT
          A: APPLE
  discount:
    # Fraction of original trade cost the player pays (0.20 = 80% off)
    villager-cost-multiplier: 0.20
    # Multiplier on XP gained from all sources
    xp-multiplier: 1.5
  efficiency:
    # Haste level while perk is equipped (1 = Haste I, 2 = Haste II, etc)
    haste-level: 1
  # TIER 2 Perks
  shield:
    # Fraction of cooldown removed (0.50 = 50% shorter)
    cooldown-reduction: 0.50
    # Chance per hit that shield takes no durability damage (0.333 = 1/3)
    block-chance: 0.333
  regenerate:
    # Regeneration effect level while perk is equipped (1 = Regen I, 2 = Regen II, etc)
    regen-level: 1
  sharpshooter:
    # Added damage fraction for crossbow projectiles (0.50 = +50%)
    damage-bonus: 0.50
  quickdraw:
    # Quick Charge enchantment level applied to held crossbows (max 3)
    quick-charge-level: 2
  # TIER 3 Perks
  swordmaster:
    # Added damage fraction on sprint hits and sweep attacks (0.25 = +25%)
    damage-bonus: 0.25
  momentum:
    stages:
      - 1.0
      - 1.1
      - 1.2
      - 1.3
      - 1.35
      - 1.4
    reset-seconds: 5
  adrenaline:
    # Added damage fraction when below health threshold (0.50 = +50%)
    damage-bonus: 0.50
    # HP threshold to activate (12.0 = 6 hearts)
    health-threshold: 12.0
  counter:
    # Charge speed multiplier for skills (1.30 = 30% faster)
    charge-multiplier: 1.30
#  ██▄  ▄██ ▄▄  ▄▄▄▄  ▄▄▄▄
#  ██ ▀▀ ██ ██ ███▄▄ ██▀▀▀
#  ██    ██ ██ ▄▄██▀ ▀████
# Misc Settings
# Anti-farm protection for kill bounty:
# true  = killing the same player twice in a row gives no +10 bounty on the second kill.
# false = every valid kill gives +10 bounty.
dupe-fix: true
# Drop the victim's player head when killed by another player.
# true  = head drops on kill.
# false = no head drop.
head-drop: true
# Dragon egg resistance:
# true  = dragon egg gives resistance 2
# false = dragon egg doesn't give resistance 2
dragon-egg-resistance:
  enabled: true
# Do not change this - used for automatic config migration
config-version: 2

Key options

Key	Default	Description
`player-tracker.tracking-fee`	10	Cost to track a player with the tracker item.
`lasso.cooldown-seconds`	30	Cooldown between lasso throws.
`billcollector.tax-percent`	30	Percentage of a target's balance taken by the bill collector.
`dupe-fix`	true	Blocks farming +10 bounty by repeatedly killing the same player.
`head-drop`	true	Drops the victim's player head on a PvP kill.
`dragon-egg-resistance.enabled`	true	Whether holding a dragon egg grants Resistance II.

shopkeepers.yml

A separate data file, generated automatically the first time you run /outlawsmp shopkeeper create. Each placed shopkeeper NPC gets its own entry: a UUID for the invisible click-interaction entity, a UUID for the visible display entity, and its exact location. Values below are illustrative, not real placements.

shopkeepers.yml - example 1

shopkeepers:
  # Example 1 - a single shopkeeper NPC entry
  - interaction-uuid: "11111111-1111-1111-1111-111111111111"
    display-uuid: "22222222-2222-2222-2222-222222222222"
    world: world
    x: XX.X
    y: XX.X
    z: XX.X
    yaw: XX.X
    pitch: XX.X

Field	Description
`interaction-uuid`	UUID of the invisible interaction entity that detects clicks on the NPC.
`display-uuid`	UUID of the visible display entity (the NPC's skin/model).
`world` / `x` / `y` / `z`	The NPC's exact spawn location.
`yaw` / `pitch`	The direction the NPC faces.

⚠️

Don't hand-edit this file while the server is running - removing or moving a shopkeeper should go through /outlawsmp shopkeeper remove so the plugin's internal state stays in sync.

sheriff.yml

Same pattern as shopkeepers.yml, generated the first time you place a Sheriff Woody NPC. Values below are illustrative, not real placements.

sheriff.yml - example 1

sheriffs:
  # Example 1 - a single sheriff NPC entry
  - interaction-uuid: "33333333-3333-3333-3333-333333333333"
    display-uuid: "44444444-4444-4444-4444-444444444444"
    world: world
    x: -5.0
    y: 12.0
    z: -28.1
    yaw: -5.27
    pitch: 21.37

Field	Description
`interaction-uuid`	UUID of the invisible interaction entity that detects clicks on the NPC.
`display-uuid`	UUID of the visible display entity (the NPC's skin/model).
`world` / `x` / `y` / `z`	The NPC's exact spawn location.
`yaw` / `pitch`	The direction the NPC faces.

sheriff_placements.yml

A lightweight companion file to sheriff.yml - one compact world,x,y,z line per placed sheriff, used internally to track placements separately from the full NPC entity data. Value below is illustrative.

sheriff_placements.yml - example 1

placements:
  - world,-5,12,-28

Field	Description
`placements`	List of placed sheriff locations, one `world,x,y,z` string per entry.

data.yml

Stores each player's economy state, keyed by UUID. Updated automatically as players earn, spend, and rack up bounty - never hand-edit while the server is running. Values below are illustrative, not real player data.

data.yml - example 1

players:
  55555555-5555-5555-5555-555555555555:
    balance: 10.0
    bounty: 0
    last-known-name: Player1
  66666666-6666-6666-6666-666666666666:
    balance: 0.0
    bounty: 10
    last-known-name: Player2

Field	Description
`players.<uuid>`	The player's UUID - one entry per player who's touched the economy.
`balance`	Current OutlawSMP currency balance.
`bounty`	Active bounty on this player's head, visible on the bounty board.
`last-known-name`	Username at last login - used to display names without an online lookup.

← PreviousPermissions