🌾 FastCane

The sugar cane growth controller for Paper servers

Tired of waiting 3+ minutes for sugar cane to grow one block?
FastCane gives you full control — from vanilla speed to near-instant, with zero TPS cost.

---

✨ Features

• 🚀 Configurable growth speed — any tick interval from 1 to 100,000
• ⚡ Zero TPS impact — event-driven architecture, no chunk scanning loops
• 🌿 Sugar cane only — every other plant stays 100% vanilla
• ⏸ Stop / Start — pause and resume growth anytime
• 🔄 Reset — back to vanilla speed in one command
• 🌍 Multi-language — English, Français, 中文
• 💾 Persistent — your settings survive restarts
• 🎯 Tab completion — smart presets built into the command

---

⚡ Commands

Command	Description
/cane	Show current settings panel
/cane tick <ticks>	Set growth speed
/cane tick	Show current speed & tracked canes
/cane stop	Stop all cane growth
/cane start	Resume cane growth
/cane reset	Reset to vanilla speed (4096 ticks)
/cane lang <en|fr|zh>	Change language
/cane info	Show info panel

Aliases: /sugarcane, /sc

---

⏱ Speed Reference

Command	Interval	Feel
/cane tick 1	~0.05s	🟢 Near-instant
/cane tick 20	1s	🟢 Ultra fast
/cane tick 100	5s	🟡 Very fast
/cane tick 1000	50s	🟡 Fast
/cane tick 4096	~3.4 min	🔵 Vanilla
/cane tick 10000	~8.3 min	⚪ Default

💡 20 ticks = 1 second

---

🔐 Permissions

Permission	Description	Default
fastcane.use	Use /cane & view speed	OP
fastcane.admin	Change speed, stop, start, reset, lang	OP

---

⚙️ How It Works

Instead of scanning every block in every loaded chunk each tick (which destroys TPS), FastCane uses an event-driven index:

• 📦 Chunk loads → cane bases indexed once
• 🌱 Player places cane → added to index
• ⛏ Player breaks cane → removed from index
• ⏱ Every X ticks → only indexed bases are grown

The vanilla BlockGrowEvent for sugar cane is cancelled — FastCane is the sole controller of cane growth speed.

---

📁 Configuration

The config file is automatically generated at plugins/FastCane/config.yml on first launch. You can edit it directly or use the in-game commands — changes made with /cane tick, /cane stop, /cane lang, etc. are saved automatically without needing to touch the file.

# plugins/FastCane/config.yml

# Growth interval in ticks (20 ticks = 1 second)
# Vanilla default: ~4096 ticks (~3.4 min per block)
# Lower = faster. Range: 1 - 100000
growth-ticks: 10000

# Vanilla tick value — used by /cane reset
vanilla-ticks: 4096

# Language: en, fr, zh
lang: en

# Is growth active?
enabled: true

---

📋 Requirements

🖥 Server	Paper 1.21.x
☕ Java	21+
🌍 Environment	Server-side only

---

❓ FAQ

Does this work with piston farms?
Yes — FastCane only controls when cane grows, not how it's harvested.

Will /cane tick 1 lag my server?
With thousands of canes it can add up. Test with /cane tick 20 first and adjust.

Does this affect bamboo or kelp?
No. Only SUGAR_CANE is affected.

The speed I set resets after restart?
It shouldn't — the value is saved automatically to config.yml. Check that your server has write permissions to the plugins folder.

---

🐛 Issues & Suggestions

Found a bug? Open an issue and include:

• Your Paper version (/version)
• FastCane version
• What you expected vs what happened
• Any console errors

---

---

🇫🇷 Voir en Français # 🌾 FastCane — Version Française

Fatigué d'attendre 3+ minutes pour que la canne à sucre pousse d'un bloc?
FastCane te donne le contrôle total — de la vitesse vanilla à quasi-instantané, sans impact sur les TPS.

---

✨ Fonctionnalités

• 🚀 Vitesse configurable — n'importe quel intervalle de 1 à 100 000 ticks
• ⚡ Zéro impact TPS — architecture event-driven, aucun scan de chunks
• 🌿 Canne à sucre uniquement — toutes les autres plantes restent en vanilla
• ⏸ Stop / Start — pause et reprise de la croissance à tout moment
• 🔄 Reset — retour à la vitesse vanilla en une commande
• 🌍 Multi-langue — English, Français, 中文
• 💾 Persistant — les paramètres survivent aux redémarrages
• 🎯 Tab completion — suggestions automatiques intégrées

---

⚡ Commandes

Commande	Description
/cane	Afficher le panneau de paramètres
/cane tick <ticks>	Définir la vitesse de croissance
/cane tick	Voir la vitesse actuelle
/cane stop	Arrêter toute croissance
/cane start	Reprendre la croissance
/cane reset	Réinitialiser au vanilla (4096 ticks)
/cane lang <en|fr|zh>	Changer la langue
/cane info	Afficher le panneau d'info

Alias: /sugarcane, /sc

---

⏱ Référence de vitesse

Commande	Intervalle	Ressenti
/cane tick 1	~0.05s	🟢 Quasi-instantané
/cane tick 20	1s	🟢 Ultra rapide
/cane tick 100	5s	🟡 Très rapide
/cane tick 1000	50s	🟡 Rapide
/cane tick 4096	~3.4 min	🔵 Vanilla
/cane tick 10000	~8.3 min	⚪ Défaut

💡 20 ticks = 1 seconde

---

📁 Configuration

Le fichier de config est généré automatiquement dans plugins/FastCane/config.yml au premier démarrage. Tu peux l'éditer directement ou utiliser les commandes en jeu — les changements faits avec /cane tick, /cane stop, /cane lang, etc. sont sauvegardés automatiquement.

---

❓ FAQ

Ça marche avec les fermes à pistons?
Oui — FastCane contrôle uniquement quand la canne pousse, pas comment elle est récoltée.

Est-ce que /cane tick 1 va lagger le serveur?
Avec des milliers de cannes ça peut s'accumuler. Teste avec /cane tick 20 d'abord.

Ça affecte le bambou ou les algues?
Non. Uniquement SUGAR_CANE est affecté.

---

Fait avec ❤️ par belyxzor