Scripted SMP Utils

This plugin adds many utilities for your Scripted minecraft SMP such as Immortality, fast regen, anti armor break, Orbital strike cannon and railguns!

IMPORTANT

For the orbital strike cannon to work perfectly, go into spigot.yml and set the max tnt per tick to 1000000

To-do: Add fabric support

ScriptedSMPUtils

ScriptedSMPUtils is a very useful and multi-purpose plugin and handles server-management.

Key Features:

Orbital Strike Cannons: Includes Nuke shot, Stab shot, Railgun, Wolf cannon, Stasis, Totem-Stasis and Darkness.

Optimization: Optimization is a command that limits your entity view range and view distance and simulation distance to increase performance on your server.

Chatlock: For a unique Scripted Server you ofcourse need to lock the chat so no one can spam it to mess up your recording, well this locks it and no one can chat anymore!

Commands and Utilities: This includes Immortality, Fast-regen, Anti armor break, Server Freeze, Mafia tag, Deathkick (or ban), and DeathSound.

Highly configurable: U can configure everything inside the config.yml to fit your server's needs!

Example config.yml:

# ═══════════════════════════════════════════════════════════════
# ScriptedSMPUtils - Default Configuration
# ═══════════════════════════════════════════════════════════════

# ── Death Sound ───────────────────────────────────────────────
# Master toggle for the death sound effect.
enabled: true

# Bukkit sound key played on death.
sound: ENTITY.WITHER.SPAWN

# Sound volume from 0.0 to 2.0.
volume: 1.0

# Sound pitch from 0.0 to 2.0.
pitch: 1.0

# 0.0 plays to the whole world. Positive values limit playback to nearby players.
death-sound-range: 0.0

# ── Proximity Messages ────────────────────────────────────────
proximity-messages:
  # Enables proximity-based join, quit, and death messages.
  enabled: false
  
  # Maximum block distance for those messages.
  distance: 500

# ── Keep Inventory ────────────────────────────────────────────
keep-inventory:
  # Keeps inventory on death when enabled.
  enabled: false

# ── Chat Control ──────────────────────────────────────────────
chat:
  # NORMAL, DISABLED, or PROXIMITY.
  mode: NORMAL
  
  # Range used only when mode is PROXIMITY.
  proximity-range: 100.0
  
  # Message shown when chat is disabled.
  disabled-message: Chat is currently disabled.


# ── Death Punishment ──────────────────────────────────────────
death:
  # NONE, KICK, or BAN.
  action: NONE
  
  # Message used when action is KICK.
  kick-message: You died.
  
  # Reason used when action is BAN.
  ban-reason: Death is permanent.

# ── Fast Regen ────────────────────────────────────────────────
fast-regen:
  # Master toggle for the fast regen system.
  enabled: false
  
  # 2.0 doubles hunger and saturation gains from food.
  saturation-multiplier: 2.0
  
  # Healing tick interval while the player has enough food and saturation.
  regen-interval-ticks: 20

# ── Anti Armor Break ──────────────────────────────────────────
anti-armor-break:
  # Master toggle for armor break protection.
  enabled: false
  
  # Remaining durability to preserve on protected armor pieces.
  min-durability: 1

# ── Optimization ──────────────────────────────────────────────
optimization:
  # Applies lower player-side view settings to non-admin players.
  enabled: false
  
  view-distance: 12
  simulation-distance: 6
  
  # Reserved for compatibility with the imported config layout.
  entity-tracking-range: 32

# ── Server Freeze ─────────────────────────────────────────────
server-freeze:
  # Persisted global freeze state.
  enabled: false

# ── Immortality Settings ──────────────────────────────────────
settings:
  # If the immortal player is holding a totem in either hand, the plugin does nothing.
  allow-totem-pop: true
  
  # 1.0 = half a heart.
  min-health: 1.0
  
  # Set to 0 to always protect them from dropping below min-health.
  health-set-cooldown-seconds: 0

# ── Immortality Resistance ────────────────────────────────────
resistance:
  # Potion amplifier applied during the save tick.
  amplifier: 255
  
  # Ticks of temporary resistance.
  duration-ticks: 2
  
  # Delay before restoring the previous resistance effect.
  remove-after-ticks: 1
  
  # Ambient = subtler particles.
  ambient: true

# ── Immortality Damage Filter ─────────────────────────────────
damage-causes:
  # BLACKLIST handles every cause except those in the list.
  # WHITELIST handles only the causes in the list.
  mode: BLACKLIST
  
  # Example: add SUICIDE if you want /kill to bypass immortality.
  list:
  - CUSTOM

# ── Immortality Commands ──────────────────────────────────────
commands:
  # If false, /immortal set only works for online players.
  allow-offline-targets: true

# ── Immortality Data ──────────────────────────────────────────
data:
  # Autosave data.yml every X seconds. Set to 0 to disable autosave.
  auto-save-interval-seconds: 60

# ── Orbitals ──────────────────────────────────────────────────
orbital:
  # Delay before an orbital fishing rod payload executes.
  rod-delay-seconds: 0.75

# ── Messages ──────────────────────────────────────────────────
messages:
  prefix: '&8[ScriptedSMPUtils]&r '
  set: '&a%player% is now immortal.'
  unset: '&c%player% is no longer immortal.'
  already: '&e%player% is already immortal.'
  not: '&e%player% is not immortal.'
  reload: '&aConfig reloaded.'
  list: '&eImmortal (&f%count%&e): &f%players%'
  no-permission: '&cNo permission.'
  usage: '&cUsage: /immortal <player> | /immortal <set|unset|toggle> <player> | /immortal
    <list|reload>'

# ── Debug ─────────────────────────────────────────────────────
# Enables extra debug logging when supported.
debug: false

And Example Commands:

/scriptedsmp [reload|deathsound|proximitychat|nochat|fastregen|antiarmor|freeze|keepinventory|optimization] 

/chat [disable|normal|proximity]

/fastregen <player>

/antiarmor <player>

/deathsound [on|off]

/death [ban|kick|normal|sound]

/immortal [list|set|toggle|unset]

/os [nuke|stab|darkness|railgun|wolf|stab|totem-stasis] <amount> (for nuke) <how many rings> <player> (optional)

/orbitalstrike [nuke|stab|darkness|railgun|wolf|stab|totem-stasis] <amount> (for nuke) <how many rings> <player> (optional)

/osc [nuke|stab|darkness|railgun|wolf|stab|totem-stasis] <amount> (for nuke) <how many rings> <player> (optional)