A Visual Studio Code extension providing powerful tools for working with Kore, a Kotlin library for creating Minecraft datapacks without writing JSON.
- Kore declaration discovery: Detects datapacks, functions, predicates, recipes, advancements, world-generation resources, and the other supported Kore DSL builders in Kotlin files
- Gutter icons and hovers: Marks declarations in the editor and shows their resource location, generated output path, source location, and relevant Minecraft command
- Kore Explorer: Browses declarations by datapack and resource kind, or groups them by source file
- Navigation and copy actions: Reveals the declaration source and copies its resource location, output path, command, or name from the explorer
- Sorting and grouping: Switch between file and type views, then sort declarations by source file or name
- Snippets: Code snippets for quickly creating Kore elements with proper imports
Browse each datapack and its generated resources directly from the Activity Bar. Resource folders are grouped by their Kore declaration kind, and nested resource paths stay organized in the tree.
Hover a gutter icon to inspect the declaration's generated resource location and output path without leaving the source file.
You can install this extension through the VS Code Marketplace:
- Open VS Code
- Go to the Extensions view (
Ctrl+Shift+XorCmd+Shift+Xon macOS) - Search for "Kore Assistant"
- Click Install
Alternatively, you can install it directly from the VS Code Marketplace.
Kore is a modern Kotlin library that allows you to:
- Create Minecraft datapacks using Kotlin instead of JSON
- Write clean, type-safe code with full IDE support
- Generate commands, recipes, advancements and other datapack components
- Support for Minecraft 1.20 and later versions
Visit kore.ayfri.com for official documentation.
- Visual Studio Code 1.125.0 or newer
- A Kotlin language extension, e.g. the official Kotlin by JetBrains extension (powered by kotlin-lsp)
- Open a Kotlin file containing Kore declarations, such as
dataPack,function,predicate, orcraftingShaped - The extension will automatically detect and highlight them with gutter icons
- Use the Kore Explorer in the Activity Bar to browse declarations by datapack and resource kind
- Select a declaration to jump to its Kotlin source, or use its context menu to copy its generated value
- Configure grouping and sorting with the view toolbar buttons
- Use the snippets to quickly create new Kore elements (see snippets section below)
To refresh the icons manually, run the "Kore: Refresh Gutter Icons" command from the command palette.
The extension provides the following snippets for Kotlin files:
dp- Creates a datapack declaration with automatic importfn- Creates a function declaration with automatic import
- Group elements by file or type
- Sort elements by name or file location
Please file issues and feature requests on the project's repository.
This extension is licensed under the GNU General Public License v3.0.
Contributions to the Kore Assistant extension are welcome!
- Fork the repository
- Create your feature branch:
git checkout -b feature/amazing-feature - Install dependencies:
bun install - Make your changes
- Build and test:
bun run package - Commit your changes:
git commit -m 'Add some amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
The extension is published to the VS Code Marketplace automatically when a new tag is pushed to the repository.
To publish a new version:
- Update the version in
package.json - Update the CHANGELOG.md file
- Update the version badge in README.md
- Commit your changes:
git commit -m 'Release v0.x.x' - Tag the release:
git tag v0.x.x - Push the changes:
git push && git push --tags
GitHub Actions will automatically build and publish the extension.