An open API service indexing awesome lists of open source software.

https://github.com/icecraft-studio/insert-molang-file-vsc-ext

Repository of VSCode Extension - Insert Molang File.
https://github.com/icecraft-studio/insert-molang-file-vsc-ext

minecraft minecraft-api minecraft-bedrock-addon minecraft-bedrock-edition molang vscode vscode-extension

Last synced: about 1 month ago
JSON representation

Repository of VSCode Extension - Insert Molang File.

Awesome Lists containing this project

README

          

# Insert MoLang File \[Minecraft Bedrock\]

Very simple extension to make development on Minecraft: Bedrock a little more easier, it gives you options to insert `.molang` files into `.json` files without a problem.

## Usage

To use this extension, simply right click (you can also use command pallete) on any string within an addon file, a menu will pop up and you can select whichever file from the `molang` folder you want to insert. It doesn't matter if the string is empty or not, it will simply replace it completely.
If working in resource pack file it will only look into resource pack's `molang` folder and so with behavior packs.
When it inserts the MoLang file's code, it removes any newlines or returns and comments, so you don't have to worry about json errors!
Comments are supported within MoLang files like so: single-line comments using `//` or `#` and multi-line comments using `/**/`. They will be ignored and won't be inserted.

### !Attention!

Molang files in subfolders aren't supported, refer only to files in root folders!

`molang` folder is case-sensitive, make sure it's all lower-case letters!

The extension looks for the addon root path by finding the directory closest to the root of the file system, that contains a folder with addon keyword name like `features` or `entities`. Make sure addon folder keyword names don't exist anywhere in the addon root path, only inside the addon!

Example of this problem: `C:\Minecraft\Development\biomes\My addon\features\test.json`

- In this case the extension will think your addon is located at `C:\Minecraft\Development\` even if you intent to have it at `C:\Minecraft\Development\biomes\My addon\`. A simple fix for this is to replace the `biomes` folder with something else like `Custom Biomes`, which isn't a keyword name.

Addon folder keyword names: `subpacks,features,biomes,feature_rules,entities,entity,blocks,items,animations,animation_controllers,attachables,particles,render_controllers`

### Usage example:

![usage example](https://raw.githubusercontent.com/PavelDobCZ23/Insert-Molang-File-VSCode-Extension-/main/assets/example_usage.gif)

## Setup

- Molang folder in your resource pack or behavior pack (*`[BP/RP]`*`\molang`) with Molang files in it.
- Any addon file to insert Molang code into.

## Dependencies

This extension does not have any dependencies.

## Settings

- `molang-insert.fileSorting`: set how files will be sorted in the menu
- `molang-insert.typing.enabled`: set to `true` if you want to insert molang files by typing their name alone into a string (optionally with a prefix)
- `molang-insert.typing.prefix`: optional setting to set prefix when using typing option mentioned above

More details are explained within VSCode settings.

Usage example of inserting Molang file by typing its name:

![usage example legacy](https://raw.githubusercontent.com/PavelDobCZ23/Insert-Molang-File-VSCode-Extension-/main/assets/example_usage_legacy.gif)

## Known Issues

So far no issues have been spotted.

## Finishing up

This extension is made by **Studio IceCraft**

- [Our Website!](https://www.icecraftstudio.repl.co) *WIP*
- [Our Discord Server!](https://discord.com/invite/K28m8cKp74)

\
*Not affiliated with Mojang or Microsoft*

**Minecraft is an IP owned by Microsoft and Molang is a part of this IP, all legal rights to those subjects belong to them.**