⛏️ Minecraft Theme

A fully immersive VS Code experience inspired by the world of Minecraft.

✨ Features

🎨 10 Color Themes

Choose from a growing collection of Minecraft-inspired color themes:

• Minecraft (General) — The original dark theme with grass greens, stone grays, sky blues, and wood browns
• Minecraft: Plains — Warm greens, light blues, and golden yellows
• Minecraft: Desert — Sandy browns, terracotta oranges, and arid yellows
• Minecraft: Nether — Deep reds, oranges, netherrack browns, and soulfire blues
• Minecraft: The End — Dark purples, endstone off-whites, and chorus plant pinks
• Minecraft: Villager — Warm browns, emerald greens, and parchment off-whites
• Minecraft: Piglin — Crimson reds, gold yellows, and netherrack browns
• Minecraft: Enderman — Deep purples and black with ender pearl cyan highlights
• Minecraft: Steve — Classic blue jeans, cyan shirt, and skin tones
• Minecraft: Creeper — Dark greens, black, and creeper-face lime green accents

🔊 Minecraft Sound Effects

Context-aware audio feedback that brings the Minecraft atmosphere to your coding environment:

Sound playback is handled natively on each platform:

• Windows — PowerShell with MediaPlayer API
• macOS — afplay
• Linux — mpg123

🖊️ Markdown Preview Styles

Your markdown previews are styled to look like Minecraft's enchanting language and written books — blockquotes become achievement popups, code blocks become command blocks, and headings get the Minecraft treatment.

🧭 Welcome Walkthrough

When you first install the extension, an interactive 3-step walkthrough welcomes you:

1. Equip Your Armor — Select your favorite theme
2. Craft Your Workspace — Customize settings
3. Tune Your Ear — Enable all sounds

🛠 Prerequisites

This extension provides an immersive experience with sounds from the world of Minecraft. To enable audio features, your system requires a media player accessible via terminal.

Sound System Requirements

🐧 Special Note for WSL2 Users

If you are using WSL2, please ensure:

1. You have mpg123 installed inside your Linux distribution.
2. Your WSL2 instance is configured to output audio to Windows (standard in latest Windows 11 versions with WSLg).
3. If you don't hear sounds, ensure your PulseAudio or system sound server is correctly bridged.

⚠️ Troubleshooting

If the sound system fails to initialize, the extension will still function as a color theme. You can check the Extension Host logs in the Output panel for specific error messages regarding audio playback.

🚀 Installation Guide

You can install the Minecraft Theme using one of the following methods:

1. Via Visual Studio Code Marketplace

1. Open Visual Studio Code.
2. Go to the Extensions view (Ctrl+Shift+X).
3. Search for Minecraft Theme.
4. Click Install.

2. Manual Installation (.vsix)

If you have the compiled extension file:

1. Open your terminal in the directory where the .vsix file is located.
2. Run the following command:

code --install-extension minecraft-theme-1.0.3.vsix

3. Restart Visual Studio Code.

⚙️ Configuration & Commands

Once installed, the Walkthrough will guide you, but you can manually configure everything:

Selecting a Theme

Press Ctrl+K then Ctrl+T and select any theme from the Minecraft family.

Sound Commands

Open the Command Palette (Ctrl+Shift+P) and type Minecraft to access:

• Minecraft Theme: Enable All Sounds — Turns on the master audio switch
• Minecraft Theme: Disable All Sounds — Instantly mutes all sounds

You can also customize exactly which events trigger sounds (like file saving, terminal errors, or tab switching) by searching for Minecraft Theme in your VS Code Settings (Ctrl+,).

🛠️ Development & Customization

If you want to modify the theme or sounds for personal use:

1. Clone this repository: git clone https://github.com/MateoRyhr/minecraft-theme.git
2. Install dependencies: npm install
3. Press F5 inside VS Code to open a Extension Development Host window and test your changes in real-time.

📜 Credits

This is a fan project. Minecraft and all related assets, themes, and concepts belong to Mojang Studios.