Tobacco Plugin — Documentation
Addiction
The plugin features a three-stage habit system:
Stage I,
Stage II, and
Stage III.
You can turn it off in the config:
addiction:
enabled: false
Commands
Command
Description
/tobacco give <1-3> Give yourself a cigarette of the specified stage
/tobacco box Give yourself a Cigarette Box
/tobacco seed <1-3> Give yourself Tobacco Seeds of the specified stage
/tobacco lighter <blue|red|yellow|black|gold> Give yourself a lighter
/tobacco reload Reload the config
Permissions
Permission
Description
Default
tobacco.admin Access to all /tobacco commands OP only
Mechanics
You can get Tobacco Seeds by breaking
Short Grass and
Tall Grass.
Seed Type
Drop Chance
Light Seeds 6%
Medium Seeds 3%
Strong Seeds 0.8%
Each grass block broken triggers an independent drop chance for each seed type. Multiple seed types can drop from a single break.
Crafting
Cigarettes
Crafted in a
Crafting Table (2 slots in a row, left to right).
Result
Ingredient 1
Ingredient 2
Cigarette (Light) Paper Tobacco Leaf (Light)
Cigarette (Medium) Paper Tobacco Leaf (Medium)
Cigarette (Strong) Paper Tobacco Leaf (Strong)
Tobacco Leaves are obtained by growing and harvesting Tobacco crops from seeds.
Cigarette Box
Crafted in a
Crafting Table (3×3). Holds up to 18 cigarettes.
[ Paper ][ Paper ][ Paper ]
[ Leather ][ Leather ][ Leather ]
[ Paper ][ Paper ][ Paper ]
Butt Recycling
Shapeless recipe — place all 3 items anywhere in the crafting grid.
[ Cigarette Butt ] + [ Cigarette Butt ] + [ Cigarette Butt ]
Result: 1 Cigarette with half the normal puffs. The stage of the resulting cigarette is calculated as the average of the 3 butt stages (rounded).
Lighters
Crafted in a
Crafting Table (3×3). Lighters use vanilla durability and will break after extended use.
[ Dye ][ Iron Ingot ][ Dye ]
[ Iron Ingot ][ Flint & Steel ][ Iron Ingot ]
[ Dye ][ Iron Ingot ][ Dye ]
Result
Dye Used
Blue Lighter Blue Dye
Red Lighter Red Dye
Yellow Lighter Yellow Dye
Black Lighter Black Dye
Gold Lighter
Crafted in a
Crafting Table (3×3).
[ Gold Ingot ][ Gold Ingot ][ Gold Ingot ]
[ Gold Ingot ][ Flint & Steel ][ Gold Ingot ]
[ Gold Ingot ][ Gold Ingot ][ Gold Ingot ]
Cigarette Box
Crafted in (3×3). Can puff from 10 to 30 times with mixed tobacco and effects
[ Nothing ] [ Nothing] [ Bowl ]
[ Nothing ] [ Bowl ] [ Stick ]
[ Bowl ] [Stick] [Nothing ]
Tobacco Farming
- Plant Tobacco Seeds on farmland (like wheat).
- Wait for the crop to fully grow.
- Break the fully grown crop to receive:
- 1× Tobacco Leaf (matching seed stage)
- 2× Tobacco Seeds (matching seed stage)
Breaking before fully grown only returns 1× Tobacco Seeds, no leaf.
config.yml
Code (Text):
# ╔══════════════════════════════════════╗
# ║ Tobacco Plugin Config ║
# ╚══════════════════════════════════════╝
# Language file: basename of a YAML file in the lang/ folder (without .yml).
# Bundled with the plugin: en_en, ru_ru. Add more by dropping a file into lang/.
# Old short codes 'en' and 'ru' are still accepted for backward compatibility.
language: en_en
addiction:
enabled: true
chance-per-puff: 0.15
stages:
1:
withdrawal-minutes: 10
withdrawal-damage: 2.0
effects:
- SLOWNESS:100:0
- BLINDNESS:60:0
2:
withdrawal-minutes: 7
withdrawal-damage: 4.0
effects:
- SLOWNESS:160:1
- BLINDNESS:100:0
- NAUSEA:120:0
3:
withdrawal-minutes: 4
withdrawal-damage: 6.0
effects:
- SLOWNESS:200:2
- BLINDNESS:140:0
- NAUSEA:200:0
- WEAKNESS:200:1
smoke:
puff-hold-ticks: 25
deep-puff-hold-ticks: 55
deep-puff-damage: 1.5
puffs-per-cigarette: 10
tobacco-seed:
drop-chance-light: 0.06
drop-chance-medium: 0.03
drop-chance-strong: 0.008
resource-pack:
enabled: true
update-checker:
enabled: true
# Tobacco Pipe settings
pipe:
# Base puffs per tobacco slot (puffs-per-cigarette is used, so 1 tobacco = 10 puffs by default)
# Total puffs = loaded_tobaccos * puffs-per-cigarette
light-fail-chance: 0.10 # 10% chance the pipe doesn't catch when lighting
# ═══════════════════════════════════════════════════════════════
# INGREDIENTS — tobaccos & pipe-mix items
#
# Add as many entries as you want. Each ingredient has an `id`
# (the YAML key), a display name, a Material, optional drop
# settings, and lists of effects.
#
# Effect format: TYPE:durationTicks:amplifier
# e.g. SPEED:200:1 → Speed II for 10 seconds (200 ticks)
# Vanilla effect names are accepted: SPEED, SLOWNESS, REGENERATION,
# NIGHT_VISION, NAUSEA, WEAKNESS, STRENGTH, JUMP_BOOST, FIRE_RESISTANCE,
# WATER_BREATHING, INVISIBILITY, BLINDNESS, HUNGER, POISON, WITHER,
# HEALTH_BOOST, ABSORPTION, SATURATION, GLOWING, LEVITATION,
# LUCK, UNLUCK, SLOW_FALLING, CONDUIT_POWER, DOLPHINS_GRACE, BAD_OMEN,
# HERO_OF_THE_VILLAGE, DARKNESS (subject to your MC version).
#
# Mixing in pipe (≥ 2 different ingredients):
# • good-effects from each are applied with amplifier reduced by 1
# • bad-effects from each are applied at full strength
# • a baseline NAUSEA is added on top
# → "softer good + small debuff" as requested.
#
# mix-only: true
# Marks an ingredient as pipe-only. It cannot be used to craft cigarettes
# (paper + leaf in the crafting table) — it only works when loaded into
# a pipe. Use this for items like cookie, golden_apple, rotten_flesh —
# you don't want vanilla cookies to suddenly be craftable into cigarettes.
#
# Drop from grass:
# drop.enabled: true to spawn this ingredient's seeds when SHORT_GRASS,
# TALL_GRASS, FERN, or LARGE_FERN is broken.
# grow-all-biomes: true → seeds can be PLANTED in any biome/region (ignores biome-filter).
# grow-all-biomes: false → seeds can only be planted where this tobacco naturally grows
# (same biome-filter / worldguard-filter rules as wild drops).
# biome-filter: true → only drops in `biomes` list (vanilla biome keys).
# worldguard-filter: true → only drops inside one of `regions`.
# worldguard-filter: true → only drops inside one of `regions`.
# Both filters can be combined; both default to false.
# ═══════════════════════════════════════════════════════════════
ingredients:
light:
name: "&7Light Tobacco"
material: KELP
strength: 1 # 1=light, 2=medium, 3=strong (cosmetic colour)
deep-damage: 1.0
good-effects:
- SLOWNESS:140:0
bad-effects: []
deep-bad-effects:
- NAUSEA:100:0
drop:
enabled: true
chance: 0.06
grow-all-biomes: true # true = can plant anywhere; false = only in biomes/regions below
biome-filter: false
biomes: [ PLAINS, FOREST ]
worldguard-filter: false
regions: []
medium:
name: "&6Medium Tobacco"
material: DRIED_KELP
strength: 2
deep-damage: 1.5
good-effects:
- SPEED:140:0
bad-effects: []
deep-bad-effects:
- NAUSEA:140:1
drop:
enabled: true
chance: 0.03
grow-all-biomes: true # true = can plant anywhere; false = only in biomes/regions below
biome-filter: false
biomes: [ PLAINS, SAVANNA ]
worldguard-filter: false
regions: []
strong:
name: "&cStrong Tobacco"
material: FERMENTED_SPIDER_EYE
strength: 3
deep-damage: 2.0
good-effects:
- SPEED:140:1
- REGENERATION:140:0
bad-effects: []
deep-bad-effects:
- NAUSEA:200:1
- WEAKNESS:100:1
drop:
enabled: true
chance: 0.008
grow-all-biomes: true # true = can plant anywhere; false = only in biomes/regions below
biome-filter: false
biomes: [ JUNGLE, BAMBOO_JUNGLE ]
worldguard-filter: false
regions: []
# ── Example custom strain ─────────────────────────────────────
# Drops only inside a WG region called "tobacco_field". Disabled
# by default — set drop.enabled: true to use.
rare_minty:
name: "&bMinty Reserve"
material: PITCHER_PLANT # any item Material works
strength: 2
deep-damage: 0.5
good-effects:
- JUMP_BOOST:160:1
- SPEED:140:0
bad-effects: []
deep-bad-effects:
- NAUSEA:60:0
drop:
enabled: false
chance: 0.02
grow-all-biomes: false # false = only plantable inside the WG region below
biome-filter: false
biomes: []
worldguard-filter: true
regions: [ tobacco_field ]
# ── Pipe-mix items (no drop, just loadable into the pipe) ─────
golden_apple_mix:
name: "&6Golden Whiff"
material: GOLDEN_APPLE
strength: 3
deep-damage: 0.0
mix-only: true # only loadable into pipe; cannot be crafted into cigarette
good-effects:
- REGENERATION:200:1
- ABSORPTION:600:0
bad-effects: []
deep-bad-effects: []
drop:
enabled: false
rotten_flesh_mix:
name: "&2Rancid Smoke"
material: ROTTEN_FLESH
strength: 1
deep-damage: 0.5
mix-only: true # only loadable into pipe; cannot be crafted into cigarette
good-effects: []
bad-effects:
- HUNGER:200:0
deep-bad-effects:
- NAUSEA:160:0
drop:
enabled: false
golden_carrot_mix:
name: "&eGolden Glimmer"
material: GOLDEN_CARROT
strength: 2
deep-damage: 0.0
mix-only: true # only loadable into pipe; cannot be crafted into cigarette
good-effects:
- NIGHT_VISION:400:0
- SATURATION:60:0
bad-effects: []
deep-bad-effects: []
drop:
enabled: false
cookie_mix:
name: "&6Sweet Crumb"
material: COOKIE
strength: 1
deep-damage: 0.0
mix-only: true # only loadable into pipe; cannot be crafted into cigarette
good-effects:
- SATURATION:30:0
bad-effects:
- HUNGER:120:0
deep-bad-effects: []
drop:
enabled: false
pufferfish_mix:
name: "&5Toxic Bloom"
material: PUFFERFISH
strength: 3
deep-damage: 3.0
mix-only: true # only loadable into pipe; cannot be crafted into cigarette
good-effects:
- WATER_BREATHING:300:0
bad-effects:
- POISON:80:0
deep-bad-effects:
- NAUSEA:200:1
- WEAKNESS:200:1
drop:
enabled: false