[img] tag

The one plugin your survival server needs.

This plugin tackles limitations and common problems of vanilla survival multiplayer, by adding various tweaks and configuration options. SMPtweaks is fully modular, largely async and built in a lightweight way with high player counts in mind.

All features can be enabled individually and put zero load on your server when not used.


[img] tag

Custom death logic
Fine-tune what happens when a player dies: Options to reduce item durability, keep equipment, drop only a portion of XP or items carried, drop chance per inventory slot, respawn health and hunger points etc.

Modify day/night cycle
Increase or decrease duration of day or night, disable sleeping, reduce bad weather etc.

Change mob spawning behaviour
Configure how frequently a certain type of mob spawns, disable some spawns completely (for example phantoms) and allow naturally spawning shulkers.

Easy way to add custom crafting recipes
Recipes can be easily added via the config file so you won't need another plugin or heavyweight datapacks for that.

Various other tweaks
Set XP & mending repair amount multiplier, buff vegetarian food, etc.


[img] tag

Server level system
Persistent level based on total experience gained

Recurring rewards
Configure item rewards players can collect in regular intervals

[img] tag

[img] tag


[img] tag

1. Download the plugin jar and place it in the
/plugins/ folder
2. Restart the server
3. Configure the plugin by editing
/plugins/SMPtweaks/config.yml

Please note that this plugin requires at least Java 16 and Minecraft version 1.17 or higher.



[img] tag

Below is the default config file with all features disabled. Please refer to the documentation if anything is unclear.

#
# General plugin settings
#
verbose: false
language: en-US
#
# MYSQL Settings
# If you leave this the way it is, the plugin will use SQLite instead
#
mysql:
  enabled: false
  host: ''
  username: ''
  password: ''
  database: 'smptweaks'
#
# Whether PAPI placeholders should be enabled. This requires the plugin PlaceholderAPI to be installed
#
papi_placeholders:
  enabled: false
#
# Whether players should drop items and experience on death
# Note: keepInventory needs to be ON in order to use this feature
#
remove_xp_on_death:
  enabled: false
  base: 5
  portion_of_current: 0.4
  randomize: true
  max: 1000
  drop_on_ground: true
  drop_amount_multiplier: 1.0
  disable_for_pvp_deaths: false
  disable_for_non_pvp_deaths: false
remove_inventory_on_death:
  enabled: false
  chance_per_slot: 1.0
  portion_per_slot: 0.6
  randomize: true
  include_non_stackable_items: false
  drop_on_ground: true
  drop_amount_multiplier: 1.0
  always_drop:
    - DIRT
    - COBBLESTONE
  never_drop:
    - DRAGON_EGG
  disable_for_pvp_deaths: false
  disable_for_non_pvp_deaths: false
remove_equipment_on_death:
  enabled: false
  chance_per_slot: 0.3
  drop_on_ground: true
  disable_for_pvp_deaths: false
  disable_for_non_pvp_deaths: false
decrease_item_durability_on_death:
  enabled: false
  multiplier: 0.8
  disable_for_pvp_deaths: false
  disable_for_non_pvp_deaths: false
respawn_health: 20 # The amount of half hearts players have after they respawn
respawn_food_level: 20 # The amount of half hunger points players have after they respawn
#
# Day-night cycle & weather tweaks
#
disable_night_skip: false # Sleeping will not skip the night
health_regen_while_in_bed: false # Give regeneration effect to players lying in bed
day_duration_modifier: 0 # Number of ticks to make days longer or shorter (inaccurate!)
night_duration_modifier: 0 # Number of ticks to make nights longer or shorter (inaccurate!)
clear_weather_at_dawn: false # Force sunshine in the morning, results in less bad weather overall
#
# Other tweaks
#
xp_multiplier: 1.0 # eg. 0.5 for half the experience gain
mending_repair_amount_multiplier: 1.0 # eg. 2.0 to repair items twice as fast
buff_vegetarian_food: false # Slightly increases saturation restored by some vegetarian foods
shulkers_spawn_naturally: false # Occasionally spawn shulkers in the end
#
# Modify spawn rates
# Allowed multiplier range is from 0 (no spawns at all) to 1 (normal spawn rate)
# Keep in mind that if you reduce spawns of a certain mob type,
# it will result in slightly more spawns of other mobs as the mob cap will remain unchanged
#
spawn_rates:
  enabled: false
  mobs:
    - type: CREEPER
      multiplier: 0.7
    - type: PHANTOM
      multiplier: 0
#
# Specify what happens when certain mobs die
# If you specify a custom item drop for the ender dragon, the drop will appear next to the exit portal
# instead of the mobs death location
#
custom_drops:
  enabled: false
  mobs:
    - type: ENDER_DRAGON # Entity type
      xp: 800 # Overwrite how much experience the mob drops
      commands: # List of commands that will execute
        - 'minecraft:effect give @p regeneration 12'
      drops: # List of items that may drop ADDITIONALLY to vanilla drops
        - material: DRAGON_EGG
          amount: 1
          chance: 1.0
#
# Custom crafting recipes
#
custom_recipes:
  enabled: false
  recipes:
    - material: ELYTRA
      shape:
        - 'MDM'
        - 'M M'
        - 'M M'
      ingredients:
        - material: DRAGON_EGG
          key: D
        - material: PHANTOM_MEMBRANE
          key: M
    - material: LEATHER
      amount: 1
      ingredients:
        - material: ROTTEN_FLESH
          amount: 9
#
# Select which commands you want to enable
#
enable_commands:
  level: false
  whereis: false
#
# Login Rewards
#
rewards:
  enabled: false
  cooldown: 82800 # Cooldown in seconds between collecting rewards
  scale_amount_with_level: true # Whether the amount received scales with server level, otherwise random
  broadcast_collection: true # Whether reward collection will be broadcasted to chat
  xp: 50 # How much experience the player receives when collecting their reward
  contents:
    - material: BREAD
      min_amount: 1
      max_amount: 3
      max_level: 10
      weight: 10
    - material: IRON_INGOT
      max_amount: 6
      min_level: 5
      max_level: 20
      weight: 5
    - material: DIAMOND
      min_level: 15
#
# Whether the SMPtweaks server level system is used
#
server_levels:
  enabled: false
  count_mending_xp: true # Whether experience that is used for mending counts towards server level
  broadcast_levelup: true # Whether levelup will be broadcasted to chat
  thresholds: [
      0,
      100,
      240,
      420,
      640,
      900,
      1200,
      1540,
      1920,
      2340,
      2800,
      3300,
      3840,
      4420,
      5040,
      5700,
      6400,
      7140,
      7920,
      8740,
      9600,
      10500,
      11480,
      12560,
      13730,
      15000,
      16350,
      17800,
      19340,
      20980,
      22710,
      24540,
      26470,
      28500,
      30630,
      32860,
      35190,
      37630,
      40170,
      42810,
      45560,
      48420,
      51390,
      54470,
      57660,
      60960,
      64370,
      67900,
      71540,
      75300,
      79180,
      83180,
      87490,
      92140,
      97150,
      102500,
      108200,
      114400,
      121000,
      128100,
      135600,
      143600,
      152100,
      161200,
      170900,
      181100,
      192000,
      203600,
      215900,
      228900,
      242600,
      257200,
      272600,
      289000,
      306200,
      324400,
      343700,
      364000,
      385500,
      408200,
      432100,
      457400,
      487800,
      524500,
      568700,
      621900,
      685900,
      762900,
      855400,
      966600,
      1100100,
      1260600,
      1453200,
      1684600,
      1962500,
      2296000,
      2696500,
      3277200,
      4000000
  ]


[img] tag

We provide support via Spigot Forums or the HelpChat Discord. If you have any questions, please post in the #general-plugins or #general-plugins-2 channel and make sure to mention your request is regarding SMPtweaks and tag @noni#4879 in your message!

HelpChat is not affiliated with or in any way officially connected to SMPtweaks.


[img] tag

Big thanks to Schmon, c0l0ss0s and the HelpChat community for giving valueable feedback.
If you enjoy SMPtweaks, make sure to leave a review.
Got an idea how we could improve this plugin? Let us know in the Spigot Discussion :)


[img] tag

Documentation
GitHub
Report a bug