Viner - The New Veinminer Mod!

Welcome to Viner, a mod inspired by the classic Veinminer! With Viner, you can mine blocks in veins, saving you precious time from digging into walls. It's all about efficiency and customizability!

How It Works

Viner allows you to mine an entire vein of blocks at once, as long as they are designated as "Vineable." Simply hold down the Vine Key while breaking blocks, and experience the efficiency of Viner. The mod mines adjoining blocks together in a single action, streamlining your mining process.

Demo Trailer

Main Features

Vein Mining

Mine entire veins of blocks in one go. If blocks are part of a vein and configured as "Vineable," Viner allows you to break them all with a single action.

Customizable Activation Key

Simple and intuitive, Viner activates when you hold down the configured activation key (shift by default) while mining, making it easy to switch between standard and vein mining.

Shape Vining

Hold your "vine" key and scroll with your mouse wheel to switch between regular vining and shape vining. Customize the mining shape with advanced configurations.

Inclusion and Exclusion Lists

Control which blocks are vein-mined with inclusion and exclusion lists. This feature lets you fine-tune your mining to specific blocks or exclude certain blocks as needed.

Vine All Option

The "Vine All" feature allows Viner to mine any block.

Hunger Penalty

The "Hunger Penalty" feature reduces the players' hunger when they use the Viner action. Customize the amount of hunger per block mined with advanced configurations.

Configuring Viner

This section details how to configure the "Viner" mod, enhancing your Minecraft experience with customized vein mining capabilities.

General Steps to Configuring Viner

Using the Configuration Screen:
- Users can press the RIGHT SHIFT key while in-game to pull up the configuration screen and configure everything on the fly!
Configuring the Vine AND Configuration Menu Keys
- Go to the options screen in Minecraft
- Go to Controls.
- Go to Key Binds.
- Scroll down until you see the "Viner" section.
- The Vine Blocks option can be configured to any key, by default its set to Left Shift.
- The Configuration Menu option can be configured to any key, by default its set to Right Shift.
Configuring Shape Vining:
- In the same config file, adjust settings for heightAbove, heightBelow, widthLeft, and widthRight, LayerOffset.
Configuring the rest of the configurations:
- Locate the config file named 'viner-common.toml`.
- Open the file with a text editor; double-clicking the file should work too.
- Modify the values as per your requirements.
- Save the file and restart Minecraft for the changes to take effect.

Location of Config File

Through Minecraft:
- In Minecraft, go to your "mods" folder and click "Open mods folder".
- Navigate up one level to reach the main Minecraft folder.
- Find the "config" folder, where viner-common.toml is located.
Directly via File Explorer:
- Alternatively, open your File Explorer.
- Enter %appdata%\.minecraft\config\viner in the address bar.
- This directly opens the folder containing viner-common.toml.
- Note: if you've never launched Minecraft with Viner installed, this folder won't exist!

Configurable Options

Vineable Limit

Description: Sets the maximum number of blocks you can vein mine.
Config Key: vineableLimit
Range: 1 -> 2147483647
Default Value: 5

Vineable Blocks

Description: Specifies the list of blocks or tags that can be vein mined.
Config Key: vineableBlocks
Format: Array of block names or tags (e.g., ["minecraft:diorite", "#minecraft:ores"])
Default Value: ["minecraft:diorite", "#minecraft:ores", "#minecraft:logs", "#minecraft:leaves", "#forge:ores", "minecraft:sculk"]

Unvineable Blocks

Description: Lists blocks that are exempt from vein mining, overriding vineableBlocks.
Config Key: unvineableBlocks
Format: Array of block names or tags (e.g., ["minecraft:diorite", "#minecraft:ores"])
Default Value: []

Vine All

Description: Allows Viner to mine any block when set to true.
Config Key: vineAll
Values: true or false
Default Value: false

Shape Vining Configurations

Height Above:
- Description: The number of blocks to mine above the starting block.
- Config Key: heightAbove
- Range: 0 -> 2147483647
- Default Value: 1
Height Below:
- Description: The number of blocks to mine below the starting block.
- Config Key: heightBelow
- Range: 0 -> 2147483647
- Default Value: 1
Width Left:
- Description: The number of blocks to mine to the left of the starting block.
- Config Key: widthLeft
- Range: 0 -> 2147483647
- Default Value: 0
Width Right:
- Description: The number of blocks to mine to the right of the starting block.
- Config Key: widthRight
- Range: 0 -> 2147483647
- Default Value: 0
Layer Offset:
- Description: The number of blocks for each layer vined to be offset by vertically from each other. Useful for creating staircases for mine shafts, for example.
- Config Key: offset
- Range: 0 -> 2147483647
- Default Value: 0

Exhaustion/Hunger Per Block

Description: Amount of exhaustion added per block mined with vein mining.
Range: 0.0 -> 3.0
Default Value: 0.25

A First-Time Modder's Creation

Viner is my very first modding project, and I'm excited to share it with the Minecraft community. I welcome any feedback or suggestions you might have. If you spot any obvious improvements or if there's a feature you'd love to see added, don't hesitate to let me know on GitHub or our community Discord. Your input is valuable, and it helps make Viner even more awesome!

So, embark on your mining adventures with Viner, and experience the joy of efficient block mining in Minecraft! Happy mining!

Viner Community Discord

If you have any suggestions, anything you'd like to say, or just some like-minded people to hangout with don't forget to join our Viners Community Discord! https://discord.gg/6tp8SZnFhP

Note: Viner is not affiliated with Veinminer or its creators. This mod is a standalone creation inspired by the concept of Veinminer.

Viner