/bridge-electron-port

Next generation of bridge., the Minecraft Add-On editor

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

bridge. v2

Version License

This is the repository for bridge. v2, a powerful IDE for Minecraft Add-Ons.

Installation

  1. Visit https://editor.bridge-core.app/ with a supported browser. (We recommend the new Edge based on Chromium)
  2. Click the install icon that appears inside of the URL bar. install
  3. bridge. v2 is now installed to your system. You can continue with the guided setup process.

For more help on how to get started, please refer to our getting started guide.

New App UI

bridge. v2 comes with a gorgeous redesign of all UI elements. This gives bridge. v2 a fresh new look and increases the usability of our UI.

Pack Explorer

Our new pack explorer combines all pack types into a single, color-coded sidebar area.

Bildschirmfoto 2021-07-18 um 11 02 39


Creating Files

Presets are now at the front and center of creating files. Presets allow users to quickly create all files necessary to get a feature working in game. They are perfect for e.g. quickly setting up a new entity, block or item. You can also see that all window sidebars now have an updated look and all content windows now offer the ability to quickly search for things.

Bildschirmfoto 2021-07-18 um 11 06 06


Extension Store

Our new extension store also received a visual overhaul and some significant functionality changes to make it easier to keep extensions up to date, disabling/enabling installed extensions and exploring the catalogue.

Bildschirmfoto 2021-07-18 um 11 11 14

Broader Bedrock Support

bridge. v2 now supports creating skin packs and world templates in addition to behavior and resource packs. We have also published an extension called "WorldHub" which allows creators to add multiple worlds to a project & pulling/pushing them from/to the com.mojang folder.

Project Structure

bridge. v2 moves projects out of the com.mojang directory by default. Additionally, all packs that belong to a project can be found inside of a single folder. This allows for very easy integration with version control systems like git and makes it easier to work on the project with other editors. A typical v2 project looks like this:

-- My Project/
--- .bridge/
--- BP/
---- ...
---- manifest.json
--- RP/
---- ...
---- manifest.json
--- SP/
---- ...
---- manifest.json
--- config.json

Compiler Architecture

Even though bridge. v2 no longer stores your project inside of the com.mojang folder, you still get the same seamless development experience if you have setup com.mojang syncing by dragging the folder onto bridge. v2. Upon making changes to the project folder, bridge. will re-compile the file and move it to Minecraft for testing. Because this process is fully automatic, you should never manually work on the add-on inside of the com.mojang folder because any changes might get overwritten. Always work with the project folder!

When you make changes to your project outside of bridge., you can refresh the project and bridge. will pick up any changes made with external editors and update the com.mojang output accordingly. This also works with file deletions & renames.

Bildschirmfoto 2021-07-18 um 12 02 09

Our compiler generally has two modes: "dev" and "build". The procedure described above always happens inside of "dev" mode. It is optimized for delivering fast & correct updates to all files that need to change whenever a source file inside of the dependency tree changes. The "build" mode compiles a full build that is ready for production inside of the "project/builds/dist/" folder. Some compiler plugins such as AnyLanguage are designed to only work inside of this compiler mode.

Editing

bridge. v2 finally allows developers to freely switch between editing JSON files as text or in a dedicated tree editor that prevents newer users from making syntax mistakes. We also added a global find & replace system and live previews of files while your are working on them.

Text Editor

We are using Monaco to provide the same incredible editing experience VS Code provides and we ship auto-completions & validations for all of Minecraft's JSON files.

Bildschirmfoto 2021-07-18 um 11 17 33


Tree Editor

Our new tree editor features support for multiple selections, direct/more natural keybindings (e.g. "Del" instead of "Ctrl + Del") and makes use of the same new JSON schemas our text editor uses for its auto-completions. We are looking to add better (more Minecraft-y) syntax highlighting to both our text editor and tree editor in the future.

Bildschirmfoto 2021-07-18 um 11 26 44


Live Previews

bridge. v2 ships with the ability to preview files while you edit them. This allows developers to find the perfect seat positions & collision/hit boxes without needing to jump into Minecraft. We support previewing particles, entities (components, models, particles & animations) and blocks (components & models).

Bildschirmfoto 2021-07-18 um 11 21 42


Global Find & Replace

This was one of the most requested features for bridge. v1. It proved to be technically difficult to implement previously because of the cache system that was in place for the old editor. With our new codebase, we were finally able to add a global find & replace system!

Bildschirmfoto 2021-07-18 um 11 32 14

Extensions

We are proud to already feature some fantastic new extensions on bridge. v2's extension store.

  • We have compiler plugins for automatically generating the "texture_list.json" file for production builds or automatically generating all lang files based on the "en_US.lang" file
  • A lot of themes are already available for bridge. v2
  • @aexer0e's fantastic "Compact Prettier" changes the default "format on save" formatter to produce more compact output
  • There are fantastic UI extensions such as @jasonjgardner's texture set generator, the MoLang Playground or @aexer0e's Table2 extension for displaying & editing Google Docs Tables inside of bridge.

Bildschirmfoto 2021-07-18 um 11 36 11

Bildschirmfoto 2021-07-18 um 11 35 31