# WinCraft

**Repository Path**: YeahOSS/WinCraft

## Basic Information

- **Project Name**: WinCraft
- **Description**: ✨ 雕琢 Windows，如你所愿
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://yeahoss.github.io/WinCraft/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-26
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WinCraft

[![GitHub Release](https://img.shields.io/github/v/release/YeahOSS/WinCraft)](https://github.com/YeahOSS/WinCraft/releases) [![GitHub Downloads](https://img.shields.io/github/downloads/YeahOSS/WinCraft/total)](https://github.com/YeahOSS/WinCraft/releases) [![GitHub Stars](https://img.shields.io/github/stars/YeahOSS/WinCraft)](https://github.com/YeahOSS/WinCraft/stargazers) [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows-0078D6)](https://github.com/YeahOSS/WinCraft) [![.NET](https://img.shields.io/badge/.NET-3.0%20%7C%204.5-512BD4)](https://dotnet.microsoft.com)

<br>
<p align="center">
  <img src="assets/social-preview.png" alt="WinCraft" width="600">
</p>

English | [简体中文](docs/i18n/README.zh-CN.md)

WinCraft is a Windows tuning toolbox focused on system configuration and everyday usability improvements.

The project is still in an early scaffold stage. The repository already contains the multi-target build pipeline, release workflow, and compatibility layer, while the end-user feature set is still being built out.

## 📜 History

WinCraft continues the work of [ContextMenuManager](https://github.com/BluePointLilac/ContextMenuManager)
under a new account and name.  The original repository became unmaintainable
after I lost access to my 2FA credentials.

> 😤 GitHub 2FA: great at keeping attackers out, even better at keeping
> the [original author](https://github.com/BluePointLilac/ContextMenuManager/commits/master) out.
> Those commits are my pre-AI badge of honor.

| Then | Now |
| --- | --- |
| <img src="https://raw.githubusercontent.com/BluePointLilac/ContextMenuManager/master/ContextMenuManager/Properties/AppIcon.ico" width="16" height="16"> ContextMenuManager | <img src="assets/app.ico" width="16" height="16"> WinCraft |
| BluePointLilac (lost 2FA) | YeahOSS |
| Context menus only | Broader Windows tuning toolbox |
| WinForms | WPF — more modern look and feel |

## 🚧 Planned Features
- [ ] Context menu management
- [ ] File association management
- [ ] File Explorer tweaks and cleanup
- [ ] Additional Windows configuration improvements for a smoother daily experience

## 📥 Downloads

| Platform | Releases |
| --- | --- |
| GitHub | [Releases](https://github.com/YeahOSS/WinCraft/releases) |
| Gitee (mirror) | [Releases](https://gitee.com/YeahOSS/WinCraft/releases) |

### Installer (recommended) — `WinCraft-Setup.exe`

- **Automatic .NET Framework adaptation.** Detects the installed .NET Framework version at install time: prefers `net45` when .NET 4.5+ is available, falls back to `net30` for older built-in-framework systems.
- **Faster startup.** Files are deployed directly to disk with an optimized runtime configuration — no overlay decompression at launch.

### Portable — `WinCraft-Standard.exe` / `WinCraft-Legacy.exe`

Single-file executables for users who prefer a no-installer experience or need to deploy to a specific framework line directly:

| Package | Target Framework | Supported Windows |
| --- | --- | --- |
| `WinCraft-Standard.exe` | .NET Framework 4.5 | Windows 8, 8.1, 10, 11 |
| `WinCraft-Legacy.exe` | .NET Framework 3.0 | Windows Vista, 7 |

> [!WARNING]
> Because WinCraft modifies Windows settings through system APIs, some antivirus or security products may raise false positives — particularly on older release lines where legacy framework heuristics are stricter.
>
> Add the WinCraft folder or executable to your security software allowlist before running it.

## 🔨 Build From Source
Build and release workflow details live in [publish/README.md](publish/README.md).

## 🤝 Acknowledgements

WinCraft builds on the work of these open-source projects:

- [7-Zip LZMA SDK](https://www.7-zip.org/sdk.html) — Igor Pavlov (public domain) — efficient LZMA compression
- [Theraot](https://github.com/theraot/Theraot) — backfills missing .NET APIs for `net30` compatibility
- [CsWin32](https://github.com/microsoft/CsWin32) — Microsoft — source-generated Win32 P/Invoke
- [NSIS](https://nsis.sourceforge.io/) — Nullsoft — flexible Windows installer

[![Star History](https://api.star-history.com/svg?repos=YeahOSS/WinCraft&type=Date)](https://star-history.com/#YeahOSS/WinCraft&Date)