# SpitSTIK – Highly Configurable Spit Plugin<\/p>\n
**SpitSTIK** is a customizable Minecraft plugin that adds `\/spit` command, allowing players to launch spit projectiles with adjustable mechanics.<\/p>\n
**Join our** **Discord** \u2014 discover other cool plugins, suggest new features, or get help with configuration.
\n### Features \u2728<\/p>\n
– **Customizable Spit Mechanics**:
\n – Adjust velocity, cooldown, damage, and sound effects
\n – Multiple permission-based groups with overriding settings
\n – CoreProtect integration for item frame logging
\n – MiniMessage support for rich chat formatting<\/p>\n
* **Projectile Control**:
\n – Toggleable damage (`defaultDoDamage`)
\n – Spit action is accompanied by ENTITY_LLAMA_SPIT sound
\n – Fine-tuned audio controls (volume\/pitch)<\/p>\n
– **Group System**:
\n – Priority-based permissions (`group1`-`group3` extendable)
\n – Unique settings per group (velocity up to 1.5 default)
\n – Cooldowns from 4-10 seconds<\/p>\n
* **Safety & Logging**:
\n – Configurable **CoreProtect logging** for item frame interactions
\n – Player-specific cooldown tracking
\n – Permission-locked commands<\/p>\n
### Main config (`config.yml`) \u2699\ufe0f<\/p>\n “`yaml # default cooldown in milliseconds for “\/spit” command # default velocity with which launch spit # Plays the “ENTITY_LLAMA_SPIT” sound when the “\/spit” command is used. # does damage from “\/spit” # default Volume # default Pitch # Material – item in main hand # Log to CoreProtect when a spit projectile removes an item from an ItemFrame. # special groups which have their own cooldown, velocity, useSound and doDamage to “\/spit” # you have 3 groups here, but you create another ones, isn’t it great? # permission required – “SpitSTIK.group2” # permission required – “SpitSTIK.group3” ### Messages Config (`messages.yml`)<\/p>\n “`yaml listener: command: ### Permissions \ud83d\udd10 ### Commands \ud83d\udcdf highly configurable \/spit command<\/p>\n","protected":false},"featured_media":147008,"template":"","meta":{"_minecraft_slug":"spitstik","_minecraft_project_id":"TucZoAYc","_minecraft_author":"STOKMEN","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":455,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"spitstik.zip","_minecraft_size_bytes":57976,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T10:45:48.508647Z","_minecraft_date_created":"2025-04-13T01:50:47.243101Z","_minecraft_date_modified":"2025-06-24T12:37:52.534167Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/spitstik","_minecraft_icon_attachment_id":147008,"_minecraft_imported_at":"2026-06-08T19:30:54+00:00","_minecraft_import_hash":"4b1b80a4954b667dd009929829ff4246","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,127,128,867,92],"mod_loader":[131,132,133],"minecraft_version":[53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-147007","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nconfig.yml<\/strong><\/summary>\n
\n# Join our discord – https:\/\/discord.gg\/YGzA4UxzFB you can find another good plugins there.
\n# Permissions
\n# “SpitSTIK.use” – permission required to use “\/spit” command
\n# “SpitSTIK.reload” – permission required to use “\/spit reload” command<\/p>\n
\ndefaultCooldown: 10000<\/p>\n
\ndefaultVelocity: 0.4<\/p>\n
\ndefaultUseSound: true<\/p>\n
\ndefaultDoDamage: false<\/p>\n
\ndefaultVolume: 1.0<\/p>\n
\ndefaultPitch: 1.0<\/p>\n
\n# is material required to use “\/spit”, if materialsList is empty, material is not required
\ndefaultMaterialsList:
\n# – “WHITE_DYE”<\/p>\n
\nlogCoreProtect: false
\ncoreProtectPrefix: “#SpitSTIK-”<\/p>\n
\n# if you don’t use special groups, “\/spit” will be launched with default cooldown, velocity, useSound, doDamage, volume, pitch
\nuseSpecialGroups: false<\/p>\n
\n# you just need to create another group, but you need to do this inside “groups:” block
\n# All group names must follow the format “groupX”, where X is a number (e.g., “group4”, “group23”).
\n# and of course all groups must have cooldown, velocity, useSound, doDamage, volume, pitch
\n# If a player has more than one group, the one with the highest number will have priority.
\ngroups:
\n # permission required – “SpitSTIK.group1”
\n group1:
\n cooldown: 8000
\n velocity: 0.7
\n useSound: true
\n doDamage: false
\n volume: 0.7
\n pitch: 1.0
\n materialsList:
\n# – “LIGHT_GRAY_DYE”<\/p>\n
\n group2:
\n cooldown: 6000
\n velocity: 1.0
\n useSound: true
\n doDamage: false
\n volume: 1.0
\n pitch: 1.0
\n materialsList:<\/p>\n
\n group3:
\n cooldown: 4000
\n velocity: 1.5
\n useSound: true
\n doDamage: false
\n volume: 3.0
\n pitch: 0.5
\n materialsList:
\n# – “DARK_GRAY_DYE”
\n “`
\n<\/details>\nmessages.yml<\/strong><\/summary>\n
\n# this config supports MiniMessage
\nconfigReloaded: “
\n spitReceive: “Player %player% spat on you”<\/p>\n
\n onlyPlayerCanUse: “
\n noPermissionToUse: “
\n wrongMaterial: “
\n noPermissionToReload: “
\n cooldownRemaining: “
\n “`
\n<\/details>\n
\n| Permission Node | Description |
\n|————————–|———————————|
\n| `SpitSTIK.use` | Basic spit command access |
\n| `SpitSTIK.reload` | Config reload permission |
\n| `SpitSTIK.group[1-X]` | Tiered group system access |<\/p>\n
\n| Command | Description |
\n|————————–|———————————|
\n| `\/spit` | Launch projectile |
\n| `\/spit reload` | Reload configs |<\/p>\n","protected":false},"excerpt":{"rendered":"