vs-vineyard/plan.md

VS Vineyard — Development Plan

This is a suggested breakdown of the work ahead. Nothing here is set in stone — feel free to reorder, combine, skip, or tackle things differently. It's meant as a starting point for discussion and to help split work between contributors.

---

Phase 1: Grape Vines (Foundation)

Everything else depends on being able to grow and harvest grapes, so this is a natural place to start — but the art and JSON work can happen independently while the C# is being written.

1a. Grape Vine Block Logic — C#

• Create BlockGrapeVine.cs to handle growth stages, seasonal transitions, and right-click harvesting
• Register it in VSVineyardModSystem.cs

1b. Grape Vine Block Definition — JSON

• blocktypes/grapevine.json — defines growth stages, drops, and how the vine attaches (trellis, wall, etc.)

1c. Grape Vine Textures & Shapes — Art

• Textures for each growth stage: bare, budding, leafy, fruiting, dormant
• 3D shape (or a simple flat cross-plant shape to start)
• Tools: pixel art editor (16×16), optionally Blockbench for shapes

---

Phase 2: Grapes as Items

2a. Grape Item Definition — JSON

• itemtypes/grapes.json — nutritional values, variants by grape type

2b. Grape Item Texture — Art

• Inventory sprite for grapes

---

Phase 3: Juice Pressing

3a. Wine Press Block Logic — C#

• BlockEntityWinePress.cs — a container block entity with input/output slots and a pressing interaction

3b. Wine Press Definition, Shape & Textures — JSON + Art

• Blocktype JSON, 3D shape model, textures
• Tools: Blockbench, pixel art editor

3c. Pressing Recipes — JSON

• Recipe entries: grapes → grape juice

---

Phase 4: Fermentation & Barrel Aging

This phase has the most complexity. The barrel block entity will need to handle time-based fermentation, liquid storage, and aging — worth discussing the approach before diving in.

4a. Wine Barrel Block Entity — C#

• BlockEntityWineBarrel.cs — time-based fermentation, liquid handling, aging stages
• Probably the most involved C# task in the mod

4b. Barrel Definition, Shape & Textures — JSON + Art

• Blocktype JSON, shape, textures (empty / filling / full variants)

4c. Barrel Recipes — JSON

• recipes/barrel/ entries: grape juice → wine over time

4d. Wine Item Variants — JSON + Art

• Item definitions for each wine variety, stat effects, textures

---

Phase 5: World Generation

5a. Wild Vine Worldgen Patches — JSON

• worldgen/patches/ — spawn wild vines on trees or cliff faces in appropriate biomes

5b. Wild Vine Behaviour — C# (optional)

• Only needed if wild vines require different behaviour from player-placed vines

---

Skill Summary

Area	Skill	Can start immediately?
Block/item/recipe logic	C#	Phase 1a first, then in parallel
Block/item/recipe definitions	JSON	Yes — alongside C# once structure is clear
Textures	Pixel art (16×16)	Yes — fully independent
3D block shapes	Blockbench + JSON	Yes — fully independent
World generation	JSON	After Phase 1

The art work (textures and shapes) can be picked up right now without needing to wait for any code. JSON definitions and C# can generally be split across two people once Phase 1a establishes the patterns to follow.

---

This plan was put together as a rough guide. Adapt it however works best for the group — the goal is to have fun building this.