# ege-vscode-plugin

**Repository Path**: xege/ege-vscode-plugin

## Basic Information

- **Project Name**: ege-vscode-plugin
- **Description**: A vscode plugin to help the configuration of ege (https://xege.org ). Enjoy it!
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-11
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VSCode Plugin for [Easy Graphics Engine](https://github.com/wysaid/xege)

A VSCode plugin to help the configuration of [ege](https://xege.org). Enjoy it!

## Features

- Generate `EGE Projects` with single click
- Build and run single cpp files with EGE support.(`graphics.h`)
- Add EGE CMake Project Template for `C/C++` source.
- Support MacOS/Linux (By `mingw-w64` and `wine`)
- **Internationalization (i18n)**: Automatic language detection based on VS Code's display language
  - English (default)
  - 中文 (Chinese) - automatically selected when VS Code's display language is Chinese
- Generate project templates based on the EGE source code. The source mode will be periodically updated to the latest EGE code, making it easier to discover issues.

## Deps

- Windows: Visual Studio `2017`/`2019`/`2022`/`2026+`
- MacOS: `mingw-w64`, `wine-stable` (wine64)
  - You can install via `brew install mingw-w64 wine-stable`
- Linux: `mingw-w64`, `wine64`
  - You can install via `apt install mingw-w64 wine64` (Ubuntu/Debian)

## Install

- Search `ege` in the Visual Studio Store.
- Get it at <https://marketplace.visualstudio.com/items?itemName=wysaid.ege>

## Extension Settings

You can define some options like below:

```jsonc
{
    /// The url to get latest version of EGE (default: https://xege.org/download/ege-latest-version)
    "ege.update_url": "", 
    "ege.showEditorContextMenu": true, // Show 'ege' in editor context menu
    "ege.explorerContextMenu": true, // Show 'ege' in explorer context menu
    "ege.downloadFromOfficial": false // Download EGE from official website instead of using the builtin version
}
```

### Configuration Details

- **`ege.downloadFromOfficial`**: By default, the plugin uses the builtin EGE library (tested and stable). If you want to download the latest version from the official website (<https://xege.org>), set this option to `true`. Note that the official download may not always be stable or compatible with the plugin.

## MileStone

- Install:
  - Support ege downloading & install.

- Compiler:
  - Support vs2019 and later
  - Support MingW + GCC

- Solution:
  - Support single file compile & run
  - Support `Visual Studio` template generation.
  - Support CMake template generation.

- Platform:
  - Windows 10 and later
  - MacOS via WINE