StringPlugin

A simple utility plugin for Paper, Purpur, and Spigot 1.21+ to manage and distribute string via commands. Includes an action bar cooldown timer, customizable sounds, and simple permission checks.

Features

Instant Inventory Fill: Fills all 36 storage slots with a full inventory of string (2,304 total).

• Live Action Bar Timer: Displays the remaining cooldown countdown directly above the hotbar.
• Commands: Quick subcommands for /string fill, /string give, /string clear, /string cooldown reset, and /string reload.
• Sound & Particle Effects: Configurable sounds (pickup, errors, level up) and particle triggers when receiving string.
• Hex & Legacy Colors: Full support for RGB hex codes (&#55ff55) and legacy formatting codes (&) across chat and the action bar.
• Permissions: Configurable permission nodes for every command, plus cooldown bypass support (stringplugin.bypass.cooldown) etc .
• Performance: Standalone plugin with zero external dependencies—won't affect server MSPT or TPS.

Commands & Permissions

Commands

Command	Description
/string	Fills your inventory with string (2,304 string)
/string fill [player]	Fills your own or another player's inventory
/string give <player> [amount]	Gives a specific amount of string to a player
/string clear [player]	Clears all string from inventory
/string cooldown reset <player>	Resets a player's active cooldown
/string reload	Hot-reloads config.yml without server restart
/string help	Displays help and command list

Permissions

Permission	Description	Default
stringplugin.*	Grants access to all commands	op
stringplugin.admin	Access to all administrative features	op
stringplugin.use	Permission to use basic /string fill	true
stringplugin.fill	Permission to fill own inventory	true
stringplugin.fill.other	Permission to fill another player's inventory	op
stringplugin.give	Permission to give string to players	op
stringplugin.clear	Permission to clear own string	op
stringplugin.clear.other	Permission to clear another player's string	op
stringplugin.bypass.cooldown	Bypasses cooldown restrictions	op
stringplugin.cooldown.reset	Permission to reset cooldowns	op
stringplugin.reload	Permission to reload the configuration	op
stringplugin.help	Permission to view the help menu	true

⚙️ Configuration (config.yml)

cooldown:
  seconds: 30
  play-sound: true
inventory:
  fill-all-slots: true
  max-give-amount: 2304
actionbar:
  enabled: true
  cooldown-format: "&cCooldown: &e%seconds% seconds left"
  cooldown-singular: "&cCooldown: &e1 second left"
  expired-format: "&aCooldown expired!"
  expired-ticks: 40
messages:
  prefix: ""
  received-string-line1: "&aYou received &e%amount% &astring!"
  received-string-line2: "&6You can use this command again in &e%cooldown% seconds."
  cooldown-message: "&6You can use this command again in &e%cooldown% seconds."