⚖️ Temp4Boost — Advanced Temporary Boost Shop

A simple and powerful temporary boost shop plugin for Minecraft servers.

Temp4Boost lets you create custom potion-based boosts with durations, prices and clean GUI menus, giving your players a flexible and engaging way to enhance gameplay.

---

✨ Core Features

• GUI shop system: Category-based menus with safe browsing, confirmation screens and permission-aware visibility
• Timed boosts: Custom potion effects with configurable levels, duration, pricing, icons and layout
• Safety system: Cooldowns, max active boosts, category limits, same-effect protection and anti-exploit checks
• Safe reload: Prevents broken states and keeps a safe runtime if config fails
• Persistence: Boosts are saved and restored across restart, relog and respawn
• Live HUD: ActionBar rotation with boost name and remaining time
• Player command: /t4b active to view active boosts
• Customization: GUI, sounds, messages, layouts, categories and products
• Permissions: Per-category and per-product access with flexible visibility
• Head support: Items or custom heads (owner, Base64 or URL)
• Color support: Legacy and RGB/Hex formats
• Update checker: Optional version check
• PlaceholderAPI support: Raw and display placeholders

---

🚀 Advanced Systems

• Configurable stacking modes
• Same-effect protection
• Anti-exploit GUI checks
• Self-healing system (effect resync)
• Environment restrictions (worlds / creative mode)
• Milk and death behavior control
• Illegal amplifier protection (>255)

---

🔌 PlaceholderAPI Integration

Temp4Boost includes both raw and display-ready placeholders.

Core

Placeholder	Description
%temp4boost_active_count%	Active boosts
%temp4boost_has_<id>%	Check boost
%temp4boost_timeleft_<id>%	Remaining time
%temp4boost_list%	Boost list

Display

Placeholder	Description
%temp4boost_has_any%	Has any boost
%temp4boost_next_boost%	Next boost
%temp4boost_next_time%	Next time
%temp4boost_list_display%	Formatted list
%temp4boost_status%	Compact status

---

⚙️ Commands

Alias

Command	Description
/t4b	Main command
/temp4boost	Alias
/boostshop	Config alias

Usage

Command	Description
/t4b reload	Reload config
/t4b active	Show boosts
/t4b give <player> <boostId>	Give boost
/t4b remove <player> <boostId>	Remove boost
/t4b clear <player>	Clear boosts

---

🔐 Permissions

Permission	Description
temp4boost.use	Open GUI
temp4boost.active	Active command
temp4boost.admin	Admin commands
temp4boost.give	Give boosts
temp4boost.category.<category_id>	Category access
temp4boost.product.<category_id>.<product_id>	Product access
temp4boost.category.*	All categories
temp4boost.product.*	All products

---

🎯 Use Cases

• Survival servers
• PvP servers
• Minigames
• Custom progression systems

---

💻 Compatibility

• Minecraft: 1.18 → 1.21.x
• Java: 17 or higher
• Platforms: Paper / Spigot

---

❤️ Designed for Stability

Temp4Boost is built to be safe and reliable, with strong protection against invalid states and exploit scenarios.

---