Skip to content

README.md

Latest commit

 

History

History
138 lines (97 loc) · 3.56 KB

README.md

File metadata and controls

138 lines (97 loc) · 3.56 KB

The Bartender | A Customizable Potion Bar Experience

The Bartender lets you create a fully interactive in-game potion bar, where players can browse, purchase, and consume custom drinks with effects — just like a real tavern! Designed for RPG, survival, and themed servers wanting an immersive experience.

✨ Features

  • Custom drinks with potion effects and economy pricing
  • Fully customizable GUI layout (menu, items, lore, effects)
  • /bartender menu with categories, sanity effects, and more
  • Optional Sanity System for immersive roleplay mechanics
  • Supports Vault economy integration
  • Hooks into Brewery (if installed)
  • Folia, Purpur & Paper support out of the box

📦 Download

Latest release:
👉 SpigotMC Resource Page
👉 ker35.com

🍻 How It Works

  1. Player runs /bartender or clicks an NPC/shop sign
  2. A GUI opens displaying your configured drinks
  3. Each drink has a name, lore, price, and effects
  4. Click to buy — Vault deducts money, drink is consumed
  5. Optionally: apply sanity buffs/debuffs depending on drink

⚙️ Installation

  1. Place the .jar into /plugins
  2. Start server to generate configs
  3. Configure drinks in drinks.yml and sanity in sanity.yml
  4. Customize messages and GUI layout
  5. Reload plugin with /bartender reload or restart server

🧾 Commands & Permissions

Command Description Permission
/bartender Opens the drink menu GUI bartender.use
/bartender reload Reloads all config files bartender.reload
/bartender sanity Check or manage player sanity bartender.sanity
/bartender admin Advanced admin commands bartender.admin

🥂 Example Drink Configuration (drinks.yml)

drinks:
  rum:
    name: "&6Spiced Rum"
    material: POTION
    lore:
      - "&7A warm drink with a kick."
      - "&ePrice: $25"
    effects:
      - "SPEED:1:200"
      - "CONFUSION:1:100"
    price: 25
    permission: "bartender.drink.rum"

🧠 Sanity System (Optional)

Enable sanity to make drinks affect player mental state — buffs or debuffs when sanity is low. Configure in sanity.yml.

enabled: true
deathAtZero: true
effects:
  below50:
    - "WEAKNESS:0:200"
  below25:
    - "NAUSEA:0:100"
  zero:
    - "WITHER:1:60"

Use commands to track and modify player sanity levels.

🔌 Integrations

  • Vault: Money system for buying drinks
  • Brewery: Auto-add custom drinks to bartender GUI
  • PlaceholderAPI (planned)

✅ Compatibility

  • Java 17+
  • Minecraft 1.16 – 1.21+
  • Paper / Purpur / Folia (Thread-safe)

💬 Support

Main support is via Discord
Alternative support and inquiries at ker35.com

📌 Notes

  • Sanity is per-player and saved in sanity.yml
  • You can disable sanity entirely in config
  • GUI and drink items are fully configurable
  • Supports hex color formatting (e.g. #ff66cc)

🔒 Licensing & Usage

  • Do not redistribute, reupload, or sell modified versions
  • All sales are final unless required by law
  • Chargebacks result in bans from all Ker35.com services
    Full terms: Terms of Service

© 2025 Ker35