Alcohol

A comprehensive brewing and farming plugin for Minecraft servers, adding a complete brewing industry chain, multiple custom machines, a rich selection of drinks and special effects, along with an integrated recipe viewer and item management system.

Introduction

Alcohol is a feature-rich server plugin inspired by Let's Do Brewery and Let's Do Vinery. It brings a complete industry chain to your server, from crop farming → ingredient processing → brewing → aging → drinking.

Core Features

• 50+ Drinks
  Beers, whiskies, wines, aged wines, grape juices, apple juices and more. Every drink has its own appearance, effects and brewing recipe.

• Complete Farming System
  Corn, cherries, grapes (with 8 biome variants), supporting natural growth, bone meal acceleration, bee pollination, and custom drops.

• Multiple Custom Machines
  Cooking Pot, Brewing Box, Apple Press, Aging Barrel, Grape Basin and Bar Music Player. Each machine has its own GUI and progress mechanics.

• Brewing and Aging Mechanics
  Produce drinks with the Brewing Box, then improve their quality in the Aging Barrel. Brewing involves pressure management, fuel consumption and quality degradation.

• Rich Drinking Effects
  Vanilla potion effects plus custom special effects (Climb, Water Walker, Lava Walker, Catgirl, MaoDie, etc.), with cooldowns and notifications.

• Recipe Viewer and Item Give GUI
  Use /alcohol recipe to view recipes and crafting methods for all machines, and /alcohol give to quickly obtain plugin items.

• Villager Trades
  Farmer villagers sell cherries, without affecting vanilla trades.

• Persistence
  Containers, plants, special effects, GUI page numbers and other data are restored automatically after a restart.

• Multi-language Support
  Built-in English and Simplified Chinese, with support for adding more languages via custom files or contribute your region's language.

Installation

Requirements

Item	Version
Server	Paper 26.2 or later
Java	Java 25
Dependency	NoteBlockAPI 1.7.0+ (for the Bar Music Player)

Installation Steps

1. Download the dependency Place NoteBlockAPI-1.7.0.jar into your server's plugins/ directory.

2. Download the plugin Place Alcohol.jar into your server's plugins/ directory.

3. Start the server On first startup, the plugin creates its data directory and configuration files under plugins/Alcohol/.

4. Add custom songs (optional) Place .nbs song files into plugins/Alcohol/songs/, then run /alcohol reload to load them.

5. Verify the installation Run /alcohol help in game. If the help list appears, the installation was successful.

⚠ Tip
On first startup, the plugin generates data.yml, effects.yml, config.yml and the songs/ directory.

Configuration

Data Files

File	Purpose	When It Is Saved
data.yml	Stores the state of cooking pots, brewing boxes, apple presses, aging barrels, grape basins, corn, grapes, cherry trees, etc.	Auto-saved every 5 minutes + saved on shutdown
effects.yml	Stores player special effects, actionbar display state, and hidden cobweb coordinates	Saved immediately on change + every 30 seconds as a fallback
config.yml	Plugin language settings (default-locale)	Read by the plugin; edited by the administrator
songs/	Stores .nbs song files, loaded automatically into the Bar Music Player	Read-only

Adding Songs

1. Create or download .nbs files with Note Block Studio.
2. Place the files into plugins/Alcohol/songs/.
3. Run /alcohol reload or restart the server.
4. Open the Bar Music Player GUI and your new songs will appear.

Backup Recommendations

File	Frequency
data.yml	Weekly
effects.yml	Weekly
config.yml	Not necessary
songs/	One-time (unless manually modified)

⚠ Warning
- Do not edit data.yml / effects.yml by hand — YAML syntax errors will cause data to fail loading.
- Old data remains compatible when upgrading the plugin; there is no need to wipe it.
- Deleting data.yml will lose all container and plant data, so proceed with caution.

Commands

General Commands

Command	Description	Permission
/alcohol help	Show the help list	None
/alcohol recipe	Open the main recipe GUI	alcohol.recipe
/alcohol recipe <machine> [craft]	View recipes / crafting methods for a machine	alcohol.recipe
/alcohol give	Open the item give GUI	alcohol.give
/alcohol give <player> <item> <amount>	Give an item to the specified player	alcohol.give
/alcohol reload	Reload the plugin and songs	alcohol.reload
/alcohol kill <CatGirl|MaoDie>	Remove leftover Catgirl / MaoDie entities	alcohol.kill
/alcohol refresh [all]	Rebuild item names in player inventories or machines	alcohol.refresh

Permission Nodes

Permission	Description	Default
alcohol.recipe	View recipes	All players
alcohol.give	Obtain / give items	OP
alcohol.reload	Reload the plugin	OP
alcohol.kill	Remove leftover entities	OP
alcohol.refresh	Rebuild items	OP

Supported Machine Names

Machine names available for /alcohol recipe <machine>:

Machine Name	Label
CookingPot	Cooking Pot
BrewingBox	Brewing Box
ApplePress	Apple Press
AgingBarrel	Aging Barrel
GrapeBasin	Grape Basin
MusicPlayer	Bar Music Player

Issue

If you find any problems or bugs, please open an issue on GitHub or submit feedback on xiaomian124.top.

License and Credits

The gameplay design of this plugin is inspired by the following mods:

• Let's Do Brewery — by satisfyu
• Let's Do Vinery — by satisfyu

This plugin is an independent implementation and does not use any resource files from the original mods that are distributed under an ARR (All Rights Reserved) license.
See the NOTICE file for the full statement.

⚠ Tip
This project is open-sourced under the GNU General Public License v3.0.
See LICENSE for details.