SpitSTIK

highly configurable /spit command

455

SpitSTIK

SpitSTIK - Highly Configurable Spit Plugin

SpitSTIK is a customizable Minecraft plugin that adds `/spit` command, allowing players to launch spit projectiles with adjustable mechanics.

Join our Join our — discover other cool plugins, suggest new features, or get help with configuration.

Features ✨

- Customizable Spit Mechanics: - Adjust velocity, cooldown, damage, and sound effects - Multiple permission-based groups with overriding settings - CoreProtect integration for item frame logging - MiniMessage support for rich chat formatting

* Projectile Control: - Toggleable damage (`defaultDoDamage`) - Spit action is accompanied by ENTITY_LLAMA_SPIT sound - Fine-tuned audio controls (volume/pitch)

- Group System: - Priority-based permissions (`group1`-`group3` extendable) - Unique settings per group (velocity up to 1.5 default) - Cooldowns from 4-10 seconds

* CoreProtect logging: - Configurable CoreProtect logging for item frame interactions - Player-specific cooldown tracking - Permission-locked commands

Main config (`config.yml`) ⚙️

config.yml

```yaml

Join our discord - https://discord.gg/YGzA4UxzFB you can find another good plugins there.

Permissions

"SpitSTIK.use" - permission required to use "/spit" command

"SpitSTIK.reload" - permission required to use "/spit reload" command

default cooldown in milliseconds for "/spit" command

defaultCooldown: 10000

default velocity with which launch spit

defaultVelocity: 0.4

Plays the "ENTITY_LLAMA_SPIT" sound when the "/spit" command is used.

defaultUseSound: true

does damage from "/spit"

defaultDoDamage: false

default Volume

defaultVolume: 1.0

default Pitch

defaultPitch: 1.0

Material - item in main hand

is material required to use "/spit", if materialsList is empty, material is not required

defaultMaterialsList:

- "WHITE_DYE"

Log to CoreProtect when a spit projectile removes an item from an ItemFrame.

logCoreProtect: false coreProtectPrefix: "#SpitSTIK-"

special groups which have their own cooldown, velocity, useSound and doDamage to "/spit"

if you don't use special groups, "/spit" will be launched with default cooldown, velocity, useSound, doDamage, volume, pitch

useSpecialGroups: false

you have 3 groups here, but you create another ones, isn't it great?

you just need to create another group, but you need to do this inside "groups:" block

All group names must follow the format "groupX", where X is a number (e.g., "group4", "group23").

and of course all groups must have cooldown, velocity, useSound, doDamage, volume, pitch

If a player has more than one group, the one with the highest number will have priority.

groups:

permission required - "SpitSTIK.group1"

group1: cooldown: 8000 velocity: 0.7 useSound: true doDamage: false volume: 0.7 pitch: 1.0 materialsList:

- "LIGHT_GRAY_DYE"

permission required - "SpitSTIK.group2"

group2: cooldown: 6000 velocity: 1.0 useSound: true doDamage: false volume: 1.0 pitch: 1.0 materialsList:

permission required - "SpitSTIK.group3"

group3: cooldown: 4000 velocity: 1.5 useSound: true doDamage: false volume: 3.0 pitch: 0.5 materialsList:

- "DARK_GRAY_DYE"

```

Messages Config (`messages.yml`)

messages.yml

```yaml

this config supports MiniMessage

configReloaded: "<green>✔ <white>Config has been reloaded"

listener: spitReceive: "Player %player% spat on you"

command: onlyPlayerCanUse: "<red>✘ <white>This command can only be used by a player" noPermissionToUse: "<red>✘ <white>You do not have permission to use this command" wrongMaterial: "<red>✘ <white>You need special item in hand to use this command" noPermissionToReload: "<red>✘ <white>You do not have permission to reload the SpitSTIK plugin" cooldownRemaining: "<red>✘ <white>Please wait <cooldownRemaining>s." ```

Permissions 🔐

| Permission Node | Description | |--------------------------|---------------------------------| | `SpitSTIK.use` | Basic spit command access | | `SpitSTIK.reload` | Config reload permission | | `SpitSTIK.group[1-X]` | Tiered group system access |

Commands 📟

| Command | Description | |--------------------------|---------------------------------| | `/spit` | Launch projectile | | `/spit reload` | Reload configs |

ADS