Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
1.19.x
1.18.2
Platforms
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Licensed GPL-3.0-only
Published last month
Updated 4 weeks ago
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 Discord — 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)
- Toggleable damage (
-
Group System:
- Priority-based permissions (
group1
-group3
extendable) - Unique settings per group (velocity up to 1.5 default)
- Cooldowns from 4-10 seconds
- Priority-based permissions (
-
Safety & Logging:
- Configurable CoreProtect logging for item frame interactions
- Player-specific cooldown tracking
- Permission-locked commands
Main config (config.yml
) ⚙️
config.yml
# Join our discord - https://discord.gg/YGzA4UxzFB you can find another good plugins there. (don't delete this string)
# 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
# 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
# permission required - "SpitSTIK.group2"
group2:
cooldown: 6000
velocity: 1.0
useSound: true
doDamage: false
volume: 1.0
pitch: 1.0
# permission required - "SpitSTIK.group3"
group3:
cooldown: 4000
velocity: 1.5
useSound: true
doDamage: false
volume: 3.0
pitch: 0.5
Messages Config (messages.yml
)
messages.yml
# this config supports MiniMessage
configReloaded: "<green>✔ Config has been reloaded"
listener:
spitReceive: "Player <player> spat on you"
command:
onlyPlayerCanUse: "<red>✘ This command can only be used by a player"
noPermissionToUse: "<red>✘ You do not have permission to use this command"
noPermissionToReload: "<red>✘ You do not have permission to reload the SpitSTIK plugin"
cooldownRemaining: "<red>✘ 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 |